创建智能体实例

在发布智能体并使其在 Microsoft 管理中心可用后，您可以创建智能体实例和智能体用户。这些实例和用户将使用您创建的智能体蓝图和智能体代码。

本文将该过程分解为三个主要步骤：

在 Teams 开发者门户中配置智能体
创建智能体实例
测试已部署的智能体

如果遇到问题，请参阅故障排除部分。

必备条件

已按照设置智能体蓝图步骤中的说明正确设置了智能体蓝图。
智能体应用程序已按照将智能体发布到 Microsoft 管理中心中的说明正确发布。

1. 在 Teams 开发者门户中配置智能体

发布后，请在 Teams 开发者门户中配置智能体蓝图，以将您的智能体连接到 Microsoft 365 消息传递基础架构。如果没有此配置，您的智能体将无法接收来自 Teams、电子邮件或其他 Microsoft 365 服务的消息。

获取您的蓝图 ID

在您的工作目录中打开 a365.generated.config.json，并复制 agentBlueprintId 的值。
导航至开发者门户

打开浏览器，访问配置页面：
```
https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration
```
将 <your-blueprint-id> 替换为您复制的 agentBlueprintId 值。

备注

如果您无法访问开发者门户，请联系您的租户管理员，请求其授予您访问权限或代您完成此配置。
配置智能体

在开发者门户中：
1. 将智能体类型设置为基于 API
2. 将通知 URL 设置为您的智能体的消息传递端点。在 a365.generated.config.json 中找到 messagingEndpoint 的值。
3. 选择保存。

您必须完成此配置，才能在 Teams 中创建智能体实例。

了解有关智能体身份蓝图和开发者门户配置的更多信息。

2. 创建智能体实例

现在，您可以从 Teams 请求智能体蓝图的实例。了解有关如何发现、创建和接入智能体的更多信息。

当您请求智能体实例时，Teams 会将该请求发送给您的租户管理员以供审批。管理员可以在 Microsoft 管理中心 - 已请求的智能体页面上审核并批准请求。

管理员批准您的请求后，Teams 会创建您的智能体实例，并使其在 Teams 中可用。

3. 测试已部署的智能体

创建智能体实例后，请在 Microsoft 365 中进行测试，以确保其在生产环境中正常运行。

部署完成后，并在 Agent 365 SDK 中启用智能体通知后，您的智能体将与 Microsoft 365 服务集成。它支持 Teams 中的聊天、频道和会议；支持电子邮件和日历的发送、接收和安排；以及支持 SharePoint 和 OneDrive 的文档访问和文件共享。它还支持协作功能，例如组织在线状态、Planner 任务和文档评论。

重要提示

与普通用户一样，智能体用户也需要相应的 Microsoft 365 许可证才能访问服务。常见许可证包括 Microsoft 365 E5、Teams Enterprise 和智能智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 许可证。

在管理中心查看已部署的智能体

发布智能体后，它将显示在 Microsoft 管理中心中以供招聘。信息同步可能需要一些时间。

转到 Microsoft 365 管理中心 - 智能体以：

查看已发布的智能体
管理代理设置
监控智能体使用情况
配置权限

在 Teams 中测试智能体

在部署、发布并配置智能体蓝图以及创建智能体用户后，可直接在 Microsoft Teams 中测试该智能体用户：

开始测试

在 Teams 中搜索您的新智能体用户。

备注

智能体用户的创建过程是异步的。创建智能体用户后，可能需要几分钟到几小时的时间，该用户才能被搜索到。
与新创建的智能体实例开始新的聊天。
发送测试消息以验证智能体功能。

测试消息示例

如果您为智能体配置了电子邮件功能，请发送此消息以测试电子邮件功能。更新收件人 recipient@contoso.com 的电子邮件值。

Send an email to <recipient@contoso.com> with subject "Hello from Teams" and message "This is a test message from my agent!"

智能体会处理该请求并发送电子邮件，无需进一步确认。

验证清单

创建智能体实例后，请在 Teams 中验证其是否正常工作。

✅ 开发者门户配置已保存
✅ 智能体出现在 Teams 应用搜索结果中
✅ 您可以向 Teams 创建智能体实例
✅ 智能体实例已创建
✅ 智能体用户出现在组织中
✅ 智能体可响应消息
✅ 智能体可执行操作
✅ 应用程序日志未显示错误
✅ 管理中心中的可观察性功能

