Creaste un agente de Copilot Studio y quieres insertarlo en el sitio web de tu empresa, pero el agente no se carga o el código de inserción produce un error. Este problema suele ocurrir porque el dominio del sitio web no está autorizado en la configuración de publicación de Copilot Studio, o porque el agente requiere autenticación que el sitio web no puede proporcionar. Este artículo explica la causa exacta del fallo y proporciona una solución paso a paso para que tu agente funcione en tu sitio.
Aprenderás a verificar la autorización del dominio, ajustar la configuración de autenticación y comprobar que el fragmento de inserción esté configurado correctamente. No se requieren conocimientos de programación, pero necesitas acceso al portal de administración de Copilot Studio y al código HTML de tu sitio web.
Puntos clave: Solucionar un agente de Copilot Studio que no se carga en tu sitio web
- Copilot Studio > Configuración > Seguridad > Prevención de pérdida de datos > Dominios permitidos: Agrega el dominio de tu sitio web a la lista de permitidos para evitar que el agente se bloquee.
- Copilot Studio > Configuración > Canales > Web > Autenticación: Establece la autenticación en “Sin autenticación” o configura un proveedor de OAuth válido para tu sitio.
- Código de inserción HTML del sitio web: Asegúrate de que la etiqueta
<script>apunte al ID de agente correcto y esté colocada antes de la etiqueta de cierre</body>.
Por qué tu agente de Copilot Studio no se carga en un sitio web
Cuando publicas un agente de Copilot Studio, la plataforma genera un fragmento de inserción que incluye un ID de agente único y una conexión a Bot Framework de Microsoft. El agente debe poder verificar que el sitio web solicitante tiene permiso para hospedarlo. Si el dominio del sitio web no está incluido explícitamente en la configuración de seguridad del agente, Bot Framework rechaza la solicitud y el agente no se carga.
Una segunda causa común es la discrepancia de autenticación. Los agentes de Copilot Studio pueden requerir el inicio de sesión del usuario mediante Azure AD, Microsoft Entra ID o un proveedor de OAuth personalizado. Si tu sitio web no pasa los tokens de autenticación requeridos, el agente muestra un error de inicio de sesión o permanece en blanco. Para sitios web públicos que no exigen el inicio de sesión del usuario, el agente debe configurarse para permitir el acceso anónimo.
Una tercera causa es un fragmento de inserción dañado o desactualizado. Si copiaste la etiqueta de script antes de volver a publicar el agente después de un cambio de configuración, el fragmento puede contener un ID de agente antiguo o una URL de punto de conexión rota. Actualizar el fragmento desde la página de publicación de Copilot Studio resuelve esto.
Pasos para agregar tu agente de Copilot Studio a un sitio web
Sigue estos pasos en orden. Cada paso aborda una de las tres causas raíz descritas anteriormente.
- Agrega el dominio de tu sitio web a la lista de dominios permitidos
Abre Copilot Studio y ve a Configuración > Seguridad > Prevención de pérdida de datos. En Dominios permitidos, haz clic en Agregar dominio. Ingresa el dominio completo de tu sitio web, por ejemplowww.yourcompany.com. Incluyelocalhostsi estás probando localmente. Haz clic en Guardar. - Establece el modo de autenticación del agente para acceso anónimo
En Copilot Studio, selecciona tu agente y ve a Configuración > Canales > Web. En Autenticación, elige Sin autenticación si tu sitio web no requiere inicio de sesión del usuario. Si tu sitio usa Azure AD, selecciona Azure AD (Microsoft Entra ID) y registra tu sitio web como un URI de redireccionamiento válido. Haz clic en Guardar. - Vuelve a publicar el agente para generar un fragmento de inserción nuevo
Ve a Publicar en el panel de navegación izquierdo. Haz clic en Publicar nuevamente para forzar una publicación completa. Espera el mensaje de confirmación. Este paso aplica todos los cambios de seguridad y autenticación al agente activo. - Copia el código de inserción actualizado
Después de volver a publicar, haz clic en Publicar > Canales > Web. Haz clic en Copiar junto al fragmento de inserción. El fragmento se ve así:<script src="https://copilotstudio.microsoft.com/agents/abc123/embed.js"></script>. No modifiques la etiqueta de script manualmente. - Inserta el código de inserción en el HTML de tu sitio web
Abre el archivo HTML de tu sitio web o la plantilla del sistema de gestión de contenido. Pega la etiqueta de script justo antes de la etiqueta de cierre</body>. No la coloques dentro de la sección<head>. Guarda y publica la página. - Prueba el agente en el sitio web activo
Abre tu sitio web en una ventana de navegación privada o en un navegador donde no hayas iniciado sesión con ninguna cuenta de Microsoft. Confirma que aparece el icono del agente y que puedes iniciar una conversación. Si el agente no se carga, abre la consola de desarrollador del navegador (F12) y busca errores de JavaScript o respuestas HTTP 403.
Si el agente aún tiene problemas después de la solución principal
El agente se carga pero muestra una ventana de chat en blanco
Esto indica que el agente llega a tu sitio web pero no logra inicializarse. La razón más común es una Política de seguridad de contenido (CSP) en tu sitio web que bloquea el punto de conexión de Bot Framework. Agrega las siguientes directivas a los encabezados de respuesta HTTP de tu sitio web o a la etiqueta <meta>:
script-src 'self' https://copilotstudio.microsoft.com; frame-src 'self' https://copilotstudio.microsoft.com; connect-src 'self' https://copilotstudio.microsoft.com
Después de actualizar la CSP, borra la caché del navegador y vuelve a cargar la página.
El agente requiere inicio de sesión aunque la autenticación esté configurada como ninguna
Esto ocurre cuando el agente usa un tema o una habilidad que llama a una API de Microsoft Graph o a un conector personalizado que requiere contexto de usuario. Revisa los temas de tu agente. Si algún tema usa un flujo de Power Automate que llama a Microsoft Graph con la identidad del usuario, elimina ese flujo o configúralo para usar una cuenta de servicio. Como alternativa, establece la autenticación del agente en Azure AD y asegúrate de que tu sitio web pase los tokens correctos.
El código de inserción devuelve un error 404
Un error 404 significa que el ID de agente del fragmento de inserción no es válido o que el agente se eliminó. Vuelve a Copilot Studio y confirma que el agente aún existe. Si cambiaste el nombre del agente, el ID sigue siendo el mismo. Si eliminaste el agente, crea uno nuevo y publícalo. Copia el fragmento de inserción nuevo.
| Elemento | Agente de Copilot Studio (anónimo) | Agente de Copilot Studio (autenticado) |
|---|---|---|
| Autenticación | No se requiere autenticación | Azure AD, Microsoft Entra ID u OAuth personalizado |
| Ideal para | Sitios web públicos sin inicio de sesión de usuario | Portales internos o portales de clientes con inicio de sesión |
| Restricción de dominio | Debe agregarse a la lista de dominios permitidos | Debe agregarse a la lista de dominios permitidos y registrarse como URI de redireccionamiento |
| Fragmento de inserción | Etiqueta de script estándar | Etiqueta de script con parámetro de punto de conexión de token |
| Acceso a datos del usuario | Sin contexto de usuario | Puede acceder a los datos de Microsoft Graph del usuario |
Ahora puedes agregar tu agente de Copilot Studio a cualquier sitio web controlando los permisos de dominio, el modo de autenticación y el fragmento de inserción. Comienza con el paso de dominios permitidos porque es el bloqueador más común. Después de que el agente se cargue, prueba una conversación que use un tema con un conector para confirmar la funcionalidad de extremo a extremo. Como comprobación final, usa las herramientas de desarrollador del navegador para monitorear las solicitudes de red y verificar que todas las llamadas vayan a copilotstudio.microsoft.com sin errores.