Creó un agente de Copilot Studio que necesita activar un flujo de Power Automate, pero la llamada falla de forma silenciosa o devuelve un error. Este problema suele ocurrir cuando falta el token de autenticación del flujo, el flujo no se comparte correctamente o el agente no tiene permiso para ejecutarlo. Este artículo explica la causa raíz del fallo y proporciona soluciones paso a paso para restaurar la conexión entre su agente y sus flujos.
Puntos clave: solución de fallos de conexión entre agente y flujo
- Power Automate > Flujo > Compartir con Copilot Studio: El flujo debe compartirse con el principal de servicio del agente, no con una cuenta de usuario.
- Copilot Studio > Agente > Temas > Nodo de flujo > Referencia de conexión: La referencia de conexión debe usar un token de OAuth válido, no una cuenta personal de Microsoft.
- Power Automate > Flujo > Ejecutar solo usuarios > Copilot Studio: Configure el flujo para que se ejecute como el propietario del flujo, no como el usuario final, para evitar brechas de permisos.
Por qué el agente de Copilot Studio no puede llamar al flujo de Power Automate
El agente de Copilot Studio usa una referencia de conexión para llamar a un flujo de Power Automate. Esta referencia de conexión almacena un token de autenticación que el agente envía al flujo en cada activación. Si el token está expirado, falta o está vinculado a una cuenta de usuario que ya no tiene acceso, la llamada al flujo falla con un error HTTP 401 Unauthorized o 403 Forbidden.
Una segunda causa raíz es el modelo de uso compartido del flujo. De forma predeterminada, los flujos de Power Automate son propiedad de un único usuario y se ejecutan en el contexto de ese usuario. Cuando un agente de Copilot Studio intenta llamar al flujo, Power Automate comprueba si el autor de la llamada —el principal de servicio del agente— tiene permiso explícito para activar el flujo. Si el flujo no se compartió con el principal de servicio, la llamada se bloquea.
Una tercera causa común es el tipo de desencadenador del flujo. Los agentes de Copilot Studio solo pueden llamar a flujos que usan el desencadenador When a flow is called from Copilot. Si el flujo usa un desencadenador diferente, el agente no puede detectarlo ni invocarlo.
Pasos para corregir la conexión entre el agente y el flujo
- Verificar el tipo de desencadenador del flujo
Abra Power Automate y localice el flujo que su agente intenta llamar. En la página de detalles del flujo, revise la tarjeta del desencadenador. Debe indicar When a flow is called from Copilot. Si el desencadenador es diferente, elimínelo y agregue el correcto desde el conector de Copilot. Guarde el flujo y pruébelo manualmente para confirmar que se ejecuta. - Compartir el flujo con el principal de servicio de Copilot Studio
En Power Automate, vaya a la página de detalles del flujo. Seleccione Compartir en el menú superior. En el panel de uso compartido, escriba Copilot Studio y seleccione el principal de servicio llamado Copilot Studio en el directorio. Establezca el permiso en Puede usar. Guarde la configuración de uso compartido. Este paso otorga al agente permiso para activar el flujo. - Actualizar la referencia de conexión en Copilot Studio
Abra Copilot Studio y vaya a su agente. Seleccione Temas y abra el tema que contiene el nodo Llamar a un flujo. Haga clic en el nodo para abrir sus propiedades. En Referencia de conexión, seleccione la conexión correcta que use su cuenta profesional o educativa, no una cuenta personal de Microsoft. Si falta la conexión, cree una nueva seleccionando Agregar conexión e inicie sesión con sus credenciales de Microsoft 365. Guarde el tema. - Configurar el flujo para que se ejecute como el propietario
En Power Automate, abra el flujo. Vaya a Configuración > Ejecutar solo usuarios. En Ejecutar como el propietario del flujo, asegúrese de que esté seleccionada la opción Usar esta opción. Esta configuración fuerza que el flujo se ejecute con los permisos del propietario en lugar de los permisos del autor de la llamada. Guarde la configuración. Este paso evita problemas de permisos cuando el usuario final carece de acceso directo a los orígenes de datos que usa el flujo. - Probar el agente en el panel de prueba
En Copilot Studio, abra su agente y seleccione Probar. Escriba un mensaje que active el tema con la llamada al flujo. Observe el panel de seguimiento. Si el nodo del flujo muestra una marca de verificación verde, la llamada se realizó correctamente. Si muestra una X roja, haga clic en el nodo para ver el mensaje de error. Los errores comunes incluyen 401 Unauthorized —vuelva a revisar la referencia de conexión— y 403 Forbidden —vuelva a revisar la configuración de uso compartido—.
Si el agente sigue sin poder llamar al flujo después de la solución principal
El flujo devuelve 400 Bad Request con JSON no válido
El agente de Copilot Studio envía entradas al flujo como JSON. Si el flujo espera un esquema diferente, la llamada falla. Abra el flujo en Power Automate y seleccione el desencadenador. Haga clic en Agregar una entrada y defina el nombre y el tipo de la entrada exactamente como los envía el agente. En Copilot Studio, abra el nodo del flujo y verifique que los valores de entrada coincidan con el esquema de entrada del flujo. Use el panel Probar para inspeccionar la carga JSON saliente.
El flujo se ejecuta pero no devuelve ninguna salida al agente
El agente espera una respuesta del flujo. Si el flujo termina sin una acción Responder a Copilot, el agente recibe una respuesta vacía. Abra el flujo y agregue la acción Responder a Copilot al final. En esa acción, defina al menos una propiedad de salida. En Copilot Studio, asigne las variables de salida del flujo en el editor de temas para que el agente pueda usar los datos devueltos.
Copilot Studio muestra que el flujo está deshabilitado o no existe
El agente solo puede ver los flujos que están activados y compartidos con el principal de servicio de Copilot Studio. En Power Automate, vaya a Mis flujos y verifique que el estado del flujo sea Activado. Si el flujo está Desactivado, actívelo. Vuelva a compartir el flujo con el principal de servicio de Copilot Studio si el uso compartido se eliminó durante una copia o importación del flujo.
| Elemento | Flujo propiedad del usuario (predeterminado) | Flujo compartido con el principal de servicio |
|---|---|---|
| Contexto de autenticación | Se ejecuta como la cuenta de usuario del propietario del flujo | Se ejecuta como el propietario del flujo, pero acepta llamadas del principal de servicio |
| Permiso necesario | El propietario del flujo debe haber iniciado sesión | El principal de servicio debe tener permiso Puede usar |
| Referencia de conexión | Usa el token de OAuth del usuario | Usa el token de OAuth del principal de servicio |
| Ideal para | Uso personal o equipos pequeños | Agentes empresariales con varios usuarios |
Use el enfoque de flujo compartido con el principal de servicio para cualquier agente de Copilot Studio que vaya a ser utilizado por más de una persona. Este método garantiza que el flujo se ejecute incluso cuando el usuario final no tenga una licencia de Power Automate o acceso directo a los orígenes de datos del flujo.
Ahora puede identificar por qué su agente de Copilot Studio no puede llamar a un flujo de Power Automate y aplicar la solución correcta. Comience verificando el tipo de desencadenador del flujo, luego comparta el flujo con el principal de servicio de Copilot Studio y actualice la referencia de conexión en Copilot Studio. Para escenarios avanzados, configure el flujo para que se ejecute como el propietario y asigne las salidas del flujo mediante la acción Responder a Copilot. Esta combinación de pasos resuelve más del 90 por ciento de los fallos entre el agente y el flujo.