teams_search_messages

Microsoft Teams · macOS · Windows

効果: 読み取り. 状態: 条件付き提供.

「条件付き提供」は、バージョン、プラットフォーム、権限、アカウント、設定に依存する可能性を示し、すべての環境で有効という意味ではありません。

macOS

目的

Microsoft Search を使って、Microsoft 365 アカウントの Microsoft Teams のチャットとチャネルのメッセージを、テキスト、および任意で送信者と日付範囲で検索します。どのチャットか分からなくても、何かが議論された場所を見つけるのに使います。結果は Microsoft の関連度順（新しい順ではありません）で返り、body は一致箇所の前後のスニペットで、メッセージ全体ではありません。残りは teams_read_chat_messages でチャットを読んでください。検索の最大 4 ページから、最大 100 件の結果を返します。読み取りがその上限、または呼び出しの時間切れで打ち切られた場合、応答には truncated: true が付きます。connect_m365_account で接続した職場または学校の Microsoft 365 アカウントが必要です（個人の Microsoft アカウントでは Teams を読み取れません）。Microsoft 365 アカウントがまったく接続されていない場合は、代わりにこの Mac 上の Teams アプリのローカルキャッシュを読み取ります（フルディスクアクセスが必要で、数時間から数日遅れていることがあります）。応答の source は、どちらが応答したか（graph または local_cache）を示します。

必須入力

このプラットフォームのスキーマには必須入力が宣言されていません。任意の選択項目や実行要件が存在する場合があります。

権限と確認

スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

英語の正規技術スキーマ — macOS

{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "from_sender": {
      "description": "Only messages from this sender (name or email; optional)",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 25, max 100)",
      "type": "integer"
    },
    "query": {
      "description": "Text to search for",
      "type": "string"
    },
    "since": {
      "description": "Only messages on/after this date, YYYY-MM-DD (optional)",
      "type": "string"
    },
    "until": {
      "description": "Only messages on/before this date, YYYY-MM-DD (optional)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

ドキュメント例

teams_search_messages のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

{
  "limit": 5,
  "query": "launch checklist"
}

Windows

目的

Microsoft Teams のチャットとダイレクトメッセージの履歴（すべての会話を一度に）を、テキスト、送信者名、日付範囲のいずれかまたは組み合わせで検索します。どのチャットか分からなくても、Teams で何かが議論された場所を見つけるのに使います。一致したメッセージを（関連度の高い順に）、それぞれスニペットと元のチャットとともに返します。検索の最大 4 ページから、最大 100 件の結果を返します。読み取りがその上限、または呼び出しの時間切れで打ち切られた場合、応答には truncated: true が付きます。

必須入力

このプラットフォームのスキーマには必須入力が宣言されていません。任意の選択項目や実行要件が存在する場合があります。

権限と確認

スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

英語の正規技術スキーマ — Windows

{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "from_sender": {
      "description": "Filter to a sender by name (optional)",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 25, max 100)",
      "type": "integer"
    },
    "query": {
      "description": "Text to find in messages",
      "type": "string"
    },
    "since": {
      "description": "Only messages on/after this date, YYYY-MM-DD (optional)",
      "type": "string"
    },
    "until": {
      "description": "Only messages on/before this date, YYYY-MM-DD (optional)",
      "type": "string"
    }
  },
  "type": "object"
}

ドキュメント例

{
  "limit": 5,
  "query": "launch checklist"
}