Übersicht über die Arbeits-IQ-API (Vorschau)

Mit der Work IQ-API können Entwickler agentische und KI-gestützte Anwendungen erstellen, die microsoft 365-Daten sicher verarbeiten und gleichzeitig vorhandene Berechtigungen, Compliance- und Governancekontrollen beibehalten.

Work IQ bietet mehrere Protokolle für die Interaktion mit Agents – Agent-zu-Agent (A2A), Modellkontextprotokoll (MCP) und REST – sodass Sie das Protokoll auswählen können, das am besten zu Ihrer Anwendungs- oder Agent-Architektur passt. In dieser öffentlichen Vorschau sind A2A und lokale MCP ab sofort verfügbar. REST und Remote MCP sind in Kürze verfügbar.

Durch den Zugriff auf oder die Verwendung der Microsoft Work IQ-APIs stimmen Sie den Nutzungsbedingungen für Microsoft Work IQ-APIs (Vorschau) zu.

Was ist Work IQ?

Work IQ ist die Intelligenzebene hinter Microsoft 365 Copilot und Agents. Im Gegensatz zu Systemen, die einfach Inhalte abrufen, versteht es, wie die Arbeit tatsächlich abläuft. Es kombiniert Daten aus Microsoft 365 (E-Mails, Besprechungen, Dokumente, Chats) mit Erinnerungen an Muster, Präferenzen und Beziehungen. Es wendet den Rückschluss an, der erforderlich ist, um alle Schlussfolgerungen zu begründen und die nächstbesten Aktionen anzuzeigen. Work IQ orchestriert jede Ebene der Intelligenz – von der Zusammenstellung des Kontexts bis hin zu Erdungsantworten, der Auswahl von Fähigkeiten und dem Aufrufen von Tools – und berücksichtigt gleichzeitig Unternehmensberechtigungen und Governance.

Alle Work IQ-Anforderungen:

  • Ausführen im Kontext des angemeldeten Benutzers
  • Berücksichtigen von Microsoft 365-Berechtigungen und Vertraulichkeitsbezeichnungen
  • Bleiben Sie innerhalb der Microsoft 365-Vertrauensgrenze

Dies ermöglicht Es Anwendungen, Arbeitsdaten zu überarbeiten, ohne Inhalte zu exportieren oder zu duplizieren.

Gründe für die Verwendung von Work IQ

Herkömmliche KI-Integrationen erfordern häufig das Erstellen benutzerdefinierter Pipelines zum Extrahieren, Indizieren und Schützen von Unternehmensdaten. Work IQ beseitigt diese Komplexität, indem Folgendes bereitgestellt wird:

  • Sicheres Unternehmenserding: Der Zugriff auf Microsoft 365-Daten wird automatisch durch Berechtigungen gekürzt und durch Richtlinien erzwungen.
  • Flexible Interaktionsmodelle: Wählen Sie zwischen Konversations-APIs, Agent-Delegierung oder toolbasiertem Zugriff aus.
  • Reduzierter Betriebsaufwand: Es ist nicht erforderlich, Vektorspeicher, Datensynchronisierungsaufträge oder benutzerdefinierte Complianceerzwingung zu verwalten.

Unterstützte Protokolle

Work IQ unterstützt die folgenden Protokolle:

Protokoll Beschreibung Typische Szenarien
A2A Strukturierte Kommunikation zwischen Agent und Agent Multi-Agent-Systeme, Delegierung
Lokale MCP Toolbasierter Kontextzugriff IDEs, CLIs, KI-Codierungsassistenten
Remote MCP Toolbasierter Kontextzugriff IDEs, CLIs, KI-Codierungsassistenten
REST (in Kürze verfügbar) Konversations-, Anforderungs-/Antwort-API Vom Dienst gehostete Agents, Orchestratoren

Unterstützte Funktionen

Der Arbeits-IQ kann folgende Ursachen haben:

  • E-Mails
  • Besprechungs- und Kalenderdaten
  • Dokumente in OneDrive und SharePoint
  • Microsoft Teams-Nachrichten
  • People und Organisationskontext
  • Unternehmenssuchergebnisse

