Introducción a work IQ API (versión preliminar)

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. En esta versión preliminar pública, A2A y MCP local están disponibles hoy; REST y MCP remotos llegarán próximamente.

Al acceder o usar las API de Microsoft Work IQ, acepta los Términos de uso (versión preliminar) de las API de Microsoft Work IQ.

¿Qué es Work IQ?

Work IQ es la capa de inteligencia detrás de Microsoft 365 Copilot y agentes. A diferencia de los sistemas que simplemente recuperan contenido, entiende cómo se produce realmente el trabajo. Combina datos de Microsoft 365 (correos electrónicos, reuniones, documentos, chats) con memoria de patrones, preferencias y relaciones. Aplica la inferencia necesaria para razonar en todo él y exponer las siguientes acciones óptimas. Work IQ organiza todas las capas de inteligencia, desde el ensamblado del contexto hasta la puesta en tierra de respuestas, la selección de aptitudes y la invocación de herramientas, a la vez que respeta los permisos y la gobernanza de la empresa.

Todas las solicitudes de IQ de trabajo:

• Ejecutar en el contexto del usuario que ha iniciado sesión
• Respetar las etiquetas de confidencialidad y permisos de Microsoft 365
• Permanecer dentro del límite de confianza de Microsoft 365

Esto permite a las aplicaciones razonar sobre los datos de trabajo sin exportar ni duplicar contenido.

¿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:

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 guía siguiente para seleccionar el protocolo correcto.

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.

Puerta de enlace de IQ de trabajo

• Punto de conexión: https://workiq.svc.cloud.microsoft/a2a/
• Público de token: api://workiq.svc.cloud.microsoft
• Ámbito: WorkIQAgent.Ask

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

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 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 (versión preliminar) y configúrela como un servidor MCP local.

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

Comparación de Work IQ con Copilot Chat API

Work IQ es la evolución lista para producción de la API de Copilot Chat. Cuando Work IQ alcanza la disponibilidad general (mayo de 2026), se convierte en la forma recomendada y totalmente compatible de integrarse con el agente de Copilot en escenarios de producción. Está respaldado por acuerdos de nivel de servicio empresariales, contratos estables y compromisos de soporte técnico a largo plazo.

Qué significa:

• Los nuevos proyectos deben basarse en Work IQ desde el primer día.
• Las integraciones existentes con la API de Copilot Chat seguirán funcionando. La API de Copilot Chat permanecerá en versión preliminar pública para experimentación y desarrollo en fases tempranas, pero no está cubierta por acuerdos de nivel de servicio de producción.
• La migración es sencilla: Work IQ conserva los conceptos que ya conoce y agrega las garantías de confiabilidad, gobernanza y soporte técnico necesarias para las cargas de trabajo de producción.

Se recomienda planear el traslado a Work IQ antes del lanzamiento del producto para aprovechar al máximo el soporte técnico de producción en el lanzamiento.

Contenido relacionado

• Inicios rápidos de Work IQ API (versión preliminar)