Vue d’ensemble de l’API Work IQ

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. Vous pouvez donc choisir le protocole qui convient le mieux à votre architecture d’application ou d’agent.

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

Qu’est-ce que Work IQ ?

Work IQ est une couche de veille sur le lieu de travail qui combine des données Microsoft 365 avec une compréhension contextuelle afin que les agents puissent raisonner sur le travail et prendre des mesures. Pour obtenir une vue d’ensemble complète des fonctionnalités work IQ, consultez Vue d’ensemble de Work IQ.

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 :

Protocole Description Scénarios classiques
A2A Communication d’agent à agent structurée Systèmes multi-agents, délégation
Local MCP Accès au contexte basé sur les outils IDE, CLIs, assistants de codage IA
MCP distant Accès au contexte basé sur les outils IDE, CLIs, assistants de codage IA
REST API conversationnelle, requête/réponse Agents hébergés par le service, orchestrateurs

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 suivant pour sélectionner le protocole approprié.

Remarque

Le tableau suivant contient des recommandations pour le protocole le mieux adapté à des scénarios spécifiques, et non des règles strictes. Utilisez le protocole qui vous convient le mieux.

A2A API REST (bientôt disponible) MCP
Utiliser quand Un autre agent doit déléguer une tâche à Work IQ et obtenir les résultats Vous créez une application ou un service qui appelle Work IQ par programmation Un assistant IA doit appeler Work IQ en tant qu’outil pour l’utilisateur
Caller Un autre agent Votre application ou votre back-end Un client LLM
Exemple « Notre agent d’opérations demande à Work IQ d’examiner une régression. » « Mon application web envoie une question à Work IQ et affiche la réponse. » « Un utilisateur pose une question à Copilot et appelle Work IQ pour y répondre. »

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.

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"
        }
      }
    }
  }
}

Remarque

L’en-tête A2A-Version: 1.0 est requis pour utiliser les noms de méthode v1.0 (SendMessage). L’omission est la valeur par défaut v0.3.

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 distant pour exposer le contexte de travail Microsoft 365 en tant qu’outils pour les assistants IA exécutés dans des environnements de développement.

Local MCP

Installez l’interface CLI Microsoft Work IQ et configurez-la en tant que serveur MCP local.

▶ Voyez-le en action dans la démonstration interactive

▶ Voyez-le en action dans la démonstration interactive

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 OBO (On-behalf-of) 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.

Chemin à suivre pour le nouveau développement

Work IQ est la base recommandée pour les nouvelles applications basées sur l’agent et l’IA sur les données Microsoft 365. Créez un nouveau développement sur les API Work IQ pour tirer parti des protocoles unifiés, de la gouvernance intégrée et de l’investissement continu.

Conditions d'octroi de licence

Vous payez pour l’utilisation de l’API Work IQ via un modèle basé sur l’utilisation qui utilise des crédits Copilot. Pour plus d’informations, consultez Comprendre la facturation basée sur l’utilisation et la gestion des coûts pour les crédits Copilot.

Contenu connexe

  • Last updated on