Llamadas y mensajes desde n8n, cron y scripts

Mensajes con la API REST

Cada acción es una petición HTTPS con tu clave de API ak_…. En agentring cloud la URL de tu relay está en el panel; si lo montas tú, es tu propio relay. Mandar un mensaje:

curl -s "$AGENTRING_RELAY_URL/v1/messages" \
  -H "Authorization: Bearer $AGENTRING_API_KEY" \
  -H 'content-type: application/json' \
  -d '{"text": "Copia de seguridad terminada"}'

Las respuestas llegan con GET /v1/messages?after=<msg_id>, o en directo por el WebSocket. En n8n son dos nodos HTTP Request; en el repo tienes un flujo de ejemplo.

Tu agente obtiene cuatro herramientas: send_message (una notificación que puedes contestar), get_replies (tus respuestas, esperando hasta una hora si hace falta), call (suena el móvil y la IA de voz habla contigo) y status.

Llamadas con IA de voz desde la CLI

Para una llamada con la IA de voz, usa la CLI de agentring (una llamada REST sola solo hace sonar el móvil: la voz necesita un worker en la sala, que es el daemon o la herramienta call del MCP):

# desde un clon del repo
uv tool install './daemon[voice]'
agentring init --relay <URL-del-relay> --api-key ak_…
# solo si lo montas tú (en cloud se empareja desde el panel):
agentring pair

agentring msg "Copia de seguridad nocturna terminada"
agentring call "Ha fallado la copia de seguridad nocturna" --ai

Desde n8n, lánzalo con un nodo Execute Command, o usa cualquier nodo cliente MCP contra la URL MCP alojada. call --ai --json imprime el resultado completo: transcripción, herramientas usadas y duración.

Tus scripts, como herramientas en una llamada

Pulsa Llamar al agente en la app y pregunta de viva voz. La IA de voz consulta a tus agentes con consult_agent: cada agente de ~/.agentring/agents.yaml es una herramienta. Ejecuta agentring serve --ai en la máquina donde viven.

agents:
  ops:
    description: Mis scripts de sistemas. Disco, copias, estado de servicios.
    command: [~/bin/ops-agent]   # sin "{task}": la tarea llega por stdin

Cualquier comando puede ser una herramienta para la IA de voz: la tarea entra como argumento o por stdin, y la salida estándar es la respuesta. command es una lista de argumentos, nunca una cadena de shell.

Pruébalo sin llamada: agentring agents ask ops "…". Si el agente tarda más de 20 segundos, la llamada sigue y la respuesta llega cuando está lista, o como mensaje si ya has colgado.

Ejemplos de mensajes

• Copia terminada: 42 GB, 3 min.
• El despliegue a producción espera aprobación. Responde «sí» para seguir.
• El disco del servidor de builds está al 95 %.

Preguntas frecuentes