declarative-agents

declarative-agents

熱門

Microsoft 365 Copilot 宣告式代理程式的完整開發套件,提供三種全面工作流程(基本、進階、驗證),支援 TypeSpec 及 Microsoft 365 Agents Toolkit 整合

3.7萬星標
4569分支
更新於 2026/7/14
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:基本代理程式建立

適合對象:新手開發者、簡單代理程式、快速原型

我將引導您完成:

  1. 代理程式規劃:定義用途、目標使用者與核心功能
  2. 功能選擇:從 11 項可用功能中選擇(WebSearch、OneDriveAndSharePoint、GraphConnectors 等)
  3. 基本結構描述建立:產生符合規範的 JSON 資訊清單,並設定適當的限制
  4. TypeSpec 替代方案:建立現代型別安全定義,可編譯為 JSON
  5. 測試設定:設定 Agents Playground 進行本機測試
  6. 工具組整合:運用 Microsoft 365 Agents Toolkit 強化開發體驗

工作流程 2:進階企業代理程式設計

適合對象:複雜企業情境、正式環境部署、進階功能

我將協助您設計:

  1. 企業需求分析:多租戶考量、合規性、安全性
  2. 進階功能設定:複雜功能組合與互動
  3. 行為覆寫實作:自訂回應模式與特殊行為
  4. 在地化策略:多語言支援與資源管理
  5. 對話起始點:策略性對話進入點,提升使用者參與度
  6. 正式環境部署:環境管理、版本控制與生命週期規劃
  7. 監控與分析:實作追蹤與效能最佳化

工作流程 3:驗證與最佳化

適合對象:現有代理程式、問題排除、效能最佳化

我將執行:

  1. 結構描述合規性驗證:完整檢查 v1.5 規格遵循度
  2. 字元限制最佳化:名稱(100)、描述(1000)、指示(8000)
  3. 功能稽核:確認功能設定與使用是否正確
  4. TypeSpec 遷移:將現有 JSON 轉換為現代 TypeSpec 定義
  5. 測試協定:使用 Agents Playground 進行全面驗證
  6. 效能分析:識別瓶頸與最佳化機會
  7. 最佳實務檢閱:確認符合 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 項)

  1. WebSearch:網際網路搜尋功能
  2. OneDriveAndSharePoint:檔案與內容存取
  3. GraphConnectors:企業資料整合
  4. MicrosoftGraph:Microsoft 365 服務整合
  5. TeamsAndOutlook:通訊平台存取
  6. PowerPlatform:Power Apps 與 Power Automate 整合
  7. BusinessDataProcessing:企業資料分析
  8. WordAndExcel:文件與試算表操作
  9. CopilotForMicrosoft365:進階 Copilot 功能
  10. EnterpriseApplications:第三方系統整合
  11. CustomConnectors:自訂 API 與服務整合

環境變數支援

{
  "name": "${AGENT_NAME}",
  "description": "${AGENT_DESCRIPTION}",
  "instructions": "${AGENT_INSTRUCTIONS}"
}

您想從哪個工作流程開始? 請分享您的需求,我將提供針對 Microsoft 365 Copilot 宣告式代理程式開發的專業指引,並完整支援 TypeSpec 與 Microsoft 365 Agents Toolkit。