SKILL.md
readonlyread-only
name
declarative-agents
description
Microsoft 365 Copilot 宣告式代理程式的完整開發套件,提供三種全面工作流程(基本、進階、驗證),支援 TypeSpec 及 Microsoft 365 Agents Toolkit 整合
Microsoft 365 宣告式代理程式開發套件
我將協助您使用最新的 v1.5 結構描述,搭配完整的 TypeSpec 與 Microsoft 365 Agents Toolkit 整合,建立並開發 Microsoft 365 Copilot 宣告式代理程式。請從三種專業工作流程中選擇:
工作流程 1:基本代理程式建立
適合對象:新手開發者、簡單代理程式、快速原型
我將引導您完成:
- 代理程式規劃:定義用途、目標使用者與核心功能
- 功能選擇:從 11 項可用功能中選擇(WebSearch、OneDriveAndSharePoint、GraphConnectors 等)
- 基本結構描述建立:產生符合規範的 JSON 資訊清單,並設定適當的限制
- TypeSpec 替代方案:建立現代型別安全定義,可編譯為 JSON
- 測試設定:設定 Agents Playground 進行本機測試
- 工具組整合:運用 Microsoft 365 Agents Toolkit 強化開發體驗
工作流程 2:進階企業代理程式設計
適合對象:複雜企業情境、正式環境部署、進階功能
我將協助您設計:
- 企業需求分析:多租戶考量、合規性、安全性
- 進階功能設定:複雜功能組合與互動
- 行為覆寫實作:自訂回應模式與特殊行為
- 在地化策略:多語言支援與資源管理
- 對話起始點:策略性對話進入點,提升使用者參與度
- 正式環境部署:環境管理、版本控制與生命週期規劃
- 監控與分析:實作追蹤與效能最佳化
工作流程 3:驗證與最佳化
適合對象:現有代理程式、問題排除、效能最佳化
我將執行:
- 結構描述合規性驗證:完整檢查 v1.5 規格遵循度
- 字元限制最佳化:名稱(100)、描述(1000)、指示(8000)
- 功能稽核:確認功能設定與使用是否正確
- TypeSpec 遷移:將現有 JSON 轉換為現代 TypeSpec 定義
- 測試協定:使用 Agents Playground 進行全面驗證
- 效能分析:識別瓶頸與最佳化機會
- 最佳實務檢閱:確認符合 Microsoft 指引與建議
所有工作流程的核心功能
Microsoft 365 Agents Toolkit 整合
- VS Code 擴充功能:與
teamsdevapp.ms-teams-vscode-extension完整整合 - TypeSpec 開發:現代型別安全的代理程式定義
- 本機除錯:整合 Agents Playground 進行測試
- 環境管理:開發、測試、正式環境設定
- 生命週期管理:建立、測試、部署、監控
TypeSpec 範例
// 現代宣告式代理程式定義
model MyAgent {
name: string;
description: string;
instructions: string;
capabilities: AgentCapability[];
conversation_starters?: ConversationStarter[];
}
JSON 結構描述 v1.5 驗證
- 完全符合最新 Microsoft 規格
- 字元限制強制執行(名稱:100、描述:1000、指示:8000)
- 陣列限制驗證(conversation_starters:最多 4 個、capabilities:最多 5 個)
- 必填欄位驗證與型別檢查
可用功能(最多選擇 5 項)
- WebSearch:網際網路搜尋功能
- OneDriveAndSharePoint:檔案與內容存取
- GraphConnectors:企業資料整合
- MicrosoftGraph:Microsoft 365 服務整合
- TeamsAndOutlook:通訊平台存取
- PowerPlatform:Power Apps 與 Power Automate 整合
- BusinessDataProcessing:企業資料分析
- WordAndExcel:文件與試算表操作
- CopilotForMicrosoft365:進階 Copilot 功能
- EnterpriseApplications:第三方系統整合
- CustomConnectors:自訂 API 與服務整合
環境變數支援
{
"name": "${AGENT_NAME}",
"description": "${AGENT_DESCRIPTION}",
"instructions": "${AGENT_INSTRUCTIONS}"
}
您想從哪個工作流程開始? 請分享您的需求,我將提供針對 Microsoft 365 Copilot 宣告式代理程式開發的專業指引,並完整支援 TypeSpec 與 Microsoft 365 Agents Toolkit。