Auswählen eines Protokolls

Verwenden Sie die folgende Anleitung, um das richtige Protokoll auszuwählen.

Hinweis

Die folgende Tabelle enthält Empfehlungen für das am besten geeignete Protokoll für bestimmte Szenarien, nicht für strenge Regeln. Verwenden Sie das Protokoll, das für Sie am besten geeignet ist.

A2A REST-API (in Kürze verfügbar) MCP
Verwenden Sie , wenn Ein anderer Agent muss eine Aufgabe an den Arbeits-IQ delegieren und Ergebnisse zurück erhalten. Sie erstellen eine App oder einen Dienst, der Work IQ programmgesteuert aufruft Ein KI-Assistent (Copilot, Claude usw.) muss Arbeits-IQ als Tool für den Benutzer aufrufen.
Caller Ein anderer Agent Ihre App oder Ihr Back-End Ein LLM-basierter Client
Beispiel "Unser Ops-Agent fordert Work IQ auf, eine Regression zu untersuchen." "Meine Web-App sendet eine Frage an Work IQ und rendert die Antwort." "Ein Benutzer stellt Copilot eine Frage und ruft Work IQ auf, um zu antworten."

API-Beispiele

Agent-zu-Agent-Protokoll (A2A)

Verwenden Sie A2A für die Zusammenarbeit und Delegierung von Agents, bei denen Agents autonom arbeiten und strukturierte Aufgaben anstelle einfacher API-Aufrufe austauschen. Work IQ unterstützt sowohl A2A v1.0 als auch v0.3, die über den Anforderungsheader A2A-Version verteilt werden.

Work IQ Gateway

  • Endpunkt: https://workiq.svc.cloud.microsoft/a2a/
  • Tokenzielgruppe: api://workiq.svc.cloud.microsoft
  • Bereich: WorkIQAgent.Ask

Beispielanforderung – Synchronisieren (SendMessage)

POST https://workiq.svc.cloud.microsoft/a2a/
Authorization: Bearer {access-token}
Content-Type: application/json
A2A-Version: 1.0

{
  "jsonrpc": "2.0",
  "id": "<request-guid>",
  "method": "SendMessage",
  "params": {
    "message": {
      "role": "ROLE_USER",
      "messageId": "<message-guid>",
      "parts": [
        {
          "text": "What meetings do I have today?"
        }
      ],
      "metadata": {
        "Location": {
          "timeZoneOffset": -480,
          "timeZone": "America/Los_Angeles"
        }
      }
    }
  }
}

Hinweis

Der A2A-Version: 1.0 Header ist erforderlich, um v1.0-Methodennamen (SendMessage) zu verwenden. Wenn Sie sie weglassen, wird standardmäßig v0.3 verwendet.

Beispielantwort

{
  "jsonrpc": "2.0",
  "id": "<request-guid>",
  "result": {
    "task": {
      "id": "<task-id>",
      "contextId": "ctx-1",
      "status": {
        "state": "TASK_STATE_COMPLETED"
      },
      "artifacts": [
        {
          "artifactId": "<artifact-id>",
          "name": "Answer",
          "parts": [
            {
              "text": "Today you have: 9 AM standup, 11 AM review with Dana, 2 PM customer call."
            }
          ]
        }
      ]
    }
  }
}

Unterhaltungen mit mehreren Durchläufen

Übergeben Sie den contextId aus der vorherigen Antwort in der nächsten Nachricht:

{
  "jsonrpc": "2.0",
  "id": "<request-guid-2>",
  "method": "SendMessage",
  "params": {
    "message": {
      "role": "ROLE_USER",
      "messageId": "<message-guid-2>",
      "contextId": "ctx-1",
      "parts": [
        {
          "text": "Tell me more about the 2 PM customer call."
        }
      ]
    }
  }
}

