Araç Kaydı

Ajanlarınızın gerçek dünya işlemleri yapmasını sağlayan araçları tanımlayın, kaydedin ve yönetin.

Genel Bakış

Araç Kaydı, AI ajanlarına dış dünyayla etkileşim kurma yeteneği kazandırır. Bir araç, ajanın çağırabileceği bir fonksiyondur: API çağrısı yapma, veritabanı sorgulama, dosya okuma veya başka bir servisi tetikleme gibi işlemler araçlar aracılığıyla gerçekleştirilir.

Araçlar Olmadan Ajan = Salt Metin Üretici

Araçlar eklenmeden bir ajan yalnızca metin oluşturabilir. Araçlarla donatılmış bir ajan ise sisteminizde gerçek işlemler yapabilir: sipariş oluşturabilir, e-posta gönderebilir, veri sorgulayabilir.

Araç Tanımı

Her araç JSON Schema formatında tanımlanır. Araç kaydı sırasında aşağıdaki alanlar doldurulur:

Alan	Açıklama	Örnek
Ad	Ajanın çağıracağı benzersiz fonksiyon adı	`get_customer_orders`
Açıklama	Ajanın bu aracın ne işe yaradığını anlayacağı metin	"Müşteri ID'sine göre siparişleri getirir"
Parametreler	JSON Schema ile tanımlanan giriş parametreleri	`{ "customer_id": "string" }`
Uç Nokta	Araç çağrıldığında tetiklenecek URL veya fonksiyon	`https://api.example.com/orders`
Kimlik Doğrulama	API anahtarı, Bearer token veya OAuth	Header: `Authorization`

Ajanla Araç Bağlama

Araç Kaydı'nı aç → + Yeni Araç → Tanımı doldur → Test Et → Ajan Mimar'da seç

Araç Mimar'da bir ajana birden fazla araç atanabilir. Ajan çalışırken hangi aracı ne zaman çağıracağına bağımsız olarak karar verir.

Dahili Araçlar

TotalApp modüllerine doğrudan erişim: CRM verileri, HR kayıtları, proje görevleri. Kimlik doğrulama otomatik yapılandırılır.

Özel API Araçları

REST veya GraphQL uç noktalarınızı tanımlayın. Ajan bu uç noktaları çağırır ve yanıtı işler.

Kod Araçları

Sunucu tarafında çalışan JavaScript fonksiyonları. Veri dönüşümü, hesaplama veya mantık işlemleri için kullanılır.

Araç Çağrılarını İzleme

Gözlemlenebilirlik ekranında her araç çağrısı ayrıntılı olarak loglanır:

Hangi ajan, hangi aracı çağırdı
Gönderilen parametreler
API yanıt süresi ve durum kodu
Araç çıktısının ajana nasıl aktarıldığı
Başarısız araç çağrısı durumunda hata mesajı

Araç Testi

Kaydedilen her araç için "Test Et" düğmesiyle örnek parametreler göndererek gerçek yanıtı görebilirsiniz. Ajanla entegre etmeden önce aracın doğru çalıştığını doğrulayın.

Sık Sorulan Sorular

Bir araç kaç ajanda kullanılabilir?

Sınırsız. Aynı araç birden fazla ajana atanabilir. Araç tanımı değiştirildiğinde tüm bağlı ajanlar yeni tanımı kullanır.

Araç kimlik bilgileri güvenli mi?

Evet. API anahtarları ve token'lar sunucu tarafında şifrelenmiş olarak saklanır. Kullanıcı arayüzünde düz metin olarak gösterilmez, yalnızca araç çalışırken kullanılır.

Ajan yanlış araç çağırırsa ne olur?

Araç hata döndürürse veya beklenen formatta yanıt vermezse ajan bunu gözlemleyebilir ve farklı bir yaklaşım deneyebilir. Hata durumları Gözlemlenebilirlik ekranında loglanır.

Webhookları araç olarak tanımlayabilir miyim?

Evet. Gelen webhook olaylarını tetikleyici olarak değil, giden çağrı olarak kullanmak istiyorsanız hedef URL'yi araç olarak kaydedin. Ajan bu URL'ye POST isteği gönderir.