Introducción a work IQ API

Work IQ API permite a los desarrolladores crear aplicaciones con tecnología de agente e inteligencia artificial que razonan de forma segura sobre los datos de Microsoft 365, a la vez que conservan los permisos, el cumplimiento y los controles de gobernanza existentes.

Work IQ proporciona varios protocolos para interactuar con agentes (agente a agente (A2A), protocolo de contexto de modelo (MCP) y REST, para que pueda elegir el protocolo que mejor se adapte a la arquitectura de aplicación o agente.

Al acceder o usar las API de Microsoft Work IQ, acepta los Términos de uso de las API de Microsoft Work IQ.

¿Qué es Work IQ?

Work IQ es una capa de inteligencia del área de trabajo que combina datos de Microsoft 365 con comprensión contextual para que los agentes puedan razonar sobre el trabajo y tomar medidas. Para obtener información general completa sobre las funcionalidades de Work IQ, consulte Información general de Work IQ.

¿Por qué usar Work IQ?

Las integraciones de inteligencia artificial tradicionales suelen requerir la creación de canalizaciones personalizadas para extraer, indexar y proteger los datos empresariales. Work IQ elimina esta complejidad proporcionando:

  • Protección de la conexión a tierra empresarial: El acceso a los datos de Microsoft 365 se recorta automáticamente mediante permisos y se aplica a las directivas.
  • Modelos de interacción flexible: Elija entre las API conversacionales, la delegación del agente o el acceso basado en herramientas.
  • Sobrecarga operativa reducida: No es necesario administrar almacenes de vectores, trabajos de sincronización de datos ni cumplimiento de cumplimiento personalizado.

Protocolos admitidos

Work IQ admite los siguientes protocolos:

Protocolo Descripción Escenarios típicos
A2A Comunicación estructurada de agente a agente Sistemas multiagente, delegación
Local MCP Acceso al contexto basado en herramientas IDE, CLI, asistentes de codificación de inteligencia artificial
MCP remoto Acceso al contexto basado en herramientas IDE, CLI, asistentes de codificación de inteligencia artificial
REST API de conversación, solicitud y respuesta Agentes hospedados por el servicio, orquestadores

Funcionalidad admitida

Work IQ puede razonar sobre lo siguiente:

  • Mensajes de correo electrónico
  • Reuniones y datos de calendario
  • Documentos en OneDrive y SharePoint
  • Mensajes de Microsoft Teams
  • People y contexto organizativo
  • Resultados de la búsqueda empresarial

Elección de un protocolo

Use la siguiente guía para seleccionar el protocolo correcto.

Nota:

La tabla siguiente contiene recomendaciones para el protocolo más adecuado para escenarios específicos, no reglas estrictas. Use el protocolo que mejor funcione para usted.

A2A API REST (próximamente) MCP
Usar cuando Otro agente debe delegar una tarea en Work IQ y obtener resultados de nuevo. Está creando una aplicación o servicio que llama a Work IQ mediante programación. Una asistente de inteligencia artificial debe invocar Work IQ como una herramienta para el usuario.
Caller Otro agente Aplicación o back-end Un cliente basado en LLM
Ejemplo "Nuestro agente de operaciones pide a Work IQ que investigue una regresión". "Mi aplicación web envía una pregunta a Work IQ y representa la respuesta". "Un usuario le hace una pregunta a Copilot y llama a Work IQ para responder".

Ejemplos de API

Protocolo agente a agente (A2A)

Use A2A para la colaboración y delegación de agentes, donde los agentes operan de forma autónoma e intercambian tareas estructuradas en lugar de llamadas API sencillas. Work IQ admite A2A v1.0 y v0.3, que se envían a través del encabezado de solicitudA2A-Version.

Solicitud de ejemplo: sincronización (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"
        }
      }
    }
  }
}

Nota:

El A2A-Version: 1.0 encabezado es necesario para usar nombres de método v1.0 (SendMessage). Si se omite, el valor predeterminado es v0.3.

Ejemplo de respuesta

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

Conversaciones de varios turnos

Pase de contextId la respuesta anterior en el mensaje siguiente:

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

Características claves

  • Se requiere un sobre JSON-RPC (jsonrpc, id, method, params)
  • POST a la dirección URL base: el nombre del método está dentro del cuerpo, no la ruta de acceso de la dirección URL.
  • Admite sincrónica (SendMessage)
  • Multiturno a través de contextId
  • Location metadatos necesarios para las consultas que distinguen el tiempo

Protocolo de contexto de modelo remoto (MCP)

Use MCP remoto para exponer el contexto de trabajo de Microsoft 365 como herramientas para los asistentes de inteligencia artificial que se ejecutan en entornos de desarrollador.

Local MCP

Instale la CLI de Microsoft Work IQ y configúrela como un servidor MCP local.

▶ Verlo en acción en la demostración interactiva

▶ Verlo en acción en la demostración interactiva

Configuración del servidor MCP de ejemplo

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

Consulta basada en agente de ejemplo

Prompt

Summarize recent discussions about project risks.

Invocación de MCP conceptual
{
  "tool": "workiq.search",
  "arguments": {
    "query": "project risks",
    "source": "teams"
  }
}
Resultado
{
  "results": [
    {
      "summary": "Recent discussions highlighted timeline and dependency risks."
    }
  ]
}

Características claves

  • Optimizado para IDE y CLI
  • Contexto extraído dinámicamente cuando es necesario
  • Reduce la construcción manual de avisos
  • Servidor único con herramientas consolidadas (próximamente)

Autenticación y seguridad

Work IQ usa Microsoft Entra ID autenticación delegada.

  • Las solicitudes se ejecutan en el contexto del usuario que ha iniciado sesión.
  • Se admiten flujos en nombre de (OBO).
  • No se admite la autenticación solo de aplicación.
  • Los permisos, las etiquetas de confidencialidad y las directivas de cumplimiento de Microsoft 365 se aplican automáticamente.

Ruta de avance para el nuevo desarrollo

Work IQ es la base recomendada para nuevas aplicaciones con tecnología de inteligencia artificial y agente en datos de Microsoft 365. Cree un nuevo desarrollo en las API de IQ de trabajo para aprovechar los protocolos unificados, la gobernanza integrada y la inversión continuada.

Requisitos de licencias

Paga por el uso de work IQ API a través de un modelo basado en el uso que usa créditos de Copilot. Para obtener más información, consulte Descripción de la facturación basada en el uso y la administración de costos para créditos de Copilot.

Contenido relacionado

  • Last updated on