AI 助理
文档备案控制台
官方文档
输入文档关键字查找
首页

Agent连接使用说明

更新时间：
复制为 MD 格式
产品详情
我的收藏

本文说明在计算巢 Agent 场景下，沙箱、会话管理、知识库、MCP等工具连接如何创建并通过绑定方式接入Agent。

Agents连接介绍

Agent 连接指 Agent 依赖的外部能力或云资源，例如：沙箱（隔离环境）、会话管理（上下文持久化，常见如 Redis）、知识库、记忆（百炼记忆库） 等，以及产品后续支持的其他类型。MCP无需创建连接，需至百炼MCP开通。

每种 Agent 连接都对应阿里云上的具体资源，需依次完成云上资源就绪 、 控制台创建连接 、Agent 绑定后，Agent 才能访问该能力。

操作方法

所有Agent连接使用逻辑类似，大体分为以下三个步骤，完成后，Agent 才能成功访问并使用该能力模块。

  1. 准备云上资源：确保所需资源在阿里云上已就绪并可访问（如沙箱资源、Redis），细节见下文；

  2. 控制台创建连接：在计算巢-Agent部署中选择连接类型，依据提示填写相关信息如云资源ID、连接地址等，保存为可复用连接。

  3. Agent绑定连接：新建或编辑 Agent 时绑定对应连接。

创建Agent连接

image.png

目前，计算巢Agent支持绑定以下连接，可点击下方快速前往所需Agent连接介绍页面。

类别

操作指南

沙箱

沙箱使用说明

会话管理

会话管理使用说明

记忆

记忆使用说明

知识库

知识库使用说明

MCP

MCP使用说明

绑定Agent

单个 Agent 支持同时绑定多种类型的连接（如沙箱、会话存储等），不同类型连接会分别注入对应的环境变量。但同一类型的连接通常只能绑定一个（例如无法同时绑定多个会话存储）。

创建Agent绑定

在创建页-工具配置-应用连接中，选择所需Agent连接，创建后将自动绑定。

已有Agent绑定

  1. 进入应用-Agent管理，选择所需Agent连接，点击绑定。在对应弹框中选择所需连接完成绑定。

    image.png

  2. 进入发布管理，选择最新部署物发布。变更连接需重启应用方可生效。

绑定后生效方式

计算巢会将连接信息以环境变量写入部署 Agent 的 ECS/集群中，应用按下文方式读取即可访问沙箱、会话存储等，而不必在代码里写死地址。环境变量名与含义以各工具说明为准。

不同连接使用说明

沙箱使用说明

创建AgentRun沙箱模板

  1. 进入AgentRun控制台。

  2. 创建AgentRun模板。

  3. 创建完成后，记录模板名称。

创建沙箱连接

  1. 进入Agent部署-会话管理-创建沙箱连接，弹框后点击下一步。

  2. 进入编辑页面后，填写连接名称、模板名称、AccessKey、AccessKey Secret。其中名称您可自定义；模板名称为上一部分记录的内容。AccessKey（AK）、AccessKey Secret（SK）可通过两种方式获取：

    • 新建当前账号的AK、SK，该AK、SK拥有当前账号的所有权限。

      重要

      为降低AccessKey泄露的风险，AccessKey Secret 只在创建时显示一次，后续无法查看。请务必妥善保管。由阿里云账号（主账号）直接创建的AccessKey、AccessKey Secret，默认拥有当前账号下的全部操作权限，可对所有资源执行管理。一旦主账号 AccessKey 泄露，风险极高。强烈建议不创建和使用主账号AccessKey。

    • 登录RAM控制台，创建用户，并为用户授予AliyunAgentRunFullAccess权限。而后可创建该用户的AK和SK。更多内容请参考创建RAM用户以及为RAM用户授权。

  3. 确定上面内容填写正确后，点击创建，即可完成连接的创建

环境变量

AgentRun沙箱连接创建后，会在您的机器上设置如下环境变量：

AGENTRUN_TEMPLATE_ID：模板名称
ALIBABA_CLOUD_ACCESS_KEY_ID：Access Key
ALIBABA_CLOUD_ACCESS_KEY_SECRET：Access Secret
AGENTRUN_ACCOUNT_ID：您的阿里云账户uid
AGENTRUN_REGION：agentRun模板所在地域

您可以在您的代码中通过环境变量获取这些值，用于连接AgentRun沙箱，以python为例：

import os
account_id = os.getenv("AGENTRUN_ACCOUNT_ID")

会话管理使用说明

创建Redis

  1. 登录Redis控制台创建Redis（控制台入口）；

  2. Redis创建好后设置白名单（0.0.0.0/0） 与 设置免密登录。

创建会话连接

  1. 进入Agent部署-会话管理-创建会话连接，弹框后点击下一步。

  2. 选择Redis所在地域与选择Redis实例ID，点击创建即可。

