المهارات 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

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "Microsoft 365 Agents SDK (TypeScript)". 建立基本的 Teams 機器人以回應用戶訊息

النتيجة المتوقعة:

  • 從 Microsoft 套件匯入 AgentApplication 和 startServer
  • 使用 AgentApplication<TurnState> 初始化智慧代理
  • 新增用於 echo 模式的 onMessage 處理常式以傳送 context.activity.text
  • 呼叫 startServer(agent) 在 PORT 3978 啟動 Express 伺服器

استخدام "Microsoft 365 Agents SDK (TypeScript)". 設定與 Azure OpenAI 的串流以進行詩歌生成

النتيجة المتوقعة:

  • 設定包含回饋迴圈和 AI 標籤啟用的 streamingResponse
  • 使用 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 機器人開發

使用 AgentApplication 路由建構自訂 Microsoft Teams 機器人,處理員工請求、自動化工作流程,並與內部系統整合。

Copilot Studio 擴充功能

使用 Direct to Engine 整合建立 Microsoft Copilot Studio 的自訂動作和外掛程式,包含適當的權杖處理和串流回應。

多重管道智慧代理部署

跨越多重 Microsoft 365 管道(包括 Teams、Outlook 和網頁)部署智慧代理,具有一致的路由邏輯和串流支援。

جرّب هذه الموجهات

基礎智慧代理設定
使用 AgentApplication 建立 Microsoft 365 智慧代理,歡迎新成員並回應「hello」訊息。包含使用 startServer 的 Express 伺服器設定。
使用 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 環境變數。使用指向您部署的 AI SDK 與 azure() 提供者。
AgentApplication 和直接活動處理常式之間的差異為何?
AgentApplication 提供路由、狀態管理和生命週期處理。直接處理常式需要手動路由邏輯,僅建議用於進階情境。
部署前如何在本地測試 Teams 機器人?
在本地執行 Express 伺服器,並使用 ngrok 公開您的 PORT 3978 端點。在 Azure Bot Service 組態中註冊 ngrok URL 以進行測試。
Copilot Studio 用戶端連線需要哪些認證?
您需要 Copilot 環境的有效 bearer token。設定 CLIENT_ID、CLIENT_SECRET 和 TENANT_ID 以進行 Azure AD 認證,然後使用權杖提供者函式。
我可以搭配 Claude、Codex 或 Claude Code 使用此技能嗎?
是的,此技能與 Claude、Codex 和 Claude Code 相容。這三個 AI 助手都能生成範本中顯示的 TypeScript 程式碼模式。

تفاصيل المطور

المؤلف

sickn33

الترخيص

MIT

مرجع

main

بنية الملفات

📄 SKILL.md