Agent-Level Callbacks for Eino ADK

Notice

This is an alpha version and does not guarantee compatibility.

Overview

en:

• This release introduces agent-level callbacks and multi-agent architecture to Eino ADK, enhancing middleware flexibility, observability, and management of complex agent workflows. Key additions include middleware hooks (BeforeAgent/OnEvents), global middleware injection, and Multi-Agent structure for unified multi-agent scenarios.

zh:

• 为 Eino ADK 引入Agent 级回调与多 Agent 架构，提升中间件灵活性、可观测性及复杂工作流管理能力。核心更新包括中间件切面（BeforeAgent/OnEvents）、全局中间件注入，以及 Multi-Agent 结构以统一多 Agent 场景。

Details

en:

• Introduce agent-level callbacks for ADK.
  • Add callback hooks to current AgentMiddleware : BeforeAgent and OnEvents
  • Add AgentMiddlewareChecker interface. If an agent implements AgentMiddlewareChecker and enables agent middlewares internally, hooks run inside the agent; otherwise, agent middlewares are executed by the flowAgent.
  • flowAgent / ChatModelAgent / workflowAgent Run/Resume adapt to middleware aspect execution, with partial refactoring of ChatModelAgent to adapt to runtime middleware injection and execution.
  • Add middlewares configuration to Plan-Execute and Supervisor Agent
  • Add globalAgentMiddlewares to inject the same middleware at the outermost layer of all agent runtimes from a global perspective.
• Introduce Multi-Agent for ADK.
  • Add Multi-Agent structure, at the same conceptual level as ChatModelAgent / WorkflowAgents, to solve the problem that Agent operations are at a flat level and difficult to observe in TransferAgent scenarios.
  • flowAgent adapts to Multi-Agent operation
  • Supervisor Agent constructor returns Multi-Agent
• Add WithGraphCallbacks AgentRunOption, which provides eino graph/chain callback injection inside an agent (mainly for ChatModelAgent).
• Provide utility helpers (NewAsyncOnSingleEventHandler, NewSyncOnSingleEventHandler, BypassIterator) for event processing.
• Add tests to verify middleware execution validity (order, deduplication, termination behavior, interruption/resume flows with tool calls, and global agent middleware propagation).

zh:

• ADK 支持 Agent 级别的回调
  • 向现有的 AgentMiddleware 中新增切面: BeforeAgent 和 OnEvents
  • 新增 AgentMiddlewareChecker 接口用于检查 Agent 是否支持内部运行 AgentMiddleware。如果支持，AgentMiddleware 将在 Agent 内部运行（由 Agent 自行实现运行逻辑）；否则将由 flowAgent 在 Agent 外部运行。
  • flowAgent / ChatModelAgent / workflowAgent Run/Resume 适配 middleware 切面运行，对 ChatModelAgent 部分重构来适配运行时的 middleware 注入与运行。
  • 新增 globalAgentMiddlewares，以全局角度向所有 agent 运行时最外侧注入相同的中间件
• ADK 支持 Multi-Agent 概念
  • 新增 Multi-Agent 结构，概念层级与 ChatModelAgent / WorkflowAgents 一致，用于解决 TransferAgent 情况下各 Agent 运行处于平铺的层级难以进行观测的问题。
  • flowAgent 对 Multi-Agent 运行进行适配
  • Supervisor Agent 构造方法返回 Multi-Agent
• 增加 WithGraphCallbacks AgentRunOption，提供向 Agent 内部的 graph/chain 运行 eino callback 的能力（主要面向 ChatModelAgent）
• 提供多个工具方法，用于处理 Iterator 中的 Events (NewAsyncOnSingleEventHandler, NewSyncOnSingleEventHandler, BypassIterator)
• 补全 middleware 测试，保证功能正确性（顺序、去重、提前终止、中断恢复场景、工具调用、globalAgentMiddlewares 等）

Full Changelog: v0.7.17...v0.8.0-alpha.1

What's Changed

• fix(adk): forward opts in taskTool.InvokableRun to emit internal events by @shentongmartin in #654

Full Changelog: v0.7.16...v0.7.17

What's Changed

• feat(adk): update prompt by @meguminnnnnnnnn in #646
• fix(adk): emit tool result AgentEvent after tool middlewares by @shentongmartin in #649

Full Changelog: v0.7.15...v0.7.16

What's Changed

• fix(adk): support after chatmodel if no tools configured by @meguminnnnnnnnn in #643
• fix(adk): correct agent name settings by @meguminnnnnnnnn in #650

Full Changelog: v0.7.14...v0.7.15

What's Changed

• feat(adk): add shared session support for nested runner by @hi-pender in #645
• feat(adk): implement ChatModel retry for ChatModelAgent by @shentongmartin in #635
• fix(adk): support interrupt/resume for nested prebuilt/workflow agents, with arbitrary agent wrappers by @shentongmartin in #647
• feat(adk): add ModelRetryConfig to deepAgents by @shentongmartin in #648

Full Changelog: v0.7.13...v0.7.14

What's Changed

• feat: add allowed tools filed for model options by @zhuangjie1125 in #639

Full Changelog: v0.7.12...v0.7.13

What's Changed

• feat(adk): allow emit internal event by agent tools by @shentongmartin in #620
• docs: fix comments for StreamToolCallChecker by @Singularity0909 in #525
• feat(adk): support BeforeChatModel if no tool configured by @meguminnnnnnnnn in #642

New Contributors

• @Singularity0909 made their first contribution in #525

Full Changelog: v0.7.11...v0.7.12

What's Changed

• feat(schema): Make ToJSONSchema output deterministic by @zhuangjie1125 in #630

Full Changelog: v0.7.10...v0.7.11

What's Changed

• feat: Add detailed completion token usage for model callback output by @zhuangjie1125 in #629

Full Changelog: v0.7.9...v0.7.10

What's Changed

• feat: Add detailed completion token usage by @zhuangjie1125 in #628

Full Changelog: v0.7.8...v0.7.9