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
10 changes: 5 additions & 5 deletions content/documentation/release-notes/v1.1.0.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,20 +71,20 @@ weight: 980

## Новые возможности

### AI-агент и MCP-сервер
### AI-ассистент и MCP-сервер

{{< alert level="warning" >}}
Экспериментальный функционал
{{< /alert >}}

Добавлена поддержка AI-агента и MCP-сервера для интеграции с внешними AI моделями и клиентами.
Добавлена поддержка AI-ассистента и MCP-сервера для интеграции с внешними AI моделями и клиентами.

#### AI-агент
#### AI-ассистент

**AI-агент** — интеллектуальный помощник, интегрированный в интерфейс платформы, который предоставляет пользователям доступ к AI-моделям через удобный чат-интерфейс ([подробнее](../../user/ai-agent/)):
**AI-ассистент** — интеллектуальный помощник, интегрированный в интерфейс платформы, который предоставляет пользователям доступ к AI-моделям через удобный чат-интерфейс ([подробнее](../../user/ai-assistant/)):

- **Настраиваемые провайдеры** — поддержка различных AI-провайдеров (OpenAI, локальные модели и др.).
- **Интеграция с MCP инструментами** — AI-агент автоматически использует доступные инструменты MCP-сервера для выполнения запросов.
- **Интеграция с MCP инструментами** — AI-ассистент автоматически использует доступные инструменты MCP-сервера для выполнения запросов.

#### MCP-сервер

Expand Down
4 changes: 2 additions & 2 deletions content/documentation/release-notes/v1.2.0.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,9 +15,9 @@ weight: 960

## Новые возможности

### AI-агент
### AI-ассистент

Добавлен механизм безопасного хранения учетных данных для AI-провайдеров ([подробнее](../../user/ai-agent/#учетные-данные-для-провайдеров)).
Добавлен механизм безопасного хранения учетных данных для AI-провайдеров ([подробнее](../../user/ai-assistant/#учетные-данные-для-провайдеров)).

### Действия

Expand Down
4 changes: 2 additions & 2 deletions content/documentation/release-notes/v1.4.0.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,10 +29,10 @@ CREATE EXTENSION IF NOT EXISTS pg_trgm;

## Новые возможности

### AI-агент и MCP-сервер
### AI-ассистент и MCP-сервер

- Добавлены инструменты MCP: `get_resources`, `get_external_services`, `get_datasources`, `get_processes`. Список инструментов и параметры описаны в [документации MCP-сервера](../../user/mcp-server/).
- AI-агент теперь поддерживает множественный вызов инструментов в одном запросе ([AI-агент](../../user/ai-agent/)).
- AI-ассистент теперь поддерживает множественный вызов инструментов в одном запросе ([AI-ассистент](../../user/ai-assistant/)).

### Доверенные сертификаты

Expand Down
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
---
title: AI-агент
title: AI-ассистент
---

{{< alert level="warning" >}}
Экспериментальный функционал
{{< /alert >}}

AI-агент — это интеллектуальный помощник, встроенный в Deckhouse Development Platform. Он отвечает на вопросы о платформе, анализирует данные каталога и выполняет различные задачи с использованием инструментов MCP (Model Context Protocol).
AI-агент использует настраиваемые AI-провайдеры для обработки запросов и может работать с различными языковыми моделями, включая OpenAI GPT, Ollama и любые модели, доступные через совместимый REST API.
AI-ассистент — это интеллектуальный помощник, встроенный в Deckhouse Development Platform. Он отвечает на вопросы о платформе, анализирует данные каталога и выполняет различные задачи с использованием инструментов MCP (Model Context Protocol).
AI-ассистент использует настраиваемые AI-провайдеры для обработки запросов и может работать с различными языковыми моделями, включая OpenAI GPT, Ollama и любые модели, доступные через совместимый REST API.

## Настройка AI-провайдеров

Expand All @@ -17,7 +17,7 @@ AI-агент использует настраиваемые AI-провайд

1. **OpenAI** — для работы с моделями OpenAI (GPT-4, GPT-3.5 и др.).
1. **Ollama** — для работы с локальными моделями через Ollama.
1. **Custom** — для работы с любым кастомным REST API, совместимым с форматом запросов/ответов AI-агента.
1. **Custom** — для работы с любым кастомным REST API, совместимым с форматом запросов/ответов AI-ассистент.

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

Expand Down Expand Up @@ -232,19 +232,19 @@ choices.0.message.content
}
```

## Работа с AI-агентом
## Работа с AI-ассистентом

### Открытие чата

AI-агент доступен через боковую панель чата в правой части интерфейса. Для открытия чата нажмите на кнопку чата в правом нижнем углу экрана.
AI-ассистент доступен через боковую панель чата в правой части интерфейса. Для открытия чата нажмите на кнопку чата в правом нижнем углу экрана.

### Выбор провайдера

В верхней части чата находится селектор провайдеров. Выберите нужный провайдер из списка доступных. Если у вас настроен только один провайдер, он будет выбран автоматически.

### Доступные инструменты (MCP Tools)

AI-агент использует инструменты MCP (Model Context Protocol) для работы с платформой. Полный список с описанием, параметрами и примерами приведён в [документации MCP-сервера](../user/mcp-server/).
AI-ассистент использует инструменты MCP (Model Context Protocol) для работы с платформой. Полный список с описанием, параметрами и примерами приведён в [документации MCP-сервера](../user/mcp-server/).

Модель при необходимости может вызвать несколько инструментов в рамках одного запроса.

Expand All @@ -262,13 +262,13 @@ AI-агент использует инструменты MCP (Model Context Pro

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

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

### Отладка

Если ответ агента кажется некорректным, вы можете просмотреть логи отладки, нажав на кнопку с иконкой вопроса рядом с ответом. Это поможет понять, какие инструменты были вызваны и какие данные были получены.
Если ответ ассистента кажется некорректным, вы можете просмотреть логи отладки, нажав на кнопку с иконкой вопроса рядом с ответом. Это поможет понять, какие инструменты были вызваны и какие данные были получены.

## Примеры использования

Expand All @@ -281,7 +281,7 @@ AI-агент использует инструменты MCP (Model Context Pro
```

**Результат:**
Агент использует инструменты MCP для получения данных о сервисах и возвращает список с названием и датой создания.
Ассистент использует инструменты MCP для получения данных о сервисах и возвращает список с названием и датой создания.

### Пример 2: Список действий

Expand All @@ -292,10 +292,10 @@ AI-агент использует инструменты MCP (Model Context Pro
```

**Результат:**
Агент вызовет инструмент MCP и вернёт список доступных действий платформы.
Ассистент вызовет инструмент MCP и вернёт список доступных действий платформы.

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

1. **Используйте конкретные вопросы**: Чем конкретнее вопрос, тем точнее будет ответ.
1. **Указывайте параметры явно**: Если вы знаете название ресурса или параметр, укажите его в вопросе.
1. **Экспериментируйте**: AI-агент понимает естественный язык, пробуйте разные формулировки вопросов.
1. **Экспериментируйте**: AI-ассистент понимает естественный язык, пробуйте разные формулировки вопросов.
Loading