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
4 changes: 3 additions & 1 deletion content/documentation/admin/ai-agents/external-agents.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -97,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": "ddp_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": "get_resources", "arguments": {}}'
```

где:
Expand All @@ -107,6 +107,8 @@ curl -s -X POST "https://<DOMAIN>/api/v2/agent-mcp/tools/call" -H "X-Agent-Run-T

Инструмент, которого нет в `ddp.mcp.toolAllowlist`, возвращает ошибку `403`. Недействительный или отозванный токен — ошибку `401`.

Этот эндпоинт принимает названия из списка инструментов без префикса агента: `get_resources`, `query_catalog`, `curated_get_skill`. Префикс `ddp_` платформенный агент добавляет только при передаче инструментов модели. При реализации внешнего агента сохраняйте соответствие между названием для модели и названием, отправляемым порталу.

### Обращение к модели через портал

Если агенту разрешён прокси моделей DDP, он обращается к `<ddp.llm.baseUrl>/chat/completions` как к API OpenAI Chat Completions и передаёт `ddp.llm.apiKey` как API-ключ.
Expand Down
8 changes: 6 additions & 2 deletions content/documentation/admin/ai-agents/overview.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,13 +42,17 @@ AI-агент получает задачу на естественном язы

Без коллекций агент работает без MCP-инструментов. Это правило одинаково для платформенного агента, внешних агентов, чата, виджетов и процессов. Состав коллекции может включать инструменты портала, подключённых MCP-серверов и пользовательские HTTP-инструменты.

Например, чтобы агент читал каталог, включите `ddp_get_resources` и `ddp_get_resource_entities` в коллекцию, подключите её к агенту и предоставьте пользователю право использовать её. Для запуска процессов добавьте `get_processes`, `run_process` и `get_process_instance`.
Например, чтобы агент читал каталог, включите `get_resources` и `get_resource_entities` в коллекцию, подключите её к агенту и предоставьте пользователю право использовать её. Для запуска процессов добавьте `curated_get_processes`, `curated_run_process` и `curated_get_process_instance`.

Пошаговая настройка — [в руководстве по MCP-коллекциям](../../user/mcp-management/#mcp-коллекции).

Для поиска, подсчёта и группировки сущностей, анализа связей и диагностики процессов добавьте группу «Обозреватель каталога» в MCP-коллекцию агента и предоставьте пользователям право использовать коллекцию. Доступ к коллекции не заменяет права на ресурсы, сущности, процессы и действия. Состав инструментов и примеры вызовов — [в справочнике MCP](../../user/mcp-server/#инструменты-работы-с-каталогом).

В коллекциях используются названия `get_resources`, `curated_run_process` и `curated_get_skill`. В инструкциях платформенному агенту добавляйте префикс `ddp_`: `ddp_get_resources`, `ddp_curated_run_process`, `ddp_curated_get_skill`. Полная [схема названий инструментов](../../user/mcp-server/#названия-инструментов) учитывает и вызовы из внешнего MCP-клиента.

## Навыки агента

На той же вкладке назначьте [навыки](skills/) с конкретной версией или привязкой «Последняя». При запуске агент получает их названия и описания, полный текст читает через `get_skill` при необходимости. Этот инструмент должен быть доступен через коллекции агента и пользователя.
На той же вкладке назначьте [навыки](skills/) с конкретной версией или привязкой «Последняя». При запуске агент получает их названия и описания, полный текст читает через `curated_get_skill` при необходимости. Этот инструмент должен быть доступен через коллекции агента и пользователя.

Для инструкций и материалов в GitLab настройте [источник навыков](skill-sources/).

Expand Down
6 changes: 3 additions & 3 deletions content/documentation/admin/ai-agents/platform-agent.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ description: Подготовка платформенного агента ddp-

1. Выдайте доступ к агенту через глобальное `use:ai-agents` или объектное `use:ai-agent`. Для раздела «AI» добавьте `view:ai-page`.
1. Подготовьте [AI-провайдера](../../user/ai-assistant/#подключение-ai-провайдера) или [шаблон с общим токеном](provider-templates/).
1. Создайте включённую MCP-коллекцию с инструментами `ddp_get_resources` и `ddp_get_resource_entities`.
1. Создайте включённую MCP-коллекцию с инструментами `get_resources` и `get_resource_entities`.
1. Предоставьте пользователю право использовать эту коллекцию и права чтения нужных объектов каталога.
1. В каталоге агентов откройте редактирование платформенного агента. На вкладке «Инструменты и навыки» выберите коллекцию в «MCP-коллекции» и сохраните.
1. В AI-ассистенте выберите агента и провайдера, затем попросите показать доступные ресурсы каталога.
Expand All @@ -23,9 +23,9 @@ description: Подготовка платформенного агента ddp-

## Изменение инструментов и навыков

Для расширения возможностей отредактируйте коллекцию или подключите другую. Например, для процессов добавьте `get_processes`, `run_process` и `get_process_instance`. Пользователю также необходимы доступ к этим инструментам через коллекции и разрешения на операции с сущностями.
Для расширения возможностей отредактируйте коллекцию или подключите другую. Например, для процессов добавьте `curated_get_processes`, `curated_run_process` и `curated_get_process_instance`. Пользователю также необходимы доступ к этим инструментам через коллекции и разрешения на операции с сущностями.

На вкладке «Инструменты и навыки» можно назначить [навыки](skills/). Для их чтения в запуске должен быть доступен `get_skill`.
На вкладке «Инструменты и навыки» можно назначить [навыки](skills/). Для их чтения в запуске должен быть доступен `curated_get_skill`.

При добавлении группы портала целиком новые инструменты этой группы автоматически входят в коллекцию. Если состав должен быть фиксированным, выбирайте отдельные инструменты.

Expand Down
6 changes: 4 additions & 2 deletions content/documentation/admin/ai-agents/skills.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,11 +59,13 @@ project-check/

1. Откройте агент в «AI» → «Агенты» → «Каталог» и выберите редактирование.
1. На вкладке «Инструменты и навыки» добавьте навык и выберите конкретную версию либо «Последняя».
1. В «MCP-коллекции» подключите коллекцию с инструментом `get_skill`; для чтения дополнительных файлов добавьте также `get_skill_file`.
1. В «MCP-коллекции» подключите коллекцию с инструментом `curated_get_skill`; для чтения дополнительных файлов добавьте также `curated_get_skill_file`.
1. Предоставьте запускающему пользователю доступ к этим инструментам через доступные ему MCP-коллекции.
1. Сохраните агента и начните новый запуск.

При запуске агент получает названия и описания назначенных навыков и загружает полный текст при необходимости. Без доступного `get_skill` набор навыков не передаётся; форма привязок показывает предупреждение. `list_skills` предназначен для обычного MCP-клиента; агент получает свой подготовленный набор.
При запуске агент получает названия и описания назначенных навыков и загружает полный текст при необходимости. Без доступного `curated_get_skill` набор навыков не передаётся; форма привязок показывает предупреждение. `curated_list_skills` предназначен для обычного MCP-клиента; агент получает свой подготовленный набор.

Если инструкция в `SKILL.md` прямо называет MCP-инструмент для платформенного агента, укажите его название с префиксом `ddp_`, например `ddp_curated_get_skill_file` или `ddp_query_catalog`. В каталоге коллекций те же инструменты называются `curated_get_skill_file` и `query_catalog`.

Привязка «Последняя» выбирает активную версию с наибольшим номером при следующем запуске. Закреплённая привязка сохраняет выбранную версию.

Expand Down
4 changes: 3 additions & 1 deletion content/documentation/admin/security/rbac.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -295,7 +295,7 @@ AI-агенты и навыки:

Для навыка используются `read:agent-skill`, `edit:agent-skill` и `edit:role-bindings`. Для источника навыков — `read:agent-skill-source`, `edit:agent-skill-source` и `edit:role-bindings`.

Назначенный агенту навык не выдаёт дополнительных разрешений. Чтение навыка в запуске требует инструмента `get_skill`, доступного через MCP-коллекции агента и запускающего пользователя.
Назначенный агенту навык не выдаёт дополнительных разрешений. Чтение навыка в запуске требует инструмента `curated_get_skill`, доступного через MCP-коллекции агента и запускающего пользователя.

#### Рабочие пространства и шаблоны

Expand All @@ -311,6 +311,8 @@ AI-агенты и навыки:

Прикрепление к чату и выполнение заданий процесса требуют пространства самого пользователя. Для процесса также необходима привязка к его сущности.

Публиковать порты, менять их уровень доступа и отменять публикацию может владелец с правом обновления рабочего пространства. Для приложений «Только владелец» действует такое же ограничение на открытие. Приложения «Пользователи DDP» доступны любому вошедшему незаблокированному пользователю, «Публично» — без входа; права на карточку рабочего пространства для открытия этих ссылок не требуются. Допустимый уровень публикации портов [ограничивается шаблоном](../../workspaces/apps/#уровни-доступа).

Для других объектов (действия, автоматизации, процессы, вебхуки, виджеты, дашборды, внешние сервисы и т. д.):
- `read:[object-type]` — просмотр объекта.
- `update:[object-type]` — редактирование объекта.
Expand Down
4 changes: 2 additions & 2 deletions content/documentation/admin/widgets/ai/chat.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,12 +23,12 @@ weight: 10

При заполнении промпта явно укажите названия инструментов Model Context Protocol (MCP), которые должен вызвать агент при подготовке ответа. Агент получает инструменты назначенных ему MCP-коллекций, которыми может пользоваться запускающий пользователь. Без коллекций агент работает без MCP-инструментов.

Чтобы использовать `get_external_data` в промпте, включите его в [MCP-коллекции агента](../../ai-agents/platform-agent/#изменение-инструментов-и-навыков) и предоставьте пользователю доступ к этому инструменту через коллекцию.
Чтобы платформенный агент вызывал `ddp_curated_get_external_data` по инструкции в промпте, включите `curated_get_external_data` в [MCP-коллекции агента](../../ai-agents/platform-agent/#изменение-инструментов-и-навыков) и предоставьте пользователю доступ к этому инструменту через коллекцию.

Пример промпта для быстрого вопроса:

```text
1. Вызови MCP tool get_external_data для внешнего сервиса «Deckhouse Code» и получи пайплайны для проекта с ID {{ .entity.properties.deckhouse_code_id }}.
1. Вызови MCP-инструмент ddp_curated_get_external_data для внешнего сервиса «Deckhouse Code» и получи пайплайны для проекта с ID {{ .entity.properties.deckhouse_code_id }}.
2. Выведи таблицу с последними 10 пайплайнами.
```

Expand Down
Loading
Loading