Data Actions: sua própria API como ferramenta
Transforme um endpoint que você já tem em algo que o assistente pode chamar.
Data Actions serve para aquilo que seus clientes perguntam e nenhum documento responde: "onde está meu pedido?", "quantas unidades restam no estoque?", "minha assinatura ainda está ativa?". A resposta está no seu próprio sistema, atrás de uma API. Uma Data Action é esse endpoint, descrito uma vez, para que o assistente possa chamá-lo no meio da conversa e responder com o número real.
Dica: Não tem uma API própria? Pule esta página. O assistente é completo sem ela — isto é para equipes cujos sistemas já falam HTTP.
Como isso difere de API Connections#
Os dois dão ferramentas ao assistente; a diferença é quem roda o servidor. API Connections conecta um servidor MCP que já existe e expõe as próprias ferramentas. Data Actions é para quando não existe esse servidor: você descreve seus endpoints aqui e o Pommy os apresenta ao assistente como ferramentas. Se sua API tem um documento OpenAPI, você não descreve nada à mão — importe e os endpoints chegam como um grupo.
Grupos e ações#
As ações ficam em grupos. Um grupo é um sistema — "API de pedidos", "Estoque" — com o próprio endereço base e, se precisar, a própria autenticação. Dentro dele, cada ação é um único endpoint: um nome que o assistente vê, uma descrição de quando usá-la, o método e o caminho, e os parâmetros. Escreva a descrição para o assistente, não para um desenvolvedor: é a única coisa que diz a ele *quando* essa ação é a certa.
Adicionando uma ação#
- Crie um grupo
Abra Data Actions no menu à esquerda e crie um grupo para o sistema que você está conectando. Informe o endereço base e, se a API exigir credenciais, adicione-as aqui — elas ficam guardadas no grupo, sem repetir em cada ação.
- Adicione ações ou importe
Adicione endpoints um a um ou use Import from OpenAPI e deixe o Pommy ler o documento. As ações importadas chegam desativadas, para você revisar antes que algo entre no ar.
- Ative o que o assistente pode usar
Cada ação tem o próprio interruptor, e o grupo também. Ative só o que este assistente realmente precisa — uma ação desativada é invisível para ele.
Ações que precisam saber quem está perguntando#
Algumas respostas são pessoais — um pedido pertence a um cliente. Um grupo pode ser marcado como exigindo identidade, e então suas ações só rodam quando a conversa tem um visitante verificado. É isso que impede um estranho de perguntar sobre o pedido de outra pessoa.
Atenção: Uma Data Action roda no seu sistema em produção com as credenciais que você deu ao grupo. Comece com endpoints somente leitura; adicione qualquer coisa que grave dados só depois de ver os de leitura funcionando bem.
Testando#
Depois de ativar uma ação, faça a pergunta que um cliente faria — no widget, com as palavras dele, não com o nome do endpoint. Se o assistente responder com dados do seu sistema, a descrição está cumprindo seu papel. Se ele ignorar a ação, geralmente a descrição é o motivo: diga claramente o que a ação responde e quando usá-la.