本文由国际版原文本地化，文末提供原文链接。涉及的能力以易企办中国版租户和权限为准。
销售需要查看 CRM 中的最新客户资料，运营团队要从运输平台查询发运状态，伙伴团队也可能先把变更同步到 SharePoint，再在业务应用中解读最新数据。AI 要参与这些工作，需要一组可理解、经过授权的外部系统操作。
国际版的「调用 REST API」工具支持 OpenAPI 定义。构建者可描述业务应用允许 AI 调用的操作，并让智能体或 Copilot 根据上下文选择合适的操作。
先把外部系统操作定义清楚
业务应用经常需要协同 CRM、合同文件库、服务工单系统和财务系统。配置外部访问前，应让团队可以回答以下问题。
- AI 可以访问哪些系统及连接。
- 向它提供哪些操作，每项操作解决什么问题。
- 操作需要哪些参数，会返回哪些字段。
- 使用哪套连接、认证和权限范围。
一条固定的 HTTP 请求可以处理单一任务。随着场景增多，维护一组经过审查的操作，比让每个场景单独猜测地址和参数更容易管理。
在配置中选择连接并导入定义
在工具配置里选择已有的 HTTP API 或 OAuth 2.0 API 连接，再提供描述允许操作的 YAML 或 JSON 定义。平台解析后识别 HTTP 方法、路径、参数与操作描述。根据用户当前的请求，AI 可从已经公开给该工具的操作中选择一项，并把结构化结果带回业务应用。
OpenAPI 定义带来的四项改进
- 明确外部能力。定义可以说明每项操作的用途、输入参数和返回格式。
- 缩小选择范围。AI 从预先列出的操作中选择，不需要自行构造未配置的端点。
- 控制连接和授权。管理员及构建者可以明确使用的连接，并审阅提供给特定智能体的操作。
- 支持复用。同一组经过确认的操作，可用于读取数据、查看状态、更新记录或整理返回结果。
用连接、定义和操作描述划出边界
外部系统通常有许多端点。每个智能体或 Copilot 只需获得其场景所需的操作。连接决定如何访问目标系统，定义决定哪些操作可调用，操作描述帮助 AI 知道何时使用，返回值则用于应用内的后续处理。
可以从只读操作开始。若还需写入，要确认接口权限、更新字段和重试行为，并把有业务后果的操作纳入审阅或审批。
示例：伙伴管理、SharePoint 与 Copilot
团队在应用中维护伙伴记录。伙伴状态改变后，用户更新该记录，工作流通过获准的 API 连接把变更同步到 SharePoint，让其他团队也能查看。
随后，用户请 Copilot 总结最新伙伴状态。系统从配置的定义中识别允许的 SharePoint 操作，例如获取列表详情、读取列表字段、读取列表记录和更新列表记录。对这次查询，Copilot 可选择读取最新记录，再在应用中整理成摘要。更新能力由连接与操作定义独立限定。
对业务团队和管理员的价值
业务人员可以在当前应用中查看来自外部系统的最新资料和摘要，减少频繁切换。构建者和管理员可以复用已有连接，用定义描述可用能力，并分别审查读写范围、参数和返回数据。
接入真实业务上下文后，AI 可以在授权边界内使用应用数据、工作流信息和外部记录，参与查询、更新及后续工作。可用的连接类型与操作以易企办租户配置为准。
查看易企办开发者 API或了解 SharePoint 集成。
返回易企办博客