Entegrasyonlar
Herhangi bir API'yi bağla
Bağlayıcılar kataloğunda olmayan servisleri kullan. Herkese açık API'lerden anahtar isteyen servislere kadar hepsi olur. İstersen yapay zekânın kullanabileceği kendi bağlayıcını da ekleyebilirsin.
Bağlayıcılar kataloğunda 100'den fazla servis var. Ama uygulaman, API'si olan hemen hemen her servisle çalışabilir. API, başka yazılımların o servisle konuşmasını sağlayan bir yoldur. Bu sayfada bunu yapmanın üç yolunu görürsün. En hızlısından en çok yeniden kullanılabilir olanına doğru sıralandı.
| Durumun | Ne yapmalısın |
|---|---|
| API herkese açık ve anahtar istemiyor | Sohbette iste |
| API anahtar istiyor ve anahtarı sadece tek bir uygulamada kullanacaksın | Yapay zekâ senden anahtarı istesin. Anahtar, o uygulama için gizli anahtar olarak kaydedilir |
| Servisi birkaç uygulamada kullanacaksın ya da yapay zekânın servisi iyi anlamasını istiyorsun | Bağlayıcılar sayfasında kendi bağlayıcını oluştur |
Hangisini seçersen seç, anahtarlar sadece uygulamanın sunucu kodunda kullanılır. Yani ziyaretçilerinin tarayıcılarına ulaşmaz.
Herkese açık bir API kullan
Hava durumu, resmi tatiller ya da açık veri gibi pek çok servis hiç anahtar istemez. Servisin adını söyle ve ondan ne istediğini anlat.
Ana sayfada, ziyaretçinin şehri için Open-Meteo API'sini kullanarak 5 günlük hava durumu tahminini göster.
Yapay zekâ iyi tanımadığı bir API için ayrıntıya ihtiyaç duyarsa dokümanın ilgili kısmını sohbete yapıştırabilirsin. Örneğin tek bir örnek istek ve servisin verdiği cevap yeterli olur. Dokümanı dosya olarak da ekleyebilirsin. Bunun için Görsel ve dosya ekle sayfasına bak.
Anahtar isteyen bir API kullan
Bir özellik, katalogda olmayan bir servis için anahtar gerektirdiğinde yapay zekâ sohbette bir anahtar kartı gösterir. Kartta kullanacağı ad yazar, örneğin ACME_API_KEY. Anahtarı yapıştır ve Kaydet'e tıkla. Anahtar olmadan devam etmek istersen Atla'ya tıkla.
Kart bunu açıkça söyler: Anahtar güvenli şekilde ve şifrelenmiş olarak kaydedilir. Sohbette de uygulamanın kodunda da asla görünmez. Sonradan Yönet → Gizli anahtarlar bölümünden değiştirebilirsin (ekip üyelerine anahtarı proje sahibinin değiştirebileceği söylenir).
CRM'imizde API'si üzerinden yeni bir potansiyel müşteri oluşturan bir iletişim formu ekle. API anahtarını benden iste.
Anahtarları sormadan önce kendin de ekleyebilirsin. Yönet sekmesini aç, Gizli anahtarlar'ı seç ve Yeni gizli anahtar ekle altından bir anahtar ekle. Önizlemen değişiklikleri otomatik olarak alır. Yayınlanmış uygulaman ise değişiklikleri bir sonraki yayınlayışında alır. Bunun için Gizli anahtarlar ve API anahtarları sayfasına bak.
Anahtarları sohbet mesajına yazma. Sohbet mesajları projenle birlikte kaydedilir. Bunun yerine anahtar kartını ya da Yönet → Gizli anahtarlar bölümünü kullan.
Kendi bağlayıcını oluştur
Bir servisi birden fazla uygulamada kullanacaksan ya da yapay zekânın API'sini iyice anlamasını istiyorsan onu kendi bağlayıcın olarak ekle. API'yi bir kez anlatırsın. Sonra katalogdaki her bağlayıcı gibi çalışır. Kendi anahtarınla bağlarsın, uygulama bazında açıp kapatırsın. Yapay zekâ da uygulamayı oluştururken onu kullanabilir ve ondan okuyabilir.
Bağlayıcılar sayfasında Kendi bağlayıcıların bölümüne in ve Bağlayıcı oluştur'a tıkla. Servisin API dokümanını açık tut. Çünkü API adresine ve anahtarı nasıl aldığına ihtiyacın olacak. Açıklamanın içine hiç anahtar yazılmaz. Kendi anahtarınla en sonda bağlanırsın.
Ayrıntılar
Bağlayıcıya bir Ad ver. İstersen kart için bir Kısa açıklama ve Ne işe yarar kısmını ekle (bu, yapay zekânın onu ne zaman kullanacağını anlamasına yardım eder). Sonra bir Kategori seç, istersen bir API dokümanı bağlantısı ekle ve bir Renk seç. Kod adı, uygulamalarının okuduğu ayar adlarını belirler, örneğin
ACME_CRM_API_KEY. Bu ad sonradan değiştirilemez.Nasıl giriş yapar
Her isteğin başladığı API adresini yaz (
https://ile başlamalıdır). Sonra Servis kim olduğunu nasıl kontrol ediyor? sorusunu yanıtla: Bearer token, Başlıkta API anahtarı, Adreste API anahtarı ya da Kullanıcı adı ve şifre. Servis birden fazla değer istiyorsa, örneğin bir hesap kimliği (ID), bunları Birden fazla değer gerekiyor mu? altına ekle. Bir önizleme de İstek nasıl görünür bölümünü gösterir.Test isteği
Sadece okuyan ve anahtar gerektiren bir istek seç, örneğin "ben kimim" ya da "öğelerimi listele" gibi. Buildliy, her anahtarı kaydetmeden önce kontrol etmek için bu isteği çalıştırır. Bu yüzden hiçbir şeyi değiştirmemelidir. Dene (isteğe bağlı) altına bir anahtar yapıştırıp Test isteğini çalıştır'a tıklayarak cevabı görebilirsin. Bu anahtar sadece test için kullanılır. Sonradan onunla bağlanmazsan kaydedilmez.
Verileri kim görür
Özel hesap verileri için (gelen kutun, notların ya da bankan) Sadece ben — kişisel'i seç. Herkes için olan veriler için (ürün listesi ya da herkese açık ilanlar gibi) Uygulamamı kullanan herkes — paylaşılan'ı seç.
Yapay zekâ için notlar
İstersen API dokümanının yapay zekânın bilmesi gereken kısımlarını yapıştır: uç noktalar (endpoint), örnek istekler ve cevaplar. Her nota bir Dosya adı ver. İstersen Yapay zekâ bunu ne zaman okumalı? kısmını da doldur. Her biri 20.000 karakterlik 10 nota kadar ekleyebilirsin. Yapay zekâ her notun başını görür, kalanını ihtiyaç duyunca okur. Buraya asla anahtar yapıştırma.
Bağlayıcı oluştur'a tıkla. Sonra bağlanma penceresi açılır. Dene (isteğe bağlı) altına bir anahtar yazdıysan pencerede o zaten doldurulmuş olur. Gerekirse anahtarını gir ve Bağlan'a tıkla. Buildliy anahtarı kaydetmeden önce test isteğini onunla çalıştırır, sonra şifreli olarak saklar. Anahtar sadece uygulamalarının sunucu kodunda kullanılır.
Acme CRM bağlayıcımı kullanarak bir panel sayfasında en yeni 20 kişimi göster ve bir arama kutusu ekle.
Kendi bağlayıcılarının her birinin bir kartı vardır. Kartta Bağlan (bağlandıktan sonra Yönet, anahtar çalışmayı bırakırsa Yeniden bağlan), Düzenle ve bir silme düğmesi bulunur. Bağlayıcıyı silersen bağlayıcı ve onun için kayıtlı anahtarın silinir. Onu kullanan uygulamalar, sen yeniden ekleyene kadar servise ulaşamaz. En fazla 25 kendi bağlayıcına sahip olabilirsin.
Sadece ben — kişisel'i seçtiysen yapay zekâ, o servisten gelen her şeyi uygulamanın giriş ekranının arkasında tutar. Bağlayıcı bağlandıktan sonra uygulamanın kodu onu kullanıyorsa ve uygulamada giriş yoksa yayın öncesi kontrol listesi yayınlamayı engeller. Uygulamada giriş varsa kontrol listesi, sadece senin (ya da seçtiğin kişilerin) giriş yapabildiğinden emin olmanı hatırlatır. Çünkü herkese açık kayıt, verileri herkesin görmesine izin verir.
Bir servisten olay al
Bazı servisler, yeni bir sipariş ya da tamamlanmış bir ödeme gibi bir şey olduğunda uygulamana mesaj gönderebilir. Bu mesajlara çoğu zaman webhook denir. Yapay zekâdan uygulamana bu mesajları alacak bir yer eklemesini iste. Servis, mesajların gerçek olduğunu kontrol etmen için sana bir imza anahtarı verirse yapay zekâ onu bir anahtar kartıyla ister.
Depo sistemimizden yeni sipariş olaylarını alan bir webhook uç noktası ekle ve her siparişi veritabanına kaydet.
Servise önizlemenin değil, yayınlanmış uygulamanın adresini ver. Çünkü önizleme her zaman çalışmaz. Bunun için Uygulamanı yayınla sayfasına bak.