Esta página é uma tradução da documentação em inglês. Comandos, identificadores e exemplos permanecem iguais. Runtime 7.24.4 · SDK 2.6.7. Original em inglês

Caminho feliz do ACP (Agent Client Protocol)

Status: Ativo
Escopo: caminho feliz documentado para hosts de IDE
Última revisão: 2026-07-12 Responsável: AX Code runtime

O AX Code expõe um servidor ACP para que IDEs (por exemplo, o Zed) hospedem o agente sem um transporte personalizado.

Requisitos

• Instalação da CLI com suporte (ax-code no PATH)
• Um provedor configurado (ax-code providers login ou chaves de ambiente)

Iniciar o servidor

# Current directory as workspace
ax-code acp

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

Inicializar, sessão e prompt (stdio)

O ACP é JSON-RPC sobre stdio. Caminho feliz mínimo:

# 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

Sequência típica do host:

1. initialize — negociar a versão do protocolo e as capacidades do agente
2. session/new — criar uma sessão com cwd definido como a raiz do projeto
3. session/prompt — enviar o texto do usuário; o agente executa ferramentas e devolve um motivo de parada
4. session/load — retomar um id de sessão conhecido pelo host

Exemplo no Zed

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

O que funciona hoje

Detalhes e limitações: packages/ax-code/src/acp/README.md.

Perguntas interativas opcionais

AX_CODE_ENABLE_QUESTION_TOOL=1 ax-code acp

Ative somente quando a interface do host puder responder aos prompts de pergunta.