Team Info Toolkit
Team Info ツールキットを使うと、エージェントが現在のプロジェクトに割り当てられたチームのメンバーを参照できます:メンバー総数、または名前・メール・ユーザー id による検索。API キーはありません — サインイン中のユーザーのセッションとプロジェクトのチーム設定を使用します。
エージェントの Toolkits タブで追加し、プロジェクトにチームが割り当てられていることを確認してから、ペルソナプロンプトで @ を使ってツールを参照します。
前提条件
- 編集できるエージェント
- プロジェクトの Project Settings → Project Configs → Project Team でチームが選択されていること
- エージェントがプロジェクトコンテキストで実行されること
セットアップ
- プロジェクトを開き → Settings → Project Configs へ。
- Project Team でチームを選択して保存。
- エージェントを開き → Toolkits → Team Info を追加。
- 保存し、メンバー数または名前/メール検索でテスト。
利用可能なツール
| ツール | 説明 |
|---|---|
| Get Team Member Count | プロジェクトに割り当てられたチームのメンバー数を返す。 |
| Search Team Members | 部分的な名前、メール、ユーザー id によるメンバー検索(大文字小文字を区別しない)。Limit 1–50(デフォルト 10)。 |
検索結果には、ユーザーレコード上に存在する場合、名前、メール、部署、会社、最終サインイン、タグ、メタデータなどのフィールドが含まれる場合があります。
ユースケース
- 「このチームには何人いますか?」に答える
- プロジェクトに招待する前に、部分的な名前からチームメイトのメールを見つける
- チャットで言及された名前に一致する人物を解決する
ヒント
- スコープはプロジェクトに割り当てられたチームのみ — プラットフォーム全体ではありません。
- 検索はユーザー id、メール、名前に一致します(すべてのメタデータフィールドの全文検索ではありません)。
- 結果には個人データ(メール、名前)が含まれます。エージェントの利用者に適切な場合のみこのツールキットを有効化してください。
- プロジェクトへの招待や所属の変更には、プロジェクトの Members 設定(またはプロジェクトを管理する Autopilot の Build フロー)を使用してください。
トラブルシューティング
| 症状 | 確認すること |
|---|---|
| チームが欠けているというエラー | Project Settings → Project Configs → Project Team でチームを割り当てる |
| 検索結果が空 | 別の表記を試す;その人がそのチームにいるか確認 |
| 別のチームのメンバー | プロジェクトに割り当てられたチームが意図したものか確認 |
| プロジェクトコンテキストがない | プロジェクト内でエージェントを実行する |