Saltar al contenido principal

Proveedores

La página Agent Providers es una superficie exclusiva para administradores que permite conectar plataformas de agentes de IA externos al Runtime de Beak AI e importar los agentes alojados en dichas plataformas. El subtítulo de la página indica "Connect external agent platforms and import agents into the Runtime". Los tipos de proveedores compatibles incluyen Copilot Studio, Amazon Bedrock, Agentforce, OpenAI Assistants y cualquier plataforma accesible mediante el protocolo A2A.

Una vez registrado un proveedor, los agentes pueden importarse manualmente o descubrirse automáticamente mediante una operación de sincronización. Los agentes importados aparecen en la cuadrícula de agentes disponible para los usuarios finales en todo el Runtime.

Cuadrícula de Tarjetas de Proveedores​

Los proveedores registrados se muestran en una cuadrícula de tarjetas adaptable. Al hacer clic en cualquier tarjeta, esta queda seleccionada y se abre el panel de detalles del proveedor debajo de la cuadrícula.

Tarjeta de Proveedor​

Cada tarjeta muestra lo siguiente.

  • Icono del proveedor — Un icono específico del tipo, determinado por el tipo de proveedor (cpu para Copilot Studio, zap para Agentforce, database para Bedrock, sparkles para OpenAI Assistants, link para A2A).
  • Nombre de visualización — El nombre legible por humanos asignado al proveedor durante el registro.
  • Tipo de proveedor — El identificador de tipo de proveedor sin procesar, mostrado como texto secundario debajo del nombre.
  • Insignia de estado de salud — Una etiqueta de color que muestra el estado de salud actual. Los estados y sus colores son:
    • healthy — color de éxito
    • degraded — color de advertencia
    • unreachable — color de error
    • auth_expired — color de error
    • unknown — color secundario atenuado
  • Descripción — Descripción opcional en texto libre de la instancia del proveedor.
  • Fecha de última sincronización — La fecha de la sincronización exitosa más reciente, o "Never synced" si no se ha completado ninguna sincronización.
  • Botón Check Health — Ejecuta una sonda de salud inmediata contra el endpoint del proveedor y actualiza la insignia de salud. El botón muestra Checking... mientras la sonda está en curso.
  • Botón Remove — Elimina permanentemente el registro del proveedor y todos los agentes importados asociados.

Formulario para Agregar Proveedor​

Al hacer clic en el botón Add Provider del encabezado de la página, el botón se reemplaza por una tarjeta de formulario titulada Register New Provider. El formulario contiene los siguientes campos.

Campos Comunes​

  • Provider Type — Obligatorio. Un menú desplegable con los tipos de proveedores disponibles. Al seleccionar un tipo, se muestra una nota con los modos de ejecución compatibles.
  • Display Name — Obligatorio. La etiqueta utilizada en todo el Runtime para identificar esta instancia de proveedor.
  • Description — Opcional. Una descripción breve.

Campos de Copilot Studio​

Cuando se selecciona Copilot Studio, el formulario se expande con campos de conexión específicos de Microsoft.

  • Power Platform Base URL — La URL base de la API REST de Power Platform; tiene como valor predeterminado https://api.powerplatform.com.
  • Environment ID — El GUID del entorno de Power Platform de destino, que se encuentra en la URL de Copilot Studio.
  • Microsoft Tenant ID — El GUID del tenant de Azure AD.
  • App Registration Client ID — El client_id del principal de servicio del registro de aplicación de Azure utilizado para el acceso a la API.
  • App Registration Client Secret — El client_secret correspondiente; se almacena cifrado y enmascarado tras guardar.

Nota: El registro de aplicación debe tener concedido el rol Environment Admin (o el rol equivalente de Dataverse System Administrator) en el entorno de Power Platform de destino para que la operación Sync All pueda descubrir agentes automáticamente. Los principales de servicio se agregan en el centro de administración de Power Platform en Entornos → Configuración → Usuarios + permisos.

Campos para Otros Proveedores​

Para todos los tipos de proveedores que no sean Copilot Studio, se muestra un único campo API Key / Secret después de los campos comunes. El valor se almacena cifrado y enmascarado tras guardar.

El pie del formulario contiene los botones Cancel y Register Provider. El botón Register Provider se deshabilita mientras el envío está en curso.

Panel de Detalles del Proveedor​

Al hacer clic en una tarjeta de proveedor en la cuadrícula, se abre un panel de detalles debajo de la cuadrícula, que muestra el nombre de visualización del proveedor como título del panel junto con dos botones de acción.

  • Import Agents — Abre el formulario de importación de agentes integrado dentro del panel.
  • Sync All — Activa una sincronización de descubrimiento automática que consulta la plataforma del proveedor en busca de todos los agentes disponibles y actualiza el registro de agentes del Runtime. El botón muestra Syncing... mientras la operación está en curso.

Formulario de Importación de Agentes​

El formulario de importación de agentes permite registrar uno o más agentes manualmente. Se pueden agregar filas con + Add another agent y eliminarlas individualmente.

Cada fila de agente contiene lo siguiente.

  • Agent name — Obligatorio. El nombre de visualización del agente dentro del Runtime.
  • Description — Opcional.

