# Data Actions: ваш API как инструмент

> ИИ-ассистент · Превратите уже существующий эндпоинт в инструмент, который может вызывать ассистент.

**Data Actions** нужны для вопросов клиентов, на которые не ответит ни один документ: «где мой заказ?», «сколько осталось на складе?», «моё членство ещё действует?». Ответ хранится в вашей собственной системе, за API. Data Action — это такой эндпоинт, описанный один раз, чтобы ассистент мог вызвать его прямо в разговоре и ответить реальной цифрой.

> **Совет:** Своего API нет? Пропустите эту страницу. Ассистент полноценен и без этого — раздел для команд, чьи системы уже работают по HTTP.

## Чем это отличается от API Connections

Оба способа дают ассистенту инструменты; разница в том, кто держит сервер. **API Connections** подключает уже существующий MCP-сервер, который сам предоставляет свои инструменты. **Data Actions** — для случаев, когда такого сервера нет: вы описываете здесь свои эндпоинты, а Pommy представляет их ассистенту как инструменты. Если у вашего API есть документ **OpenAPI**, ничего описывать вручную не нужно — импортируйте его, и эндпоинты появятся группой.

## Группы и действия

Действия хранятся в **группах**. Группа — это одна система («Order API», «Склад») со своим базовым адресом и, если нужно, своей аутентификацией. Внутри неё каждое действие — отдельный эндпоинт: имя, которое видит ассистент, описание того, когда его использовать, метод и путь, а также параметры. Пишите описание для ассистента, а не для разработчика: только оно подсказывает ему, *когда* именно это действие подходит.

## Как добавить действие

1. **Создайте группу** — Откройте **Data Actions** в левом меню и создайте группу для подключаемой системы. Укажите базовый адрес и, если API требует учётные данные, добавьте их здесь — они хранятся в группе и не повторяются для каждого действия.
2. **Добавьте действия или импортируйте их** — Добавляйте эндпоинты по одному или воспользуйтесь **Import from OpenAPI**, чтобы Pommy прочитал документ. Импортированные действия приходят выключенными, чтобы вы могли проверить их до запуска.
3. **Включите то, чем может пользоваться ассистент** — У каждого действия свой переключатель, у группы — тоже. Включайте только то, что этому ассистенту действительно нужно: выключенное действие для него невидимо.

## Действия, которым нужно знать, кто спрашивает

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

> **Внимание:** Data Action работает с вашей рабочей системой, используя учётные данные, которые вы указали в группе. Начните с эндпоинтов только для чтения; то, что записывает данные, добавляйте, лишь убедившись, что читающие работают как надо.

## Проверка

После включения действия задайте вопрос так, как спросил бы клиент, — в виджете, его словами, а не названием эндпоинта. Если ассистент отвечает данными из вашей системы, описание работает. Если он игнорирует действие, причина обычно в описании: прямо напишите, на какой вопрос отвечает действие и когда к нему обращаться.

---

Читать эту страницу на сайте: [Data Actions: ваш API как инструмент](/ru/docs/ai-assistant/data-actions)
