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
2 changes: 1 addition & 1 deletion content/documentation/admin/ai-agents/agent-sources.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ AI-агенты — функциональность на стадии Preview.

1. Создайте ресурс, сущности которого будут описывать агентов. Добавьте в ресурс параметр типа `String` для URL карточки агента, например `agent_card_url`.
1. Создайте сущности ресурса и заполните в них URL карточки. Идентификатор сущности станет идентификатором агента.
1. Перейдите в раздел «AI» → «AI-агенты» → «Источники агентов» и нажмите «Создать источник агентов». Кнопка доступна с разрешением `edit:ai-agents`.
1. Перейдите в раздел «AI» → «Агенты» → «Источники агентов» и нажмите «Создать источник агентов». Кнопка доступна с разрешением `edit:ai-agents`.
1. На вкладке «Основная информация» включите «Включить», заполните «Название» и «Идентификатор».
1. На вкладке «Ресурсы каталога» нажмите «Добавить ресурс», выберите ресурс и в поле «Параметр с URL Agent Card» выберите параметр с URL карточки.
1. На вкладке «Подключение» укажите «API-ключ», общий для всех агентов источника.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ AI-агенты — функциональность на стадии Preview.

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

1. Перейдите в раздел «AI» → «AI-агенты» → «Каталог» и нажмите «Подключить агента». Кнопка доступна с разрешением `edit:ai-agents`.
1. Перейдите в раздел «AI» → «Агенты» → «Каталог» и нажмите «Подключить агента». Кнопка доступна с разрешением `edit:ai-agents`.
1. На вкладке «Основная информация» заполните «Название» и «Идентификатор».
1. На вкладке «Подключение» включите переключатель «Включить».
1. Укажите «URL Agent Card» — адрес карточки агента, например `https://agents.example.com/.well-known/agent-card.json`.
Expand Down
2 changes: 2 additions & 0 deletions content/documentation/admin/ai-agents/overview.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,8 @@ AI-агент получает задачу на естественном язы

Агент использует собственные доступы к модели или прокси моделей DDP. При работе через прокси портал использует AI-провайдера пользователя, запустившего задачу, и расходует его квоту.

В каталоге источник модели отображается как «Модель DDP» или «Модель агента».

Платформенный агент всегда использует прокси. Для внешнего агента включите «Разрешить прокси моделей DDP» в настройках подключения, если модель должен предоставлять портал.

Прокси работает с API, совместимым с OpenAI Chat Completions: к URL провайдера добавляется `/chat/completions`, если суффикса ещё нет. Требуются модель и токен; поля провайдера «Шаблон тела запроса» и «Поле ответа» для агентского запроса не используются.
Expand Down
2 changes: 1 addition & 1 deletion content/documentation/admin/ai-agents/platform-agent.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: Подготовка платформенного агента ddp-

Платформенный агент с идентификатором `ddp-agent` разворачивается вместе с Deckhouse Development Portal (DDP). Он доступен в AI-ассистенте, виджете «AI-чат» и шагах процессов.

Агент использует языковую модель через AI-провайдера запускающего пользователя. Для работы с файлами проекта используйте [рабочее пространство](../../user/workspaces/).
Агент использует языковую модель через AI-провайдера запускающего пользователя. В каталоге он отмечен как «Модель DDP»; переключатель «Разрешить прокси моделей DDP» в его подключении включён и недоступен для изменения. Для работы с файлами проекта используйте [рабочее пространство](../../user/workspaces/).

## Быстрый старт

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,11 +28,13 @@ AI-провайдер нужен пользователю для работы с

Чтобы создать шаблон:

1. Перейдите в раздел «AI» → «AI-агенты» → «Шаблоны AI-провайдеров». Создание доступно с глобальным `edit:ai-provider-templates`; просмотр и изменение существующих шаблонов также могут быть разрешены объектными ролями.
1. Перейдите в раздел «AI» → «Агенты» → «Шаблоны провайдеров». Создание доступно с глобальным `edit:ai-provider-templates`; просмотр и изменение существующих шаблонов также могут быть разрешены объектными ролями.
1. Нажмите «Создать».
1. Заполните поля шаблона, как описано в разделе [«Параметры шаблона»](#параметры-шаблона).
1. Нажмите «Сохранить».

Для предварительной подготовки сохраните шаблон выключенным. Выключенное состояние сохраняется при создании; включите шаблон, когда он будет готов к использованию.

## Параметры шаблона

Форма шаблона содержит поля:
Expand Down
2 changes: 1 addition & 1 deletion content/documentation/admin/ai-agents/runs.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ AI-агенты — функциональность на стадии Preview.

## История запусков

История открывается в разделе «AI» → «AI-агенты» → «История запусков» и доступна с разрешением `read:ai-agent-runs`.
История открывается в разделе «AI» → «Использование» → «Аудит», на вкладке «Запуски агентов», и доступна с разрешением `read:ai-agent-runs`.
Пользователь видит только свои запуски, супер-администратор — запуски всех пользователей.

Таблицу запусков можно отфильтровать по полям:
Expand Down
2 changes: 1 addition & 1 deletion content/documentation/admin/ai-agents/skills.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ project-check/

Чтобы агент получил опубликованный навык:

1. Откройте агент в «AI» → «AI-агенты» → «Каталог» и выберите редактирование.
1. Откройте агент в «AI» → «Агенты» → «Каталог» и выберите редактирование.
1. На вкладке «Инструменты и навыки» добавьте навык и выберите конкретную версию либо «Последняя».
1. В «MCP-коллекции» подключите коллекцию с инструментом `get_skill`; для чтения дополнительных файлов добавьте также `get_skill_file`.
1. Предоставьте запускающему пользователю доступ к этим инструментам через доступные ему MCP-коллекции.
Expand Down
2 changes: 1 addition & 1 deletion content/documentation/admin/workspaces/files.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -110,7 +110,7 @@ printf 'Workspace configuration is ready\n'

Скрипт выполняется до старта агента и IDE. Команды должны завершаться; не запускайте в нём сервер, который занимает процесс навсегда. Ошибка скрипта препятствует готовности пода и отображается в логе `bootstrap` на вкладке «Диагностика».

Штатный под работает с UID/GID `10000`, без повышения привилегий и с корневой файловой системой только для чтения. Размещайте рабочие данные на томе и не используйте в скриптах команды, которым нужны права root. Для дополнительных системных пакетов подготовьте собственный образ и укажите его в контейнере шаблона.
Штатный под работает с UID/GID `10000`, без повышения привилегий и с корневой файловой системой только для чтения. Размещайте рабочие данные и устанавливаемые инструменты на постоянном томе. Пример установки Go и настройки окружения агента и IDE — [в руководстве по инструментам разработки](tools/#установка-go).

## Применение изменений к существующему пространству

Expand Down
2 changes: 1 addition & 1 deletion content/documentation/admin/workspaces/templates.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -128,4 +128,4 @@ output "ddp_runtime" {
| Содержимое | Текст в UTF-8 |
| Путь | Относительный, без пустых сегментов, `.` и `..` |

Практические примеры — [доставка файлов и скрипты](files/), [образы, Ingress и хранение](network-storage/), [синхронизация из GitLab](sources/).
Практические примеры — [доставка файлов и скрипты](files/), [установка Go и других инструментов](tools/), [образы, Ingress и хранение](network-storage/), [синхронизация из GitLab](sources/).
Loading
Loading