Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions content/documentation/admin/ai-agents/agent-sources.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ AI-агенты — функциональность на стадии Preview.
1. Создайте ресурс, сущности которого будут описывать агентов. Добавьте в ресурс параметр типа `String` для URL карточки агента, например `agent_card_url`.
1. Создайте сущности ресурса и заполните в них URL карточки. Идентификатор сущности станет идентификатором агента.
1. Перейдите в раздел «AI» → «AI-агенты» → «Источники агентов» и нажмите «Создать источник агентов». Кнопка доступна с разрешением `edit:ai-agents`.
1. На вкладке «Основная информация» включите «Включить источник», заполните «Название» и «Идентификатор».
1. На вкладке «Основная информация» включите «Включить», заполните «Название» и «Идентификатор».
1. На вкладке «Ресурсы каталога» нажмите «Добавить ресурс», выберите ресурс и в поле «Параметр с URL Agent Card» выберите параметр с URL карточки.
1. На вкладке «Подключение» укажите «API-ключ», общий для всех агентов источника.
1. Нажмите «Сохранить», затем в меню карточки источника выберите «Синхронизировать сейчас».
Expand All @@ -52,15 +52,15 @@ AI-агенты — функциональность на стадии Preview.

## Параметры источника

Форма источника состоит из вкладок «Основная информация», «Ресурсы каталога» и «Подключение».
Форма источника содержит вкладки «Основная информация», «Ресурсы каталога» и «Подключение». Коллекции задаются в настройках источника и применяются к его агентам.

### Основная информация

На вкладке «Основная информация» задаются поля:

| Поле | Обязательность | Описание |
| --- | --- | --- |
| «Включить источник» | — | Выключенный источник не синхронизируется и не выключает уже созданных им агентов |
| «Включить» | — | Выключенный источник не синхронизируется и не выключает уже созданных им агентов |
| «Название» | Да | Название источника |
| «Идентификатор» | Да | Уникальный идентификатор источника |
| «Описание» | Нет | Описание источника |
Expand Down Expand Up @@ -119,14 +119,14 @@ AI-агенты — функциональность на стадии Preview.
| --- | --- | --- |
| «API-ключ» | Да | Ключ, который портал передаёт каждому агенту источника в заголовках `X-A2A-Api-Key` и `Authorization: Bearer` |
| «Вызывать адрес из карточки агента» | — | Если выключено, портал вызывает базовый URL карточки. Выключите для источников внутри кластера, например kagent, которые публикуют адреса, доступные только изнутри кластера |
| «MCP-инструменты» | Нет | Инструменты портала, доступные каждому агенту источника. Пустой список — агенты не получают доступа к инструментам портала |
| «MCP-коллекции» | Нет | Коллекции каждого агента источника. В запуск попадают их инструменты, которыми может пользоваться запускающий пользователь; без коллекций агенты работают без MCP-инструментов |

API-ключ хранится в зашифрованном виде и после сохранения не отображается. При редактировании источника оставьте поле пустым, чтобы сохранить текущий ключ.

## Агенты из источника

У агента из источника портал при каждой синхронизации задаёт адрес карточки, API-ключ, «Вызывать адрес из карточки агента» и «MCP-инструменты» по настройкам источника.
В подключении такого агента вручную меняются только переключатель «Включить агента» и «Разрешить прокси моделей DDP».
У агента из источника портал при каждой синхронизации задаёт адрес карточки, API-ключ, «Вызывать адрес из карточки агента» и MCP-коллекции по настройкам источника.
Коллекции такого агента меняйте в источнике. В подключении агента можно менять включение и разрешение прокси моделей DDP; навыки назначаются самому агенту.

Если агенту нужен прокси моделей DDP, включите «Разрешить прокси моделей DDP» в подключении агента после первой синхронизации: источник этот переключатель не меняет.

Expand Down
27 changes: 14 additions & 13 deletions content/documentation/admin/ai-agents/external-agents.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,18 +17,18 @@ AI-агенты — функциональность на стадии Preview.

Чтобы подключить внешнего агента:

1. Перейдите в раздел «AI» → «AI-агенты» → «Каталог» и нажмите «Подключить». Кнопка доступна с разрешением `edit:ai-agents`.
1. Перейдите в раздел «AI» → «AI-агенты» → «Каталог» и нажмите «Подключить агента». Кнопка доступна с разрешением `edit:ai-agents`.
1. На вкладке «Основная информация» заполните «Название» и «Идентификатор».
1. На вкладке «Подключение» включите переключатель «Включить агента».
1. На вкладке «Подключение» включите переключатель «Включить».
1. Укажите «URL Agent Card» — адрес карточки агента, например `https://agents.example.com/.well-known/agent-card.json`.
1. Укажите «API-ключ», который ожидает агент.
1. Нажмите «Сохранить».

Агент появится в каталоге с отметкой «Внешний». Запускать его может только владелец подключения — пользователь, который его создал.
Агент появится в каталоге с отметкой «Внешний». Для запуска предоставьте пользователю `use:ai-agents` или `use:ai-agent` на это подключение. Владение даёт права при включённом `owner-is-admin`.

## Параметры подключения

Форма подключения состоит из вкладок «Основная информация» и «Подключение».
Форма подключения содержит вкладки «Основная информация», «Подключение» и «Инструменты и навыки».

### Основная информация

Expand All @@ -44,16 +44,17 @@ AI-агенты — функциональность на стадии Preview.

### Подключение

Поля вкладки «Подключение» отображаются, когда включён переключатель «Включить агента»:
Поля вкладки «Подключение» отображаются, когда включён переключатель «Включить»:

