Vue d’ensemble de l’API Work IQ (préversion)

L’API Work IQ permet aux développeurs de créer des applications basées sur des agents et basées sur l’IA qui raisonner en toute sécurité sur les données Microsoft 365 tout en conservant les autorisations, la conformité et les contrôles de gouvernance existants.

Work IQ fournit plusieurs protocoles pour interagir avec les agents : agent à agent (A2A), MCP (Model Context Protocol) et REST, ce qui vous permet de choisir le protocole qui convient le mieux à votre architecture d’application ou d’agent. Dans cette préversion publique, A2A et mcp local sont disponibles dès aujourd’hui. REST et MCP distant seront bientôt disponibles.

En accédant ou en utilisant les API Microsoft Work IQ, vous acceptez les conditions d’utilisation des API Microsoft Work IQ (préversion) .

Qu’est-ce que Work IQ ?

Work IQ est la couche d’intelligence derrière Microsoft 365 Copilot et les agents. Contrairement aux systèmes qui récupèrent simplement du contenu, il comprend comment le travail se produit réellement. Il combine les données de Microsoft 365 (e-mails, réunions, documents, conversations) avec la mémoire des modèles, des préférences et des relations. Il applique l’inférence nécessaire à la raison sur l’ensemble de celui-ci et fait apparaître les actions les plus performantes suivantes. Work IQ orchestre chaque couche d’intelligence , de l’assemblage du contexte à la mise en terre des réponses, en passant par la sélection des compétences et l’appel d’outils, tout en respectant les autorisations et la gouvernance de l’entreprise.

Toutes les demandes work IQ :

• Exécuter dans le contexte de l’utilisateur connecté
• Respecter les autorisations microsoft 365 et les étiquettes de confidentialité
• Rester dans la limite d’approbation Microsoft 365

Cela permet aux applications de raisonner sur les données de travail sans exporter ou dupliquer du contenu.

Pourquoi utiliser Work IQ ?

Les intégrations d’IA traditionnelles nécessitent souvent la création de pipelines personnalisés pour extraire, indexer et sécuriser les données d’entreprise. Work IQ élimine cette complexité en fournissant :

• Sécurisation de la base de l’entreprise : L’accès aux données Microsoft 365 est automatiquement supprimé des autorisations et appliqué aux stratégies.
• Modèles d’interaction flexibles : Choisissez parmi les API de conversation, la délégation d’agent ou l’accès basé sur les outils.
• Réduction de la surcharge opérationnelle : Il n’est pas nécessaire de gérer les magasins de vecteurs, les travaux de synchronisation des données ou l’application de conformité personnalisée.

Protocoles pris en charge

Work IQ prend en charge les protocoles suivants :

Fonctionnalités prises en charge

Le QI de travail peut raisonner sur :

• Messages électroniques
• Réunions et données de calendrier
• Documents dans OneDrive et SharePoint
• Messages Microsoft Teams
• People et contexte organisationnel
• Résultats de la recherche d’entreprise

Choisir un protocole

Utilisez le guide ci-dessous pour sélectionner le protocole approprié.

Exemples d’API

Protocole agent à agent (A2A)

Utilisez A2A pour la collaboration et la délégation des agents, où les agents fonctionnent de manière autonome et échangent des tâches structurées au lieu d’appels d’API simples. Work IQ prend en charge les A2A v1.0 et v0.3, distribuées via l’en-tête de requêteA2A-Version.

Work IQ Gateway

• Terminaison: https://workiq.svc.cloud.microsoft/a2a/
• Audience du jeton : api://workiq.svc.cloud.microsoft
• Portée :WorkIQAgent.Ask

Exemple de demande — synchronisation (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"
        }
      }
    }
  }
}

Exemple de réponse

{
  "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."
            }
          ]
        }
      ]
    }
  }
}

Conversations multitours

Transmettez le contextId à partir de la réponse précédente dans le message suivant :

{
  "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."
        }
      ]
    }
  }
}

Principales caractéristiques

• Enveloppe JSON-RPC requise (jsonrpc, id, method, params)
• POST vers l’URL de base : le nom de la méthode se trouve dans le corps, et non le chemin d’URL
• Prend en charge synchrone (SendMessage)
• Multitour via contextId
• Location métadonnées requises pour les requêtes limitées dans le temps

Protocole MCP (Remote Model Context Protocol)

Utilisez MCP pour exposer le contexte de travail Microsoft 365 en tant qu’outils pour les assistants IA s’exécutant dans des environnements de développement.

Local MCP

Installez l’interface CLI Microsoft Work IQ (préversion) et configurez-la en tant que serveur MCP local.

Exemple de configuration de serveur MCP

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

Exemple de requête basée sur un agent

Invite

Summarize recent discussions about project risks.

Appel MCP conceptuel

{
  "tool": "workiq.search",
  "arguments": {
    "query": "project risks",
    "source": "teams"
  }
}

Résultat

{
  "results": [
    {
      "summary": "Recent discussions highlighted timeline and dependency risks."
    }
  ]
}

Principales caractéristiques

• Optimisé pour les IDE et les CLIs
• Contexte extrait dynamiquement si nécessaire
• Réduit la construction manuelle de l’invite
• Serveur unique avec outils consolidés (bientôt disponible)

Authentification et sécurité

Work IQ utilise l’authentification déléguée Microsoft Entra ID.

• Les requêtes s’exécutent dans le contexte de l’utilisateur connecté
• Les flux on-behalf-of (OBO) sont pris en charge
• L’authentification d’application uniquement n’est pas prise en charge
• Les autorisations Microsoft 365, les étiquettes de confidentialité et les stratégies de conformité sont appliquées automatiquement

Comparaison de Work IQ avec l’API Copilot Chat

Work IQ sera l’évolution prête pour la production de l’API Copilot Chat. Lorsque Work IQ atteint la disponibilité générale (dès le mois de mai), il devient le moyen recommandé et entièrement pris en charge pour s’intégrer à l’agent Copilot dans les scénarios de production. Il sera soutenu par des contrats SLA d’entreprise, des contrats stables et des engagements de support à long terme.

Conséquences pour vous :

• Les nouveaux projets doivent s’appuyer sur Work IQ dès le premier jour.
• Les intégrations existantes utilisant l’API Copilot Chat continueront de fonctionner. L’API Copilot Chat restera en préversion publique pour l’expérimentation et le développement à un stade précoce, mais elle n’est pas couverte par les contrats SLA de production.
• La migration est simple : Work IQ conserve les concepts que vous connaissez déjà et ajoute les garanties de fiabilité, de gouvernance et de support requises pour les charges de travail de production.

Nous vous recommandons de planifier votre passage à Work IQ avant la sortie de votre produit pour tirer pleinement parti de la prise en charge de la production au lancement.

Contenu connexe

• Démarrages rapides de l’API Work IQ (préversion)