Sohbet Aracı
AI'nın sohbetler sırasında kullanabileceği bir araç oluşturun. AI, bağlama göre ne zaman çağıracağına karar verir.
AI ajanınızı HAREKETE GEÇİRİN · ilk Aracınızı oluşturun
Ne Zaman Kullanılır
AI'nizin yapabileceği şeyleri genişletmek için bu tetikleyiciyi kullanın:
- Kataloğunuzda ürün 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 sohbet yoluyla
- 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 sadece üç ş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çiminde %15–20 puanlık bir artış sağlayabileceğ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 arar." Ad ve açıklama, onları ayırt etmenin tek yoludur.
Araç Adı
Adın her aracı ayırt edebilmesi için domain_action_target desenini 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 yaptığı — 1 cümle]
Kullanım için: [3–5 somut kullanım durumu, kullanıcılarınızın gerçekten söyleyeceği kelimelerle]
❌ Kötü:
Bilgi için bilgi tabanını arayın.
✅ İyi:
CNIL yaptırımları ve CJUE içtihadını arar.
Kullanım için: sektör veya ihlal türüne göre ceza kararlarını bulmak,
ceza miktarlarını araştırmak, hukuki emsal göstermek,
RGPD uyumsuzluğunun finansal riskini değerlendirmek.
" Kullanım için" içindeki kelimeler anlamsal tetikleyiciler olarak işlev görür. 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 ifade etmez. Her seferinde kullanıcının ham sorusunu yapıştırır. Daha iyi bir açıklama, AI'nın doğru anahtar kelimeleri çıkarmasına rehberlik eder.
| ❌ 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 her iki araca da gidebilecek bir kullanıcı sorusu düşünebiliyorsanız, açıklamalarınız daha fazla netlik gerektirir.
Örnek — 5 uyum aracı ile net sınırlar:
| Araç | Kapsar | Kapsamaz |
|---|---|---|
compliance_legal_analysis | Hukuk maddeleri, hukuki yükümlülükler, haklar | Pratik tavsiye yok, gerçek dünya vakaları yok |
compliance_methodology | Adım adım kılavuzlar, 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 devreleri | Hukuki metin yok, sadece iç süreçler |
compliance_operational_solutions | Somut çözümler, teknik öneriler | Teori yok, sadece uygulanabilir çözümler |
Her açıklamanın aracın kapsadığı konularda 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
Sohbet Aracı tetikleyicisi ile bir akışı yayınlamadan önce, kontrol edin:
- Ad
domain_action_targetformatına uyuyor — açıklamayı okumadan ayırt edilebilir - Açıklama 1 cümlede aracın ne yaptığını belirtiyor
- Açıklama "Kullanım için:" 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ı ile çakışma yok
- Test edildi: Test panelinde 2–3 belirsiz soruyla doğru yönlendirmeyi doğrulamak için
Ö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 için: belirli bir ürünü bulmak, bir kategorideki ürünleri karşılaştırmak, bir ürünün var 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: Sohbet Aracı
- Eylem: Bilgi Tabanını Ara (
{{query}}) - Eylem: Gözlem Ayarla (sonuçları döndür)
Kullanıcı sohbeti:
Kullanıcı: "Kablosuz kulaklığınız var mı?"
AI:ecommerce_product_searcharacı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: Sohbetten bir JIRA destek bileti oluşturur. Kullanım için: 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 üretme adımları, beklenen davranış ve gerçek davranış dahil detaylı açıklama"
Akış:
- Tetikleyici: Sohbet Aracı
- Eylem: AI Talebi (başlık/açıklama oluştur)
- Paralel: Açıklama + başlık oluştur
- Eylem: JIRA Sorun Oluştur
