Quickstart
Installation
Eino ADK has been 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 an Agent development framework for Go. The core primitive is ChatModelAgent β an intelligent agent that uses ChatModel as its decision-maker, Tools as its action space, and autonomously progresses 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: Reason β Act β Feedback, autonomous decision-making | ChatModelAgent Introduction |
| Middleware | Inject behavior at ReAct Loop lifecycle points (compression, search, retry, etc.) | ChatModelAgentMiddleware |
| Runner | Single Agent run entry point: 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
In addition to ChatModelAgent, ADK also provides deterministic orchestration primitives:
- Workflow Agents: Sequential / Loop / Parallel Agent, for structured orchestration of predefined flows.
- Custom Agent: Implement the
Agentinterface to integrate with the framework.
π‘ Graph (deterministic orchestration) and Agent (autonomous decision-making) are two different AI application paradigms. 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 sample code:
- ChatModelAgent Quickstart: chatmodel β Book recommendation Agent with interrupt and resume
- DeepAgents: deep β Task planning + subtask delegation
- Workflow: sequential / loop / parallel
- Multi-Agent: supervisor / plan-execute