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

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

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

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

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

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

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

1. Создайте группу

   Откройте Data Actions в левом меню и создайте группу для подключаемой системы. Укажите базовый адрес и, если API требует учётные данные, добавьте их здесь — они хранятся в группе и не повторяются для каждого действия.

2. Добавьте действия или импортируйте их

   Добавляйте эндпоинты по одному или воспользуйтесь Import from OpenAPI, чтобы Pommy прочитал документ. Импортированные действия приходят выключенными, чтобы вы могли проверить их до запуска.

3. Включите то, чем может пользоваться ассистент

   У каждого действия свой переключатель, у группы — тоже. Включайте только то, что этому ассистенту действительно нужно: выключенное действие для него невидимо.

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

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

Проверка#

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