Usa habilidades de Azure Bot Service en los agentes de Copilot Studio

Note

Este artículo describe características utilizadas en agentes o flujos de agentes alimentados por el arnés estándar.

Important

Este artículo incluye información sobre las habilidades Azure Bot Service, una forma basada en código para ampliar las capacidades de un agente en el entorno estándar. Estas habilidades no deben confundirse con las habilidades de agencia en el entorno de GitHub Copilot. Aprende más sobre cómo usar habilidades agénticas en Información general sobre Habilidades para agentes.

Copilot Studio te permite ampliar tu agente usando Azure Bot Service habilidades. Si tu organización ya tiene bots desplegados para escenarios específicos (construidos usando herramientas pro-code, incluyendo el SDK de agentes de Microsoft 365), puedes convertir estos bots en habilidades Azure Bot Service e integrarlos en un agente Copilot Studio.

Prerequisites

Añade una habilidad Azure Bot Service a una conversación de agente

Primero, crea un agente Copilot Studio y crea y despliega la habilidad Azure Bot Service usando herramientas pro-code en tu organización.

Después, registra la habilidad Azure Bot Service en Copilot Studio para que tu agente pueda usarla.

Por último, añade la habilidad Azure Bot Service a un tema conversacional siguiendo estos pasos:

  1. Ve a la página de Temas del agente.

  2. Abre la sección desde la que deseas invocar una habilidad.

  3. Selecciona el icono Añadir nodo bajo el nodo, después del cual quieres invocar la habilidad.

  4. Selecciona Añadir una herramienta y luego selecciona la habilidad que quieres usar.

  5. Si tu habilidad tiene entradas, asigna variables a esas entradas. Además, si la destreza produce valores para variables, puede usar esas variables en los nodos que se siguen.

    Note

    las habilidades de Azure Bot Service pueden aceptar tipos de datos simples (enteros, booleanos, cadenas) y tipos de datos complejos (como cadenas JSON).

    Si necesita extraer variables de tipos de datos complejos, debe utilizar un flujo de agente para analizar y descomponer cadenas JSON complejas en pares de valores clave para usar en su agente.

  6. Seleccione Guardar para conservar sus cambios en el tema.

  7. Prueba a tu agente para asegurarte de que está usando bien la habilidad.

Convierte una habilidad de Azure Bot Service existente de multiinquilino a un solo inquilino

Puedes convertir las habilidades existentes de Azure Bot Service de soporte multitenant a soporte de inquilino único. Para convertir una habilidad multiinquilino en una habilidad de un solo inquilino, realiza los siguientes cambios:

  1. Cree un nuevo registro de aplicación de Microsoft Entra ID para un cliente único.

  2. Actualiza la configuración de habilidades para usar un solo inquilino.

  3. Despliega la habilidad.

  4. (Opcional) Actualiza el código fuente.

Aprende más en Implementar una habilidad de Azure Bot Service para Copilot Studio.

Habilidades de Azure Bot Service de un solo inquilino y políticas de acceso condicional

Microsoft Entra ID administradores de inquilinos pueden configurar directivas de acceso condicional para controlar el acceso a los recursos del inquilino. Estas políticas pueden afectar las solicitudes de recursos, incluidas las Azure Bot Service habilidades, en función de factores como la geografía. Revisa las políticas de acceso condicional en tu tenant.