如果您的智能体实例未按预期运行，请参阅故障排除部分，了解常见问题的详细解决方案。

验证开发者门户配置是否已保存

导航至：https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration

✅ 智能体类型显示：基于 API 的✅通知 URL 与您的智能体的消息终结点一致，✅ 显示已成功保存消息

验证智能体是否出现在 Teams 中

打开 Teams >应用
搜索您的智能体名称

✅智能体出现在搜索结果中✅显示您的智能体图标和描述

验证您能否将智能体实例添加到 Teams

在 Teams 应用中选择您的智能体

✅ 请求实例/创建实例按钮处于启用状态 ✅ 可无错误地请求实例

验证智能体实例已创建

选择请求实例后：

✅ 请求已成功发送给管理员

验证智能体用户是否出现在组织中

在 Microsoft 365 管理中心：

转到： https://admin.cloud.microsoft/#/agents/all
导航至“所有智能体”请求选项卡

✅您的智能体实例请求已列出，状态为“待审核”✅ 管理员可批准该智能体实例以供使用✅用户可从 Teams 创建实例并为其命名。

验证智能体是否能响应消息

在 Teams 聊天中与您的智能体交互 - 发送测试消息：Hello!

✅智能体显示正在输入的指示符 ✅ 智能体在几秒内作出响应 ✅ 响应内容连贯且相关

验证智能体能否执行操作

如果配置了工具，请测试工具的功能。例如，如果添加了邮件 MCP 服务器，请向自己发送一封测试邮件。

智能体应：

✅ 确认请求 ✅ 执行工具调用 ✅ 确认成功完成

您应验证该邮件是否已送达您的收件箱。

验证功能

以下检查清单为您的智能体提供了一种系统化的测试方法：

基本功能：

✅ 智能体能对简单的问候作出回应。 ✅ 智能体能处理多步骤对话。 ✅ 智能体能提供相关的回复。

工具功能：

取决于 MCP 服务器的配置

✅ 能发送电子邮件。 ✅ 能访问日历。 ✅ 能搜索文档。 ✅ 能执行已配置的操作。

错误处理：

✅ 能优雅地处理无效请求。 ✅ 提供有用的错误信息。 ✅ 遇到意外输入时不会崩溃。

性能：

✅ 几秒内响应。 ✅ 无超时错误。 ✅ 响应时间稳定。

验证应用程序日志

要查看智能体的运行情况，请使用 az webapp log tail 命令检查应用程序日志。

# Real-time logs from Azure
az webapp log tail --name <your-web-app> --resource-group <your-resource-group>

日志中应关注的内容：

✅Teams 的传入请求 ✅ 成功的身份验证 ✅ 正在执行的工具调用 ✅ 已发送响应 ❌ 错误消息或异常

在管理中心验证可观测性

智能体开始运行后：

转到：https://admin.cloud.microsoft/#/agents/all。
选择您的智能体并打开活动选项卡。

应会看到：

✅会话开始显示。 ✅ 每个会话都会显示触发器和操作。 ✅ 工具调用会带有时戳记录在日志中。

后续步骤

您的智能体现已部署到云端，并准备好在 Microsoft 365 中与您的团队协同工作。最初的本地代码现在是一个注册的企业就绪的助手，用户可以在其中创建整个组织的智能体实例。

智能体的开发生命周期已告完成，但其影响才刚刚开始。您在 Agent 365 开发生命周期中构建的大部分内容均为开源，并欢迎社区贡献。提交错误、功能请求和拉取请求：

Agent 365 示例：有有趣且好玩的智能体示例吗？请在此处与开源社区分享您的智能体代码！
Node.js SDK：基于 Node.js 的 Agent 365 SDK。
Python SDK：基于 Python 的 Agent 365 SDK。
.NET SDK：基于 C# (.NET) 的 Agent 365 SDK。
Agent 365 DevTools CLI：一款可协助您完成整个 Agent 365 开发生命周期的命令行工具。

故障排除

本节列出了创建和测试智能体实例时常见的故障。

提示

Agent 365 故障排除指南包含高层次的故障排除建议、最佳实践，以及针对 Agent 365 开发生命周期各阶段的故障排除内容链接。

智能体未在 Teams 中显示