Wichtige Merkmale

  • JSON-RPC-Umschlag erforderlich (jsonrpc, id, method, params)
  • POST zur Basis-URL : Der Methodenname befindet sich im Text, nicht im URL-Pfad.
  • Unterstützt synchrone (SendMessage)
  • Mehrfachdrehen über contextId
  • Location Metadaten, die für zeitkritische Abfragen erforderlich sind

Remote Model Context Protocol (MCP)

Verwenden Sie MCP, um den Microsoft 365-Arbeitskontext als Tools für KI-Assistenten verfügbar zu machen, die in Entwicklerumgebungen ausgeführt werden.

Wichtig

  • Aktueller Status: Heute ist der Microsoft 365-Arbeitskontext über einzelne MCP-Server für bestimmte Workloads verfügbar.
  • Demnächst: Ein einzelner, einheitlicher Remotearbeits-IQ-MCP-Server konsolidiert diese zu einem Server mit einem zusammengestellten Satz von Tools und Fähigkeiten, wodurch die Konfiguration vereinfacht und eine konsistente Entwicklerumgebung bereitgestellt wird.

Lokale MCP

Installieren Sie die Microsoft Work IQ CLI (Vorschau), und konfigurieren Sie sie als lokalen MCP-Server.

Beispiel für eine MCP-Serverkonfiguration

{
  "workiq": {
    "type": "stdio",
    "command": "workiq",
    "args": ["mcp"]
  }
}

Beispiel für eine Agent-basierte Abfrage

Eingabeaufforderung

Summarize recent discussions about project risks.

Konzeptioneller MCP-Aufruf
{
  "tool": "workiq.search",
  "arguments": {
    "query": "project risks",
    "source": "teams"
  }
}
Ergebnis
{
  "results": [
    {
      "summary": "Recent discussions highlighted timeline and dependency risks."
    }
  ]
}

Wichtige Merkmale

  • Optimiert für IDEs und CLIs
  • Kontext wird bei Bedarf dynamisch gepullt
  • Reduziert manuelles Erstellen von Aufforderungen
  • Einzelserver mit konsolidierten Tools (in Kürze verfügbar)

Authentifizierung und Sicherheit

Work IQ verwendet Microsoft Entra ID delegierte Authentifizierung.

  • Anforderungen werden im Kontext des angemeldeten Benutzers ausgeführt
  • On-Behalf-of-Flows (OBO) werden unterstützt.
  • Die reine Anwendungsauthentifizierung wird nicht unterstützt.
  • Microsoft 365-Berechtigungen, Vertraulichkeitsbezeichnungen und Konformitätsrichtlinien werden automatisch erzwungen

Vergleich von Work IQ mit Copilot Chat-API

Work IQ ist die produktionsbereite Weiterentwicklung der Copilot Chat-API. Wenn Work IQ die allgemeine Verfügbarkeit erreicht (Mai 2026), wird dies zur empfohlenen, vollständig unterstützten Methode für die Integration mit dem Copilot-Agent in Produktionsszenarien. Es wird durch Unternehmens-SLAs, stabile Verträge und langfristige Supportverpflichtungen unterstützt.

Für Sie bedeutet das:

  • Neue Projekte sollten vom ersten Tag an auf Work IQ aufbauen.
  • Vorhandene Integrationen, die die Copilot Chat-API verwenden, funktionieren weiterhin. Die Copilot Chat-API verbleibt in der öffentlichen Vorschau für Experimente und die Entwicklung in der frühen Phase, wird aber nicht von Produktions-SLAs abgedeckt.
  • Die Migration ist einfach: Der Arbeits-IQ behält die konzepte bei, die Sie bereits kennen, und fügt die Zuverlässigkeits-, Governance- und Supportgarantien hinzu, die für Produktionsworkloads erforderlich sind.

Es wird empfohlen, Ihren Wechsel zu Work IQ vor der Veröffentlichung Ihres Produkts zu planen, um den Produktionssupport bei der Einführung in vollem Umfang nutzen zu können.

Verwandte Inhalte

  • Last updated on