convez.ai
AgenteIntegração & APIsAvançado
STRRL

Eino ACP Provider

STRRL/eino-acp

Conecta agentes ACP-compatíveis ao Eino para IA em Go

Ver no GitHub
InicialPluginScore · de 0 a 100

Provider que conecta agentes de código compatíveis com ACP (Claude Code, Codex CLI, Gemini CLI) ao framework CloudWeGo Eino em Go. Funciona como backend LLM para agentes de IA que realizam chamadas de ferramentas e edição de código.

Instalação

$npx convez-ai STRRL/eino-acp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
2
Acompanhando
0
Saúde
42%
Último commit
há 4 meses
Versão
—
Issues abertas
1
Contribuidores
3

Casos de uso

  • Integrar Claude Code ou Codex CLI como backend de modelo de chat em aplicações Go
  • Construir agentes de IA que fazem chamadas de ferramentas e modificam código
  • Processar streaming de respostas de agentes ACP com observabilidade de tool calls

Veredito

Solução técnica bem-definida para quem já conhece o ecossistema CloudWeGo Eino e quer integrar agentes de código via ACP. Requer familiaridade com Go e o protocolo Agent Client Protocol.

README

A tradução para o português deste README ainda está na fila.

eino-acp

Eino ChatModel provider that connects to any ACP (Agent Client Protocol) compatible coding agent.

Use Claude Code, Codex CLI, Gemini CLI, or any other ACP agent as an LLM backend for CloudWeGo Eino.

Install

go get github.com/strrl/eino-acp

Usage

package main

import (
	"context"
	"fmt"

	einoacp "github.com/strrl/eino-acp"
)

func main() {
	ctx := context.Background()

	cm, err := einoacp.NewChatModel(ctx, &einoacp.Config{
		Command: einoacp.ClaudeCommand(),
		// or: einoacp.CodexCommand()
		// or: einoacp.CopilotCommand()
		// or: einoacp.GeminiCommand()
	})
	if err != nil {
		panic(err)
	}

	// Generate (non-streaming)
	msg, err := cm.Generate(ctx, einoacp.UserMessages("Hello!"))
	if err != nil {
		panic(err)
	}
	fmt.Println(msg.Content)

	// Stream
	stream, err := cm.Stream(ctx, einoacp.UserMessages("Tell me a joke."))
	if err != nil {
		panic(err)
	}
	defer stream.Close()

	for {
		chunk, err := stream.Recv()
		if err != nil {
			break
		}
		fmt.Print(chunk.Content)
	}
	fmt.Println()
}

Config

FieldDescription
CommandCommand to launch the ACP agent. Use ClaudeCommand(), CodexCommand(), CopilotCommand(), or GeminiCommand() helpers, which auto-detect bunx, then pnpm dlx, then npx -y. Required.
CwdWorking directory for the agent session. Defaults to current directory.
EnvAdditional environment variables for the agent subprocess.
AutoApproveAuto-approve all permission requests from the agent. Default false.

How it works

  1. Launches the agent as a subprocess
  2. Communicates via ACP (JSON-RPC 2.0 over stdio)
  3. Maps ACP session updates to Eino's schema.Message streaming interface

Tool Call Mapping

eino-acp translates ACP tool_call and tool_call_update session updates into Eino assistant ToolCalls.

ACP fieldEino fieldNotes
toolCallIdToolCall.IDPreserved as-is.
kindToolCall.Function.NameUses ACP tool kind such as read, edit, or execute. Falls back to other when ACP omits the kind.
rawInputToolCall.Function.ArgumentsJSON-marshaled into a stable string. Defaults to {} when missing.
title, status, rawOutput, locations, content, _metaToolCall.ExtraPreserved under acp_* keys so observability consumers can inspect ACP-specific metadata.

For Generate, the final assistant message includes the accumulated ToolCalls.

For Stream, each ACP tool event is emitted as an assistant chunk with empty Content and a single ToolCall, so consumers such as tape, Langfuse-style handlers, or ADK can observe tool activity as it happens.

agent_thought_chunk, plan, and other non-message ACP session updates are still ignored.

Built on coder/acp-go-sdk.

License

MIT

Ver o original no GitHub

Bom para

Relacionados