TypeSpec 宣言型エージェントの作成

Microsoft 365 Copilot 用の完全な TypeSpec 宣言型エージェントを以下の構造で作成します:

要件

以下の内容を含む main.tsp ファイルを生成してください:

1. エージェント宣言

   • @agent デコレータを説明的な名前と説明とともに使用
   • 名前は 100 文字以内
   • 説明は 1,000 文字以内

2. 指示

   • @instructions デコレータで明確な行動ガイドラインを指定
   • エージェントの役割、専門知識、および個性を定義
   • エージェントが実施すべきことと実施すべきでないことを指定
   • 8,000 文字以内に収める

3. 会話スターター

   • 2～4 個の @conversationStarter デコレータを含める
   • それぞれにタイトルとサンプルクエリを設定
   • 多様で異なる機能を示すようにする

4. 機能 (ユーザーのニーズに基づく)

   • WebSearch - ウェブコンテンツ検索 (オプションでサイトスコープ指定可能)
   • OneDriveAndSharePoint - ドキュメントアクセス (URL フィルタリング付き)
   • TeamsMessages - Teams チャネル/チャットアクセス
   • Email - メールアクセス (フォルダフィルタリング付き)
   • People - 組織内ユーザー検索
   • CodeInterpreter - Python コード実行
   • GraphicArt - 画像生成
   • GraphConnectors - Copilot コネクタコンテンツ
   • Dataverse - Dataverse データアクセス
   • Meetings - 会議コンテンツアクセス

テンプレート構造

import "@typespec/http";
import "@typespec/openapi3";
import "@microsoft/typespec-m365-copilot";

using TypeSpec.Http;
using TypeSpec.M365.Copilot.Agents;

@agent({
  name: "[Agent Name]",
  description: "[Agent Description]"
})
@instructions("""
  [Detailed instructions about agent behavior, role, and guidelines]
""")
@conversationStarter(#{
  title: "[Starter Title 1]",
  text: "[Example query 1]"
})
@conversationStarter(#{
  title: "[Starter Title 2]",
  text: "[Example query 2]"
})
namespace [AgentName] {
  // Add capabilities as operations here
  op capabilityName is AgentCapabilities.[CapabilityType]<[Parameters]>;
}

ベストプラクティス

• 説明的でロールベースのエージェント名を使用 (例: "顧客サポートアシスタント", "リサーチヘルパー")
• 指示は二人称で記述 ("You are...")
• エージェントの専門知識と制限事項について明確に説明
• 異なる機能を示す多様な会話スターターを含める
• エージェントが実際に必要な機能のみを含める
• より良いパフォーマンスのため、機能のスコープを設定 (URL、フォルダなど)
• 複数行の指示には三重引用符を使用

例

ユーザーに以下を尋ねてください:

1. エージェントの目的と役割は何か?
2. どの機能が必要か?
3. どのナレッジソースにアクセスすべきか?
4. 典型的なユーザーインタラクションは何か?

その後、完全な TypeSpec エージェント定義を生成してください。