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

# Tool Logs

> Моніторинг виконання інструментів AI агента та подій каналів у реальному часі

## Огляд

Tool Logs забезпечують повну видимість того, що ваш AI агент робить під час розмов — кожен виклик інструмента, пошук по базі знань та зовнішня подія каналу записуються з даними вхід/вихід, часом виконання та статусом.

Відкрийте Tool Logs, натиснувши кнопку **Tool Logs** у верхньому правому куті модалки редактора агента.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/FgC1DOR7_ZtbW3Sz/images/tool-logs-light.png?fit=max&auto=format&n=FgC1DOR7_ZtbW3Sz&q=85&s=f83770722049e8784700235b4f87dd9e" alt="Модалка Tool Logs" width="2869" height="1546" data-path="images/tool-logs-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/FgC1DOR7_ZtbW3Sz/images/tool-logs-dark.png?fit=max&auto=format&n=FgC1DOR7_ZtbW3Sz&q=85&s=a030944ca3bf8075e18289489ecc59eb" alt="Модалка Tool Logs" width="2869" height="1555" data-path="images/tool-logs-dark.png" />
</Frame>

## Дві вкладки

Модалка має дві вкладки:

### Tool Logs

Записує кожне виконання інструмента під час AI розмов. Кожен запис показує:

| Поле               | Опис                                                                                            |
| ------------------ | ----------------------------------------------------------------------------------------------- |
| **Tool Name**      | Функція, яка була викликана (напр. `rag_search`, `get_products`, `get_company_info`)            |
| **Node Name**      | Який вузол workflow ініціював цей інструмент                                                    |
| **Node Type**      | Категорія вузла — Orchestrator, Product Agent, Media Agent, Company Agent, Formatter або Custom |
| **Status**         | `success`, `error` або `no_results`                                                             |
| **Execution Time** | Тривалість у мілісекундах                                                                       |
| **Date**           | Коли інструмент був виконаний                                                                   |

Натисніть на будь-який запис, щоб розгорнути його та побачити повний **Input** (параметри запиту у JSON) та **Output** (дані відповіді у JSON). Якщо статус `error`, повідомлення про помилку відображається зверху розгорнутої секції.

<Tip>
  Логи інструментів згруповані за **раундами**. Раунд представляє одну ітерацію виклику функцій LLM — AI може викликати кілька інструментів за один раунд перед генерацією відповіді. Розділювачі раундів допомагають зрозуміти послідовність викликів інструментів у межах одного повороту розмови.
</Tip>

### Channel Logs

Записує події від зовнішніх каналів зв'язку — вебхуки, телефонні дзвінки, повідомлення з месенджерів. Кожен запис показує:

| Поле             | Опис                                                              |
| ---------------- | ----------------------------------------------------------------- |
| **Channel Type** | Widget, Phone, Telegram, WhatsApp, Instagram тощо                 |
| **Direction**    | `inbound` (отримано) або `outbound` (надіслано)                   |
| **External ID**  | Ідентифікатор абонента або відправника від зовнішнього провайдера |
| **Status**       | `success` або `error`                                             |
| **Date**         | Коли подія відбулась                                              |

Натисніть, щоб розгорнути та переглянути повний **Request Payload** (сирі дані вебхуку) та **Response** (що було надіслано у відповідь).

## Що логується

Логи інструментів створюються автоматично, коли агент:

* **Шукає по базі знань** — `rag_search` із запитом та кількістю знайдених результатів
* **Викликає функціональний інструмент** — будь-який інструмент з набору агента (напр. `get_products`, `get_documents`, `get_photos`, `get_videos`, `get_company_info`)
* **Виконує інтеграційні інструменти** — Google Ads, Facebook Ads та інші підключені сервіси

Логи каналів створюються, коли:

* **Надходить вхідний вебхук** — телефонний дзвінок, повідомлення з месенджера або будь-яка зовнішня подія каналу
* **Надсилається вихідне повідомлення** — відповідь агента, доставлена через канал

## Очищення логів

Використовуйте кнопку **Clear Logs** (іконка кошика) зверху модалки, щоб видалити всі логи поточного агента. Ця дія незворотна.

<Note>
  Логи зберігаються у партиціонованій таблиці бази даних для продуктивності. Агенти з високим навантаженням можуть накопичувати тисячі записів — періодично використовуйте Clear Logs, щоб інтерфейс залишався швидким.
</Note>