Konuşma Aracı
AI'nın konuşmalar sırasında kullanabileceği bir araç oluşturun. AI, bağlama göre ne zaman çağıracağına karar verir.
Ne Zaman Kullanılır
AI'nizin yapabileceklerini genişletmek için bu tetikleyiciyi kullanın:
- Kataloğunuzda ürünleri arayın
- Sisteminizde sipariş durumunu kontrol edin
- CRM'de müşteri verilerini araştırın
- JIRA'da destek biletleri oluşturun
- Randevu alın
- Herhangi bir özel yetenek
Yapılandırma
Temel Ayarlar
| Alan | Açıklama |
|---|---|
| Araç Adı | İnsan tarafından okunabilir ad (Node Kütüphanesinde gösterilir) |
| Açıklama | AI'nın bu aracı ne zaman/nasıl kullanması gerektiğini açıklar |
Kullanıcı Hedefleme
Bu aracı kimin kullanabileceğini seçin:
| Seçenek | Açıklama |
|---|---|
| Tüm Kullanıcılar | Anonim + bağlı kullanıcılar |
| Sadece Bağlı Kullanıcılar | Sadece giriş yapmış kullanıcılar |
| Rol Tabanlı Erişim | Belirli kullanıcı rolleri |
Araç Değişkenleri
AI'nın kullanıcıdan toplaması gereken parametreleri tanımlayın:
| Alan | Açıklama |
|---|---|
| Değişken Adı | Dahili ad (örneğin, query, orderId) |
| Açıklama | AI'nın ne sorması gerektiğini anlamasına yardımcı olur |
Değişkenler, akışınızda {{variableName}} olarak kullanılabilir hale gelir.
Nasıl Çalışır
- Bir aracı tanımlarsınız: ad, açıklama ve değişkenler ile
- AI öğrenir: ne zaman kullanacağını açıklamanızdan
- Kullanıcı bir şey sorar: (örneğin, "Bana bir dizüstü bilgisayar bul")
- AI toplar: gerekli değişkenleri konuşarak
- Akış çalışır: toplanan verilerle
- Sonuç döner: AI'ya nihai yanıt için
Araçlarınızı Adlandırma: Neden Önemlidir
AI asistanınız birden fazla araca eriştiğinde, hangi aracı çağıracağına yalnızca üç şey üzerinden karar verir: araç adı, araç açıklaması ve değişken açıklamaları. Akışın içini göremez — metni okur ve karar verir.
Eğer bu üç alan belirsiz veya araçlar arasında çok benzerse, AI yanlış aracı seçecektir. LLM işlev çağrıları üzerine yapılan çalışmalar, açıklama netliğini artırmanın, temel modeli değiştirmeden doğru araç seçimini %15–20 oranında artırabileceğini göstermektedir.
Bu, farklı bilgi tabanlarını arayan birkaç aracınız olduğunda özellikle kritik öneme sahiptir — AI'nın bakış açısından, hepsi "bilgi arıyor." Ad ve açıklama, onları ayırt etmenin tek yoludur.
Araç Adı
Adın her aracı ayırt edecek şekilde domain_action_target kalıbını kullanın:
| ❌ Belirsiz | ✅ Açık |
|---|---|
Arama | rgpd_legal_analysis |
search_docs | ecommerce_product_search |
Araç 2 | support_ticket_lookup |
AI, açıklamayı okumadan önce adı ilk filtre olarak kullanır. Açık bir ad, hemen kısaltma yapmasına olanak tanır; genel bir ad, tahmin yapmasını zorlar.
Araç Açıklaması
Açıklama, en güçlü kaldıraçınızdır. Bu formülü kullanın:
[Ne yapar — 1 cümle]
Kullanım amacı: [Kullanıcıların gerçekten söyleyeceği 3–5 somut kullanım durumu]
❌ Kötü:
Bilgi için bilgi tabanını arayın.
✅ İyi:
CNIL yaptırımlarını ve CJUE içtihadını arar.
Kullanım amacı: sektör veya ihlal türüne göre ceza kararlarını bulmak,
ceza miktarlarını araştırmak, hukuki içtihatları alıntılamak,
RGPD uyumsuzluğunun finansal riskini değerlendirmek.
" Kullanım amacı" içindeki kelimeler anlamsal tetikleyiciler olarak işlev görür. Bir kullanıcının mesajında "ceza", "yaptırım" veya "risk" kelimeleri geçtiğinde, AI bunu hemen bu araca eşleştirir.
Değişken Açıklamaları
"Arama sorgusu" olarak tanımlanan bir değişken, AI'ya hiçbir şey söylemez. Kullanıcının ham sorusunu her seferinde yapıştırır. Daha iyi bir açıklama, AI'nın doğru anahtar kelimeleri çıkarmasına yardımcı olur.
| ❌ Belirsiz | ✅ Açık |
|---|---|
Arama sorgusu | Arama sorgusu: ihlal türü, şirket adı, sektör, ceza miktarı veya hukuki kavram |
Kullanıcı girişi | Talep edilen belge türü: şablon, model, form, madde veya sözleşme |
Bu, AI'nın kullanıcının tüm mesajını kopyalamak yerine yeniden formüle etmesini sağlar — daha hedefli aramalar ve daha iyi sonuçlar elde edilir.
Araç Çatışmalarını Önleme
İki araç aynı soruyu yanıtlayabiliyorsa, AI tereddüt eder — ve bazen rastgele seçim yapar. Her aracın özel bir alanı kapsaması gerekir.
Kural: Eğer bir kullanıcı sorusunun her iki araca da gidebileceğini düşünüyorsanız, açıklamalarınızın daha fazla netliğe ihtiyacı var.
Örnek — 5 uyum aracı ile net sınırlar:
| Araç | Kapsar | Kapsamaz |
|---|---|---|
compliance_legal_analysis | Hukuk maddeleri, yasal yükümlülükler, haklar | Pratik tavsiye yok, gerçek dünya vakaları yok |
compliance_methodology | Adım adım rehberler, denetim prosedürleri, çerçeveler | Hukuki metin yok, şablon yok |
compliance_document_templates | Kullanıma hazır modeller, formlar, sözleşme maddeleri | Metodoloji yok, hukuki analiz yok |
compliance_business_processes | Operasyonel iş akışları, onay döngüleri | Hukuki metin yok, yalnızca iç süreçler |
compliance_operational_solutions | Somut çözümler, teknik öneriler | Teori yok, yalnızca uygulanabilir çözümler |
Her açıklamanın aracın kapsadığı konular hakkında ne kadar spesifik olursa, belirsizlik o kadar azalır. Açık dışlamalar yazmanıza gerek yok — netlik işinizi görür.
Hızlı Kontrol Listesi
Konuşma Aracı tetikleyicisi ile bir akışı yayınlamadan önce, doğrulayın:
- Ad
domain_action_targetkalıbına uygun — açıklamayı okumadan ayırt edilebilir - Açıklama 1 cümlede aracın ne yaptığını belirtiyor
- Açıklama "Kullanım amacı:" ile 3–5 somut kullanım durumu içeriyor
- Değişken açıklamaları beklenen bilgi türlerini listeliyor, sadece "sorgu" değil
- Başka bir aracın alanıyla örtüşme yok
- Test edildi: Doğru yönlendirmeyi onaylamak için Test panelinde 2–3 belirsiz soru ile
Örnek: Ürün Arama
Araç Yapılandırması:
- Ad:
ecommerce_product_search - Açıklama: Ürün kataloğunu ad, kategori veya özellik ile arar. Kullanım amacı: belirli bir ürünü bulmak, bir kategorideki ürünleri karşılaştırmak, bir ürünün mevcut olup olmadığını kontrol etmek, ürün özelliklerini veya fiyatını araştırmak.
- Değişken:
query— "Aranacak ürün adı, kategori, özellik veya fiyat aralığı"
Akış:
- Tetikleyici: Konuşma Aracı
- Eylem: Bilgi Tabanını Ara (
{{query}}) - Eylem: Gözlem Ayarla (sonuçları döndür)
Kullanıcı konuşması:
Kullanıcı: "Kablosuz kulaklığınız var mı?"
AI: ecommerce_product_search aracını query="kablosuz kulaklık" ile çağırır
AI: "Evet! 3 kablosuz kulaklık buldum. Sony WH-1000XM5, 349 € ile en çok satanımız..."
Örnek: JIRA Bileti
Araç Yapılandırması:
- Ad:
support_create_jira_ticket - Açıklama: Konuşmadan bir JIRA destek bileti oluşturur. Kullanım amacı: kullanıcı bir hata bildirdiğinde, bir özellik talep ettiğinde veya bir sorunu teknik ekibe iletmesi gerektiğinde.
- Değişkenler:
title— "Sorunun kısa özeti (1 cümle)",description— "Yeniden üretim adımlarını, beklenen davranışı ve gerçek davranışı içeren ayrıntılı açıklama"
Akış:
- Tetikleyici: Konuşma Aracı
- Eylem: AI Talebi (başlık/açıklama oluştur)
- Paralel: Açıklama + başlık oluştur
- Eylem: JIRA Sorun Oluştur
