documentation

Publier un agent

Choisissez le point d'entrée adapté à votre public sans changer le contrat, les versions ni les traces de l'agent.

Faire coopérer les agents#

MCP et A2A servent à faire dialoguer vos agents avec des systèmes externes. Entre les agents d'une même équipe orangeforge.ai, cette façade n'est pas nécessaire : la coordination est intégrée aux runtimes Worker et Mission.

call_agent invoque un agent Worker et attend sa réponse dans le run courant.
start_mission lance une mission asynchrone et rend immédiatement son identifiant.
check_mission suit son état et récupère ses livrables.

Chaque délégation est signée par la plateforme ; le code de l'agent ne reçoit donc aucune clé API d'équipe. La chaîne conserve sa racine, son parent et sa profondeur afin que les appels restent reconstituables dans les traces. Elle est limitée à cinq niveaux et les cycles sont refusés. Chaque enfant reste compté et facturé comme un run ordinaire.

Le prompt et le code de l'agent décident quand déléguer et comment réagir à un échec. La plateforme sécurise et trace la coordination, mais ne réessaie pas une étape à leur place.

Essayer l'agent public#

La démonstration horaires-demo utilise réellement les quatre accès de production :

ouvrir le Chat publié pour converser sans installation ;
tester la même question via HTTPS depuis le mini-chat de la landing ;
connecter un client MCP à https://mcp.agent-forge.cc/mcp/xp_40112278877c704b5ac8dac1 avec une clé d'exposition ;
ouvrir sa carte Agent A2A, puis utiliser son URL d'invocation.

Configuration MCP minimale :

{
  "url": "https://mcp.agent-forge.cc/mcp/xp_40112278877c704b5ac8dac1",
  "headers": { "x-api-key": "<EXPOSURE_KEY>" }
}

Le Chat et la démo HTTPS sont accessibles immédiatement. MCP et l'invocation A2A demandent une clé d'exposition : l'identifiant public présent dans l'URL n'est pas un secret et ne suffit pas à autoriser un appel. La carte A2A reste consultable sans clé pour permettre la découverte.

Choisir le canal#

Un agent activé conserve le même contrat, les mêmes versions et les mêmes traces quel que soit son point d'entrée.

Besoin	Accès	Credential
Une conversation à partager ou intégrer	Chat publié	Session anonyme, magic link ou identité signée du site hôte
Un tool dans un client IA compatible	MCP	Clé d'exposition fex_…
Un agent distant pour un orchestrateur	A2A	Clé d'exposition fex_…
Une intégration serveur sur mesure	HTTPS	Clé API d'équipe fak_…

Publier un Chat#

Dans forge ui, ouvrez le projet puis Chats. Créez une surface, choisissez ses agents, son mode d'accès, ses budgets, sa rétention et les origines autorisées, puis publiez-la.

L'administration fournit une URL autonome :

https://chat.agent-forge.cc/c/<publicId>

et un widget :

<script
  src="https://chat.agent-forge.cc/widget.js"
  data-surface="<publicId>"
  async
></script>

Une surface anonyme reçoit un pseudonyme propre au navigateur. Une surface authentifiée utilise un magic link ou une identité courte signée par le backend du site hôte. Le navigateur ne reçoit jamais une clé API d'équipe.

Exposer via MCP et A2A#

Dans forge ui, ouvrez Exposition. Créez une exposition, sélectionnez les agents Worker contractés, activez MCP et/ou A2A, puis publiez.

Créez ensuite une clé d'exposition fex_…. Elle n'est affichée qu'une fois, n'ouvre que cette exposition et peut être révoquée immédiatement. Ce n'est pas une clé API de votre compte.

Un agent qui peut écrire dans un service externe ou traiter une capacité sensible exige un opt-in administrateur explicite. MCP et A2A V1 ne relaient pas la confirmation d'un utilisateur final.

Connecter un client MCP#

L'interface d'administration fournit l'endpoint et la commande adaptés à l'exposition :

claude mcp add --transport http forge-<publicId> https://mcp.agent-forge.cc/mcp/<publicId> --header "x-api-key: fex_…"

Le serveur publie un tool par agent contracté. Les paramètres viennent du contrat d'entrée versionné ; chaque appel reste compté et tracé comme un run ordinaire.

Connecter un client A2A#

A2A V1 expose une carte par agent :

https://mcp.agent-forge.cc/a2a/<publicId>/<slug>/.well-known/agent-card.json

L'invocation JSON-RPC se fait sur :

https://mcp.agent-forge.cc/a2a/<publicId>/<slug>

Ce profil A2A 0.3 est synchrone. Les tasks longues, le streaming A2A et l'interface A2A 1.0 ne font pas partie de cette version.

Appeler l'API HTTPS#

Pour une intégration serveur sur mesure, invoquez directement l'agent activé :

curl -N https://agents.agent-forge.cc/mon-agent/invoke \
  -H "x-api-key: fak_…" \
  -H "content-type: application/json" \
  -d '{"query":"..."}'

La clé fak_… ouvre les agents de l'équipe : gardez-la côté serveur. Une clé fex_… est volontairement refusée par cet endpoint direct.

Identité et contrôle communs#

Le Chat peut porter l'identité d'un utilisateur final. MCP et A2A V1 authentifient le client avec une clé d'exposition, mais ne transmettent pas encore l'identité de la personne qui utilise ce client.

Tous les accès conservent les contrats d'entrée, les versions actives, le comptage, les runs et les traces. Désactiver une surface ou révoquer sa clé coupe son accès sans modifier les fichiers de l'agent.