> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API bağlantıları

> Herhangi bir HTTP API'sini, yapay zeka ajanınızın görüşme sırasında çağırabileceği bir işleve dönüştürün — bir cURL komutu yapıştırın, sihirbaz gerisini halletsin.

API bağlantıları, ajanlarınızın bir görüşme sırasında çağırabileceği özel HTTP işlevleridir — bir siparişi sorgulayın, talep oluşturun veya hesap durumunu kendi arka ucunuzdan alın. Uç noktayı **Connections → APIs** (`/dashboard/api-connections`) altında bir kez tanımlarsınız; bağlantının eklendiği ajanlar, görüşme gerektiğinde bu uç noktayı çağırabilir.

Bir bağlantı oluşturmanın iki yolu vardır: sihirbazın analiz edebileceği bir içerik 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. Kutunun içine örnek bir **cURL komutu**,
    **OpenAPI/Swagger spesifikasyonu**, **Postman dışa aktarma dosyası**, **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 tüm bağlantıyı çıkarır — URL,
    yöntem, başlıklar ve bulduğu sorgu parametreleri ile istek gövdesinden
    türetilen bir parametre şeması. Yapıştırdığınız başlıklar (kimlik
    doğrulama başlıkları dahil) uç nokta yapılandırmasına aktarılır.
  </Step>

  <Step title="Vurgulanan alanları onaylayın">
    Çıkarılan yapılandırma, incelemeniz için tahmin edilen alanlar
    vurgulanmış olarak 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 —
    model açıklamayı okur.
  </Step>

  <Step title="Doğrula ve Kaydet">
    Kaydetme işlemi önce uç noktanıza karşı canlı bir test isteği çalıştırır.
    İstek başarısız olursa bağlantı kaydedilmez — URL'yi, kimlik doğrulama
    başlıklarını veya gövdeyi düzeltin ve yeniden deneyin. Başarılı olduğunda
    bağlantı **Doğrulandı** rozetiyle saklanır.
  </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 kurulum

Sihirbazda **Manuel olarak ayarla →** seçeneğine tıklayın (veya geri dönmek için **Yapay zekanın bunu çıkarmasını mı istiyorsunuz?
Sihirbazı Dene →** 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 **başlıklar** 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ç spesifikasyonunu doğrudan yapıştırmak veya ince ayar
  yapmak için aynı tanımın ham JSON biçimi.

Bir **İstek Testi** paneli (isteğe bağlı), kaydetmeden önce yapılandırılan
isteği göndermenizi sağlar ve durumu, gecikmeyi ve 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.

<Tip>
  Parametrelere sade dille açıklamalar ekleyin ("Müşteri e-posta adresi,
  ör. [jane@example.com](mailto:jane@example.com)"). Ajan, görüşme sırasında gerçek zamanlı olarak
  bu açıklamalardan bağımsız değişkenleri seçer.
</Tip>

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

Her bağlantı satırı doğrulama durumunu — **Doğrulandı**,
**Test Edilmedi** veya **Hata** — işlev adını ve hangi ajanların kullandığını
gösterir. Satırın işlem menüsünden şunları yapabilirsiniz:

* **Düzenle** — yapılandırmayı yeniden açın.
* **Kopyala** — 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şımak, bağlantıyı buradan kaldırır; bunu 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 görebilirsiniz.

## Sonraki adımlar

<CardGroup cols={2}>
  <Card title="API üzerinden 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>