查询服务端点（手动）

描述

重要提示：

此活动不会检索模型的输入和输出架构。因此，请参阅模型文档并按照说明使用。

此活动使您能够通过手动编写完整的 JSON 有效负载来向 Databricks 服务端点发送请求。与根据所选模型自动生成请求架构的“查询服务端点”活动不同，此活动要求您自己了解并提供完整的请求结构。

在下列情况下使用此活动：

• 自动生成的架构方法不适用于您的模型类型。
• 您需要完全控制发送到端点的 JSON 有效负载。
• 您正在与自定义或非标准 Databricks 服务端点集成。

如何使用活动

要在 Maestro 智能体流程中使用此活动，请按照以下步骤操作：

1. 在画布中添加服务任务元素，然后打开任务的“属性”面板。

2. 在实施部分的操作下拉列表中，选择启动并等待外部智能体。

3. 选择“Databricks 代理连接器”。

4. 选择现有连接或新建连接。有关详细信息，请参阅Databricks 代理身份验证。

5. 从“活动”中，选择“查询服务端点（手动）” 。

6. 从“服务端点”中，选择要调用的服务端点。

7. 在“输入”字段中，输入要发送到端点的完整 JSON 有效负载。预期的有效负载结构取决于您的模型 — 请参阅其文档。

   例如，对于基于聊天的模型，有效负载可能如下所示：

   {
     "messages": [
       {
         "role": "user",
         "content": "What is the capital of France?"
       }
     ]
   }
   

8. 将开始事件连接到服务任务，然后将服务任务连接到画布上的结束事件节点。

9. 选择“调试”以运行流程。成功运行后，查看全局变量并查找服务任务的响应。

故障排除和调整

由于此活动不检索模型的输入和输出架构，因此请求结构和响应的形式完全取决于您正在调用的服务端点。请参阅 Databricks 工作区中的模型文档，以了解以下内容：

• 必填 JSON 字段及其类型。
• 端点返回的响应对象的结构。

我们建议您先直接在 Databricks 工作区中测试有效负载，以确认预期的输入和输出，然后再将其集成到 Maestro 流程中。