Connect tools & data

API bağlantıları

Herhangi bir HTTP API

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#

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

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

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

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

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ğ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). 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#