Skip to main content
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

1

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.
2

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.
3

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.
4

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.
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.
Parametrelere sade dille açıklamalar ekleyin (“Müşteri e-posta adresi, ör. 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.

​
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). 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

API üzerinden araç entegrasyonları

Aynı bağlantıları programatik olarak oluşturun ve yönetin.

Uygulamaları bağlayın

Hazır Google, Slack, HubSpot, Salesforce ve Cal.com bağlantıları.

MCP sunucusu ekleyin

Tüm bir araç sunucusunu ajanlarınıza sunun.

Entegrasyonlar API referansı

Entegrasyon kaynağundaki her alan.