Адаптеры

tip

Требуемая роль: ain_admin.

Адаптер – это контейнер с набором методов. ИИ-агент может использовать для работы только те методы, которые добавлены в выбранный адаптер.

Когда к адаптеру подключены активные серверы MCP, в связанном списке отображаются актуальные (доступные на сервере и активированные) инструменты MCP.

К ИИ-агенту можно подключить только один адаптер, список методов доступен в связанном списке Adapter Methods формы AI Agent.

Чтобы создать адаптер для ИИ-агента, выполните следующие шаги:

1. В навигаторе перейдите в Ainergy → AI Agents → AI Adapter.

2. Нажмите Создать и укажите название нового адаптера.

3. Нажмите Сохранить.

4. В связанном списке AI Adapter Has Method добавьте необходимые методы:

   1. Нажмите Создать в связанном списке, чтобы добавить необходимую запись из таблицы AI Methods (ain_ai_method). На форме новой записи в поле Adapter будет уже указано название адаптера.
   2. В поле Method выберите запись из таблицы AI Methods (ain_ai_method).
   3. В поле Default variables укажите параметры по умолчанию, которые будут применяться при вызове метода через данный адаптер. Например, {"content_db": "ID", "object_category": 10, "responsible_group": "ID", "content_item_class": "ID", "knowledge_base_category": "ID"}
   note

   Если адаптер подключен к серверу MCP, то его инструменты будут также отображаться в связанном списке AI Adapter Has Method формы AI Agent.

В результате, в связанном списке созданного адаптера появится список добавленных в него методов.

Поля формы Адаптер

Поле	Обязательно	Описание
Заголовок	Да	Укажите название адаптера.
Наименование	Да	Системное наименование, формируется автоматически при указании заголовка, но доступно для редактирования. После сохранения записи поле заблокировано.
Серверы MCP	Нет	Добавьте записи серверов MCP, инструменты которых будут доступны с этим адаптером.
Автоматически добавлять новые методы	Нет	Установите флажок, чтобы разрешить обновление списка инструментов MCP при изменении конфигурации добавленного Сервера MCP.

Связанные списки

• AI Adapter Has Method – список доступных методов и инструментов MCP. Вы можете управлять активностью методов при помощи встроенного редактирования на форме связанного списка или перейдя на форму каждого из них.

Список обновляется автоматически инструментами MCP, если на форме адаптера установлен флажок Автоматически добавлять новые методы.

Только активные методы и инструменты MCP могут быть добавлены в адаптер.

Методы

---

В таблице AI Method (ain_ai_method) хранятся все методы, доступные для ИИ-агентов. Каждый метод включает:

• JSON-схему для нейросети.
• JS-скрипт для выполнения на экземпляре.

Чтобы создать метод, выполните действия:

1. В навигаторе перейдите в Ainergy → AI Agents → AI Method.
2. Нажмите Создать и укажите название нового метода.
3. Нажмите Сохранить.

Поля формы AI Method

Поле	Обязательно	Описание
Name	Да	Укажите название метода.
Function	Нет	Укажите схему метода для нейросети в формате JSON.
Callback Script	Нет	Укажите логику, которую необходимо выполнить при вызове метода.

Пример значения Function

{
    "type": "function",
    "function": {
        "name": "add",
        "description": "Add two numbers and returns the result number",
        "parameters": {
            "type": "object",
            "properties": {
                "a": {
                    "type": "number",
                    "description": "The first number"
                },
                "b": {
                    "type": "number",
                    "description": "The second number"
                }
            }
        }
    }
}

Пример значения Callback script

((args) => {
    return Number(args.a) + Number(args.b);
})(args)