构建 API 工作流

link

新建 API 工作流项目​

• 解决方案名称： Monster Query - 5e SRD
• 工作流名称： API Query - 5e Monsters

配置输入和输出​

添加 HTTP 请求​

1. 在工作流画布中，选择“+活动”，以打开活动菜单。选择“HTTP” 。该活动在画布上显示为“HTTP 请求” 。
2. 打开活动上下文菜单，然后选择“重命名” 。将其命名为HTTP Request - Open5e Monster Query 。
3. 在属性窗格中，确认“身份验证”为“手动身份验证” ， “方法”为“GET” 。两者都是新活动的默认值，因此通常无需更改任何内容。
4. 将URL设置为https://api.open5e.com/v2/creatures/ 。
5. 将活动输出重命名为searchResults 。

• name__icontains ：不区分大小写的部分匹配； dragon将返回“Red Robot 成体”、“ Blue Robot 刚体”等
• document__key: srd-2014：筛选官方 5e SRD；如果没有，结果包括数据库中的每个发布者，包括第三方内容
• limit: 10 ：候选对象的上限为 10；足以使智能体在不会淹没其上下文的情况下进行推理
• fields：限制仅响应智能体所需的字段；完整的 v2 生物对象要大得多，并且会浪费令牌预算

HTTP 请求属性引用​

• 身份验证：OAuth 2.0、API 密钥和基本身份验证的预构建选项。此处设置为“手动身份验证”，因为 Open5e 不需要任何身份验证。对于经过身份验证的 API，请选择适当的选项并提供凭据。
• 标头：随每个请求发送的键/值对。常见用途： Authorization: Bearer <token>表示基于令牌的 API， Accept: application/json用于控制响应格式和 API 版本控制标头。
• 正文：与 POST、PUT 和 PATCH 请求一起使用，以发送 JSON、表单数据或原始内容。不适用于 GET 请求，此类请求通过查询参数在 URL 中携带参数。
• 查询参数：附加到 URL 的键/值对。要引用工作流参数，请输入 @ 以打开变量选取器，然后选择参数 - 字段存储 $input.<name> 并将其显示为芯片。@ 是选取器的触发字符，而非您可以输入的参考语法。有关在 Studio Web 中变量和表达式的更多信息，请参阅配置活动。
• 输出（重命名为searchResults ） ：接收完整的 HTTP 响应，包括状态代码、标头和正文。非默认重命名可使响应表达式可读。

添加响应​

1. 在工作流画布中，选择“HTTP 请求”后的“+” ，然后选择“响应” 。

   “响应”活动定义 API 工作流返回给调用者的内容（在本例中，为智能体工具在调用工作流时收到的内容）。您在此处的响应正文中输入的任何内容都将成为智能体推理的工具输出。

2. 将响应正文设置为：

   assignment

   {
     "monsterResults": $context.outputs.searchResults.content.results
   }
   {
     "monsterResults": $context.outputs.searchResults.content.results
   }
   

测试工作流​

1. 在工具栏中选择“调试” 。
2. 在输入面板中，将searchName设置为dragon或goblin ，然后运行工作流。
3. 请先验证响应是否包含包含巨大条目的monsterResults数组，然后再继续操作。

发布到您的订阅源​

1. 在工具栏中选择“发布” 。
2. 在发布对话框中，选择“对于我” ，以发布到您的个人工作区订阅源。个人工作区订阅源是与 Orchestrator 工作区绑定的私有包存储库；发布“属于我”后，此工作流仅对您可见，您正是开发和测试的作用域。有关详细信息，请参阅 UiPath 文档中的个人工作区。
3. 选择“发布”以确认。

---