Saltar al contenido principal
ActionFlows AI
Gateways

Llama a tus agents y flows

Diseña agents y flows en la app. Llámalos desde REST, el SDK de TypeScript, el MCP alojado, webhooks o una página pública.

REST APILibrerías SDK
Gateways

Desarrolla, conecta y comparte tu trabajo

Construye con código. Conecta por MCP y webhooks. Comparte con una página pública. El diseño se queda en la app.

Desarrollar

REST API
Inicia runs y sesiones de agent desde tu backend. Referencia OpenAPI completa en los docs.
Librerías SDK
El SDK de TypeScript inicia ejecuciones de ActionFlow. El chat del agent usa un cliente compatible con OpenAI, no un widget para incrustar.

Conectar

Servidor MCP alojado
Llama a tus agents y flujos como herramientas desde cualquier cliente MCP. Alojado por ActionFlows. Separado del catálogo MCP de terceros.
Webhooks entrantes
Un webhook entrante inicia un flow. Un webhook de organización envía eventos de run firmados a tu URL. Son productos distintos.

Compartir

Landings de agents
Una página pública para un agent. Quién puede probarla y copiarla se explica en Landings.
Landings de flujos
Una página pública para un flow. Quién puede probarla y copiarla se explica en Landings.

Qué camino encaja

Diseñas el agent o el flow en la app. Estos caminos descubren, ejecutan o chatean. No editan el grafo. Guarda las claves de API en un backend o en una configuración MCP con secretos gestionados.

CaminoÚsalo cuandoAuth y streaming
REST de backendTu servidor inicia un flow guardado con POST /api/runs.Clave de API Bearer. 201 o 202 admite el run. Consulta Get Run para el resultado. No hay una ruta /run por flow.
SDK de flow en TypeScriptEl mismo inicio de run desde TypeScript.Clave de API en el servidor. La misma admisión 201 y 202. El stream del run es una llamada REST o SDK aparte.
Chat del agentTu backend chatea con un agent activo.POST /v1/chat/completions. Cliente compatible con OpenAI. stream true envía SSE. No hay widget de incrustación en el SDK.
MCP alojadoUn cliente MCP lista y llama a tus agents y flows.Clave de API en la configuración MCP. El MCP alojado no hace streaming. Usa REST o el SDK para SSE en vivo. Esto no es el catálogo MCP de terceros.
Webhook entranteOtro sistema hace POST a una URL de flow para iniciar un run.El flow debe estar activo o el manejador responde 409. Esto no es un disparador de canal del agent.
Webhook de evento salienteTu URL recibe flow.run.started, flow.run.succeeded o flow.run.failed firmados.Regístralo en Organization, Webhooks. Verifica X-ActionFlows-Signature. Esto no inicia un run.
Página públicaUna persona abre un flow o agent publicado. Mira Landings.En esa página no hay clave de API. Las reglas de prueba y copia están en Landings, no aquí.

De una llamada de API a un resultado

  1. 01

    POST /api/runs con payload.organizationId, payload.actionFlowId y entradas con id de nodo, guion bajo y nombre de entrada, como en node_abc_prompt.

  2. 02

    201 significa despachado. 202 significa en cola. Guarda el id del run o el id de la cola. Ninguno de los dos estados significa que el grafo terminó.

  3. 03

    Lee el run en el historial o con Get Run. Para un elemento en cola, consulta el id de cola hasta que haya un id de trigger run.

Preguntas sobre acceso programático

Un run gasta créditos de la organización. El tiempo de almacenamiento de los registros y los demás límites siguen tu plan. Ver precios

Inicia un run desde tu app

Crea una clave de API, guárdala en el servidor y envía POST /api/runs. Luego lee el run. El diseño se queda en la app.

Inicio rápidoReferencia de Trigger Run