Ü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), Model Context Protocol (MCP) und REST – damit Sie das Protokoll auswählen können, das am besten zu Ihrer Anwendungs- oder Agent-Architektur passt.

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?

Arbeits-IQ ist eine Arbeitsplatzintelligenzebene, die Microsoft 365-Daten mit kontextbezogenem Verständnis kombiniert, sodass Agents die Arbeit überarbeiten und Maßnahmen ergreifen können. Eine vollständige Übersicht über die Work IQ-Funktionen finden Sie unter Übersicht über den Arbeits-IQ.

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 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 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.

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 remote MCP , um den Microsoft 365-Arbeitskontext als Tools für KI-Assistenten verfügbar zu machen, die in Entwicklerumgebungen ausgeführt werden.

Lokale MCP

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

▶ Sehen Sie es in Aktion in der interaktiven Demo (Vorschau)

▶ Sehen Sie es in Aktion in der interaktiven Demo (Vorschau)

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

Weg in die Zukunft für neue Entwicklung

Work IQ ist die empfohlene Grundlage für neue agentische und KI-gestützte Anwendungen auf Microsoft 365-Daten. Erstellen Sie neue Entwicklungen auf Arbeits-IQ-APIs, um einheitliche Protokolle, integrierte Governance und kontinuierliche Investitionen zu nutzen.

Verwandte Inhalte

  • Last updated on