连接概览

更新时间:
复制 MD 格式

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

固定写入 /root/skills 目录。每个 Skill 对应一个独立文件夹,文件夹下包含 skill.md 文件。

通过环境变量下发配置。

MCP

按部署入口区分:- Agent 市场部署:写入镜像内 config 目录- 快速部署:写入 /root/ 目录- 代码创建 Agent:写入代码工作目录

Agent 市场部署写入镜像内 config 目录;快速部署和代码创建 Agent 写入 MCP_JSON 环境变量。

连接可以在首次创建 Agent 时绑定或配置,也可以在 Agent 创建完成后进入 Agent 管理 > Agent 连接 调整。每次新增、解绑或修改连接配置后,都需要到 部署物 页签找到最新部署物并点击 发布,通过重新发布实现重启和配置生效。若采用集群部署,还需要重启 Pod 才能加载新配置。

创建连接

凭证、沙箱、会话管理、记忆和知识库连接都可以在 Agent部署 页面对应页签中创建。进入对应连接类型后,点击 创建连接,按页面提示完成配置。

部分连接类型在创建时提供 新建资源 和 已有资源 两种资源来源:

资源来源

含义

新建资源

平台根据页面参数一键创建所需云资源,并同步创建对应连接。

已有资源

用户选择或填写已有资源参数,平台只创建连接并记录绑定所需信息。

是否支持 新建资源 取决于具体连接类型和当前页面能力。没有 新建资源 入口时,请先在对应云产品中准备资源,再通过 已有资源 或参数填写方式创建连接。

环境变量注入

凭证、沙箱、会话管理、记忆和知识库连接绑定后,Agent 通过环境变量读取连接信息。不同连接类型的变量不同,例如:

连接类型

常见变量

凭证

ALIBABA_CLOUD_ACCESS_KEY_ID、ALIBABA_CLOUD_ACCESS_KEY_SECRET

沙箱

ACS Sandbox:E2B_DOMAIN、E2B_API_KEY、TLS_CERT、TEMPLATE_NAMEFC Sandbox:E2B_DOMAIN、E2B_API_URL、E2B_API_KEY、TEMPLATE_NAME

会话管理

SESSION_REDIS_URL、SESSION_TYPE

百炼记忆库

BAILIAN_MEMORY_LIBRARY_ID、BAILIAN_MEMORY_PROJECT_ID、BAILIAN_MEMORY_PROFILE_SCHEMA

Mem0 记忆库

MEM0_BASE_URL、MEM0_API_KEY

百炼知识库

BAILIAN_WORKSPACE_ID、BAILIAN_INDEX_ID、BAILIAN_REGION_ID

RAGFlow 知识库

RAGFLOW_API_KEY、RAGFLOW_BASE_URL、RAGFLOW_DATASET_IDS

请勿在日志中打印完整密钥、Token、数据库密码或包含凭证的连接 URL。

连接与凭证

部分连接能力需要先绑定 AccessKey 凭证。例如需要访问阿里云资源的知识库或工具能力,可能会在绑定时提示先配置凭证。遇到此类提示时,请先完成 AccessKey 凭证 绑定。