症状：智能体出现在管理中心，但在 Teams 应用中找不到。

根本原因：缺少开发者门户配置。

解决方案：

从 a365.generated.config.json 获取您的蓝图 ID — 查找 agentBlueprintId。
在开发者门户中进行配置：
1. 转到： https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration
2. 将智能体类型设置为基于 API
3. 将通知 URL 设置为您的智能体的消息传递端点。在 a365.generated.config.json 中找到 messagingEndpoint 的值。
4. 选择保存。
等待 5-10 分钟以完成传播。

验证：

打开 Teams > 应用 > 搜索您的智能体。
此时会显示智能体，可以进行添加。

无法在 Teams 中创建智能体实例

症状：智能体出现在 Teams 中，但无法添加或创建实例；请求实例按钮无法使用。

根本原因：该租户未启用 Microsoft Agent 365 Frontier。

解决方案：请联系您的租户管理员，确认该租户已启用 Microsoft Agent 365 Frontier。

了解有关 Frontier 的更多信息。

验证：

一旦您的许可证和管理员设置允许，Frontier 功能将出现在智能智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 和 Microsoft 365 应用中。

智能体未响应消息

症状：您创建了智能体实例，但它未响应消息。应用程序中未显示任何日志。

根本原因：可能有多种原因——消息传递端点问题、身份验证问题或配置错误。

基本故障排除

验证 Web 应用程序是否正在运行：

az webapp show --name <your-app-name> --resource-group <your-resource-group> --query state
# Should be: "Running"

检查消息传递端点：
- 应为：https://<your-app-root-url>/api/messages
- 在 a365.config.json 和 a365.generated.config.json 中进行验证

直接测试端点：

curl https://<your-app-root-url>/api/messages
# Should not return 404

检查应用程序日志：

az webapp log tail --name <your-app-name> --resource-group <your-resource-group>
# Look for incoming requests and errors

高级诊断

验证身份验证：
- 检查令牌是否已过期。如有必要，请刷新令牌。
- 验证 Web 应用程序配置中的凭据。
检查工具/MCP 配置：
- 验证 MCP 服务器是否已配置。
- 检查是否已授予相应权限。
本地测试：
- 使用相同的配置在本地运行智能体。
- 使用 Agents Playground 进行测试。
- 如果本地运行正常但在云端无法运行 > 部署问题

常见解决方法

消息传递端点不正确： 在 Azure 门户和开发者门户中进行更新。
Web 应用已停止： 使用 Azure 门户或 CLI 启动它。
令牌已过期：在 Web 应用环境变量中更新令牌。
缺少环境变量：在 Azure 门户中检查应用设置。
MCP 服务器问题：验证服务主体和权限。
代码错误：检查应用程序日志中的异常。

验证

在 Teams 中向您的智能体发送一条消息，并检查应用程序日志中的传入请求。

您还可以尝试：

工具调用失败

症状：智能体会响应消息，但工具调用失败。您看到权限被拒绝或超时错误。

根本原因：缺少 MCP 服务器权限、未配置服务主体、网络连接问题或工具配置错误。

解决方案

当工具调用失败时，请尝试以下解决方案：

在管理中心验证权限

审查并批准所需的 MCP 服务器权限：
- 转到： https://admin.cloud.microsoft/#/agents/all
- 选择您的智能体 > 权限
- 确保列表中包含并已批准所需的 MCP 服务器

检查服务主体

如果您之前未运行过，请运行一次性设置脚本：

# Download and run:
# https://github.com/microsoft/Agent365-devTools/blob/main/scripts/cli/Auth/New-Agent365ToolsServicePrincipalProdPublic.ps1

验证 MCP 端点配置

确保您正在使用生产环境的 MCP 端点：

# Should be production endpoint, not mock
MCP_PLATFORM_ENDPOINT=https://agent365.svc.cloud.microsoft

检查托管身份

验证您的 Web 应用上是否已启用托管身份：

# Verify managed identity is enabled
az webapp identity show --name <your-app-name> --resource-group <your-resource-group>

验证

测试通过 Teams 调用的工具，并检查日志以确认执行是否成功。

您可能还想尝试以下步骤：

许可证分配失败

症状：无法将许可证分配给智能体用户。在管理中心中看到许可证错误。

根本原因：可用许可证不足、许可证类型不正确或权限问题。