| Поле | Обязательность | Описание |
| --- | --- | --- |
| «Включить агента» | — | Выключенный агент не отображается в AI-ассистенте, виджетах и шагах процессов |
| «Включить» | — | Выключенный агент не отображается в AI-ассистенте, виджетах и шагах процессов |
| «URL Agent Card» | Да | Адрес карточки агента. Портал читает из карточки название, описание и адреса, по которым принимает вызовы агент |
| «Вызывать адрес из карточки агента» | — | Если включено, портал вызывает адрес, объявленный в карточке. Если выключено, портал вызывает базовый URL карточки — адрес из поля «URL Agent Card» без `/.well-known/agent-card.json` или `/.well-known/agent.json` |
| «Разрешить прокси моделей DDP» | — | Агент обращается к языковой модели через портал и использует AI-провайдера пользователя, который запустил задачу. Подробнее — в разделе [«Языковая модель агента»](overview/#языковая-модель-агента) |
| «API-ключ» | Да | Ключ, который портал передаёт агенту в заголовках `X-A2A-Api-Key` и `Authorization: Bearer` при каждом вызове и при чтении карточки |
| «MCP-инструменты» | Нет | Инструменты портала, которые может вызывать агент. Пустой список — агент не получает доступа к инструментам портала |

На вкладке «Инструменты и навыки» выберите «MCP-коллекции» и при необходимости [навыки](skills/). Агент получает инструменты этих коллекций, которыми может пользоваться запускающий пользователь. Без коллекций агент работает без MCP-инструментов. Доступ к инструментам задаётся [коллекциями и ролями](../../user/mcp-management/#связь-с-ai-ассистентом-и-mcp-сервером).

API-ключ хранится в базе данных в зашифрованном виде и после сохранения не отображается.
При редактировании подключения оставьте поле «API-ключ» пустым, чтобы сохранить текущий ключ.
Expand All @@ -76,9 +77,9 @@ API-ключ хранится в базе данных в зашифрованн

| Ключ | Когда передаётся | Значение |
| --- | --- | --- |
| `ddp.mcp.endpoint` | Список «MCP-инструменты» не пуст | Адрес MCP-эндпоинта портала, например `https://<DOMAIN>/api/v2/agent-mcp` |
| `ddp.mcp.runToken` | Список «MCP-инструменты» не пуст | Токен запуска |
| `ddp.mcp.toolAllowlist` | Список «MCP-инструменты» не пуст | Инструменты, разрешённые в этом запуске |
| `ddp.mcp.endpoint` | Есть разрешённые инструменты в коллекциях | Адрес MCP-эндпоинта портала, например `https://<DOMAIN>/api/v2/agent-mcp` |
| `ddp.mcp.runToken` | Есть разрешённые инструменты в коллекциях | Токен запуска |
| `ddp.mcp.toolAllowlist` | Есть разрешённые инструменты в коллекциях | Инструменты, разрешённые в этом запуске |
| `ddp.llm.baseUrl` | Включён переключатель «Разрешить прокси моделей DDP» | Адрес прокси моделей, например `https://<DOMAIN>/api/v2/agent-llm/v1` |
| `ddp.llm.apiKey` | Включён переключатель «Разрешить прокси моделей DDP» | Токен запуска |
| `ddp.llm.model` | Включён переключатель «Разрешить прокси моделей DDP» | Модель AI-провайдера пользователя |
Expand All @@ -96,7 +97,7 @@ API-ключ хранится в базе данных в зашифрованн
Пример вызова инструмента:

```shell
curl -s -X POST "https://<DOMAIN>/api/v2/agent-mcp/tools/call" -H "X-Agent-Run-Token: <RUN_TOKEN>" -H "Content-Type: application/json" -d '{"tool": "get_resources", "arguments": {}}'
curl -s -X POST "https://<DOMAIN>/api/v2/agent-mcp/tools/call" -H "X-Agent-Run-Token: <RUN_TOKEN>" -H "Content-Type: application/json" -d '{"tool": "ddp_get_resources", "arguments": {}}'
```

где:
Expand Down Expand Up @@ -142,7 +143,7 @@ curl -s -X POST "https://<DOMAIN>/api/v2/agent-mcp/tools/call" -H "X-Agent-Run-T

## Изменение и удаление

Изменять и удалять подключение могут его владелец, участники команды-владельца и супер-администратор.
Изменять и удалять подключение можно с глобальным `edit:ai-agents` или объектным `edit:ai-agent`. При включённом `owner-is-admin` эти права также получают владелец и участники команды-владельца; супер-администратор имеет доступ ко всем подключениям.
Чтобы изменить или удалить подключение, выберите «Редактировать» или «Удалить» в меню карточки агента в каталоге.

Если выключить агента вручную, он не включится автоматически, даже если им управляет источник агентов.
Expand All @@ -158,4 +159,4 @@ curl -s -X POST "https://<DOMAIN>/api/v2/agent-mcp/tools/call" -H "X-Agent-Run-T
| «Внешний агент отклонил учётные данные. Проверьте API-ключ его ссылки.» | Агент не принял API-ключ. Укажите в подключении ключ, который ожидает агент |
| «Внешний агент недоступен (ошибка сети или таймаут). Попробуйте позже.» | Агент не ответил вовремя или недоступен по сети |
| «Внешний агент не вернул ответ.» | Задача агента завершилась без итогового сообщения |
| «Недостаточно прав для запуска этого AI-агента» | Внешнего агента запускает только владелец подключения |
| «Недостаточно прав для запуска этого AI-агента» | Проверьте глобальное `use:ai-agents` или объектное `use:ai-agent` на подключение |
Loading
Loading