Инструменты

Справочник APA_Инструменты определяет функции, которые агенты могут вызывать для получения данных или выполнения действий.

Назначение

Инструмент — это функция, которую агент может вызвать:

  • Запрос данных из 1С

  • Вызов внешнего API

  • Запуск робота OneRPA

  • Взаимодействие через MCP

Характеристики справочника

Параметр
Значение

Имя

APA_Инструменты

Иерархический

Да

Владельцы

Нет

Реквизиты

Основные реквизиты

Реквизит
Тип
Описание

Код

Строка(9)

Уникальный код

Наименование

Строка(150)

Название инструмента

Описание

Строка(0)

Описание для LLM

ЗапросКод

Строка(0)

Код на языке 1С

MCP

Булево

Инструмент через MCP

OneRPA

Булево

Инструмент OneRPA

Формат

Справочник.APA_Форматы

Формат ответа

ВариантОтчета

Справочник.ВариантыОтчетов

Вариант отчёта

КодЗаданияOneRPA

Строка

Код задания OneRPA

Табличные части

Параметры

Колонка
Тип
Описание

Имя

Строка

Имя параметра (на русском)

ИмяEn

Строка

Имя параметра (на английском)

Описание

Строка

Описание параметра для LLM

Тип

Строка

Тип: string, number, integer, boolean

Доступность

Колонка
Тип
Описание

Пользователь

Справочник.APA_Пользователи

Кто может использовать

Типы инструментов

HTTP инструмент (код 1С)

Выполняет код на языке 1С и возвращает результат.

MCP инструмент

Вызывает внешний MCP сервер.

OneRPA инструмент

Запускает робота OneRPA.

Создание инструмента

Шаг 1: Базовые настройки

  1. Откройте справочник "Инструменты"

  2. Нажмите "Создать"

  3. Введите Наименование

  4. Выберите тип (обычный/MCP/OneRPA)

Шаг 2: Описание

Напишите понятное Описание для LLM:

Хорошее описание:

Плохое описание:

Шаг 3: Параметры

Добавьте параметры на вкладке "Параметры":

Имя
ИмяEn
Тип
Описание

Счёт

account

string

Номер расчётного счёта

Дата

date

string

Дата для получения остатка

Шаг 4: Код (для HTTP инструментов)

Напишите код на языке 1С:

Шаг 5: Сохранение

  1. Нажмите "Записать"

  2. Добавьте инструмент к агенту

  3. Выполните синхронизацию с Proxy

Типы параметров

Тип
Описание
Пример значения

string

Строка

"Иванов И.И."

number

Число (дробное)

123.45

integer

Целое число

42

boolean

Логическое

true/false

Формат ответа

Для структурированного ответа используйте справочник "Форматы":

Примеры инструментов

Получение данных

Создание документа

Доступность инструментов

Ограничение по пользователям

На вкладке "Доступность" укажите, кто может использовать инструмент:

  • Если список пуст — доступен всем

  • Если есть пользователи — только им

Контекстная доступность

Агент видит только те инструменты, которые:

  1. Добавлены в агента

  2. Доступны текущему пользователю

Устранение проблем

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

  1. Проверьте, добавлен ли инструмент в агента

  2. Проверьте описание — LLM должен понимать, когда использовать

  3. Укажите в промпте агента про инструмент

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

  1. Проверьте синтаксис кода 1С

  2. Проверьте наличие объектов в базе

  3. Смотрите регистр APA_ЛогИнструментов

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

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

  2. Проверьте типы параметров

  3. Проверьте описания параметров

Далее

Моделиchevron-right

Last updated