Para los proveedores de Copilot Studio, cada fila incluye también:

  • Bot ID — El identificador GUID del bot de Copilot Studio específico, que se encuentra en la URL del bot.
  • Direct Line Secret — El secreto de la página de seguridad del canal web del bot, utilizado para autenticar la conexión de streaming del Runtime.
  • Execution Mode — Un selector de radio con dos opciones:
    • Passthrough — El agente se ejecuta como el usuario de Microsoft 365 que ha iniciado sesión mediante el intercambio de tokens On-Behalf-Of (OBO). No se almacena historial de conversaciones local. Disponible únicamente cuando el despliegue del Runtime tiene habilitado Microsoft SSO.
    • Proxied — El agente utiliza la cuenta de servicio compartida del proveedor. Se mantiene un historial completo de conversaciones local y una pista de auditoría. Este es el único modo disponible cuando Microsoft SSO no está configurado.

Al hacer clic en Import Agents se envían todas las filas con un nombre no vacío. Una notificación de éxito confirma el número de agentes importados.

Historial de Sincronización​

Cuando un proveedor ha sido sincronizado al menos una vez, una sección Sync History muestra las cinco entradas de registro de sincronización más recientes. Cada entrada muestra una insignia de salud (healthy, degraded o failed), el número de agentes sincronizados y actualizados, el tipo de sincronización, la marca de tiempo y la duración en milisegundos.

Agentes Externos Importados​

Debajo de la cuadrícula de proveedores y el panel de detalles, una sección titulada Imported External Agents enumera todos los agentes que han sido incorporados al Runtime desde cualquier proveedor. Los agentes se muestran en una cuadrícula de tarjetas. Cada tarjeta muestra el nombre del agente, el proveedor de origen y el modo de ejecución. Para los agentes de Copilot Studio, hay dos controles adicionales disponibles directamente en la tarjeta.

Configurar el Secreto de Direct Line​

Al hacer clic en Set Direct Line secret en una tarjeta de agente de Copilot Studio, se expande una entrada en línea para actualizar el secreto de Direct Line del bot. El campo está enmascarado. Save confirma el nuevo secreto; Cancel descarta la entrada sin guardar.

Plantillas de Notificación​

Cada tarjeta de agente de Copilot Studio tiene una sección Notification Templates desplegable que gestiona las plantillas de notificación proactiva basadas en webhooks para el agente. Al hacer clic en el encabezado de la sección, se alterna la lista. Cada fila de plantilla guardada muestra la clave de la plantilla, una descripción opcional, un botón Copy URL (que copia el endpoint del webhook al portapapeles), un botón Edit y un botón Delete.

Al hacer clic en + Add template o en Edit, se abre el editor de plantillas con los siguientes campos.

  • Template Key — Un slug seguro para URL utilizado como segmento final de la ruta del endpoint del webhook (por ejemplo, freshdesk_ticket_event). La clave es de solo lectura al editar una plantilla existente.
  • Description — Texto opcional que describe cuándo se activa la plantilla.
  • Recipient email path — Una ruta de puntos dentro del cuerpo JSON del webhook entrante que se resuelve en la dirección de correo electrónico del destinatario objetivo (por ejemplo, freshdesk_webhook.requester_email).
  • Mappings — Una lista de pares nombre de variable a ruta JSON de puntos. Cada fila asigna una variable de plantilla (izquierda) a la ruta del cuerpo del webhook donde se encuentra su valor (derecha). Se pueden agregar filas con + Add mapping y eliminarlas individualmente.
  • Body template — Una plantilla de texto multilínea que utiliza marcadores {{variable}}. El filtro {{variable|html_to_text}} elimina el HTML del valor resuelto. Las líneas cuyo marcador se resuelve en una cadena vacía se omiten del mensaje final.
  • Sample JSON / Preview — Un área de texto en fuente monoespaciada para pegar un payload de webhook de muestra. Al hacer clic en Save & Preview, se guarda la plantilla y se genera una vista previa que muestra la dirección del destinatario resuelta y el cuerpo final del mensaje.

Mejores Prácticas​

  • Ejecute Check Health después de cualquier rotación de credenciales — Si la clave de API del proveedor o el secreto del principal de servicio cambian, la insignia de salud mostrará auth_expired y el Runtime dejará de sincronizar hasta que se actualice la credencial.
  • Prefiera Sync All para los proveedores de Copilot Studio — La sincronización automática mantiene el registro de agentes en sincronía con el catálogo de bots sin necesidad de entradas manuales de Import Agents para cada nuevo bot.
  • Use el modo Passthrough cuando Microsoft SSO esté disponible — Passthrough ejecuta cada conversación con la identidad del usuario que ha iniciado sesión en Microsoft 365, lo que satisface la mayoría de los requisitos empresariales de residencia de datos y auditoría sin mantener una cuenta de servicio compartida.
  • Agregue plantillas de notificación para agentes proactivos activados por webhook — El botón Copy URL en la lista de plantillas proporciona el endpoint exacto para registrar en sistemas externos como Freshdesk o Jira, de modo que los agentes puedan iniciar conversaciones en respuesta a eventos empresariales.
  • Revise el historial de sincronización antes de reportar un agente faltante — Una entrada de sincronización failed con un conteo de agentes de cero generalmente indica que el registro de aplicación carece de los permisos de Power Platform requeridos, en lugar de que el agente esté ausente del entorno.

Páginas Relacionadas​