teams_read_transcript

macOS

Zweck

Liest das Transkript eines von einem Chat aus gestarteten Microsoft-Teams-Anrufs oder einer Kalenderbesprechung (transcript_id aus teams_list_transcripts) als Zeilen «HH:MM · Person: Text», in der Zeitzone dieses Computers, die ältesten zuerst. Nur lesend. Ein Anruf braucht die Microsoft-365-Berechtigung CallTranscripts.Read.All, eine Besprechung OnlineMeetingTranscript.Read.All und OnlineMeetings.Read; ein Administrator der Organisation muss die Transkript-Berechtigung genehmigen: Ohne sie lautet die Antwort consent_required und sagt, was der Administrator gefragt werden muss. Hat die Organisation den Transkriptzugriff abgeschaltet oder verbirgt sie, wer gesprochen hat, sagt die Antwort es (speakers: false bedeutet, die Zeilen haben keine Person). Gibt höchstens limit Zeilen zurück (Standard 500, höchstens 2000); ein längeres Transkript hat truncated: true. Erfordert ein mit connect_m365_account verbundenes Microsoft-365-Arbeits- oder Schulkonto.

Erforderliche Eingaben

• transcript_id

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

• Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

{
  "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"
    },
    "limit": {
      "description": "Max lines to return (default 500, at most 2000)",
      "type": "integer"
    },
    "transcript_id": {
      "description": "Transcript ID from teams_list_transcripts (call:... or meeting:...)",
      "type": "string"
    }
  },
  "required": [
    "transcript_id"
  ],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für teams_read_transcript. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

{
  "limit": 200,
  "transcript_id": "demo-transcript-1"
}