Aller au contenu principal
ActionFlows AI
Gateways

Appelez vos agents et vos flows

Concevez les agents et les flows dans l'app. Appelez-les via REST, le SDK TypeScript, le MCP hébergé, des webhooks ou une page publique.

REST APILibrairies SDK
Gateways

Développez, connectez et partagez votre travail

Construisez avec du code. Connectez via MCP et webhooks. Partagez avec une page publique. La conception reste dans l'app.

Développer

REST API
Lancez des runs et des sessions d'agent depuis votre backend. Référence OpenAPI complète dans les docs.
Librairies SDK
Le SDK TypeScript démarre les exécutions d'ActionFlow. Le chat de l'agent utilise un client compatible OpenAI, pas un widget à intégrer.

Connecter

Serveur MCP hébergé
Appelez vos agents et flux comme des outils depuis n'importe quel client MCP. Hébergé par ActionFlows. Séparé du catalogue MCP tiers.
Webhooks entrants
Un webhook entrant démarre un flow. Un webhook d'organisation envoie des événements d'exécution signés à votre URL. Ce sont des produits différents.

Partager

Landings d'agents
Une page publique pour un agent. Qui peut l'essayer et la copier est expliqué sur Landings.
Landings de flux
Une page publique pour un flow. Qui peut l'essayer et la copier est expliqué sur Landings.

Quel chemin convient

Vous concevez l'agent ou le flow dans l'app. Ces chemins découvrent, exécutent ou discutent. Ils ne modifient pas le graphe. Gardez les clés API dans un backend ou dans une configuration MCP dont les secrets sont gérés.

CheminÀ utiliser quandAuth et streaming
REST backendVotre serveur démarre un flow enregistré avec POST /api/runs.Clé API Bearer. 201 ou 202 admet l'exécution. Interrogez Get Run pour le résultat. Il n'y a pas de route /run par flow.
SDK de flow TypeScriptLe même démarrage d'exécution depuis TypeScript.Clé API sur le serveur. La même admission 201 et 202. Le stream d'exécution est un appel REST ou SDK séparé.
Chat de l'agentVotre backend discute avec un agent actif.POST /v1/chat/completions. Client compatible OpenAI. stream true envoie du SSE. Pas de widget d'intégration dans le SDK.
MCP hébergéUn client MCP liste et appelle vos agents et vos flows.Clé API dans la configuration MCP. Le MCP hébergé ne streame pas. Utilisez REST ou le SDK pour le SSE en direct. Ce n'est pas le catalogue MCP tiers.
Webhook entrantUn autre système envoie un POST à une URL de flow pour démarrer une exécution.Le flow doit être actif, sinon le gestionnaire renvoie 409. Ce n'est pas un déclencheur de canal d'agent.
Webhook d'événement sortantVotre URL reçoit flow.run.started, flow.run.succeeded ou flow.run.failed signés.Enregistrez-le sous Organization, Webhooks. Vérifiez X-ActionFlows-Signature. Cela ne démarre pas une exécution.
Page publiqueUne personne ouvre un flow ou un agent publié. Voir Landings.Pas de clé API sur cette page. Les règles d'essai et de copie sont sur Landings, pas ici.

D'un appel API à un résultat

  1. 01

    POST /api/runs avec payload.organizationId, payload.actionFlowId et des entrées formées de l'id de nœud, d'un tiret bas et du nom de l'entrée, comme dans node_abc_prompt.

  2. 02

    201 signifie envoyée. 202 signifie en file. Conservez l'id d'exécution ou l'id de file. Aucun des deux statuts ne signifie que le graphe est terminé.

  3. 03

    Lisez l'exécution dans l'historique ou avec Get Run. Pour un élément en file, interrogez l'id de file jusqu'à ce qu'un id de trigger run soit présent.

Questions sur l’accès programmatique

Une exécution consomme des crédits de l'organisation. La durée de conservation des journaux et les autres limites suivent votre plan. Voir les tarifs

Démarrez une exécution depuis votre app

Créez une clé API, gardez-la sur le serveur et envoyez POST /api/runs. Lisez ensuite l'exécution. La conception reste dans l'app.

Démarrage rapideRéférence Trigger Run