开发 Agent 应用时,可配置多种类型的工具来扩展 Agent 能力,实现与外部服务交互、代码执行、知识检索等功能。
工具概览
LangStudio 提供 5 种工具类型,用于封装不同形式的外部能力:
MCP 工具:将实现 MCP 协议的后端服务注册到平台,Agent 可按需调用,实现与外部系统的安全交互。
自定义工具(OpenAPI工具):提供符合 OpenAPI 3.0+ 规范的接口定义文件,平台自动转换为可调用工具,每个 API 端点对应一个工具。
Python 工具:编写 Python 函数,平台自动提取函数签名、类型注解和文档,生成结构化描述供 Agent 调用。
知识库工具:将已创建的企业知识库直接配置到 Agent 节点,推理时按需检索私有知识。
联网搜索工具:通过互联网搜索引擎获取实时信息,Agent 可自动调用该工具查询最新资讯、事实数据等网络内容。
根据您的使用场景选择合适的工具类型:
工具类型 | 适用场景 | 核心特点 |
MCP 工具 | 内部微服务、私有 API | 低成本接入、内置可观测性 |
自定义工具 | 第三方 SaaS、RESTful 服务 | 零代码集成 |
Python 工具 | 复杂逻辑处理、本地计算 | 灵活编程、深度集成 Python 生态 |
知识库工具 | 专属知识问答 | 开箱即用、Agent 自动检索 |
联网搜索工具 | 实时信息查询、最新资讯获取 | 自动联网检索 |
工具组合与选择建议:
同一个 Agent 可以配置多种工具。例如,组合使用 MCP 工具(调用内部 API)和 Python 工具(数据处理)来处理复杂业务逻辑。
如果内部 API 尚未实现 MCP 协议但有 OpenAPI 规范,可先使用自定义工具快速接入,后续再迁移到 MCP 工具以获得更好的可观测性。
配置MCP工具
创建 MCP 工具连接
进入LangStudio,在页面,单击新建工具。
选择创建方式:
FunctionAI:配置通过页面创建的MCP服务。
选择已部署的 MCP 服务,系统自动填充连接参数。
自定义:配置用户自行部署或使用第三方平台托管的 MCP 服务。
transport:与 MCP 服务通信时使用的底层传输协议。支持SSE和StreamableHTTP。
url:MCP 服务的完整访问端点 URL。
authentication:用于配置访问 MCP 服务时的身份认证信息。支持以下三种:
BearerAuth:使用Bearer令牌认证。需在token字段填写有效的访问令牌。
Other:需填写auth_header_name、token,说明从哪个请求头获取token。
None: 不需要身份认证。
(可选) 运行连通性测试验证 MCP 服务可访问。
单击提交创建工具。
配置 Agent 节点
在Agent节点的配置页面,找到MCP工具,支持2种配置方式:
选择已有的MCP工具连接:需先创建可复用的MCP工具连接,详情请参见创建 MCP 工具连接。一个 MCP 服务通常会提供多个工具(Tools),可以设置工具范围和审批工具。
通过工具范围选项,可以控制哪些工具对大模型可见。
对于具有敏感操作(如修改用户数据)的工具,可以通过审批工具功能进行保护。当工作流执行到这些工具时,节点会自动暂停,并等待人工确认;审批通过后,工作流才会继续执行。
自定义添加MCP配置:仅在该节点中可用。

配置其他类型工具
在Agent节点的配置页面,进入工具,可以选择添加各种工具。对于选中的工具,支持编辑该工具的描述、是否“需要审批”等参数。
知识库:参见知识库管理创建知识库后再为Agent添加。
自定义工具(OpenAPI工具):
可以选择已有自定义工具或者新建自定义工具。
支持将PAI-EAS上已部署的LangStudio服务创建为工具,也可以选择手动填入OpenAPI 规范进行创建。
工具创建成功后,可进入工具详情页,使用测试功能发送示例请求并验证响应。
Python工具:
可选择已有工具或者新建Python工具。
如新建,设置工具集名称后,在打开的页面上编辑代码并进行测试。
查看或编辑已有 Python 工具:单击应用开发页面右上角的 ,文件位于应用源码目录下的
tools文件夹内。
联网搜索工具:使用阿里云IQS-标准搜索,添加工具后参见阿里云IQS-联网搜索(IQS-GenericSearch)进行配置。