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
Original file line number Diff line number Diff line change
Expand Up @@ -29,15 +29,15 @@ updateAddIfMissing:

### Спецификация запроса

Незаданные поля `templateId`, `templatePackSource`, `targetRepositoryUrl` и `targetBranch` заполняются из параметров сущности микросервиса по ролям [правил маппинга](../../home/mapping/#микросервисы).
Незаданные `templateId` и `templatePackSource` заполняются из управляемых параметров сущности микросервиса. Поля `targetRepositoryUrl` и `targetBranch` заполняются по ролям [правил маппинга](../../home/mapping/#микросервисы).

| Название | Обязательность | Описание | Значение по умолчанию |
| ------------------------ | -------------- | ---------------------------------------------------------------------------------------- | --------------------- |
| targetRepositoryUrl | Да | HTTPS-адрес репозитория микросервиса | Роль `microservice_repository` |
| targetBranch | Нет | Ветка, от которой создаётся ветка обновления | Роль `microservice_default_branch`, затем «Ветка по умолчанию» реестра шаблонов, затем `main` |
| sourceBranch | Нет | Ветка, в которую записываются изменения | `<префикс ветки обновления><версия>`, например `ddp/template-upgrade-1.3.0` |
| templateId | Да | Идентификатор шаблона | Роль `microservice_binding_template_id` |
| templatePackSource | Да | Название подключения в реестре шаблонов | Роль `microservice_binding_template_source` |
| templateId | Да | Идентификатор шаблона | Параметр `ddp_template_id` |
| templatePackSource | Да | Название подключения в реестре шаблонов | Параметр `ddp_template_source` |
| templateVersion | Нет | Целевая версия шаблона в формате semver | Последняя версия шаблона |
| upgradeStrategy | Нет | Стратегия обновления: `selective`, `additive`, `selective_additive`, `full` или `merge` | Параметр микросервиса, затем стратегия пакета, затем `selective` |
| updateOverwrite | Нет | Glob-шаблоны перезаписываемых путей | Параметр микросервиса, затем список пакета |
Expand Down
2 changes: 2 additions & 0 deletions content/documentation/admin/actions/overview.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -314,6 +314,8 @@ project_id: {{ .property.project_id }}

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

Чтобы следующий шаг процесса выполнялся после обновления каталога, добавьте после действия элемент [«Источник данных»](../processes/overview/#источник-данных) с теми же источниками. Выберите «Подождать текущую синхронизацию», чтобы дождаться уже запрошенного запуска, или «Нужны свежие данные», если требуется чтение источника после входа в этот шаг.

### Безопасность

#### Условия выполнения
Expand Down
14 changes: 7 additions & 7 deletions content/documentation/admin/ai-agents/agent-sources.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,8 +42,8 @@ AI-агенты — функциональность на стадии Preview.

1. Создайте ресурс, сущности которого будут описывать агентов. Добавьте в ресурс параметр типа `String` для URL карточки агента, например `agent_card_url`.
1. Создайте сущности ресурса и заполните в них URL карточки. Идентификатор сущности станет идентификатором агента.
1. Перейдите в раздел «AI» → «AI-агенты» → «Источники агентов» и нажмите «Создать источник агентов». Кнопка доступна с разрешением `edit:ai-agents`.
1. На вкладке «Основная информация» включите «Включить источник», заполните «Название» и «Идентификатор».
1. Перейдите в раздел «AI» → «Агенты» → «Источники агентов» и нажмите «Создать источник агентов». Кнопка доступна с разрешением `edit:ai-agents`.
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
Loading
Loading