Refresh community demo and docs

2026-06-21 11:20:12 +00:00
parent cab9282c50
commit c77065756d
24 changed files with 688 additions and 807 deletions
@@ -0,0 +1,54 @@
+# Веб-интерфейс
+
+Веб-интерфейс нужен для настройки инструментов, агентов и доступа к MCP.
+
+## Операции
+
+Операция описывает один REST endpoint как MCP-инструмент.
+
+В операции задаются:
+
+- имя инструмента;
+- описание для AI-агента;
+- входная схема;
+- REST endpoint;
+- правила преобразования входных параметров в REST-запрос;
+- правила преобразования REST-ответа в результат инструмента;
+- тестовый пример;
+- статус публикации.
+
+Черновик можно редактировать и тестировать. MCP-клиенты видят только опубликованные операции, которые привязаны к опубликованному агенту.
+
+## Агенты
+
+Агент - это отдельный MCP endpoint с выбранным набором инструментов.
+
+Рекомендуемый подход:
+
+- группировать инструменты под конкретную задачу;
+- не давать одному агенту слишком много инструментов;
+- делать названия и описания инструментов однозначными;
+- публиковать агента только после проверки операций.
+
+## API ключи
+
+API-ключ выдается на конкретного агента. Ключ позволяет MCP-клиенту:
+
+- открыть MCP-сессию;
+- получить список инструментов агента;
+- вызвать опубликованный инструмент.
+
+Полное значение ключа показывается только при создании.
+
+## Секреты
+
+Секреты используются для авторизации на конечных REST API.
+
+После сохранения значение шифруется и больше не отображается. Секрет можно ротировать или удалить, если он не используется профилем авторизации.
+
+## Логи и использование
+
+Раздел **Логи** показывает вызовы операций, ошибки маппинга, ошибки REST API и успешные ответы.
+
+Раздел **Использование** показывает количество вызовов, ошибки и задержки по операциям.
+