From e8787975824fd9261dd9ecdaf036343828a54a79 Mon Sep 17 00:00:00 2001 From: sidorok Date: Mon, 23 Mar 2026 16:48:12 +0300 Subject: [PATCH 1/8] firstfix --- content/documentation/user/catalog.ru.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/content/documentation/user/catalog.ru.md b/content/documentation/user/catalog.ru.md index 0668172..d7e4d76 100644 --- a/content/documentation/user/catalog.ru.md +++ b/content/documentation/user/catalog.ru.md @@ -26,11 +26,11 @@ weight: 30 Для создания группы ресурсов необходимо: -1. **Создать ресурсы** — создать все необходимые ресурсы, которые будут входить в группу. Например, ресурс «Gitlab» может быть родительским для ресурсов «Репозитории», «Группы» и т.д. +- **Создать ресурсы** — создать все необходимые ресурсы, которые будут входить в группу. Например, ресурс «Gitlab» может быть родительским для ресурсов «Репозитории», «Группы» и т.д. -2. **Связать дочерние ресурсы с родительскими** — в сайдбаре каталога перетащить дочерний ресурс на родительский ресурс. Дочерние ресурсы будут автоматически привязаны к родительскому и отобразятся в интерфейсе как вложенные элементы. +- **Связать дочерние ресурсы с родительскими** — в сайдбаре каталога перетащить дочерний ресурс на родительский ресурс. Дочерние ресурсы будут автоматически привязаны к родительскому и отобразятся в интерфейсе как вложенные элементы. -3. **Настроить отображение** — в сайдбаре каталога родительские ресурсы отображаются с иконкой раскрытия/сворачивания, позволяющей показывать или скрывать дочерние элементы. +- **Настроить отображение** — в сайдбаре каталога родительские ресурсы отображаются с иконкой раскрытия/сворачивания, позволяющей показывать или скрывать дочерние элементы. {{< alert level="info" >}} Для изменения группировки ресурсов (перетаскивания ресурсов в сайдбаре каталога) требуется глобальное разрешение `update:resources-order`. Подробнее о правах доступа — в разделе [«Ролевая модель»](../../admin/security/rbac/). @@ -105,18 +105,18 @@ weight: 30 Для выгрузки сущностей конкретного ресурса: -1. Откройте карточку ресурса в каталоге. -2. В таблице сущностей нажмите кнопку **Скачать .csv**. -3. В выгруженный файл будут включены все сущности ресурса с учетом примененных фильтров, сортировки и пагинации. +- Откройте карточку ресурса в каталоге. +- В таблице сущностей нажмите кнопку **Скачать .csv**. +- В выгруженный файл будут включены все сущности ресурса с учетом примененных фильтров, сортировки и пагинации. #### Выгрузка сущностей нескольких ресурсов Для выгрузки сущностей из нескольких ресурсов одновременно: -1. В сайдбаре каталога нажмите кнопку **Выгрузить сущности**. -2. В открывшемся диалоге выберите один или несколько ресурсов. -3. Нажмите кнопку **Скачать .csv**. -4. Все сущности выбранных ресурсов будут объединены в один CSV-файл. +- В сайдбаре каталога нажмите кнопку **Выгрузить сущности**. +- В открывшемся диалоге выберите один или несколько ресурсов. +- Нажмите кнопку **Скачать .csv**. +- Все сущности выбранных ресурсов будут объединены в один CSV-файл. {{< alert level="info" >}} Для выгрузки сущностей требуется глобальное разрешение `read:entities`. Подробнее о правах доступа см. в разделе [Ролевая модель](../../admin/security/rbac/). From aad3b6f9998a065692673cf5f66ec97814934aed Mon Sep 17 00:00:00 2001 From: sidorok Date: Tue, 24 Mar 2026 16:34:16 +0300 Subject: [PATCH 2/8] docSfix --- content/documentation/user/ai-assistant.ru.md | 38 ++++++++++--------- content/documentation/user/catalog.ru.md | 16 ++++---- content/documentation/user/credentials.ru.md | 2 +- content/documentation/user/templating.ru.md | 2 +- 4 files changed, 31 insertions(+), 27 deletions(-) diff --git a/content/documentation/user/ai-assistant.ru.md b/content/documentation/user/ai-assistant.ru.md index e0733cf..813756c 100644 --- a/content/documentation/user/ai-assistant.ru.md +++ b/content/documentation/user/ai-assistant.ru.md @@ -15,9 +15,11 @@ AI-ассистент использует настраиваемые AI-про Платформа поддерживает три типа AI-провайдеров: -1. **OpenAI** — для работы с моделями OpenAI (GPT-4, GPT-3.5 и др.). -1. **Ollama** — для работы с локальными моделями через Ollama. -1. **Custom** — для работы с любым кастомным REST API, совместимым с форматом запросов/ответов AI-ассистент. +- **OpenAI** — для работы с моделями OpenAI (GPT-4, GPT-3.5 и др.). + +- **Ollama** — для работы с локальными моделями через Ollama. + +- **Custom** — для работы с любым кастомным REST API, совместимым с форматом запросов/ответов AI-ассистент. ### Учетные данные для провайдеров @@ -34,10 +36,11 @@ AI-ассистент использует настраиваемые AI-про - **Значение**: сам токен или ключ доступа. 1. Нажмите **Сохранить**. -**Важно:** +{{< alert level="info" >}} - Ключ существующих учетных данных нельзя изменить. Для изменения ключа удалите старые учетные данные и создайте новые. - Значение существующих учетных данных можно обновить, введя новое значение. - Учетные данные шифруются при сохранении и никогда не передаются в веб-интерфейс после сохранения. + {{< /alert >}} #### Использование учетных данных в заголовках @@ -193,20 +196,21 @@ choices.0.message.content } ``` -**Важно:** +{< alert level="info" >}} - Шаблон должен быть валидным JSON. - Переменные `{{.prompt}}` и `{{.model}}` будут автоматически заменены при отправке запроса. - Значение `{{.prompt}}` автоматически экранируется для безопасной вставки в JSON. - Вы можете добавить любые дополнительные поля, необходимые для вашего API (temperature, max_tokens, и т.д.). + {{< /alert >}} **Пример полной настройки кастомного провайдера:** -1. **Название**: `My Custom API`. -1. **Провайдер**: `Custom`. -1. **Модель**: `my-model-v1`. -1. **URL**: `https://api.example.com/v1/chat`. -1. **Метод**: `POST`. -1. **Заголовки**: +- **Название**: `My Custom API`. +- **Провайдер**: `Custom`. +- **Модель**: `my-model-v1`. +- **URL**: `https://api.example.com/v1/chat`. +- **Метод**: `POST`. +- **Заголовки**: ```sh Authorization: Bearer {{ .credentials.api_key }} @@ -262,9 +266,9 @@ AI-ассистент использует инструменты MCP (Model Con ### Особенности работы -1. **Анализ данных**: AI-ассистент не просто возвращает сырые данные, а анализирует их и предоставляет структурированные ответы. -1. **Фильтрация**: Вы можете запрашивать данные с условиями, и ассистент выполнит фильтрацию. -1. **Агрегация**: Ассистент может подсчитывать количество, группировать данные и предоставлять статистику. +- **Анализ данных**: AI-ассистент не просто возвращает сырые данные, а анализирует их и предоставляет структурированные ответы. +- **Фильтрация**: Вы можете запрашивать данные с условиями, и ассистент выполнит фильтрацию. +- **Агрегация**: Ассистент может подсчитывать количество, группировать данные и предоставлять статистику. ### Отладка @@ -296,6 +300,6 @@ AI-ассистент использует инструменты MCP (Model Con ## Рекомендации -1. **Используйте конкретные вопросы**: Чем конкретнее вопрос, тем точнее будет ответ. -1. **Указывайте параметры явно**: Если вы знаете название ресурса или параметр, укажите его в вопросе. -1. **Экспериментируйте**: AI-ассистент понимает естественный язык, пробуйте разные формулировки вопросов. +- **Используйте конкретные вопросы**: Чем конкретнее вопрос, тем точнее будет ответ. +- **Указывайте параметры явно**: Если вы знаете название ресурса или параметр, укажите его в вопросе. +- **Экспериментируйте**: AI-ассистент понимает естественный язык, пробуйте разные формулировки вопросов. diff --git a/content/documentation/user/catalog.ru.md b/content/documentation/user/catalog.ru.md index d7e4d76..8702feb 100644 --- a/content/documentation/user/catalog.ru.md +++ b/content/documentation/user/catalog.ru.md @@ -105,19 +105,19 @@ weight: 30 Для выгрузки сущностей конкретного ресурса: -- Откройте карточку ресурса в каталоге. -- В таблице сущностей нажмите кнопку **Скачать .csv**. -- В выгруженный файл будут включены все сущности ресурса с учетом примененных фильтров, сортировки и пагинации. +1. Откройте карточку ресурса в каталоге. +1. В таблице сущностей нажмите кнопку **Скачать .csv**. +1. В выгруженный файл будут включены все сущности ресурса с учетом примененных фильтров, сортировки и пагинации. #### Выгрузка сущностей нескольких ресурсов Для выгрузки сущностей из нескольких ресурсов одновременно: -- В сайдбаре каталога нажмите кнопку **Выгрузить сущности**. -- В открывшемся диалоге выберите один или несколько ресурсов. -- Нажмите кнопку **Скачать .csv**. -- Все сущности выбранных ресурсов будут объединены в один CSV-файл. +1. В сайдбаре каталога нажмите кнопку **Выгрузить сущности**. +1. В открывшемся диалоге выберите один или несколько ресурсов. +1. Нажмите кнопку **Скачать .csv**. +1. Все сущности выбранных ресурсов будут объединены в один CSV-файл. {{< alert level="info" >}} -Для выгрузки сущностей требуется глобальное разрешение `read:entities`. Подробнее о правах доступа см. в разделе [Ролевая модель](../../admin/security/rbac/). +Для выгрузки сущностей требуется глобальное разрешение `read:entities`. Подробнее о правах доступа см. в разделе [«Ролевая модель»](../../admin/security/rbac/). {{< /alert >}} diff --git a/content/documentation/user/credentials.ru.md b/content/documentation/user/credentials.ru.md index 72023a2..0a40720 100644 --- a/content/documentation/user/credentials.ru.md +++ b/content/documentation/user/credentials.ru.md @@ -11,7 +11,7 @@ moduleStatus: experimental Все взаимодействие с инфраструктурными сервисами в DDP происходит с использованием учётных данных конкретного пользователя. Учетные данные шифруются перед сохранением в базе данных и расшифровываются только при необходимости их использования в действиях, источниках данных и виджетах. -Подробнее о механизме работы, шифровании и настройке см. в [документации](../../admin/security/credentials/). +Подробнее о механизме работы, шифровании и настройке смотрите в [документации](../../admin/security/credentials/). ## Заполнение учётных данных diff --git a/content/documentation/user/templating.ru.md b/content/documentation/user/templating.ru.md index 273803c..5736042 100644 --- a/content/documentation/user/templating.ru.md +++ b/content/documentation/user/templating.ru.md @@ -500,7 +500,7 @@ title: Шаблонизация ## Хранилище процесса -Хранилище доступно только в процессах и используется для передачи данных между действиями. В настройках действия задаются правила записи в хранилище (см. [«Запись в хранилище процесса»](../../admin/actions/overview/#запись-в-хранилище-процесса)), а в конфигурации последующих действий используются плейсхолдеры для чтения данных. +Хранилище доступно только в процессах и используется для передачи данных между действиями. В настройках действия задаются правила записи в хранилище (смотрите [«Запись в хранилище процесса»](../../admin/actions/overview/#запись-в-хранилище-процесса)), а в конфигурации последующих действий используются плейсхолдеры для чтения данных. Для получения значения из хранилища используйте следующую конструкцию: From a595cbb23c3e21e29ef3db9d7bca5d2b93043b27 Mon Sep 17 00:00:00 2001 From: sidorok Date: Tue, 24 Mar 2026 16:52:25 +0300 Subject: [PATCH 3/8] fix3 --- content/documentation/user/catalog.ru.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/content/documentation/user/catalog.ru.md b/content/documentation/user/catalog.ru.md index 8702feb..93d611d 100644 --- a/content/documentation/user/catalog.ru.md +++ b/content/documentation/user/catalog.ru.md @@ -105,8 +105,10 @@ weight: 30 Для выгрузки сущностей конкретного ресурса: -1. Откройте карточку ресурса в каталоге. +1. Откройте карточку ресурса в каталоге. + 1. В таблице сущностей нажмите кнопку **Скачать .csv**. + 1. В выгруженный файл будут включены все сущности ресурса с учетом примененных фильтров, сортировки и пагинации. #### Выгрузка сущностей нескольких ресурсов @@ -114,8 +116,11 @@ weight: 30 Для выгрузки сущностей из нескольких ресурсов одновременно: 1. В сайдбаре каталога нажмите кнопку **Выгрузить сущности**. + 1. В открывшемся диалоге выберите один или несколько ресурсов. + 1. Нажмите кнопку **Скачать .csv**. + 1. Все сущности выбранных ресурсов будут объединены в один CSV-файл. {{< alert level="info" >}} From 7c0b69779d6112da1f2d893b542bb8b73f801e06 Mon Sep 17 00:00:00 2001 From: sidorok Date: Tue, 24 Mar 2026 16:56:45 +0300 Subject: [PATCH 4/8] fix4 --- content/documentation/user/ai-assistant.ru.md | 2 +- content/documentation/user/catalog.ru.md | 8 ++++---- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/content/documentation/user/ai-assistant.ru.md b/content/documentation/user/ai-assistant.ru.md index 813756c..47937ab 100644 --- a/content/documentation/user/ai-assistant.ru.md +++ b/content/documentation/user/ai-assistant.ru.md @@ -268,7 +268,7 @@ AI-ассистент использует инструменты MCP (Model Con - **Анализ данных**: AI-ассистент не просто возвращает сырые данные, а анализирует их и предоставляет структурированные ответы. - **Фильтрация**: Вы можете запрашивать данные с условиями, и ассистент выполнит фильтрацию. -- **Агрегация**: Ассистент может подсчитывать количество, группировать данные и предоставлять статистику. +- **Агрегация**: Ассистент может подсчитывать количество, группировать данные и предоставлять статистику. ### Отладка diff --git a/content/documentation/user/catalog.ru.md b/content/documentation/user/catalog.ru.md index 93d611d..5211464 100644 --- a/content/documentation/user/catalog.ru.md +++ b/content/documentation/user/catalog.ru.md @@ -107,7 +107,7 @@ weight: 30 1. Откройте карточку ресурса в каталоге. -1. В таблице сущностей нажмите кнопку **Скачать .csv**. +1. В таблице сущностей нажмите кнопку **Скачать .csv**. 1. В выгруженный файл будут включены все сущности ресурса с учетом примененных фильтров, сортировки и пагинации. @@ -115,11 +115,11 @@ weight: 30 Для выгрузки сущностей из нескольких ресурсов одновременно: -1. В сайдбаре каталога нажмите кнопку **Выгрузить сущности**. +1. В сайдбаре каталога нажмите кнопку **Выгрузить сущности**. -1. В открывшемся диалоге выберите один или несколько ресурсов. +1. В открывшемся диалоге выберите один или несколько ресурсов. -1. Нажмите кнопку **Скачать .csv**. +1. Нажмите кнопку **Скачать .csv**. 1. Все сущности выбранных ресурсов будут объединены в один CSV-файл. From dc95c2255d127cd2e8d87054d232a2defd47b450 Mon Sep 17 00:00:00 2001 From: Anastasia Sidorok Date: Wed, 25 Mar 2026 10:43:07 +0300 Subject: [PATCH 5/8] Apply suggestions from code review Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com> Signed-off-by: Anastasia Sidorok --- content/documentation/user/catalog.ru.md | 2 +- content/documentation/user/templating.ru.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/content/documentation/user/catalog.ru.md b/content/documentation/user/catalog.ru.md index 5211464..caedaee 100644 --- a/content/documentation/user/catalog.ru.md +++ b/content/documentation/user/catalog.ru.md @@ -124,5 +124,5 @@ weight: 30 1. Все сущности выбранных ресурсов будут объединены в один CSV-файл. {{< alert level="info" >}} -Для выгрузки сущностей требуется глобальное разрешение `read:entities`. Подробнее о правах доступа см. в разделе [«Ролевая модель»](../../admin/security/rbac/). +Для выгрузки сущностей требуется глобальное разрешение `read:entities`. Подробнее о правах доступа — в разделе [«Ролевая модель»](../../admin/security/rbac/). {{< /alert >}} diff --git a/content/documentation/user/templating.ru.md b/content/documentation/user/templating.ru.md index 5736042..7befac3 100644 --- a/content/documentation/user/templating.ru.md +++ b/content/documentation/user/templating.ru.md @@ -500,7 +500,7 @@ title: Шаблонизация ## Хранилище процесса -Хранилище доступно только в процессах и используется для передачи данных между действиями. В настройках действия задаются правила записи в хранилище (смотрите [«Запись в хранилище процесса»](../../admin/actions/overview/#запись-в-хранилище-процесса)), а в конфигурации последующих действий используются плейсхолдеры для чтения данных. +Хранилище доступно только в процессах и используется для передачи данных между действиями. В настройках действия задаются правила записи в хранилище (подробнее — в разделе [«Запись в хранилище процесса»](../../admin/actions/overview/#запись-в-хранилище-процесса)), а в конфигурации последующих действий используются плейсхолдеры для чтения данных. Для получения значения из хранилища используйте следующую конструкцию: From 4ac576385300f835559b54a3faad0dd761e71c96 Mon Sep 17 00:00:00 2001 From: Anastasia Sidorok Date: Wed, 25 Mar 2026 15:50:10 +0300 Subject: [PATCH 6/8] Update ai-assistant.ru.md Signed-off-by: Anastasia Sidorok --- content/documentation/user/ai-assistant.ru.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/documentation/user/ai-assistant.ru.md b/content/documentation/user/ai-assistant.ru.md index 47937ab..dd001a3 100644 --- a/content/documentation/user/ai-assistant.ru.md +++ b/content/documentation/user/ai-assistant.ru.md @@ -36,11 +36,11 @@ AI-ассистент использует настраиваемые AI-про - **Значение**: сам токен или ключ доступа. 1. Нажмите **Сохранить**. -{{< alert level="info" >}} +#### Изменение учетных данных + - Ключ существующих учетных данных нельзя изменить. Для изменения ключа удалите старые учетные данные и создайте новые. - Значение существующих учетных данных можно обновить, введя новое значение. - Учетные данные шифруются при сохранении и никогда не передаются в веб-интерфейс после сохранения. - {{< /alert >}} #### Использование учетных данных в заголовках @@ -196,12 +196,12 @@ choices.0.message.content } ``` -{< alert level="info" >}} +#### Особенности подготовки шаблона + - Шаблон должен быть валидным JSON. - Переменные `{{.prompt}}` и `{{.model}}` будут автоматически заменены при отправке запроса. - Значение `{{.prompt}}` автоматически экранируется для безопасной вставки в JSON. - Вы можете добавить любые дополнительные поля, необходимые для вашего API (temperature, max_tokens, и т.д.). - {{< /alert >}} **Пример полной настройки кастомного провайдера:** From bd26115d138eb1309c43a4f525b3cfbb4f81d1af Mon Sep 17 00:00:00 2001 From: Anastasia Sidorok Date: Wed, 25 Mar 2026 16:41:49 +0300 Subject: [PATCH 7/8] Apply suggestions from code review Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com> Signed-off-by: Anastasia Sidorok --- content/documentation/user/credentials.ru.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/documentation/user/credentials.ru.md b/content/documentation/user/credentials.ru.md index 0a40720..78bc6d6 100644 --- a/content/documentation/user/credentials.ru.md +++ b/content/documentation/user/credentials.ru.md @@ -11,7 +11,7 @@ moduleStatus: experimental Все взаимодействие с инфраструктурными сервисами в DDP происходит с использованием учётных данных конкретного пользователя. Учетные данные шифруются перед сохранением в базе данных и расшифровываются только при необходимости их использования в действиях, источниках данных и виджетах. -Подробнее о механизме работы, шифровании и настройке смотрите в [документации](../../admin/security/credentials/). +Подробнее о механизме работы, шифровании и настройке — [в документации](../../admin/security/credentials/). ## Заполнение учётных данных From f4735ebef79cc59eb3b664a63fd892a3c048073c Mon Sep 17 00:00:00 2001 From: Anastasia Sidorok Date: Wed, 25 Mar 2026 16:49:41 +0300 Subject: [PATCH 8/8] Update catalog.ru.md Signed-off-by: Anastasia Sidorok --- content/documentation/user/catalog.ru.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/documentation/user/catalog.ru.md b/content/documentation/user/catalog.ru.md index caedaee..1bbf56c 100644 --- a/content/documentation/user/catalog.ru.md +++ b/content/documentation/user/catalog.ru.md @@ -26,11 +26,11 @@ weight: 30 Для создания группы ресурсов необходимо: -- **Создать ресурсы** — создать все необходимые ресурсы, которые будут входить в группу. Например, ресурс «Gitlab» может быть родительским для ресурсов «Репозитории», «Группы» и т.д. +1. **Создать ресурсы** — создать все необходимые ресурсы, которые будут входить в группу. Например, ресурс «Gitlab» может быть родительским для ресурсов «Репозитории», «Группы» и т.д. -- **Связать дочерние ресурсы с родительскими** — в сайдбаре каталога перетащить дочерний ресурс на родительский ресурс. Дочерние ресурсы будут автоматически привязаны к родительскому и отобразятся в интерфейсе как вложенные элементы. +1. **Связать дочерние ресурсы с родительскими** — в сайдбаре каталога перетащить дочерний ресурс на родительский ресурс. Дочерние ресурсы будут автоматически привязаны к родительскому и отобразятся в интерфейсе как вложенные элементы. -- **Настроить отображение** — в сайдбаре каталога родительские ресурсы отображаются с иконкой раскрытия/сворачивания, позволяющей показывать или скрывать дочерние элементы. +1. **Настроить отображение** — в сайдбаре каталога родительские ресурсы отображаются с иконкой раскрытия/сворачивания, позволяющей показывать или скрывать дочерние элементы. {{< alert level="info" >}} Для изменения группировки ресурсов (перетаскивания ресурсов в сайдбаре каталога) требуется глобальное разрешение `update:resources-order`. Подробнее о правах доступа — в разделе [«Ролевая модель»](../../admin/security/rbac/).