重要
你需要是边境预览计划的一部分，才能提前访问 Microsoft Agent 365。 边界将你直接与Microsoft最新的 AI 创新联系起来。 边境预览版受客户协议现有预览条款的约束。 由于这些功能仍在开发中，其可用性和功能可能会随时间而变化。
通过开发 隧道，你可以用 Microsoft 365 应用程序（如 Teams、Outlook 或 Word）测试你的 Agent 365，而你的代理则在开发机器上本地运行。 这种方法连接了本地开发和实际测试，因此你可以在部署到云端之前，在实际的 Microsoft 365 环境中验证代理行为。
先决条件
在使用开发隧道之前，务必安装开发 隧道的命令行工具。
- Windows：
winget install Microsoft.devtunnel - macOS/Linux：从 aka.ms/devtunnels/download 下载
建立开发隧道
配置开发隧道，将本地代理端点暴露给Microsoft 365服务。
创建并启动隧道
登录开发隧道：
devtunnel user login创建持久隧道：
devtunnel create --allow-anonymous该命令返回隧道ID。 请保存此标识以备将来使用。
配置隧道端口：
分配你的代理服务器使用的端口（通常是3978）：
devtunnel port create <tunnel-id> -p <port-number>启动隧道：
devtunnel host <tunnel-id>该命令显示你的隧道URL（例如，
https://abc123xyz.devtunnels.ms:3978）。 复制此网址以便下一步。
小窍门
用来 devtunnel list 查看你所有的隧道，并 devtunnel delete <tunnel-id> 移除不再需要的隧道。
配置代理消息传递端点
注册你的开发隧道 URL（例如 https://abc123xyz.devtunnels.ms:3978/api/messages）作为代理消息终端，这样 Microsoft 365 就知道消息的路由位置。 别忘了端点后 /api/messages 缀。
请参见 Set agent消息终端
用 Microsoft 365 测试
在开发隧道激活且终端注册后，在 Microsoft 365 应用中测试你的代理。
在 Microsoft Teams 中测试
按照“安装依赖”中的说明启动本地代理，并启动代理应用服务器。
验证隧道连接性：
devtunnel list检查你的隧道是否显示有活跃的主机连接。 “主机连接”列应显示大于0的数字。
在Teams中与你的客服互动：
- 打开 Microsoft Teams（网页或桌面）
- 在Teams搜索栏中，请通过姓名或电子邮件搜索您的代理人
- 和代理人开始对话
- 发送消息并观察回复
- 检查本地控制台是否有收到请求和代理活动
测试邮件通知
如果你的座席设置为 发送邮件通知：
- 给你代理人的邮箱发送邮件
- 在邮件线程中抄送你的代理人
- 监控本地控制台的通知网络钩子
- 核实你的客服流程并回复邮件
测试字积分
对于回复Word评论的客服：
- 打开一个Word文档，让你的代理人能访问。
- 添加一条评论，提及你的经纪人。
- 请查看你本地的控制台是否有通知。
- 请确认您的代理回复显示在Word中。
监控隧道活动
Dev Tunnels 提供流量检查功能，帮助调试连接问题并理解请求流程：
devtunnel show <tunnel-id>
该命令显示：
- 活跃连接和会话详情。
- 请求和响应信息。
- 交通流量统计数据。
- 连接错误和警告。
你还可以通过观看命令的 devtunnel host 输出实时监控隧道活动。
保持隧道连接
开发隧道需要进程 devtunnel host 持续运行。 如果不活跃、网络问题或电脑进入睡眠导致连接中断，你需要重启。
检查隧道状态
确认你的隧道是否处于激活状态：
devtunnel list
输出显示：
- 隧道ID：您的隧道标识符
-
主机连接数：活跃连接数（运行时
devtunnel host应为一个或多个） - 端口：配置端口
- 到期时间：隧道到期时间
如果 主机连接 显示为0，隧道存在但目前未被托管。
重启断开的隧道
如果隧道连接断开，使用相同的隧道 ID 重启：
devtunnel host <tunnel-id>
隧道URL保持不变，所以你不需要更新代理消息终端配置。
开发过程中保持隧道活跃
为了保持稳定的连接：
-
保持终端窗口开启 ——不要关闭运行
devtunnel host中的终端。 - 防止电脑睡眠 ——配置系统在测试过程中保持清醒。
-
注意连接错误 ——监控
devtunnel host终端输出是否有断线消息。 - 网络变更后重启 ——如果你切换网络或重新连接VPN，请重启隧道。
小窍门
如果你的隧道经常断开连接，检查一下网络设置和防火墙规则，确保它们没有阻断连接。
清理
当你完成开发隧道测试后：
阻止隧道
按下 Ctrl+C 终端 devtunnel host ，运行以停止隧道。
该命令会移除代理消息端点的开发隧道URL。 部署到生产环境时，设置云端端点URL。
注释
隧道在你通过 明确删除之前 devtunnel delete <tunnel-id>，仍可继续使用。
局限性
在使用开发隧道测试时，请考虑以下限制：
- 仅限开发：开发隧道用于开发和测试，而非生产环境。
- 性能：由于网络路由，预计延迟会比云端代理更高。
- 连接稳定性：隧道连接偶尔会断开，需要手动重启。
-
安全考虑：该
--allow-anonymous标志方便测试，但不要用它处理敏感数据。 - 会话管理：根据会话时长，可能需要定期重新认证。
后续步骤
在成功测试开发隧道后：
- 将代理部署到云端：部署 到 Azure， 在 AWS 中设置代理消息终端，或 在 GCP 中设置代理消息终端。
- 配置代理消息终端：代理 消息终端。
- 请关注完整的开发生命周期： Agent 365 开发生命周期。
Troubleshooting
如果你在通过开发隧道测试时遇到问题，可以从这里开始，了解通用隧道、连接性和端点修复。 关于更广泛的 Agent 365 故障排除（设置、认证和消息发送），请参见 故障排除。
隧道连接失败
症状：开发隧道无法启动或立即断开连接。
解决方法：
- 确认你已登录：
devtunnel user login - 检查一下有没有其他进程在使用同一个端口
- 确保你的防火墙允许开发隧道连接
- 删除并重建隧道：
devtunnel delete <tunnel-id>然后重新创建一个新的
消息无法到达本地代理
症状：Microsoft 365显示已发送消息，但本地代理未收到。
解决方法：
- 确认你的代理是否在本地运行
- 确认隧道是否活跃：
devtunnel list应该显示“已连接”。 - 检查端点配置：
a365 config display应该会显示你的开发隧道URL。 - 检查终端运行
devtunnel host中的开发隧道日志，查找连接错误 - 确保你的本地端口和隧道端口匹配（默认两者都应该是3978）
通过开发隧道的认证错误
症状：通过开发隧道测试时出现401或403错误。
解决方法：
- 验证代理认证已配置（持有令牌认证无法在 Microsoft 365 的开发隧道中支持）。
- 通过使用
a365 config display -g。 - 确认你的代理是否拥有你测试的作所需的权限。
- 确保你的认证令牌没有过期。
隧道URL更改或过期
症状：之前正常工作的隧道URL不再被路由到你的代理。
解决方法：
- 通过使用
devtunnel list。 - 通过使用
devtunnel host <tunnel-id>。 - 如果 URL 通过使用
a365 setup blueprint --endpoint-only.