Vue d’ensemble de l’API Work IQ

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

Work IQ fournit plusieurs protocoles pour interagir avec les agents (Agent-to-Agent (A2A), Model Context Protocol (MCP) et REST, afin que vous puissiez choisir le protocole qui convient le mieux à votre application ou à l’architecture de l’agent.

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

Qu’est-ce que le QI au travail ?

Work IQ est une couche d’intelligence du lieu de travail qui combine les données Microsoft 365 avec une compréhension contextuelle afin que les agents puissent réfléchir sur le travail et agir. Pour obtenir une vue d’ensemble complète des fonctionnalités de 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 offrant :

• Ancrage sécurisé de l’entreprise : L’accès aux données Microsoft 365 est automatiquement découpé en fonction des autorisations et des stratégies.
• Modèles d’interaction flexibles : Choisissez entre les API conversationnelles, la délégation d’agent ou l’accès basé sur des outils.
• Réduction des frais généraux opérationnels : Vous n’avez pas besoin de gérer les magasins vectoriels, les tâches de synchronisation des données ou l’application de la 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
• Données de réunions et de calendrier
• Documents dans OneDrive et SharePoint
• Messages Microsoft Teams
• People et contexte organisationnel
• Plans du Planificateur Microsoft
• Résultats de la recherche d’entreprise

Choisissez un protocole

Utilisez le guide suivant 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 opèrent de manière autonome et échangent des tâches structurées au lieu de simples appels d’API. Work IQ prend en charge à la fois A2A v1.0 et v0.3, distribués via l’en-tête de A2A-Version requête.

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 à plusieurs tours

Transmettez la contextId 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, , idmethod, params)
• POST vers l’URL de base — le nom de la méthode se trouve dans le corps, pas dans le chemin de l’URL
• Prend en charge synchrone (SendMessage)
• Multi-tours via contextId
• Location Métadonnées requises pour les requêtes urgentes

Protocole MCP (Remote Model Context Protocol)

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

Local MCP

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

▶ Explorer le MCP local dans la démo interactive

Exemple de configuration du 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 conceptuel MCP

{
  "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 CLI
• Contexte extrait dynamiquement si nécessaire
• Réduit la construction manuelle d’invites
• 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 demandes s’exécutent dans le contexte de l’utilisateur connecté.
• Les flux OBO (de la part de) sont pris en charge.
• L’authentification par 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.

Voie à suivre pour de nouveaux développements

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 de nouveaux développements sur les API Work IQ pour tirer parti des protocoles unifiés, de la gouvernance intégrée et des investissements continus.

Conditions d'octroi de licence

L’API Work IQ est concédée sous licence en vertu de votre contrat régissant l’utilisation des services en ligne Microsoft, y compris les conditions des produits Microsoft. 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

• Démarrage rapide Work IQ A2A
• Vue d’ensemble de l’API REST de Work IQ
• Microsoft Work IQ CLI
• Conditions d’utilisation des API Microsoft Work IQ
• Comprendre la facturation basée sur l’utilisation et la gestion des coûts pour les crédits Copilot
• Gestion des expériences d’IA rendues possibles par la facturation à l’utilisation
• Paramètre de découverte pour les expériences d’IA rendues possibles par la facturation à l’utilisation
• Essayez les API dans la démonstration interactive