Skip to main content
POST
Arama içi araç oluştur
Bu endpoint, yapay zeka asistanlarınızın aramalar sırasında harici API’lerle etkileşim kurması için kullanılabilecek yeni bir arama içi araç oluşturmanızı sağlar.

Gövde Parametreleri

string
gerekli
Araç adı - yalnızca küçük harfler ve alt çizgi içermeli ve bir harfle başlamalıdır (ör. get_weather, book_appointment)
string
gerekli
Yapay zekanın bu aracı ne zaman ve nasıl kullanması gerektiğinin ayrıntılı açıklaması (maksimum 255 karakter)
string
gerekli
Çağrılacak API endpoint’inin geçerli URL’si
string
gerekli
HTTP yöntemi: GET, POST, PUT, PATCH veya DELETE
integer
Saniye cinsinden istek zaman aşımı (1-30, varsayılan: 10)
array
İstekle birlikte gönderilecek HTTP başlıkları
array
Yapay zekanın konuşmadan çıkaracağı ve endpoint’e göndereceği parametreler

Yanıt alanları

string
Başarı mesajı
object
Oluşturulan araç nesnesi

Araçları Asistanlara Ekleme

Bir araç oluşturduktan sonra, aramalar sırasında kullanmak için onu bir asistana eklemeniz gerekir. Araçlar Asistan API’si aracılığıyla yönetilir:
  • Asistan Oluştur - Bir asistan oluştururken araçları eklemek için tool_ids parametresini kullanın
  • Asistan Güncelle - Mevcut bir asistanda araçları eklemek, kaldırmak veya değiştirmek için tool_ids parametresini kullanın