diff --git a/content/documentation/admin/ai-agents/agent-sources.ru.md b/content/documentation/admin/ai-agents/agent-sources.ru.md index d795bb1..6c7889f 100644 --- a/content/documentation/admin/ai-agents/agent-sources.ru.md +++ b/content/documentation/admin/ai-agents/agent-sources.ru.md @@ -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-ключ», общий для всех агентов источника. diff --git a/content/documentation/admin/ai-agents/external-agents.ru.md b/content/documentation/admin/ai-agents/external-agents.ru.md index 8ba6717..da56ae6 100644 --- a/content/documentation/admin/ai-agents/external-agents.ru.md +++ b/content/documentation/admin/ai-agents/external-agents.ru.md @@ -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`. diff --git a/content/documentation/admin/ai-agents/overview.ru.md b/content/documentation/admin/ai-agents/overview.ru.md index 1ee34ff..79dab5c 100644 --- a/content/documentation/admin/ai-agents/overview.ru.md +++ b/content/documentation/admin/ai-agents/overview.ru.md @@ -28,6 +28,8 @@ AI-агент получает задачу на естественном язы Агент использует собственные доступы к модели или прокси моделей DDP. При работе через прокси портал использует AI-провайдера пользователя, запустившего задачу, и расходует его квоту. +В каталоге источник модели отображается как «Модель DDP» или «Модель агента». + Платформенный агент всегда использует прокси. Для внешнего агента включите «Разрешить прокси моделей DDP» в настройках подключения, если модель должен предоставлять портал. Прокси работает с API, совместимым с OpenAI Chat Completions: к URL провайдера добавляется `/chat/completions`, если суффикса ещё нет. Требуются модель и токен; поля провайдера «Шаблон тела запроса» и «Поле ответа» для агентского запроса не используются. diff --git a/content/documentation/admin/ai-agents/platform-agent.ru.md b/content/documentation/admin/ai-agents/platform-agent.ru.md index 4bc00bf..089d843 100644 --- a/content/documentation/admin/ai-agents/platform-agent.ru.md +++ b/content/documentation/admin/ai-agents/platform-agent.ru.md @@ -6,7 +6,7 @@ description: Подготовка платформенного агента ddp- Платформенный агент с идентификатором `ddp-agent` разворачивается вместе с Deckhouse Development Portal (DDP). Он доступен в AI-ассистенте, виджете «AI-чат» и шагах процессов. -Агент использует языковую модель через AI-провайдера запускающего пользователя. Для работы с файлами проекта используйте [рабочее пространство](../../user/workspaces/). +Агент использует языковую модель через AI-провайдера запускающего пользователя. В каталоге он отмечен как «Модель DDP»; переключатель «Разрешить прокси моделей DDP» в его подключении включён и недоступен для изменения. Для работы с файлами проекта используйте [рабочее пространство](../../user/workspaces/). ## Быстрый старт diff --git a/content/documentation/admin/ai-agents/provider-templates.ru.md b/content/documentation/admin/ai-agents/provider-templates.ru.md index d83ffb9..225fa0f 100644 --- a/content/documentation/admin/ai-agents/provider-templates.ru.md +++ b/content/documentation/admin/ai-agents/provider-templates.ru.md @@ -28,11 +28,13 @@ AI-провайдер нужен пользователю для работы с Чтобы создать шаблон: -1. Перейдите в раздел «AI» → «AI-агенты» → «Шаблоны AI-провайдеров». Создание доступно с глобальным `edit:ai-provider-templates`; просмотр и изменение существующих шаблонов также могут быть разрешены объектными ролями. +1. Перейдите в раздел «AI» → «Агенты» → «Шаблоны провайдеров». Создание доступно с глобальным `edit:ai-provider-templates`; просмотр и изменение существующих шаблонов также могут быть разрешены объектными ролями. 1. Нажмите «Создать». 1. Заполните поля шаблона, как описано в разделе [«Параметры шаблона»](#параметры-шаблона). 1. Нажмите «Сохранить». +Для предварительной подготовки сохраните шаблон выключенным. Выключенное состояние сохраняется при создании; включите шаблон, когда он будет готов к использованию. + ## Параметры шаблона Форма шаблона содержит поля: diff --git a/content/documentation/admin/ai-agents/runs.ru.md b/content/documentation/admin/ai-agents/runs.ru.md index e2dcb4d..ca6fcca 100644 --- a/content/documentation/admin/ai-agents/runs.ru.md +++ b/content/documentation/admin/ai-agents/runs.ru.md @@ -13,7 +13,7 @@ AI-агенты — функциональность на стадии Preview. ## История запусков -История открывается в разделе «AI» → «AI-агенты» → «История запусков» и доступна с разрешением `read:ai-agent-runs`. +История открывается в разделе «AI» → «Использование» → «Аудит», на вкладке «Запуски агентов», и доступна с разрешением `read:ai-agent-runs`. Пользователь видит только свои запуски, супер-администратор — запуски всех пользователей. Таблицу запусков можно отфильтровать по полям: diff --git a/content/documentation/admin/ai-agents/skills.ru.md b/content/documentation/admin/ai-agents/skills.ru.md index 4d4fa2f..ea136da 100644 --- a/content/documentation/admin/ai-agents/skills.ru.md +++ b/content/documentation/admin/ai-agents/skills.ru.md @@ -57,7 +57,7 @@ project-check/ Чтобы агент получил опубликованный навык: -1. Откройте агент в «AI» → «AI-агенты» → «Каталог» и выберите редактирование. +1. Откройте агент в «AI» → «Агенты» → «Каталог» и выберите редактирование. 1. На вкладке «Инструменты и навыки» добавьте навык и выберите конкретную версию либо «Последняя». 1. В «MCP-коллекции» подключите коллекцию с инструментом `get_skill`; для чтения дополнительных файлов добавьте также `get_skill_file`. 1. Предоставьте запускающему пользователю доступ к этим инструментам через доступные ему MCP-коллекции. diff --git a/content/documentation/admin/workspaces/files.ru.md b/content/documentation/admin/workspaces/files.ru.md index ca88cba..3a78ac8 100644 --- a/content/documentation/admin/workspaces/files.ru.md +++ b/content/documentation/admin/workspaces/files.ru.md @@ -110,7 +110,7 @@ printf 'Workspace configuration is ready\n' Скрипт выполняется до старта агента и IDE. Команды должны завершаться; не запускайте в нём сервер, который занимает процесс навсегда. Ошибка скрипта препятствует готовности пода и отображается в логе `bootstrap` на вкладке «Диагностика». -Штатный под работает с UID/GID `10000`, без повышения привилегий и с корневой файловой системой только для чтения. Размещайте рабочие данные на томе и не используйте в скриптах команды, которым нужны права root. Для дополнительных системных пакетов подготовьте собственный образ и укажите его в контейнере шаблона. +Штатный под работает с UID/GID `10000`, без повышения привилегий и с корневой файловой системой только для чтения. Размещайте рабочие данные и устанавливаемые инструменты на постоянном томе. Пример установки Go и настройки окружения агента и IDE — [в руководстве по инструментам разработки](tools/#установка-go). ## Применение изменений к существующему пространству diff --git a/content/documentation/admin/workspaces/templates.ru.md b/content/documentation/admin/workspaces/templates.ru.md index f3fcc60..a93790f 100644 --- a/content/documentation/admin/workspaces/templates.ru.md +++ b/content/documentation/admin/workspaces/templates.ru.md @@ -128,4 +128,4 @@ output "ddp_runtime" { | Содержимое | Текст в UTF-8 | | Путь | Относительный, без пустых сегментов, `.` и `..` | -Практические примеры — [доставка файлов и скрипты](files/), [образы, Ingress и хранение](network-storage/), [синхронизация из GitLab](sources/). +Практические примеры — [доставка файлов и скрипты](files/), [установка Go и других инструментов](tools/), [образы, Ingress и хранение](network-storage/), [синхронизация из GitLab](sources/). diff --git a/content/documentation/admin/workspaces/tools.ru.md b/content/documentation/admin/workspaces/tools.ru.md new file mode 100644 index 0000000..e9904f6 --- /dev/null +++ b/content/documentation/admin/workspaces/tools.ru.md @@ -0,0 +1,137 @@ +--- +title: Инструменты разработки +description: Установка Go в рабочее пространство скриптом шаблона, настройка PATH для агента и IDE, сохранение инструментов при перезапуске. +weight: 35 +--- + +Инструменты разработки можно устанавливать скриптами шаблона на постоянный том рабочего пространства. Агент и IDE используют этот том совместно. Установка в `/workspace/state` сохраняется после остановки и запуска, а файлы проекта остаются в `/workspace/code`. + +Штатные контейнеры работают с UID/GID `10000` и корневой файловой системой только для чтения. Выбирайте дистрибутив инструмента, который можно распаковать в пользовательскую директорию без `sudo`, `apt` или `apk`. + +## Установка Go + +Пример устанавливает Go `1.27.3` на Linux amd64 или arm64. Версия и SHA-256 архивов зафиксированы в скрипте; они опубликованы [на странице загрузок Go](https://go.dev/dl/). + +### Скрипт установки + +Добавьте в черновик шаблона файл `scripts/start.sh` со следующим содержимым. Если файл уже содержит команды настройки, объедините их с примером: + +```bash +#!/usr/bin/env bash +set -euo pipefail + +: "${DDP_STATE_DIR:?}" +go_version="1.27.3" + +case "$(uname -m)" in + x86_64) + go_arch="amd64" + go_checksum="65efbc80fdc1fa2cd2631cad5b481777a68e8725f34e89f50fc6ac714e379b40" + ;; + aarch64|arm64) + go_arch="arm64" + go_checksum="a06e99309dbcbdca1a8ccd2282c3ee146e55930886e26b4f1193269587165f49" + ;; + *) + printf 'Unsupported architecture: %s\n' "$(uname -m)" >&2 + exit 1 + ;; +esac + +toolchains_dir="${DDP_STATE_DIR}/toolchains" +go_directory="${toolchains_dir}/go${go_version}-linux-${go_arch}" +mkdir -p "$toolchains_dir" "${DDP_STATE_DIR}/tools" "${DDP_STATE_DIR}/tmp/go" + +if [ ! -d "$go_directory" ]; then + staging_dir="$(mktemp -d "${toolchains_dir}/.go-install.XXXXXX")" + trap 'rm -rf "$staging_dir"' EXIT + + curl -fsSL --retry 3 --connect-timeout 15 --max-time 300 "https://go.dev/dl/go${go_version}.linux-${go_arch}.tar.gz" -o "${staging_dir}/go.tar.gz" + printf '%s go.tar.gz\n' "$go_checksum" > "${staging_dir}/go.sha256" + (cd "$staging_dir" && sha256sum -c go.sha256) + tar -xzf "${staging_dir}/go.tar.gz" -C "$staging_dir" + mv "${staging_dir}/go" "$go_directory" + + rm -rf "$staging_dir" + trap - EXIT +fi + +ln -sfn "$go_directory" "${DDP_STATE_DIR}/tools/go" +"${DDP_STATE_DIR}/tools/go/bin/go" version +``` + +Скрипт скачивает и проверяет архив только при отсутствии выбранной версии на томе. Распаковка выполняется во временной директории на том же томе; готовая установка переносится в директорию версии. При повторном запуске используется сохранённая копия. + +Ссылка `/workspace/state/tools/go` указывает на выбранную версию. Благодаря этому при обновлении версии путь в `PATH` остаётся прежним. + +Используйте `start.sh`, чтобы пример применялся и к новым, и к уже созданным пространствам после обновления шаблона. `create.sh` пропускается, если первоначальная настройка тома уже успешно выполнялась. + +### Окружение агента и IDE + +В `main.tf` добавьте следующие поля в существующий блок `local.environment`, сохранив остальные поля: + +```hcl +PATH = "${local.state_directory}/tools/go/bin:${local.state_directory}/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" +GOPATH = "${local.state_directory}/go" +GOCACHE = "${local.state_directory}/cache/go-build" +GOTMPDIR = "${local.state_directory}/tmp/go" +CGO_ENABLED = "0" +``` + +Штатный шаблон передаёт `local.environment` контейнеру первоначальной настройки, агенту и IDE. Go и команды, установленные через `go install`, будут доступны во всех этих контейнерах. Кеш сборки и `GOPATH`, включая кеш модулей, располагаются на постоянном томе. `GOTMPDIR` переносит временные файлы компиляции на тот же том, чтобы сборка не занимала ограниченный `/tmp` контейнера. + +Изменение `PATH` через `export` внутри `start.sh` действует только на сам скрипт и его дочерние процессы. Поэтому задавайте переменные в `main.tf`. + +В примере `CGO_ENABLED = "0"` отключает использование C-компилятора. Он подходит для проектов на Go без зависимостей от C; для проектов с CGo также требуются соответствующий компилятор и системные библиотеки. + +### Публикация и проверка + +Для запуска примера поду нужен HTTPS-доступ к `go.dev` и адресу загрузки после перенаправления, обычно `dl.google.com`. Для зависимостей проекта также нужен доступ к выбранному прокси Go-модулей или репозиториям. Если прямой доступ закрыт, разместите тот же архив во внутреннем хранилище и измените URL в скрипте, сохранив проверку SHA-256. + +Чтобы применить пример: + +1. Сохраните `scripts/start.sh` и `main.tf`, опубликуйте версию и активируйте её. +1. Создайте новое рабочее пространство либо остановите существующее, обновите его версию шаблона и снова запустите. +1. В логе контейнера `bootstrap` на вкладке «Диагностика» проверьте успешную проверку архива и строку `go version`. +1. Откройте терминал IDE и проверьте установку: + + ```shell + go version + go env GOPATH GOCACHE GOTMPDIR CGO_ENABLED + command -v go + ``` + +1. Попросите агента в чате выполнить `go version`. Он должен увидеть ту же версию, что и терминал IDE. +1. Остановите и запустите пространство ещё раз. Go должен остаться доступным; повторное скачивание той же версии не требуется. + +### Проверка сборки + +Для проверки компилятора создайте и запустите программу вне директории проекта. Пример не меняет `go.mod` и исходные файлы проекта: + +```shell +mkdir -p /workspace/state/checks/go +cat > /workspace/state/checks/go/hello.go <<'EOF' +package main + +import "fmt" + +func main() { + fmt.Println("Go is ready") +} +EOF +go run /workspace/state/checks/go/hello.go +``` + +Ожидаемый вывод — `Go is ready`. Затем выполните проверки самого проекта, например `go test ./...` из его корневой директории. + +## Обновление версии инструмента + +Для обновления Go измените `go_version` и обе контрольные суммы архивов в `scripts/start.sh`. Возьмите значения [со страницы загрузок Go](https://go.dev/dl/), сохраните и опубликуйте новую версию шаблона. + +Остановите пространство, обновите шаблон и снова запустите. Скрипт установит новую версию в отдельную директорию и переключит ссылку `tools/go`. Прежняя версия останется на томе; её директорию можно удалить из терминала после проверки новой версии. + +## Установка других инструментов + +Для других инструментов используйте ту же последовательность: выберите архив под архитектуру и системные библиотеки контейнера, проверьте его контрольную сумму, распакуйте на постоянный том и добавьте исполняемые файлы в окружение шаблона. + +Совместимость проверяйте отдельно в агенте и IDE. Штатный агент использует Alpine Linux с musl; для него подходят совместимые с musl или статически скомпонованные бинарные файлы. Совпадения архитектуры процессора недостаточно, если инструмент зависит от системных библиотек. diff --git a/content/documentation/release-notes/v1.8.0.ru.md b/content/documentation/release-notes/v1.8.0.ru.md index 08311b8..3b5b898 100644 --- a/content/documentation/release-notes/v1.8.0.ru.md +++ b/content/documentation/release-notes/v1.8.0.ru.md @@ -34,6 +34,8 @@ description: Рабочие пространства с IDE и AI-агентом - Обновлена [страница сущности](../user/catalog/#страница-сущности); в списке доступны фильтры по статусу и команде. - Для задач, AI-шагов и параллельных шлюзов процессов настраивается [тайм-аут](../admin/processes/overview/#задача). +- Лимит [чатов AI-ассистента](../user/ai-assistant/#чаты) увеличен с 20 до 50 на пользователя. +- Новые [параметры форм](../user/properties/#конфигурация) по умолчанию необязательны; обязательность задаётся при настройке параметра. ## Исправления @@ -42,3 +44,4 @@ description: Рабочие пространства с IDE и AI-агентом - Процессы сохраняют свою схему при редактировании, корректно обрабатывают параллельные ветки, таймеры, подтверждения и [восстановление запусков](../admin/processes/overview/). - Переключение чатов во время ответа агента больше не смешивает сообщения разных диалогов. - Записи действий больше не остаются выполняющимися после удаления связанной сущности. +- [MCP-серверы и инструменты](../user/mcp-management/), а также [шаблоны AI-провайдеров](../admin/ai-agents/provider-templates/), созданные выключенными, сохраняют это состояние. diff --git a/content/documentation/user/ai-assistant.ru.md b/content/documentation/user/ai-assistant.ru.md index d07bb56..fa42966 100644 --- a/content/documentation/user/ai-assistant.ru.md +++ b/content/documentation/user/ai-assistant.ru.md @@ -105,7 +105,7 @@ Authorization: Bearer {{ .token }} Чаты имеют следующие настройки: -1. До 20 чатов на пользователя. При достижении лимита удалите старые чаты через меню «Действия с чатом». +1. До 50 чатов на пользователя. При достижении лимита кнопка «Новый чат» недоступна и отображается пояснение. Удалите ненужный чат через меню «Действия с чатом», чтобы создать новый. Этот же лимит действует при открытии нового чата рабочего пространства. 1. До первого сообщения у чата служебное название. После первого вопроса название подставляется по тексту (можно «Переименовать»). 1. Удаление чата вместе с историей сообщений в нём необратимо. diff --git a/content/documentation/user/interface.ru.md b/content/documentation/user/interface.ru.md index 5126e1f..2e0d745 100644 --- a/content/documentation/user/interface.ru.md +++ b/content/documentation/user/interface.ru.md @@ -12,6 +12,20 @@ weight: 20 - «AI» — раздел рабочих пространств, навыков, агентов, AI-провайдеров, MCP-инструментов и статистики использования. Подробнее — в разделе [«Управление MCP»](mcp-management/). Доступ к разделу может быть ограничен ролевой моделью. - «Администрирование» — раздел для управления командами, пользователями, политиками доступа и учётными данными. Доступ к разделу может быть ограничен ролевой моделью. +## Раздел AI + +Раздел «AI» открывается на каталоге агентов. Настройки и журналы сгруппированы в боковом меню: + +| Группа | Пункты меню | +| --- | --- | +| «Агенты» | «Каталог», «Источники агентов», «Шаблоны провайдеров» | +| «MCP» | «Каталог», «MCP-серверы», «MCP-коллекции», «MCP-инструменты» | +| «Рабочие пространства» | «Рабочие пространства», «Шаблоны рабочих пространств», «Источники шаблонов» | +| «Навыки» | «Навыки», «Источники навыков» | +| «Использование» | «Аудит», «Статистика» | + +Каталог агентов показывает источник языковой модели: «Модель DDP» означает работу через AI-провайдера запускающего пользователя, «Модель агента» — собственное подключение внешнего агента к модели. Платформенный агент всегда использует модель DDP. + ## Верхняя панель В правой части верхней панели портала расположены кнопки: diff --git a/content/documentation/user/mcp-management.ru.md b/content/documentation/user/mcp-management.ru.md index a4be435..e22cee7 100644 --- a/content/documentation/user/mcp-management.ru.md +++ b/content/documentation/user/mcp-management.ru.md @@ -40,6 +40,8 @@ description: Подключение upstream MCP-серверов, пользо После сохранения откройте карточку сервера и нажмите «Синхронизировать», чтобы загрузить каталог инструментов. На вкладке «Инструменты» включите нужные инструменты и при необходимости задайте «Теги». Включите их в коллекцию, чтобы предоставить доступ пользователям и агентам. +Чтобы подготовить подключение без доступа к его инструментам, сохраните сервер с выключенным переключателем «Включить». Он останется выключенным после создания; инструменты станут доступны для вызовов только после его включения и выдачи доступа через коллекции. + ### Учётные записи Для синхронизации каталога и проверки доступности выберите «Системная учётная запись» и заполните у неё реквизиты, используемые в заголовках. Она нужна для этих операций и тогда, когда сервер не требует авторизации. @@ -84,6 +86,8 @@ description: Подключение upstream MCP-серверов, пользо 1. На вкладке «Авторизация» укажите «URL» эндпоинта исполнителя, «HTTP-метод», «Заголовки» и «Учётные данные». При необходимости включите «Выбрать учётную запись для вызовов», чтобы использовать реквизиты выбранного пользователя вместо вызывающего. В URL можно использовать сегменты `{placeholder}` для path-параметров и плейсхолдеры учётных данных, например `{{ .credentials.tenant_id }}`. 1. Нажмите «Сохранить». +Сохраните инструмент с выключенным переключателем «Включить», если его пока нельзя использовать. Выключенное состояние сохраняется при создании; для вызовов инструмент потребуется включить и добавить в доступную коллекцию. + Пример. В схеме аргументов задан аргумент `space_id`, URL исполнителя — `https://api.example.com/v1/spaces/{spaceId}/boards`, сопоставление path-параметров — `{"space_id": "spaceId"}`. При вызове инструмента с `space_id=42` запрос будет отправлен по адресу `https://api.example.com/v1/spaces/42/boards`. Аргументы передаются эндпоинту исполнителя следующим образом: @@ -129,7 +133,7 @@ MCP-коллекция объединяет инструменты и опред Чтобы выдать инструменты агенту: -1. Откройте редактирование агента в «AI» → «AI-агенты» → «Каталог». +1. Откройте редактирование агента в «AI» → «Агенты» → «Каталог». 1. На вкладке «Инструменты и навыки» выберите «MCP-коллекции» и сохраните. 1. Убедитесь, что запускающему пользователю разрешены нужные инструменты через доступные ему коллекции. 1. Выдайте пользователю право использовать агента и необходимые права на объекты портала. diff --git a/content/documentation/user/properties.ru.md b/content/documentation/user/properties.ru.md index a4e93a2..46e9cfd 100644 --- a/content/documentation/user/properties.ru.md +++ b/content/documentation/user/properties.ru.md @@ -1,5 +1,6 @@ --- title: Параметры +description: Типы параметров каталога и форм, настройка обязательности, редактирования и видимости. --- Для каждого ресурса, действия или сценария администратор DDP может добавить неограниченное количество параметров одного из следующих типов: @@ -50,6 +51,8 @@ title: Параметры ## Конфигурация +Новый параметр в редакторе по умолчанию необязателен, доступен для редактирования и виден пользователю. Включите «Обязательный параметр», если его значение требуется для сохранения формы или запуска. Настройки задаются отдельно для каждого параметра: + * «Редактируемый параметр» — для каждого параметра можно настроить разрешение либо запрет редактирования пользователем. В случае запрета редактирования пользователь при запуске действий или сценариев не сможет изменить значение параметра, то есть всегда будет использоваться значение по умолчанию. * «Обязательный параметр» — каждый параметр может быть обязательным либо опциональным. Значение обязательного параметра не может быть пустым при запуске действий, сценариев и процессов и при сохранении [формы сущности](../catalog/#создание-и-редактирование-сущности). Параметр типа «Boolean» всегда имеет значение. Значение опционального параметра может оставаться пустым без влияния на работоспособность действия. При создании и изменении сущности через API, источники данных и действия обязательность параметров ресурса не проверяется. * «Скрытый параметр» — скрытый параметр не отображается в таблицах и карточках сущностей, а также при запуске действий и сценариев. diff --git a/content/documentation/user/workspace-chat.ru.md b/content/documentation/user/workspace-chat.ru.md index 84deb2a..7ec523c 100644 --- a/content/documentation/user/workspace-chat.ru.md +++ b/content/documentation/user/workspace-chat.ru.md @@ -28,12 +28,25 @@ weight: 56 ## Очередь и остановка -Пока агент отвечает, следующие сообщения попадают в очередь. Можно забрать ожидающее сообщение из очереди до начала его выполнения. +Пока агент отвечает, следующие сообщения попадают в очередь. В очереди рабочего пространства может ожидать до 10 заданий. Можно забрать ожидающее сообщение из очереди до начала его выполнения. + +Если пространство не приняло сообщение, например из-за заполненной очереди или недоступности агента, вопрос остаётся в истории чата с причиной ошибки. Он сохраняет своё место среди других сообщений после перезагрузки. Устраните причину и повторите отправку; такое сообщение ещё не является заданием рабочего пространства. Кнопка остановки прерывает текущее задание агента. Чтобы остановить также IDE и под рабочего пространства, используйте «Остановить» в карточке пространства. Отсоединение рабочего пространства от чата возвращает чат к агенту из каталога и оставляет само пространство работающим. +## Ошибки отправки + +Если задание не принято, проверьте указанную в чате причину: + +| Сообщение | Действие | +| --- | --- | +| «Очередь вопросов рабочего пространства заполнена. Дождитесь ответов и повторите попытку.» | Дождитесь выполнения заданий или уберите ненужные вопросы из очереди, затем повторите отправку | +| «Агент рабочего пространства недоступен. Проверьте статус и диагностику рабочего пространства.» | Проверьте, что пространство запущено и готово, затем откройте его диагностику | +| «Рабочее пространство, прикреплённое к чату, не найдено. Прикрепите другое.» | Прикрепите доступное пространство | +| «Рабочее пространство отвечает на другой вопрос. Дождитесь завершения и повторите попытку.» | Дождитесь завершения текущего задания и повторите отправку | + ## Изменения файлов После задания просмотрите список изменённых файлов и разницу содержимого. Уточняйте в следующем сообщении конкретные файлы и ожидаемый результат: diff --git a/content/documentation/user/workspaces.ru.md b/content/documentation/user/workspaces.ru.md index 064f96d..359f548 100644 --- a/content/documentation/user/workspaces.ru.md +++ b/content/documentation/user/workspaces.ru.md @@ -66,8 +66,8 @@ IDE открывается на отдельном HTTPS-домене. Вход 1. Остановите рабочее пространство. 1. Нажмите «Обновить версию». -1. Выберите версию и проверьте параметры. Форма отмечает новые, удалённые и изменённые значения. -1. Подтвердите обновление и проверьте его результат на вкладке «Операции». +1. Проверьте выбранную версию и параметры. Если активная опубликованная версия шаблона новее текущей, форма сразу предлагает её. Текущий черновик остаётся выбранным, если он доступен пользователю. При необходимости выберите другую доступную версию. Форма отмечает новые, удалённые и изменённые значения. +1. Подтвердите обновление и проверьте его результат на вкладке «Операции». Переход на другую версию доступен и без изменения значений параметров. 1. После успешного обновления запустите рабочее пространство. Данные постоянных томов сохраняются. Изменение шаблона, которое удаляет или заменяет существующий постоянный том, отклоняется. Файлы, которыми управляет шаблон, при следующем запуске обновляются по [политике доставки файлов](../admin/workspaces/files/).