Day 01 建立了地图。今天把环境搭起来，跑通"第一个 Agent"，并建立三个直觉：Eino 的 Agent 是"吐事件流"的、react 循环是它的心跳、工具能用一个普通 Go 函数自动生成。

Eino 需要 Go 1.18+（用了泛型）。三步：

# 1. 装 Go（若没有）：https://go.dev/dl/  或 brew install go
go version                       # 确认 >= 1.18

# 2. 新建你的项目，拉 eino 核心 + eino-ext（实现）
mkdir my-eino-app && cd my-eino-app && go mod init my-eino-app
go get github.com/cloudwego/eino
go get github.com/cloudwego/eino-ext/components/model/openai   # 某个模型实现

# 3. 配 API key（走 OpenAI/兼容接口）
export OPENAI_API_KEY=sk-...

用 ADK 搭一个最小 Agent，就五步（对照 adk/runner.go + adk/chatmodel.go 的真实 API）：

// 1. 造一个 ChatModel（实现来自 eino-ext）
cm, _ := openai.NewChatModel(ctx, &openai.ChatModelConfig{Model: "gpt-4o", APIKey: key})

// 2. 造一个 ChatModelAgent（adk/chatmodel.go:484 NewChatModelAgent）
agent, _ := adk.NewChatModelAgent(ctx, &adk.ChatModelAgentConfig{
    Name:        "assistant",
    Description: "一个有用的助手",
    Instruction: "You are a helpful assistant.",
    Model:       cm,
    ToolsConfig: adk.ToolsConfig{ /* Tools: []tool.BaseTool{天气工具...} */ },
    MaxIterations: 20,          // react 循环最多转 20 圈（默认 20，react.go:345）
})

// 3. 造一个 Runner（adk/runner.go:89 NewRunner）
runner := adk.NewRunner(ctx, adk.RunnerConfig{Agent: agent, EnableStreaming: true})

// 4. 跑！Query 是便捷入口（runner.go:108），返回一个"事件迭代器"
iter := runner.Query(ctx, "北京今天天气怎么样？")

// 5. 消费事件流（关键：Agent 是"吐事件流"的，不是"返回一个值"）
for {
    event, ok := iter.Next()
    if !ok { break }                          // 迭代结束
    if event.Err != nil { /* 处理错误 */ }
    if event.Output != nil && event.Output.MessageOutput != nil {
        msg, _ := event.Output.MessageOutput.GetMessage()  // 流式会自动拼成完整消息
        fmt.Println(msg.Content)
    }
}

看 adk/interface.go:453 的 Agent 接口定义——Run 不返回结果，而是返回一个异步事件迭代器：

type TypedAgent[M MessageType] interface {
    Name(ctx) string
    Description(ctx) string
    Run(ctx, input *TypedAgentInput[M], opts ...AgentRunOption) *AsyncIterator[*TypedAgentEvent[M]]
}
type Agent = TypedAgent[*schema.Message]   // interface.go:467 最常用的别名

事件结构 AgentEvent（interface.go:419）含：AgentName、Output（消息，可能是流）、Action（动作：Exit/Transfer/Interrupt/BreakLoop）、Err。Action 就是 Agent 用来“控制流程”的信号（Day 13/14 会用到）。

你上面那个 Agent，收到"北京天气"后内部转的圈就是 ReAct 循环（Day 12/15 精读真实代码，今天先建立直觉）：

用一张走查表跟踪「北京天气」这个输入在循环里每一圈发生了什么、消息列表长成什么样：

那个"查天气"的工具怎么来？Eino 提供了从普通 Go 函数自动生成工具的能力（components/tool/utils 的 InferTool）：

type WeatherReq struct {
    City string `json:"city" jsonschema:"description=城市名"`   // struct tag 描述参数
}
// 一个普通函数 → 自动变成一个 Tool
weatherTool, _ := utils.InferTool(
    "get_weather",              // 工具名
    "查询某城市的天气",           // 描述（给模型看，决定何时调用）
    func(ctx context.Context, req WeatherReq) (string, error) {
        return "北京今天晴，25℃", nil   // 你的真实逻辑
    },
)

把这个 weatherTool 放进 L04 第 2 步的 ToolsConfig.Tools 里，Agent 就会在需要时自己调它。

✋ 动手

# 1. 看 Agent 接口定义（L05）
sed -n '453,467p' adk/interface.go

# 2. 看 ChatModelAgent 构造与 Runner
grep -n "func NewChatModelAgent\|func NewRunner\|func.*Query" adk/chatmodel.go adk/runner.go | head

# 3. 看事件结构
sed -n '419,438p' adk/interface.go

# 4. 看工具接口（明天/Day04 细读）
sed -n '1,60p' components/tool/interface.go | head -40