Agent 连接用于把外部资源、工具能力和上下文能力绑定给 Agent。绑定后,平台会把连接配置下发到 Agent 运行环境。
连接类型
连接类型 | 典型用途 | 常见实现 |
凭证 | 为 Agent 提供访问阿里云资源所需的 AccessKey。 | AccessKey |
沙箱 | 为 Agent 提供隔离代码执行或文件处理环境。 | ACS Sandbox、FC Sandbox |
会话管理 | 保存多轮会话上下文。 | Redis |
记忆 | 保存长期偏好、用户画像或跨会话状态。 | 百炼记忆库、Mem0 记忆库 |
知识库 | 为 Agent 提供检索增强回答能力。 | 百炼知识库、RAGFlow 知识库 |
Skills | 扩展 Agent 可执行的任务能力。 | 以页面展示为准 |
MCP | 接入标准化工具服务。 | 计算巢 MCP、百炼 MCP |
不同 Agent 支持的连接类型不同。如果 Agent 连接 页面中没有某个连接类型,表示当前 Agent 不支持该能力。
配置下发方式
不同连接类型的下发方式不同:
连接类型 | ECS 场景 | 集群场景 |
凭证、沙箱、会话管理、记忆、知识库 | 本质是向运行环境注入环境变量,Agent 代码通过环境变量读取连接参数。 | 与 ECS 场景一致。 |
Skills | 固定写入 | 通过环境变量下发配置。 |
MCP | 按部署入口区分:- Agent 市场部署:写入镜像内 | Agent 市场部署写入镜像内 |
连接可以在首次创建 Agent 时绑定或配置,也可以在 Agent 创建完成后进入 Agent 管理 > Agent 连接 调整。每次新增、解绑或修改连接配置后,都需要到 部署物 页签找到最新部署物并点击 发布,通过重新发布实现重启和配置生效。若采用集群部署,还需要重启 Pod 才能加载新配置。
创建连接
凭证、沙箱、会话管理、记忆和知识库连接都可以在 Agent部署 页面对应页签中创建。进入对应连接类型后,点击 创建连接,按页面提示完成配置。
部分连接类型在创建时提供 新建资源 和 已有资源 两种资源来源:
资源来源 | 含义 |
新建资源 | 平台根据页面参数一键创建所需云资源,并同步创建对应连接。 |
已有资源 | 用户选择或填写已有资源参数,平台只创建连接并记录绑定所需信息。 |
是否支持 新建资源 取决于具体连接类型和当前页面能力。没有 新建资源 入口时,请先在对应云产品中准备资源,再通过 已有资源 或参数填写方式创建连接。
环境变量注入
凭证、沙箱、会话管理、记忆和知识库连接绑定后,Agent 通过环境变量读取连接信息。不同连接类型的变量不同,例如:
连接类型 | 常见变量 |
凭证 |
|
沙箱 | ACS Sandbox: |
会话管理 |
|
百炼记忆库 |
|
Mem0 记忆库 |
|
百炼知识库 |
|
RAGFlow 知识库 |
|
请勿在日志中打印完整密钥、Token、数据库密码或包含凭证的连接 URL。
连接与凭证
部分连接能力需要先绑定 AccessKey 凭证。例如需要访问阿里云资源的知识库或工具能力,可能会在绑定时提示先配置凭证。遇到此类提示时,请先完成 AccessKey 凭证 绑定。