技能 Microsoft 365 Agents SDK (TypeScript)
📦

Microsoft 365 Agents SDK (TypeScript)

安全 🔑 环境变量🌐 网络访问⚙️ 外部命令

使用 TypeScript 构建 Microsoft 365 代理

为 Microsoft 365、Teams 和 Copilot Studio 开��企业级代理。通过 Express 托管、路由和流式响应��能简化代理创建流程。

支持: Claude Codex Code(CC)
🥉 72 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“Microsoft 365 Agents SDK (TypeScript)”。 创建一个回显用户消息的基本 Teams 机器人

预期结果:

  • 从 Microsoft 包导入 AgentApplication 和 startServer
  • 使用 AgentApplication<TurnState> 初始化代理
  • 添加用于回显模式的 onMessage 处理器,发送 context.activity.text
  • 调用 startServer(agent) 在端口 3978 上启动 Express 服务��

正在使用“Microsoft 365 Agents SDK (TypeScript)”。 设置 Azure OpenAI 流式传输以���成诗歌

预期结果:

  • 配置 streamingResponse,启用反馈循环和 AI 标签
  • 使用 schema.org CreativeWork 类型设置敏感度标签
  • 使用带有 fullStream 迭代的 streamText 从 Azure OpenAI 流式传输文本块
  • 将每个 text-delta 排队到 streamingResponse,并在 finally 块中调用 endStream

安全审计

安全
v1 • 2/25/2026

Documentation-only skill with no executable code. Static analysis found zero patterns. The skill provides guidance for Microsoft 365 Agents SDK development. Environment variable usage and npm commands are expected for this development workflow skill.

0
已扫描文件
0
分析行数
3
发现项
1
审计总数

风险因素

🔑 环境变量 (1)
🌐 网络访问 (1)
⚙️ 外部命令 (1)
审计者: claude

质量评分

38
架构
100
可维护性
87
内容
50
社区
100
安全
74
规范符合性

你能构建什么

企业 Teams 机器人开发

为 Microsoft Teams 构建自定义机器人,使用 AgentApplication 路由处理员工请求、自动化工作流程并集成内部系统。

Copilot Studio 扩展

使用 Direct to Engine 集成,通过适当的令牌处理和流式响应,为 Microsoft Copilot Studio 创建自定义操作和插件。

多渠道代理部署

在多个 Microsoft 365 渠道(包括 Teams、Outlook 和 Web)上部署代理,具有一致的路由逻辑和流式支持。

试试这些提示

基本代理设置
使用 AgentApplication 创建一个 Microsoft 365 代理,欢迎新成员并响应 'hello' 消息。包含 Express 服务器设置和 startServer。
使用 Azure OpenAI 的流式响应
构建一个代理处理器,使用 AI SDK 从 Azure OpenAI 流式传输响应。包含适当的错误处理、反馈循环启用和敏感度标签。
Copilot Studio 客户端集成
生成使用 CopilotStudioClient 连接到 Copilot Studio 的代码,包含基于环境的配置和令牌提供器函数。包含对话启动和问题流程。
带验证的 Invoke 活动处理器
为 'invoke' 类型活动创建一个 onActivity 处理器,验证负载,返回状态为 200 的 InvokeResponse,并发送确认消息。

最佳实践

  • 使用 AgentApplication 进行路由,保持处理器专注于单一职责
  • 对于长时间运行的完成操作,首选 streamingResponse,并在 finally 块中调用 endStream
  • 不要在源代码中保留密钥,从环境变量或安全存储加载令牌

避免

  • 直接在源文件中硬编码凭据或令牌,而不是使用环境变量
  • 在消息处理器中使用同步操作阻塞事件循环
  • 在流迭代中跳过错误处理,这可能导致连接挂起

常见问题

进行 Microsoft 365 代理开发需要安装哪些包?
安装 @microsoft/agents-hosting、@microsoft/agents-hosting-express 和 @microsoft/agents-activity 以获得核心功能。添加 @microsoft/agents-copilotstudio-client 用于 Copilot Studio 集成。
如何配置 Azure OpenAI 以进行流式响应?
设置 AZURE_RESOURCE_NAME、AZURE_API_KEY 和 AZURE_OPENAI_DEPLOYMENT_NAME 环境变量。使用带有指向您部署的 azure() 提供器的 AI SDK。
AgentApplication 和直接活动处理器之间有什么区别?
AgentApplication 提供路由、状态管理和生命周期处理。直接处理器需要手动路由逻辑,仅建议用于高级场景。
如何在部署前本地测试我的 Teams 机器人?
在本地运行 Express 服务器,并使用 ngrok 暴露您的端口 3978 端点。在 Azure Bot Service 配置中注册 ngrok URL 以进行测试。
Copilot Studio 客户端连接需要什么身份验证?
您需要 Copilot 环境的有效承载令牌。配置 Azure AD 身份验证的 CLIENT_ID、CLIENT_SECRET 和 TENANT_ID,然后使用令牌提供器函数。
我可以将此技能与 Claude、Codex 或 Claude Code 一起使用吗?
是的,此技能与 Claude、Codex 和 Claude Code 兼容。这三个 AI 助手都可以生成模板中显示的 TypeScript 代码模式。

开发者详情

文件结构

📄 SKILL.md