为 Agent 配置工具

更新时间:
复制为 MD 格式

开发 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 工具连接

  1. 进入LangStudio,在工具 > MCP工具页面,单击新建工具

  2. 选择创建方式:

    • FunctionAI:配置通过探索 > MCP模板页面创建的MCP服务。

      • 选择已部署的 MCP 服务,系统自动填充连接参数。

    • 自定义:配置用户自行部署或使用第三方平台托管的 MCP 服务。

      • transport:与 MCP 服务通信时使用的底层传输协议。支持SSEStreamableHTTP。

      • url:MCP 服务的完整访问端点 URL。

      • authentication:用于配置访问 MCP 服务时的身份认证信息。支持以下三种:

        • BearerAuth:使用Bearer令牌认证。需在token字段填写有效的访问令牌。

        • Other:需填写auth_header_nametoken,说明从哪个请求头获取token。

        • None: 不需要身份认证。

  3. (可选) 运行连通性测试验证 MCP 服务可访问。

  4. 单击提交创建工具。

配置 Agent 节点

Agent节点的配置页面,找到MCP工具,支持2种配置方式:

  • 选择已有的MCP工具连接:需先创建可复用的MCP工具连接,详情请参见创建 MCP 工具连接。一个 MCP 服务通常会提供多个工具(Tools),可以设置工具范围和审批工具。

    • 通过工具范围选项,可以控制哪些工具对大模型可见。

    • 对于具有敏感操作(如修改用户数据)的工具,可以通过审批工具功能进行保护。当工作流执行到这些工具时,节点会自动暂停,并等待人工确认;审批通过后,工作流才会继续执行。

  • 自定义添加MCP配置:仅在该节点中可用。

image

配置其他类型工具

Agent节点的配置页面,进入工具,可以选择添加各种工具。对于选中的工具,支持编辑该工具的描述、是否“需要审批”等参数。image

  • 知识库:参见知识库管理创建知识库后再为Agent添加。

  • 自定义工具(OpenAPI工具)

    • 可以选择已有自定义工具或者新建自定义工具

    • 支持将PAI-EAS上已部署的LangStudio服务创建为工具,也可以选择手动填入OpenAPI 规范进行创建。

    • 工具创建成功后,可进入工具详情页,使用测试功能发送示例请求并验证响应。

  • Python工具:

    • 可选择已有工具或者新建Python工具

    • 如新建,设置工具集名称后,在打开的页面上编辑代码并进行测试。

    • 查看或编辑已有 Python 工具:单击应用开发页面右上角的更多 > 纯代码模式 ,文件位于应用源码目录下的tools文件夹内。

  • 联网搜索工具:使用阿里云IQS-标准搜索,添加工具后参见阿里云IQS-联网搜索(IQS-GenericSearch)进行配置。