Configuración y administración de conexiones

Los agentes usan herramientas y conocimientos para realizar acciones en nombre de los usuarios y recopilar información contextual relevante. Los desarrolladores suelen almacenar estas herramientas y orígenes de conocimiento en sistemas externos, como Microsoft Dataverse, Microsoft SharePoint u otras API. Para acceder a estos recursos de forma segura, los agentes deben autenticarse para establecer conexiones entre ellos y el sistema externo. El agente puede utilizar la autenticación del autor o la autenticación de usuario, según el escenario.

En Microsoft Copilot Studio, se usan conexiones para acceder de forma segura a los servicios autenticados para herramientas y conocimientos. Puede crear conexiones a varios orígenes de datos, como Microsoft Dataverse, Microsoft SharePoint o API externas.

Ver y administrar conexiones de agente

En Copilot Studio, puede ver y configurar las conexiones que usa el agente en la página Configuración de conexión.

En la página de configuración de conexión , puedes configurar y gestionar las conexiones que utiliza tu agente. Puede ver las conexiones existentes, crear nuevas y editarlas o desconectarlas según sea necesario.

Ver conexiones en la página Configuración de conexión

1. Vaya a la página del agente en Copilot Studio; para ello, seleccione Agents y, a continuación, seleccione el agente que desea ver.

   Se abre la página Información general del agente.

2. Seleccione Configuración para abrir la página Configuración del agente.

3. Selecciona Configuración de conexión.

Una lista se muestra en una tabla con todas las conexiones asociadas a tu agente. Para cada conexión, puedes ver:

• Nombre de conexión
• Herramientas y fuentes de conocimiento que utilizan la conexión
• Estado de conexión

Página de configuración de conexión en configuraciones del agente

Definiciones de estado de conexión

El estado de la conexión indica el estado actual de la conexión. Existen varios posibles estados:

• Conectado: La conexión está activa y el agente puede usarla para acceder a la herramienta o conocimiento asociado.
• No conectado: No hay conexión activa. El agente no puede acceder a la herramienta o conocimiento asociado. Necesitas establecer una conexión.
• Desactivado: La conexión está desactivada, posiblemente por un administrador, y el agente no la está usando en ese momento.
• Caducado: Las credenciales de autenticación de la conexión han caducado y ya no son válidas. Necesitas volver a autenticar la conexión para que el agente acceda a la herramienta o conocimiento asociado.
• Obsoleto: La conexión ya no es válida ni utilizable, normalmente porque se ha perdido o se ha agotado. Necesitas revisar y actualizar o reemplazar la conexión para que el agente acceda a la herramienta o conocimiento asociado.

Conexiones de filtro

Si tienes muchas conexiones en tu agente, filtra la lista para encontrar la conexión que quieres gestionar. Puede aplicar diferentes filtros para ver las conexiones en función de su estado, como Activadas, Desactivadas, Conectadas, No Conectadas, Desactivadas, Expiradas o Error de Conexión.

Seleccionar o crear una conexión individual

1. En Estado de la entrada de conexión en la lista, selecciona el hipervínculo junto al estado para abrir el panel Crear o elegir un panel de conexión.

2. Selecciona ... para abrir la configuración de conexión .

3. Selecciona una conexión existente de la lista o selecciona Añadir nueva conexión para crear una nueva.

   Si seleccionas Añadir nueva conexión, se abre un panel de configuración de conexión. Según sea necesario, es posible que se le pida que inicie sesión en el servicio o proporcione información adicional para completar la configuración de la conexión.

4. Cuando haya terminado, seleccione Enviar para guardar los cambios.

   La conexión ahora está configurada y asociada con tu agente, y este puede usar la conexión para acceder a las herramientas y conocimientos.

Ver detalles y configurar parámetros de conexión

En Administrar para la entrada de conexión de la lista, seleccione Ver detalles para ver más detalles sobre la conexión.

Visualización de los detalles de la conexión

La información aparece en dos pestañas:

• Detalles: muestra el nombre de conexión, la descripción, el estado y los detalles de creación.
• Parámetros de conexión: muestra los parámetros de conexión, como los detalles de autenticación, las claves de API u otra información necesaria y le permite configurar los detalles.

Compartir parámetros de conexión para la autenticación en nombre de otros

Para algunas conexiones que soportan inicio de sesión único (SSO), puedes configurar la conexión para que use autenticación On-Behalf-Of (OBO). En un flujo de OBO, el usuario delega el agente para usar los parámetros de conexión compartidos con el servicio en nombre del usuario. Este método de autenticación es útil cuando el agente necesita acceder a recursos que requieren permisos específicos de cada usuario o cuando es necesario realizar acciones en el contexto de la identidad del usuario.

Habilitación del uso compartido de parámetros para OBO

En Parámetros de conexión para la entrada de conexión de la lista, puede permitir al usuario autorizar el uso compartido de parámetros de conexión específicos.

1. En Parámetros de conexión, active Permitir permiso para compartir parámetros.

   Habilitación del uso compartido de parámetros

2. Active las casillas de los parámetros que desea permitir que el usuario comparta.

   Se solicita al usuario que conceda permiso para estos parámetros cuando el agente usa la autenticación de OBO.

Experiencia de usuario para la autenticación OBO

Cuando el agente usa la autenticación de OBO, se solicita al usuario que conceda permiso para que el agente use sus parámetros de conexión. El usuario puede optar por permitir o denegar este permiso. Si el usuario lo permite, el agente puede acceder a los recursos y realizar acciones en nombre del usuario. El agente se conecta al servicio de forma transparente mediante los parámetros de conexión compartidos.

Solicitudes de conexión repetidas al usar OAuth 2.0 con herramientas de Microsoft Graph API

Cuando usas la autenticación OAuth 2.0 , cada usuario debe iniciar sesión y dar su consentimiento. Cuando compartes o alojas al agente, otros usuarios aún no han dado su consentimiento, así que ven la tarjeta Connect .

Para evitar que se repitan las indicaciones, puedes probar una de las siguientes opciones de autenticación:

• Habilitar el inicio de sesión único (SSO) de Teams con el flujo on-behalf-of (OBO): Los usuarios sólo necesitan iniciar sesión una vez en Teams. No se requiere consentimiento extra en el chat.

• Usar los permisos de aplicación (entidad de servicio): el back-end llama a Microsoft Graph mediante credenciales de aplicación. No se requiere consentimiento del usuario.

• Usa SSO OAuth genérico para agentes alojados en la web: tu app gestiona el inicio de sesión y pasa el token al agente.

• Concede consentimiento de administrador para ámbitos delegados: elimina las solicitudes de permiso por usuario. Sigue siendo necesario iniciar sesión inicialmente.

Contenido relacionado

• Configurar la autenticación OBO para conectores personalizados