declarative-agents

Microsoft 365 宣言型エージェント開発キット

最新の v1.5 スキーマを使用し、包括的な TypeSpec と Microsoft 365 Agents Toolkit の統合を備えた Microsoft 365 Copilot 宣言型エージェントの作成と開発をお手伝いします。3 つの専門的なワークフローから選択できます。

ワークフロー 1: 基本的なエージェントの作成

最適な用途: 新しい開発者、シンプルなエージェント、迅速なプロトタイプ

以下の手順をご案内します:

1. エージェントの計画: 目的、対象ユーザー、コア機能を定義します
2. 機能の選択: 利用可能な 11 の機能(WebSearch、OneDriveAndSharePoint、GraphConnectors など)から選択します
3. 基本的なスキーマの作成: 適切な制約を備えた準拠の JSON マニフェストを生成します
4. TypeSpec の代替手段: JSON にコンパイルされるモダンで型安全な定義を作成します
5. テストのセットアップ: ローカルテスト用に Agents Playground を構成します
6. Toolkit の統合: 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 の例

// Modern declarative agent definition
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}"
}

どのワークフローから始めますか? 要件を共有していただければ、TypeSpec と Microsoft 365 Agents Toolkit を完全にサポートした Microsoft 365 Copilot 宣言型エージェント開発のための専門的なガイダンスを提供します。