Cette page est traduite de la documentation anglaise. Les commandes, identifiants et exemples sont inchangés. Runtime 7.24.4 · SDK 2.6.7. Source anglaise

Chemin nominal ACP (Agent Client Protocol)

Statut : actif
Portée : chemin nominal documenté pour les hôtes d’IDE
Dernière revue : 2026-07-12 Responsable : runtime AX Code

AX Code expose un serveur ACP afin que les IDE (par exemple Zed) puissent héberger l’agent sans transport personnalisé.

Exigences

• Installation CLI prise en charge (ax-code sur le PATH)
• Un fournisseur configuré (ax-code providers login ou des clés d’environnement)

Démarrer le serveur

# Current directory as workspace
ax-code acp

# Explicit workspace
ax-code acp --dir /path/to/project

Initialisation, session et invite (stdio)

ACP est du JSON-RPC sur stdio. Chemin nominal minimal :

# One-shot style example (hosts normally keep the process open)
printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":1,"clientCapabilities":{}}}' \
  | ax-code acp

Séquence typique de l’hôte :

1. initialize — négocier la version du protocole et les capacités de l’agent
2. session/new — créer une session avec cwd réglé sur la racine du projet
3. session/prompt — envoyer le texte de l’utilisateur ; l’agent exécute les outils et renvoie une raison d’arrêt
4. session/load — reprendre un identifiant de session connu de l’hôte

Exemple Zed

{
  "agent_servers": {
    "AX Code": {
      "command": "ax-code",
      "args": ["acp"]
    }
  }
}

Ce qui fonctionne aujourd'hui

Détails et limites : packages/ax-code/src/acp/README.md.

Questions interactives facultatives

AX_CODE_ENABLE_QUESTION_TOOL=1 ax-code acp

N’activez ceci que lorsque l’interface de l’hôte peut répondre aux invites de question.