Skip to main content
В Yahont CE 0.2 действия OpenAPI переехали с отдельной страницы администратора в Панель администратора → Плагины. См. Что переехало.
Плагин OpenAPI подключает Yahont к REST API. Вы передаёте Yahont схему OpenAPI, и Yahont превращает каждую операцию схемы в инструмент. Агенты читают описания операций и параметры, чтобы решить, когда и как вызывать API. Плагины OpenAPI работают в обычном чате и в своих агентах. В Craft они недоступны. Для Craft используйте MCP-сервер или собственное приложение Craft. Пользователи с правом Управление действиями могут добавлять и менять плагины OpenAPI. Только полные администраторы могут менять Включить в обычном чате. Используйте плагин OpenAPI для внутренних сервисов, например системы заявок или API склада, когда MCP-сервера нет.

Добавление плагина OpenAPI

1

Вставьте схему

Откройте Панель администратора → Плагины, нажмите Добавить, затем выберите OpenAPI. Вставьте схему в поле Определение схемы OpenAPI. Yahont прочитает схему и покажет её операции под полем.Форма добавления плагина OpenAPI со схемой и операциями, которые нашёл YahontВ схеме должны быть:
  • Запись servers с базовым адресом API.
  • operationId у каждой операции. Yahont использует его как название инструмента.
  • summary или description у каждой операции, чтобы агент знал, когда её использовать.
API-сервер Yahont должен иметь доступ к адресу сервера.
2

Добавьте описания

3

Задайте доступность в обычном чате

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

Настройте аутентификацию

Выберите способ аутентификации. См. Аутентификация. Нажмите Добавить плагин.

Аутентификация

Свой заголовок авторизации

Настройки «Свой заголовок авторизации» с полями имени и значения заголовка Введите имя и значение заголовка. Можно отправлять несколько заголовков.

OAuth

Настройки OAuth: URL авторизации, URL токена, client ID, client secret, scope и PKCE
1

Создайте OAuth-клиент у провайдера

Укажите для клиента redirect URI, который показывает Yahont:
2

Введите данные клиента

Введите URL авторизации, URL токена, OAuth Client ID и OAuth Client Secret. При необходимости введите Scope списком через запятую.
3

Настройте PKCE

Включите PKCE, если его требует провайдер. Yahont использует метод S256. Нажмите Проверить подключение, чтобы убедиться, что Yahont может пройти процесс OAuth.
Каждый пользователь подключает свой аккаунт на странице «Плагины», прежде чем агент сможет вызывать API от его имени.

Подстановки в запросах

Используйте эти подстановки в любом месте схемы, например в адресе сервера, пути или значении параметра по умолчанию. Yahont заменяет их значениями текущего запроса в момент вызова.

Управление плагином

Вкладка «Инструменты» с операциями из схемы OpenAPI Вкладка Инструменты доступна только для чтения. Чтобы добавить, удалить или изменить операцию, измените схему на вкладке Настройка. Выключение Включить в обычном чате не убирает плагин из своих агентов. Его учётные данные и настройки не меняются. Чтобы убрать плагин из всех агентов, удалите его на странице «Плагины».
В Terraform onyx_custom_tool.enabled задаёт Включить в обычном чате. Он не меняет подключения к своим агентам.

Использование плагина в своих агентах

Откройте редактор агента и выберите плагин в разделе Действия. См. Агенты.

Пример

Используйте эту схему, чтобы добавить плагин, который создаёт агентов в Yahont и получает их. Замените адрес сервера адресом API вашего Yahont.
OpenAPI