环境变量

会话连接创建后，会在您的机器上设置如下环境变量：

SESSION_REDIS_URL：会话管理Redis私网连接URL，格式为 redis://r-bp1b7cexxxxxxxx.redis.rds.aliyuncs.com:6379

您可以在您的代码中通过环境变量获取这些值，用于连接会话管理，以python为例：

import os
session_redis_url = os.getenv("SESSION_REDIS_URL")

其他说明

Redis仅支持VPC私网通信。Agent运行服务器必须与Redis实例位于同一VPC内，否则将无法建立会话连接。

知识库使用说明

需开通百炼、并创建百炼知识库。

创建知识库连接

  1. 进入Agent部署-记忆-创建知识库链接，弹框后点击下一步

  2. 进入编辑页面后，填写连接名称，选择百炼业务空间ID、百炼知识库ID，并填写AccessKey、AccessSecret。其中名称您可自定义；模板名称为上一部分记录的内容；AccessKey、AccessSecret可通过两种方式获取：

    1. 进入此链接：https://ram.console.aliyun.com/profile/access-keys。获取该账号的ak和sk，该ak sk拥有该账号的所有权限

    2. 登录RAM平台，创建用户，并为用户授予AliyunAgentRunFullAccess权限。而后可创建该用户的ak和sk。更多内容请参考：创建RAM用户以及为RAM用户授权

环境变量

BAILIAN_WORKSPACE_ID： 百练业务空间ID
BAILIAN_INDEX_ID：  百练知识库ID
BAILIAN_ALIBABA_CLOUD_ACCESS_KEY_ID：阿里云AK
BAILIAN_ALIBABA_CLOUD_ACCESS_KEY_SECRET： 阿里云SK
BAILIAN_REGION_ID：  百练业务空间地域

您可以在您的代码中通过环境变量获取这些值，用于连接记忆库，以python为例：

import os
bailian_workspace_id = os.getenv("BAILIAN_WORKSPACE_ID")
bailian_region_id = os.getenv("BAILIAN_REGION_ID")

记忆库管理使用说明

需开通百炼后使用。

创建记忆库连接

  1. 进入Agent部署-记忆-创建记忆连接，弹框后点击下一步。

  2. 依据页面填写具体记忆库ID、记忆规则ID等，点击创建即可。若不填写，则采用默认记忆库创建连接。

环境变量

记忆库连接创建后，会在您的机器上设置如下环境变量：

BAILIAN_MEMORY_LIBRARY_ID：百炼记忆库ID，不配置→走百炼默认记忆库；配置→读写指定记忆库
BAILIAN_MEMORY_PROJECT_ID：百炼记忆规则ID，不配置→不启用控制台绑定的记忆规则；配置→按该 project 的规则存取记忆

您可以在您的代码中通过环境变量获取这些值，用于连接记忆库，以python为例：

import os
bailian_library_id = os.getenv("BAILIAN_MEMORY_LIBRARY_ID")
bailian_project_id = os.getenv("BAILIAN_MEMORY_PROJECT_ID")

MCP使用说明

Agent部署使用MCP均为百炼MCP，用户使用的MCP均需要在百炼开通才可以使用。Agent市场中的MCP均为特定Agent专属使用，不支持修改或删除。仅自定义Agent支持更换。

创建Agent时使用

  1. 在创建页-工具配置，开启 “启动MCP”开关，选择所需MCP。若MCP未开通，页面将提示前往开通。

  2. 开通并确认按钮开关开启后即选中，后续正常创建Agent即可。

已有Agent时使用

  1. 进入Agent应用-Agent管理-MCP，点击 变更MCP配置；

  2. 变更页面类似创建页，选择所需MCP，点击变更配置即可。

JSON文件说明

MCP最终会变为JSON文件存入指定的文件路径中，Json文件格式如下：

{
  "mcpServers": {
    "market-cmapi011033": {
      "type": "streamableHttp",
      "baseUrl": "https://dashscope.aliyuncs.com/api/v1/mcps/market-cmapi011033/mcp",
      "headers": {
        "Authorization": "Bearer ${DASHSCOPE_API_KEY}"
      }
    },
    "amap-maps": {
      "type": "sse",
      "baseUrl": "https://dashscope.aliyuncs.com/api/v1/mcps/amap-maps/sse",
      "headers": {
        "Authorization": "Bearer ${DASHSCOPE_API_KEY}"
      }
    }
  }
}

  1. ECS部署：若使用ECS部署，则上述Json内容将会覆盖到指定目录下；

  2. 集群部署：若使用集群部署，上述Json内容将会作为环境变量存入配置项 app-config中，具体配置项键值为MCP_JSON，Value值为具体Json文件内容。

上一篇：自定义Agent部署下一篇：提高部署成功率