eino

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• 本机已安装 Go 工具链（README 未注明最低版本）
• 能访问 GitHub / Go 模块代理以下载依赖
• 使用 OpenAI 模型时需要一个可用的 OpenAI API Key
• 具备基本的 Go 语言与模块（go mod）使用经验

安装与启动步骤

1. 1准备 Go 环境

   确认本机 go 命令可用，并配置好 GOPROXY；README 未给出具体的版本要求。

   go version

   复制

2. 2初始化 Go 模块

   新建一个空目录并在其中初始化 Go 模块，作为 Eino 示例工程。

   mkdir eino-demo && cd eino-demo
   go mod init eino-demo

   复制

3. 3引入 Eino 依赖

   把 cloudwego/eino 加入模块依赖；README 未直接给出该命令，此处按 Go 模块惯例推断。

   go get github.com/cloudwego/eino

   复制

4. 4配置模型密钥

   把 OpenAI 密钥写入环境变量 OPENAI_API_KEY，示例代码通过该变量读取。

   export OPENAI_API_KEY=sk-xxxxxxxx

   复制

5. 5编写示例代码

   在 main.go 中写入 README 的 ChatModelAgent 示例逻辑，import 需自行补全。

   chatModel, _ := openai.NewChatModel(ctx, &openai.ChatModelConfig{
       Model:  "gpt-4o",
       APIKey: os.Getenv("OPENAI_API_KEY"),
   })
   
   agent, _ := adk.NewChatModelAgent(ctx, &adk.ChatModelAgentConfig{
       Model: chatModel,
   })
   
   runner := adk.NewRunner(ctx, adk.RunnerConfig{Agent: agent})
   iter := runner.Query(ctx, "Hello, who are you?")
   for {
       event, ok := iter.Next()
       if !ok {
           break
       }
       fmt.Println(event.Message.Content)
   }

   复制

6. 6运行程序

   执行 main.go，观察 agent 输出的回复内容。

   go run main.go

   复制

关键配置

如何确认成功

程序运行后终端持续打印 agent 返回的消息内容（Message.Content），即表示模型与 Runner 已正常工作。

常见问题

注意事项

• README 未提供完整安装说明与 Go 版本要求，本教程中的 go mod / go get 命令是按 Go 模块惯例推断的，请以官网文档为准。
• README 示例代码没有 import 与 package 声明，实际编写 main.go 时需自行补全所需包路径。
• 更多 Agent、工具与编排的完整可运行代码见 README 中链接的 eino-examples 仓库。