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
38 changes: 21 additions & 17 deletions content/documentation/user/ai-assistant.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -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-ассистент.
Comment thread
asidorok-NS marked this conversation as resolved.

### Учетные данные для провайдеров

Expand All @@ -34,7 +36,8 @@ AI-ассистент использует настраиваемые AI-про
- **Значение**: сам токен или ключ доступа.
1. Нажмите **Сохранить**.

**Важно:**
#### Изменение учетных данных

- Ключ существующих учетных данных нельзя изменить. Для изменения ключа удалите старые учетные данные и создайте новые.
- Значение существующих учетных данных можно обновить, введя новое значение.
- Учетные данные шифруются при сохранении и никогда не передаются в веб-интерфейс после сохранения.
Expand Down Expand Up @@ -193,20 +196,21 @@ choices.0.message.content
}
```

**Важно:**
#### Особенности подготовки шаблона

- Шаблон должен быть валидным JSON.
- Переменные `{{.prompt}}` и `{{.model}}` будут автоматически заменены при отправке запроса.
- Значение `{{.prompt}}` автоматически экранируется для безопасной вставки в JSON.
- Вы можете добавить любые дополнительные поля, необходимые для вашего API (temperature, max_tokens, и т.д.).

**Пример полной настройки кастомного провайдера:**

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 }}
Expand Down Expand Up @@ -262,9 +266,9 @@ AI-ассистент использует инструменты MCP (Model Con

### Особенности работы

1. **Анализ данных**: AI-ассистент не просто возвращает сырые данные, а анализирует их и предоставляет структурированные ответы.
1. **Фильтрация**: Вы можете запрашивать данные с условиями, и ассистент выполнит фильтрацию.
1. **Агрегация**: Ассистент может подсчитывать количество, группировать данные и предоставлять статистику.
- **Анализ данных**: AI-ассистент не просто возвращает сырые данные, а анализирует их и предоставляет структурированные ответы.
- **Фильтрация**: Вы можете запрашивать данные с условиями, и ассистент выполнит фильтрацию.
- **Агрегация**: Ассистент может подсчитывать количество, группировать данные и предоставлять статистику.

### Отладка

Expand Down Expand Up @@ -296,6 +300,6 @@ AI-ассистент использует инструменты MCP (Model Con

## Рекомендации

1. **Используйте конкретные вопросы**: Чем конкретнее вопрос, тем точнее будет ответ.
1. **Указывайте параметры явно**: Если вы знаете название ресурса или параметр, укажите его в вопросе.
1. **Экспериментируйте**: AI-ассистент понимает естественный язык, пробуйте разные формулировки вопросов.
- **Используйте конкретные вопросы**: Чем конкретнее вопрос, тем точнее будет ответ.
- **Указывайте параметры явно**: Если вы знаете название ресурса или параметр, укажите его в вопросе.
- **Экспериментируйте**: AI-ассистент понимает естественный язык, пробуйте разные формулировки вопросов.
21 changes: 13 additions & 8 deletions content/documentation/user/catalog.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,9 +28,9 @@ weight: 30

1. **Создать ресурсы** — создать все необходимые ресурсы, которые будут входить в группу. Например, ресурс «Gitlab» может быть родительским для ресурсов «Репозитории», «Группы» и т.д.

2. **Связать дочерние ресурсы с родительскими** — в сайдбаре каталога перетащить дочерний ресурс на родительский ресурс. Дочерние ресурсы будут автоматически привязаны к родительскому и отобразятся в интерфейсе как вложенные элементы.
1. **Связать дочерние ресурсы с родительскими** — в сайдбаре каталога перетащить дочерний ресурс на родительский ресурс. Дочерние ресурсы будут автоматически привязаны к родительскому и отобразятся в интерфейсе как вложенные элементы.

3. **Настроить отображение** — в сайдбаре каталога родительские ресурсы отображаются с иконкой раскрытия/сворачивания, позволяющей показывать или скрывать дочерние элементы.
1. **Настроить отображение** — в сайдбаре каталога родительские ресурсы отображаются с иконкой раскрытия/сворачивания, позволяющей показывать или скрывать дочерние элементы.

{{< alert level="info" >}}
Для изменения группировки ресурсов (перетаскивания ресурсов в сайдбаре каталога) требуется глобальное разрешение `update:resources-order`. Подробнее о правах доступа — в разделе [«Ролевая модель»](../../admin/security/rbac/).
Expand Down Expand Up @@ -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 >}}
2 changes: 1 addition & 1 deletion content/documentation/user/credentials.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ moduleStatus: experimental

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

Подробнее о механизме работы, шифровании и настройке см. в [документации](../../admin/security/credentials/).
Подробнее о механизме работы, шифровании и настройке — [в документации](../../admin/security/credentials/).

## Заполнение учётных данных

Expand Down
2 changes: 1 addition & 1 deletion content/documentation/user/templating.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -500,7 +500,7 @@ title: Шаблонизация

## Хранилище процесса

Хранилище доступно только в процессах и используется для передачи данных между действиями. В настройках действия задаются правила записи в хранилище (см. [«Запись в хранилище процесса»](../../admin/actions/overview/#запись-в-хранилище-процесса)), а в конфигурации последующих действий используются плейсхолдеры для чтения данных.
Хранилище доступно только в процессах и используется для передачи данных между действиями. В настройках действия задаются правила записи в хранилище (подробнее — в разделе [«Запись в хранилище процесса»](../../admin/actions/overview/#запись-в-хранилище-процесса)), а в конфигурации последующих действий используются плейсхолдеры для чтения данных.

Для получения значения из хранилища используйте следующую конструкцию:

Expand Down
Loading