Quickstart
Installation
Eino ADK is available since v0.5.0, with v0.9.0 as the current recommended version:
go get github.com/cloudwego/eino@latest
Core Concepts
Eino ADK is a Go-based Agent development framework. The core primitive is ChatModelAgent β an intelligent agent that uses a ChatModel as its decision-maker, Tools as its action space, and autonomously drives problem-solving through a ReAct Loop.
π‘ If you only read one document, read: Eino ADK: ChatModelAgent Introduction
Component Map
| Component | Responsibility | Documentation |
| ChatModelAgent | ReAct Loop: Reasoning β Action β Feedback, autonomous decision-making | ChatModelAgent Introduction |
| Middleware | Inject behavior at lifecycle points of the ReAct Loop (compression, search, retry, etc.) | ChatModelAgentMiddleware |
| Runner | Single Agent run entry: Query / Run β event stream | Agent Runner and Extension |
| TurnLoop | Multi-turn runtime: Push / Preempt / Stop + declarative checkpoint/resume | Agent Cancel and TurnLoop |
| DeepAgents | Pre-built Agent: task planning (PlanTask) + subtask delegation (TaskTool) | DeepAgents |
Other Agent Types
Besides ChatModelAgent, ADK also provides deterministic orchestration primitives:
- Workflow Agents: Sequential / Loop / Parallel Agent, for structured orchestration of predefined processes.
- Custom Agent: Implement the
Agentinterface to integrate with the framework.
π‘ Graph (deterministic orchestration) and Agent (autonomous decision-making) are two different forms of AI applications. When the core problem is “autonomous decision-making + runtime enhancement”, ChatModelAgent is recommended. See “Why not continue using flow/react” in the ChatModelAgent Introduction.
Examples
eino-examples/adk provides complete ADK example code:
- ChatModelAgent Intro: chatmodel β Book recommendation Agent with interrupt and resume
- DeepAgents: deep β Task planning + subtask delegation
- Workflow: sequential / loop / parallel
- Multi-Agent: supervisor / plan-execute