Skip to main content
POST
Създаване на инструмент за време на повикване
Този endpoint ви позволява да създадете нов инструмент за време на повикване, който може да бъде използван от вашите AI асистенти за взаимодействие с външни API по време на повиквания.

Параметри в тялото на заявката

string
required
Име на инструмента - трябва да съдържа само малки букви и долни черти, и да започва с буква (например, get_weather, book_appointment)
string
required
Подробно обяснение кога и как AI трябва да използва този инструмент (максимум 255 символа)
string
required
Валиден URL на API endpoint за извикване
string
required
HTTP метод: GET, POST, PUT, PATCH, или DELETE
integer
Timeout на заявката в секунди (1-30, по подразбиране: 10)
array
HTTP headers за изпращане с заявката
array
Параметри, които AI ще извлече от разговора и ще изпрати до endpoint

Полета в отговора

string
Съобщение за успех
object
Обектът на създадения инструмент

Прикачване на инструменти към асистенти

След създаването на инструмент, трябва да го прикачите към асистент за да го използвате по време на повиквания. Инструментите се управляват чрез Assistant API:
  • Създаване на асистент - Използвайте параметъра tool_ids за да прикачите инструменти при създаване на асистент
  • Актуализиране на асистент - Използвайте параметъра tool_ids за да добавите, премахнете или заместите инструменти на съществуващ асистент