Tutorial 7: ADK — Agent 开发套件

ADK 概述

Agent Development Kit（ADK） 是 Eino 的 Pillar 3：在编排框架之上提供高层 Agent 抽象，便于实现多步推理、工具调用、多 Agent 协作和人工介入。

参考：Eino ADK Overview、DeepWiki ADK。

核心概念

Agent 接口

  • ADK 定义统一的 Agent 接口（输入/输出、执行方式），不同实现（如 ChatModelAgent、Workflow Agents、MultiAgent）都遵循该接口。

  • 便于在图中将「整个 Agent」当作一个节点使用（例如通过 AgentTool 把 Agent 包装成 Tool，被其他 Agent 调用）。

文档：Eino ADK: Agent Interface。

Runner 与扩展

  • Runner 负责 Agent 的生命周期：启动运行、推进步骤、处理中断与恢复。

  • 支持 检查点：将状态持久化，之后可从某一步恢复（用于 Human-in-the-Loop 或故障恢复）。

  • 通过 扩展（如中间件、回调）可以注入日志、监控、限流、权限等。

文档：Eino ADK: Agent Runner & Extensions。

ChatModelAgent

  • ChatModelAgent 是 ReAct 模式的「开箱即用」实现：

    • 内部是「ChatModel + 工具循环」的图；

    • 支持中间件（如注入工具、修改上下文）；

    • 支持中断与恢复（与 Runner、CheckPoint 配合）。

文档：Eino ADK: ChatModelAgent。

Workflow Agents

  • 基于 Workflow 编排的 Agent：用字段级映射描述数据流，适合「多步骤、多输入输出」的固定流程。

  • 可与 ChatModel、Tool、Retriever 等组件组合。

文档：Eino ADK: Workflow Agents。

执行模式与中断

  • 正常执行：Runner 驱动 Agent 一步步执行直到结束。

  • 中断（Interrupt）：在配置的节点（如「需要人工确认」）暂停，将当前状态写入 CheckPoint；恢复时从该状态继续。

  • 用于审核、人工修正、多轮确认等 Human-in-the-Loop 场景。

文档：Eino ADK: Interrupt & CheckPoint Manual、Interrupt System Architecture。

小结

  • ADK 提供 Agent 接口、Runner、ChatModelAgent、Workflow Agents 等高层抽象。

  • Runner 管理生命周期与检查点；ChatModelAgent 实现 ReAct；AgentTool 支持 Agent 嵌套与组合。

  • 中断与检查点为实现 Human-in-the-Loop 提供基础。

下一节将介绍 多 Agent：MultiAgent、DeepAgent、Host-Specialist 等模式。