diff --git a/content/documentation/user/ai-assistant.ru.md b/content/documentation/user/ai-assistant.ru.md index e0733cf..dd001a3 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,7 +36,8 @@ AI-ассистент использует настраиваемые AI-про - **Значение**: сам токен или ключ доступа. 1. Нажмите **Сохранить**. -**Важно:** +#### Изменение учетных данных + - Ключ существующих учетных данных нельзя изменить. Для изменения ключа удалите старые учетные данные и создайте новые. - Значение существующих учетных данных можно обновить, введя новое значение. - Учетные данные шифруются при сохранении и никогда не передаются в веб-интерфейс после сохранения. @@ -193,7 +196,8 @@ choices.0.message.content } ``` -**Важно:** +#### Особенности подготовки шаблона + - Шаблон должен быть валидным JSON. - Переменные `{{.prompt}}` и `{{.model}}` будут автоматически заменены при отправке запроса. - Значение `{{.prompt}}` автоматически экранируется для безопасной вставки в JSON. @@ -201,12 +205,12 @@ choices.0.message.content **Пример полной настройки кастомного провайдера:** -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 0668172..1bbf56c 100644 --- a/content/documentation/user/catalog.ru.md +++ b/content/documentation/user/catalog.ru.md @@ -28,9 +28,9 @@ weight: 30 1. **Создать ресурсы** — создать все необходимые ресурсы, которые будут входить в группу. Например, ресурс «Gitlab» может быть родительским для ресурсов «Репозитории», «Группы» и т.д. -2. **Связать дочерние ресурсы с родительскими** — в сайдбаре каталога перетащить дочерний ресурс на родительский ресурс. Дочерние ресурсы будут автоматически привязаны к родительскому и отобразятся в интерфейсе как вложенные элементы. +1. **Связать дочерние ресурсы с родительскими** — в сайдбаре каталога перетащить дочерний ресурс на родительский ресурс. Дочерние ресурсы будут автоматически привязаны к родительскому и отобразятся в интерфейсе как вложенные элементы. -3. **Настроить отображение** — в сайдбаре каталога родительские ресурсы отображаются с иконкой раскрытия/сворачивания, позволяющей показывать или скрывать дочерние элементы. +1. **Настроить отображение** — в сайдбаре каталога родительские ресурсы отображаются с иконкой раскрытия/сворачивания, позволяющей показывать или скрывать дочерние элементы. {{< alert level="info" >}} Для изменения группировки ресурсов (перетаскивания ресурсов в сайдбаре каталога) требуется глобальное разрешение `update:resources-order`. Подробнее о правах доступа — в разделе [«Ролевая модель»](../../admin/security/rbac/). @@ -106,18 +106,23 @@ weight: 30 Для выгрузки сущностей конкретного ресурса: 1. Откройте карточку ресурса в каталоге. -2. В таблице сущностей нажмите кнопку **Скачать .csv**. -3. В выгруженный файл будут включены все сущности ресурса с учетом примененных фильтров, сортировки и пагинации. + +1. В таблице сущностей нажмите кнопку **Скачать .csv**. + +1. В выгруженный файл будут включены все сущности ресурса с учетом примененных фильтров, сортировки и пагинации. #### Выгрузка сущностей нескольких ресурсов Для выгрузки сущностей из нескольких ресурсов одновременно: 1. В сайдбаре каталога нажмите кнопку **Выгрузить сущности**. -2. В открывшемся диалоге выберите один или несколько ресурсов. -3. Нажмите кнопку **Скачать .csv**. -4. Все сущности выбранных ресурсов будут объединены в один CSV-файл. + +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..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/). ## Заполнение учётных данных diff --git a/content/documentation/user/templating.ru.md b/content/documentation/user/templating.ru.md index 273803c..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/#запись-в-хранилище-процесса)), а в конфигурации последующих действий используются плейсхолдеры для чтения данных. Для получения значения из хранилища используйте следующую конструкцию: