运行时决定智能体「内层循环」如何执行——即每一轮如何调用模型、解析意图、调用工具。默认运行时基于 Google ADK 的内置执行流程,开箱即用;你也可以切换执行后端,或在执行流程上插入统一的处理逻辑,而无需改动智能体本身。
默认运行时
默认即为 ADK 运行时,无需额外配置:
切换执行后端
通过 runtime 选择内层循环的执行后端:
使用 Codex 运行时前需安装其 Python SDK:
Codex 运行时可能根据 Codex SDK 的策略执行命令和访问文件。请在隔离环境中运行可信任务,并限制进程可访问的凭证和数据。VeADK 1.0.0 不会覆盖 SDK 的沙箱、网络和操作审核默认值。
请求处理
在不侵入业务逻辑的前提下,可为每次执行插入统一的横切处理。将处理器传入 run_processor 即可,例如接入身份认证做登录态校验:
不设置时使用默认处理器,不改变任何行为。VeADK 内置 AuthRequestProcessor 作为身份认证的开箱即用实现。
自定义处理器
所有处理器都继承抽象基类 BaseRunProcessor,实现其 process_run(runner, message) 方法。该方法返回一个包裹本轮「事件流」的装饰器,从而让你:
- 在整轮执行的前后插入逻辑(如鉴权、日志、性能监控);
- 拦截、改写或注入执行过程中产生的事件;
- 在此基础上实现重试等控制逻辑。