> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ukrgsm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Інструменти

> Розширюйте можливості голосового агента, надаючи йому інструменти для виконання дій під час живих розмов.

Інструменти дозволяють ШІ-агенту виконувати дії під час розмови — переводити дзвінки, завершувати дзвінки, викликати зовнішні API або звертатись до віддалених MCP-серверів — залежно від контексту розмови та ваших інструкцій у промпті.

Коли інструмент прикріплено до вузла сценарію, LLM сама вирішує, **коли** його викликати і **з якими параметрами**, спираючись на висловлений намір абонента та ваші інструкції на рівні вузла.

## Типи інструментів

Платформа надає дві категорії інструментів:

### Вбудовані інструменти

Готові до використання інструменти для типових телефонних операцій:

* [**Переведення дзвінка**](/voice-agent/tools/call-transfer) — перевести активний дзвінок на телефонний номер або SIP-ендпоінт
* [**Завершення дзвінка**](/voice-agent/tools/end-call) — завершити дзвінок, коли розмову закінчено

### Власні інструменти

Інструменти, які ви визначаєте самі для інтеграції з будь-якою зовнішньою системою:

* [**HTTP API**](/voice-agent/tools/http-api) — викликати будь-який REST API ендпоінт під час розмови (наприклад, оновлення CRM, пошук даних, запуск автоматизацій)
* [**MCP-інструмент**](/voice-agent/tools/mcp-tool) — підключити зовнішній MCP-сервер і надати LLM доступ до його віддалених інструментів під час розмови

## Як працюють інструменти

1. Ви **визначаєте** інструмент з назвою, описом і параметрами.
2. Ви **прикріплюєте** інструмент до одного або кількох вузлів сценарію.
3. Під час дзвінка LLM читає промпт вузла, опис інструмента й намір абонента, щоб вирішити, чи викликати інструмент.
4. Інструмент виконується і повертає результат, який агент використовує, щоб продовжити розмову.

## Найкращі практики

* **Прикріплюйте до кожного вузла лише релевантні інструменти** — менше інструментів означає надійніші виклики.
* **Пишіть чіткі описи інструментів** — LLM використовує їх, щоб вирішити, коли викликати інструмент.
* **Спрямовуйте LLM у промпті вузла** — явно описуйте, коли слід використовувати інструмент.
* **Тестуйте поведінку інструментів** — перевіряйте, чи агент викликає інструменти в потрібні моменти, за допомогою веб- чи телефонних дзвінків.
