Ошибки инструментов

Диагностика и устранение проблем с инструментами.

Типичные ошибки

Инструмент не вызывается

Симптом: Агент отвечает, но не использует инструмент

Причины и решения:

Причина	Решение
Не добавлен в агента	Добавьте на вкладке "Инструменты"
Не синхронизировано	Выполните "Обмен с Proxy"
Плохое описание	Улучшите описание инструмента
LLM не понимает	Укажите в промпте когда использовать

Ошибка выполнения кода

Симптом: Инструмент вызывается, но возвращает ошибку

Диагностика:

1. Проверьте регистр APA_ЛогИнструментов

2. Найдите запись с ошибкой

3. Изучите текст ошибки

Типичные ошибки кода:

Ошибка: "Переменная не определена"
→ Проверьте имена переменных

Ошибка: "Объект не найден"
→ Проверьте существование справочника/документа

Ошибка: "Недостаточно прав"
→ Проверьте права пользователя

Таймаут инструмента

Причина: Инструмент выполняется слишком долго

Решения:

1. Оптимизируйте код (индексы, ограничения)

2. Увеличьте таймаут в настройках

3. Разбейте на несколько инструментов

Неверные параметры

Симптом: Инструмент получает неверные значения

Решения:

1. Проверьте имена параметров (ИмяEn)

2. Улучшите описания параметров

3. Добавьте примеры в описание

Отладка

Проверка кода

// Выполните код инструмента вручную
Параметры = Новый Структура("employee", "Иванов");

// Код инструмента
ФИО = Параметры.employee;
// ...

Сообщить(Результат);

Логирование в инструменте

// Добавьте логирование
ЗаписьЖурнала.Записать("APA_Debug", 
    "Параметры: " + СериализоватьJSON(Параметры));

// Основной код
...

ЗаписьЖурнала.Записать("APA_Debug", 
    "Результат: " + СериализоватьJSON(Результат));

Тестовый вызов

Создайте агента только с одним инструментом и попросите его явно использовать:

Используй инструмент "Получить остаток" для сотрудника Иванов