Data Actions: tu propia API como herramienta
Convierte un endpoint que ya tienes en algo que el asistente puede llamar.
Data Actions (acciones de datos) sirve para lo que preguntan tus clientes y ningún documento puede responder: "¿dónde está mi pedido?", "¿cuántas unidades quedan en el almacén?", "¿sigue activa mi membresía?". La respuesta está en tu propio sistema, detrás de una API. Una Data Action es ese endpoint, descrito una vez, para que el asistente pueda llamarlo en mitad de la conversación y responder con el dato real.
Consejo: ¿No tienes una API propia? Sáltate esta página. El asistente está completo sin ella: esto es para equipos cuyos sistemas ya hablan HTTP.
En qué se diferencia de API Connections#
Las dos dan herramientas al asistente; la diferencia es quién gestiona el servidor. API Connections conecta un servidor MCP que ya existe y expone sus propias herramientas. Data Actions es para cuando no hay tal servidor: describes tus endpoints aquí y Pommy se los presenta al asistente como herramientas. Si tu API tiene un documento OpenAPI, no describes nada a mano: lo importas y los endpoints llegan como un grupo.
Grupos y acciones#
Las acciones viven en grupos. Un grupo es un sistema —"API de pedidos", "Almacén"— con su propia dirección base y, si la necesita, su propia autenticación. Dentro, cada acción es un único endpoint: un nombre que ve el asistente, una descripción de cuándo usarla, el método y la ruta, y los parámetros. Escribe la descripción para el asistente, no para un desarrollador: es lo único que le dice *cuándo* es la acción adecuada.
Añadir una#
- Crea un grupo
Abre Data Actions en el menú de la izquierda y crea un grupo para el sistema que vas a conectar. Indica la dirección base y, si la API necesita credenciales, añádelas aquí: se guardan con el grupo, no se repiten en cada acción.
- Añade acciones o impórtalas
Añade los endpoints uno a uno o usa Import from OpenAPI (importar desde OpenAPI) y deja que Pommy lea el documento. Las acciones importadas llegan desactivadas para que puedas revisarlas antes de que nada esté en vivo.
- Activa lo que puede usar el asistente
Cada acción tiene su propio interruptor, y el grupo también. Activa solo lo que este asistente necesita de verdad: una acción desactivada es invisible para él.
Acciones que necesitan saber quién pregunta#
Algunas respuestas son personales: un pedido pertenece a un cliente. Un grupo puede marcarse como requiring identity (requiere identidad), y entonces sus acciones solo se ejecutan cuando la conversación tiene un visitante verificado. Esto es lo que impide que un desconocido pregunte por el pedido de otra persona.
Atención: Una Data Action se ejecuta contra tu sistema real con las credenciales que diste al grupo. Empieza con endpoints de solo lectura; añade cualquier cosa que escriba datos solo cuando hayas visto que los de lectura funcionan bien.
Probarla#
Después de activar una acción, haz la pregunta que haría un cliente: en el widget, con sus palabras, no con el nombre del endpoint. Si el asistente responde con datos de tu sistema, la descripción está cumpliendo su función. Si ignora la acción, el motivo suele ser la descripción: di claramente qué responde la acción y cuándo debe usarse.