Araçlar: asistanı kendi sistemlerinize bağlama

Araç ne işe yarar?

Araç, sizin sisteminizde çalışan bir HTTPS adresidir (API uç noktası). Asistan konuşma sırasında gerektiğinde onu çağırır: örneğin randevu müsaitliğini, kargo durumunu ya da müşteri bakiyesini sizin sisteminizden okur.

Hazır bir entegrasyonu olmayan her sistem için araç kullanabilirsiniz. Menüden “Araçlar”ı açın; araç eklemek, düzenlemek, silmek ve denemek için sahip ya da yönetici olmanız gerekir.

Yeni araç ekleme

1. “Yeni araç” düğmesine basın.
2. “Araç adı”nı küçük harf ve alt çizgiyle yazın; örneğin musaitlik_sorgula.
3. “Ne zaman kullanılsın?” alanına aracın ne yaptığını ve hangi soruda çağrılması gerektiğini açıkça yazın. Asistan aracı ne zaman çağıracağına bu açıklamaya bakarak karar verir.
4. Yöntemi (GET ya da POST) ve adresi girin. Adres https ile başlamalıdır; yerel ve özel ağ adresleri kabul edilmez.
5. “Alan ekle” ile aracın beklediği alanları tanımlayın: ad, tip, açıklama ve zorunlu olup olmadığı. Asistan bu alanları konuşmadan doldurur. Tipler aşağıda.
6. “Kimlik doğrulama”yı seçin: yok, Bearer token ya da özel başlık (başlık adıyla). Gizli değer sunucuda saklanır ve bir daha gösterilmez; düzenlerken boş bırakırsanız kayıtlı değer korunur.
7. Kaydetmeden önce “Deneme çağrısı” ile örnek değerlerle deneyin; cevabı ya da hatayı hemen görürsünüz.

Alan tipleri ve iç içe alanlar

Her alanın bir tipi vardır ve değer uca bu tipte gider. Örneğin “Evet/Hayır” alanı "true" metni olarak değil true olarak, “Sayı” alanına 1.234,5 yazılsa da 1234.5 olarak gider.

• Metin, Sayı, Evet/Hayır: tek değer. Evet/Hayır alanı evet, hayır, true, false, 1 ve 0 yazımlarını tanır.
• Tarih: 06.10.2026 ya da 2026-10-06 yazılabilir; uca 2026-10-06 olarak gider. Tarih ve saat: 06.10.2026 14:30 gibi; uca 2026-10-06T14:30:00 olarak gider.
• Nesne: kendi alt alanları olan bir grup, örneğin müşteri (ad, e-posta). Alt alan eklemezseniz değer olduğu gibi, serbest JSON olarak gider.
• Liste: birden çok değer. “Öğe tipi”ni seçin; öğe Nesne ise öğenin alanlarını tanımlayın, örneğin sipariş kalemleri (ürün kimliği, adet).

Alanlar en çok 5 seviye iç içe tanımlanabilir. Nesne ve Liste yalnız POST araçlarında seçilebilir; GET isteği iç içe yapı taşımaz.

POST araçlarında alanların altında “Gövde örneği” görünür: uca gidecek JSON gövdesinin biçimi. Ucunuzun beklediğiyle karşılaştırabilirsiniz. “Deneme çağrısı”nda her alan tipine uygun bir kutuyla gelir; Nesne ve Liste alanları örnek gövdeyle dolu açılır.

Bir değer alanın tipine uymuyorsa (örneğin Sayı alanına “çok”) ya da zorunlu bir alan boşsa istek gönderilmez; hata hangi alanda olduğunu söyler, örneğin items[1].id (ikinci öğenin id alanı).

Veri değiştiren araçlar

Araç sisteminizde bir şeyi değiştiriyorsa (kayıt oluşturma, iptal gibi) “Bu araç veri değiştirir” kutusunu işaretleyin. Bu araçlar farklı değerlerle yeniden denenmez ve her çağrıları kaydedilir. Listede “Veri değiştirir” rozetiyle görünürler.

Aracı asistanda kullanma

• Yapay zekâ asistanı adımının “Araçlar” sekmesinde asistanın hangi araçlara erişeceğini seçersiniz: tümü (sonradan eklenenler dahil) ya da seçtikleriniz.
• “Seçim” adımında seçenekleri bir araçtan getirebilirsiniz; örneğin boş randevu saatleri kart olarak listelenir.
• “Araç Çağrısı” adımı aracı akışın belirli bir noktasında, yapay zekâ olmadan çağırır ve cevabı bir değişkene yazar.

Ayrıntılar için yapay zekâ asistanı adımı, Seçim adımı ve Araç Çağrısı adımı yazılarına bakın.

Listeyi yönetme

Araçları ada ya da açıklamaya göre arayabilir, yönteme ve kimlik doğrulama türüne göre süzebilirsiniz. Hata veren araçlar “Hata veriyor” rozetiyle işaretlenir. Bir aracı sildiğinizde asistan onu artık çağırmaz.