调用智能体

在 Maestro 智能体流程中调用基于响应 API 构建的 Microsoft Azure AI Foundry 智能体。

描述

此活动允许使用基于响应 API 构建的 Microsoft Azure AI Foundry 智能体，作为 Maestro 编排的自动化流程的参与者。

Foundry 智能体表面

Azure AI Foundry 在同一个项目端点上公开两个单独的智能体界面：

• Assistant （传统） — 通过/assistants API 创建。请使用“执行线程”活动。
• 智能体（Foundry 门户）— 在 Azure AI Foundry 门户中创建，并通过响应 API 调用。为此，请使用调用代理。

备注：

只有提示类型和托管类型的智能体经过验证，可用于此活动。此类工作流或外部智能体尚未经过验证，也未确认是否可行。

如何使用活动

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

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

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

3. 选择“Microsoft Azure AI Foundry连接器”。

4. 选择现有连接或新建连接。有关更多信息，请参阅Microsoft Azure AI Foundry 身份验证。

5. 在“活动”中，选择“调用智能体” 。

6. 在“智能体”中，从 Azure AI Foundry 项目的智能体列表中选择一个智能体。每个条目都会在其名称旁边显示智能体的类型，例如 ah-vo-script-agent (hosted)。

7. 在消息中，输入要发送给智能体的提示词。

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

9. 选择“调试”以运行此流程。

   活动始终异步运行：Integration Service 会轮询智能体的响应，并在运行完成后继续 Maestro 步骤。

输出

参数	描述
响应标识符	智能体响应的唯一标识符。
状态	响应的当前状态：queued、in_progress、completed、failed 或 incomplete。
输出文本	智能体的应答文本。
模型标识符	生成响应的模型。
错误代码	运行未成功完成时的错误代码（status 为 failed）。成功则为空。
错误消息	人工可读的运行失败原因（status 为 failed）。成功则为空。
原因不完整	运行未完成结束的原因（status 为 incomplete），例如 content_filter 或 max_output_tokens。成功则为空。
使用的输入令牌	消耗的输入令牌数量。
输出已使用的令牌	生成的输出令牌数量。
使用的令牌总数	请求期间消耗的令牌总数。

将输出分配给流程变量，以便它可以影响 Maestro 流程的进度，例如，按状态进行分支，或使用输出文本中的答案。

备注：

活动的响应时间取决于连接的轮询间隔，默认为 5 分钟。因此，已完成的运行可能显示为慢于实际完成时间。