工作原理
本文介绍AgentArts运行时的内部架构和运行机制,帮助您理解一个请求从进入运行时到返回结果的完整过程。运行时是安全隔离、框架无关的托管执行环境,其核心是入站网关与安全沙箱的分层协作。
整体架构

典型的运行时架构和交互流程:
Agent开发者:
- 使用任意Agent开发框架完成Agent开发,构建Docker镜像,发布到SWR 镜像仓库。
- 在AgentArts平台基于Agent镜像创建运行时,获取访问方式。
- 配置访问方式到前端应用。
Agent用户:
- 在前端应用(Frontend App)完成业务登录。
- 通过前端应用提交Agent任务。
前端应用(由开发者开发、部署、配置):
- 完成用户任务请求的认证和鉴权,提取user-id,并映射到运行时的session-id。
- 调用运行时的访问方式,调用/invocation接口,header中需携带session-id。
- Agent Gateway接收到Frontend的请求后进行认证,提取session-id,按照session-id进行路由:
- 如果session-id存在对应的活跃microVM,直接转发路由。
- 如果session-id找不到对应的microVM,唤醒新的microVM,然后转发路由。
核心概念
智能体运行时(Agent Runtime):智能体的核心逻辑、决策和编排运行的环境,可用于托管智能体代码或者MCP工具,管理它们的生命周期。
版本(Versions):智能体运行时的不可变版本,每次编辑运行时配置都会产生新版本。
访问方式(Endpoints):智能体运行时的访问方式,可指向某一个具体版本,也可按权重指向多个版本,实现蓝绿发布,灰度发布
会话(Sessions):智能体运行时的一个独立交互上下文,由请求头的session-id唯一标识。由前端应用负责业务对象与Session的映射,如需按用户隔离,配置user-id映射到一个session-id