---
title: "API bağlantıları"
description: "Herhangi bir HTTP API'sini, yapay zeka ajanınızın konuşma sırasında çağırabileceği bir işleve dönüştürün: bir cURL komutu yapıştırın; sihirbaz araç tanımını, parametreleri ve kimlik doğrulamayı oluşturur."
---

API bağlantıları, yapay zeka ajanlarınızın bir konuşma sırasında çağırabileceği özel HTTP işlevleridir — bir siparişi sorgulayın, destek kaydı oluşturun, hesap durumunu kendi arka ucunuzdan alın. Uç noktayı bir kez **Bağlantılar → API'ler** (`/dashboard/api-connections`) altında tanımlarsınız; bağlantının eklendiği ajanlar, konuşma gerektirdiğinde bu bağlantıyı çağırabilir.

Bir bağlantı oluşturmanın iki yolu vardır: sihirbazın analiz edebileceği bir şeyi yapıştırın veya bağlantıyı manuel olarak ayarlayın.

## Hızlı yol: yapıştırın ve analiz edin

<Steps>
  <Step title="Yeni API bağlantısı'na tıklayın">
    İletişim kutusu sihirbazda açılır. Kutucuğa örnek bir **cURL komutu**,
    **OpenAPI/Swagger belirtimi**, **Postman dışa aktarımı**, **TypeScript
    arayüzü** veya **Zod şeması** yapıştırın.
  </Step>
  <Step title="Analiz Et'e tıklayın">
    ThunderPhone, yapıştırdığınız içerikten bağlantının tamamını çıkarır — URL,
    yöntem, üstbilgiler ve bulduğu sorgu parametreleri ile istek
    gövdesinden türetilen bir parametre şeması. Yapıştırdığınız üstbilgiler
    (kimlik doğrulama üstbilgileri dahil) uç nokta yapılandırmasına eklenir.
  </Step>
  <Step title="Vurgulanan alanları onaylayın">
    Çıkarılan yapılandırma, incelemeniz için tahmin edilen alanlar vurgulanmış
    şekilde açılır. Ajanın işlevi ne zaman ve nasıl çağıracağını anlaması için
    adları, açıklamaları ve parametre türlerini düzenleyin — açıklama,
    modelin okuduğu metindir.
  </Step>
  <Step title="Doğrula ve Kaydet">
    Kaydetme işlemi önce uç noktanıza canlı bir test isteği gönderir. İstek
    başarısız olursa bağlantı kaydedilmez — URL'yi, kimlik doğrulama
    üstbilgilerini veya gövdeyi düzeltin ve yeniden deneyin. Başarılı olursa
    bağlantı **Doğrulandı** rozetiyle kaydedilir.
  </Step>
</Steps>

Sihirbaz, yapıştırdığınız içerikte bir istek URL'si bulamazsa bunu bildirir —
tam bir `http(s)` uç noktası ekleyin ve yeniden deneyin.

## Manuel ayar

Sihirbazda **Manuel olarak ayarla →** seçeneğine tıklayın (veya geri dönmek için
**Yapay zekanın bunu çıkarsamasını ister misiniz? Sihirbazı deneyin →**
seçeneğine tıklayın). Manuel oluşturucuda iki düzenleyici bulunur:

- **Görsel** — görüntüleme adı, işlev adı, istek **URL'si**, **yöntem**
  (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`), özel **üstbilgiler** ve
  parametre şeması için form alanları (ajanın sağlayabileceği her bağımsız
  değişken için **Özellik ekle**).
- **JSON** — bir araç belirtimini doğrudan yapıştırmak veya ince ayar yapmak
  için aynı tanımın ham JSON biçimi.

Bir **Test İsteği** paneli (isteğe bağlı), kaydetmeden önce yapılandırılmış
isteği göndermenizi sağlar ve durum, gecikme ile yanıt önizlemesini gösterir.
**Doğrula ve Kaydet** her zaman bu testi çalıştırır ve yalnızca başarılı
olduğunda kaydeder.

Başlık değerleri yalnızca yazılabilir. Kaydedildikten sonra şifrelenir ve ne kontrol panelinde ne de API'de bir daha gösterilir. Bir bağlantıyı düzenlediğinizde, kaydedilmiş bir başlık değer yerine noktalarla birlikte adını ve **Kaydedildi** notunu gösterir: kaydedilmiş değeri korumak için olduğu gibi bırakın veya değiştirmek için yeni bir değer yazın. Test istekleri ve canlı çağrılar kaydedilmiş değeri kullanır. **Klonla**, kaydedilmiş değerleri yeni bağlantıya kopyalar.

<Tip>
  Parametrelere açık dilde açıklamalar verin ("Müşteri e-posta adresi,
  ör. jane@example.com"). Ajan, çağrı sırasında bu açıklamalardan
  bağımsız değişkenleri gerçek zamanlı olarak seçer.
</Tip>

## Bağlantılarınızı yönetin

Her bağlantı satırında doğrulama durumu — **Doğrulandı**,
**Test edilmedi** veya **Hata** — işlev adı ve bağlantıyı kullanan ajanlar
gösterilir. Satırın işlem menüsünden şunları yapabilirsiniz:

- **Düzenle** — yapılandırmayı yeniden açın.
- **Klonla** — başlangıç noktası olarak çoğaltın (kopya Test edilmedi
  durumunda başlar).
- **Revizyon geçmişi** — önceki sürümleri görüntüleyin ve birini
  düzenleyiciye geri yükleyin.
- **Aktar** — bağlantıyı üyesi olduğunuz başka bir kuruluşa kopyalayın veya
  taşıyın. Taşıma işlemi bağlantıyı buradan kaldırır; bağlantıyı kullanan
  ajanların yeniden yapılandırılması gerekebilir.
- **Sil** — kalıcıdır; bağlantıyı kullanan ajanların yeniden
  yapılandırılması gerekir.

## Bir ajana ekleyin

Bağlantıyı oluşturucunun API bağlantıları bölümünde bir ajana ekleyin
([Bir ajan oluşturun](/tr/guides/build-an-agent)). Liste, her bağlantıyı hangi
ajanların kullandığını gösterir; böylece bir değişikliğin neyi etkilediğini
tek bakışta anlayabilirsiniz.

## Sonraki adımlar

<CardGroup cols={2}>
  <Card title="API aracılığıyla araç entegrasyonları" icon="code" href="/tr/guides/build-tool-integration">
    Aynı bağlantıları programatik olarak oluşturun ve yönetin.
  </Card>
  <Card title="Uygulamaları bağlayın" icon="cable" href="/tr/guides/connect-apps">
    Hazır Google, Slack, HubSpot, Salesforce ve Cal.com bağlantıları.
  </Card>
  <Card title="MCP sunucusu ekleyin" icon="server" href="/tr/guides/mcp-servers">
    Tüm bir araç sunucusunu ajanlarınıza sunun.
  </Card>
  <Card title="Entegrasyonlar API referansı" icon="book" href="/api-reference/integrations">
    Entegrasyon kaynağundaki her alan.
  </Card>
</CardGroup>