Vai al contenuto
Tutti gli strumenti

teams_search_messages

Microsoft Teams · macOS · Windows

Effetto: lettura. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Cerca nei messaggi di chat e di canale di Microsoft Teams di un account Microsoft 365 con Microsoft Search: per testo e, facoltativamente, per mittente e intervallo di date. Usalo per trovare dove si è discusso di qualcosa senza conoscere la chat. I risultati arrivano nell'ordine di pertinenza di Microsoft (non dal più recente) e body è un frammento attorno alla corrispondenza, non l'intero messaggio; leggi la chat con teams_read_chat_messages per il resto. Restituisce al massimo 100 risultati da al massimo 4 pagine della ricerca. Quando la lettura viene interrotta (da quel limite, o perché la chiamata ha esaurito il tempo) la risposta contiene truncated: true. Richiede un account Microsoft 365 di lavoro o scuola collegato con connect_m365_account (gli account Microsoft personali non hanno letture di Teams). Quando non è collegato alcun account Microsoft 365, legge invece la cache locale dell'app Teams su questo Mac (richiede Accesso completo al disco, può essere indietro di ore o giorni); il campo source della risposta indica quale dei due ha risposto (graph o local_cache).

Input obbligatori

Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.

Autorizzazioni e conferma

Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per teams_search_messages. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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

Windows

Scopo

Cerca nella cronologia delle tue chat e dei messaggi diretti di Microsoft Teams (tutte le conversazioni insieme) per testo, nome del mittente e/o intervallo di date. Usalo per trovare dove si è discusso di qualcosa in Teams senza sapere in quale chat. Restituisce i messaggi corrispondenti (i più pertinenti per primi), ciascuno con un frammento e la chat da cui provengono. Restituisce al massimo 100 risultati da al massimo 4 pagine della ricerca. Quando la lettura viene interrotta (da quel limite, o perché la chiamata ha esaurito il tempo) la risposta contiene truncated: true.

Input obbligatori

Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.

Autorizzazioni e conferma

Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per teams_search_messages. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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