Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Importante
Las API de la /beta versión están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción.
Work IQ Chat API le permite crear y continuar conversaciones de varios turnos con Microsoft 365 Copilot, a la vez que respeta los controles de acceso definidos dentro de la organización. Use chat API para integrar Microsoft 365 Copilot en las soluciones de IA generativas.
En esta documentación se trata la creación de conversaciones de Copilot mediante chat API. Obtenga información sobre cómo continuar conversaciones sincrónicas o conversaciones en secuencias con chat API.
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
| Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
|---|---|---|
| Delegado (cuenta profesional o educativa) | WorkIQAgent.Ask | No disponible. |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | No admitida. | No admitida. |
Solicitud HTTP
POST https://workiq.svc.cloud.microsoft/rest/conversations
POST https://workiq.svc.cloud.microsoft/rest/beta/conversations
Encabezados de solicitud
| Nombre | Descripción |
|---|---|
Authorization |
Bearer {token}. Obligatorio. |
Content-Type |
application/json. Obligatorio. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione un cuerpo JSON vacío.
Respuesta
Si se ejecuta correctamente, esta acción devuelve un 201 Created código de respuesta y una copilotConversation en el cuerpo de la respuesta.
Ejemplo
En el ejemplo siguiente se muestra cómo crear una conversación de Copilot a través de work IQ Chat API. Una vez creada la conversación, id en el cuerpo de la respuesta se usa como parámetro de ruta de acceso para continuar la conversación, ya sea mediante el punto de conexión sincrónico o el punto de conexión transmitido.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
POST https://workiq.svc.cloud.microsoft/rest/conversations
Content-Type: application/json
{}
POST https://workiq.svc.cloud.microsoft/rest/beta/conversations
Content-Type: application/json
{}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 201 Created
Content-Type: application/json
{
"id": "0d110e7e-2b7e-4270-a899-fd2af6fde333",
"createdDateTime": "2025-09-30T15:28:46.1560062Z",
"displayName": "",
"status": "active",
"turnCount": 0
}