github-ops
55 lines
2.7 KiB
Markdown
55 lines
2.7 KiB
Markdown
# Веб-интерфейс
|
|
|
|
Веб-интерфейс нужен для настройки инструментов, агентов и доступа к MCP.
|
|
|
|
## Операции
|
|
|
|
Операция описывает один REST endpoint как MCP-инструмент.
|
|
|
|
В операции задаются:
|
|
|
|
- имя инструмента;
|
|
- описание для AI-агента;
|
|
- входная схема;
|
|
- REST endpoint;
|
|
- правила преобразования входных параметров в REST-запрос;
|
|
- правила преобразования REST-ответа в результат инструмента;
|
|
- тестовый пример;
|
|
- статус публикации.
|
|
|
|
Черновик можно редактировать и тестировать. MCP-клиенты видят только опубликованные операции, которые привязаны к опубликованному агенту.
|
|
|
|
## Агенты
|
|
|
|
Агент - это отдельный MCP endpoint с выбранным набором инструментов.
|
|
|
|
Рекомендуемый подход:
|
|
|
|
- группировать инструменты под конкретную задачу;
|
|
- не давать одному агенту слишком много инструментов;
|
|
- делать названия и описания инструментов однозначными;
|
|
- публиковать агента только после проверки операций.
|
|
|
|
## API ключи
|
|
|
|
API-ключ выдается на конкретного агента. Ключ позволяет MCP-клиенту:
|
|
|
|
- открыть MCP-сессию;
|
|
- получить список инструментов агента;
|
|
- вызвать опубликованный инструмент.
|
|
|
|
Полное значение ключа показывается только при создании.
|
|
|
|
## Секреты
|
|
|
|
Секреты используются для авторизации на конечных REST API.
|
|
|
|
После сохранения значение шифруется и больше не отображается. Секрет можно ротировать или удалить, если он не используется профилем авторизации.
|
|
|
|
## Логи и использование
|
|
|
|
Раздел **Логи** показывает вызовы операций, ошибки маппинга, ошибки REST API и успешные ответы.
|
|
|
|
Раздел **Использование** показывает количество вызовов, ошибки и задержки по операциям.
|
|
|