Compartir a través de


Configurar agentes en Copilot Studio Kit

Para probar agentes de Copilot Studio personalizados, cree un registro de configuración del agente que incluya la información necesaria para conectarse a los agentes y ejecutar pruebas.

Captura de pantalla de la vista Configuración del agente en Copilot Studio Kit.

Se admiten los siguientes tipos de configuración:

  • Automatización de pruebas: permite pruebas masivas de agentes personalizados.
  • KPIs de conversación: analiza las transcripciones de conversación de agentes personalizados seleccionados y genera registros de KPIs de conversación (Indicadores Clave de Rendimiento).
  • Sincronización de archivos: habilita la sincronización selectiva de contenido desde ubicaciones de SharePoint a la base de conocimiento del agente personalizado como archivos.

Puede admitir varios tipos de configuración en un único registro de configuración del agente. En la vista Configuración del agente, solo verá las secciones de configuración pertinentes.

Creación de un nuevo registro de configuración del agente

  1. Acceda a la aplicación Copilot Studio Kit.

  2. Vaya a Agentes.

  3. Cree un registro de configuración del agente nuevo.

  4. Escriba la siguiente información, necesaria para todos los tipos de configuración:

    Nombre de la columna Obligatorio Description
    Nombre Nombre de la configuración del agente. El nombre no tiene que coincidir con el agente en el que te enfocas.
    Tipos de configuración Seleccione uno o varios tipos de configuración.
  5. Siga los pasos de configuración siguientes para cada tipo de configuración que haya seleccionado.

Configuración de un nuevo agente para Test Automation

  1. Seleccione Test Automation (Automatización de pruebas) en Tipos de configuración.

  2. Además de la configuración base, proporcione la siguiente información:

    Nombre de la columna Obligatorio Description
    Region Región en la que se despliega el agente. Necesario para tener como destino el punto de conexión de Direct Line API adecuado.
    Punto de conexión de token Depende Si Seguridad de canal no se usa o aplica, use el punto de conexión del token que está disponible en el canal de la aplicación Correo electrónico.
    Seguridad del canal Depende Habilite esta opción si la seguridad de los canales web y Direct Line está habilitada para asegurarse de que se pueda obtener un token a cambio de un secreto.
    Nota: La seguridad del canal debe habilitarse si la autenticación de usuario está habilitada.
    Ubicación secreta Depende Cuando se active La seguridad del canal , elija dónde almacenar el secreto del canal de Direct Line. Dataverse almacena el secreto en una columna protegida, mientras que Azure Key Vault usa una variable de entorno de tipo secret y almacena el secreto en Azure Key Vault.
    Secreto Depende Cuando Se selecciona Dataverse como ubicación secreta, esta columna almacena el secreto del canal de Direct Line.
    Variable de entorno Depende Cuando Key Vault se selecciona como ubicación secreta, esta columna almacena el nombre del esquema de la variable de entorno de tipo secreto que se vincula al secreto de Azure Key Vault. Siga los pasos descritos en Configuración de secretos en Azure Key Vault.
    Autenticación de usuario Depende Seleccione Entra ID v2 si se requiere autenticación de usuario . Para usar la autenticación de Microsoft, siga los pasos descritos en Configuración de la autenticación de Microsoft para las pruebas del kit de Copilot Studio.
    Nota:La seguridad del canal debe habilitarse si la autenticación de usuario está habilitada.
    Id. de cliente Depende Escriba el identificador de aplicación (cliente) de la aplicación creada para habilitar la autenticación de usuario final para el agente personalizado. Obtenga más información en Configuración de la autenticación de usuario con microsoft Entra ID.
    Id. de inquilino Depende Escriba el identificador de inquilino de la aplicación creada para habilitar la autenticación de usuario final para el agente personalizado.
    Ubicación secreta (autenticación de usuario) Depende Cuando se selecciona Autenticación de usuario , elija dónde prefiere almacenar el secreto de cliente. Dataverse almacena el secreto en una columna protegida, mientras que Key Vault requiere una variable de entorno de tipo secret y almacena el secreto en Azure Key Vault.
    Secreto de cliente Depende Escriba el secreto de cliente que creó cuando activaste la autenticación. Por ejemplo: KitAuthApp secret.
    Ámbito Depende Escriba el ámbito personalizado que creó al habilitar el soporte para la autenticación. Use el formato URI de ámbito completo; por ejemplo: api://1234-4567/scope.name.
    Enriquecimiento con Azure Application Insights Depende Habilite esta opción para enriquecer los resultados de las pruebas de respuestas generativas con datos de telemetría de Azure Application Insights.
    Nota: Para enriquecer los resultados de las pruebas de Application Insights, debe registrar la aplicación en el mismo inquilino que el recurso de Application Insights. El recurso de Application Insights y la aplicación pueden estar en un arrendatario diferente al del agente personalizado que usted está probando. Obtenga más información sobre cómo registrar la aplicación y obtener la información necesaria para el recurso de Application Insights. Asegúrese de que el agente personalizado está configurado para enviar telemetría al recurso de Application Insights y de que coincida con la configuración del agente en el Kit de Copilot Studio. Obtenga más información sobre cómo conectar el agente personalizado a Application Insights.
    Id. de cliente de App Insights Depende Escriba el identificador de aplicación (cliente) de la aplicación que tiene permiso para leer datos del recurso de Application Insights.
    Id. de aplicación de App Insights Depende Escriba appId del recurso de Application Insights. Consulte Pasos para localizar AppId.
    Ubicación secreta de App Insights Depende Elija dónde almacenar el secreto de aplicación de Application Insights. Dataverse almacena el secreto en una columna protegida, mientras que Azure Key Vault requiere una variable de entorno de tipo secret y almacena el secreto en Azure Key Vault.
    Id. de inquilino de App Insights Depende Escriba el identificador de inquilino del recurso de Application Insights y la aplicación.
    Secreto de App Insights Depende Cuando Se selecciona Dataverse como ubicación secreta, esta columna almacena el secreto de aplicación de App Insights.
    Variable de entorno de App Insights Depende Cuando Key Vault se selecciona como ubicación secreta, esta columna almacena el nombre de esquema de la variable de entorno de tipo secreto que se vincula al secreto de aplicación de App Insights.
    Enriquece con transcripciones de conversaciones No Habilite esta opción para enriquecer los resultados de las pruebas con datos de transcripciones de conversación almacenadas en Dataverse.
    Nota: Para que Copilot Studio Kit recupere registros de transcripción de conversaciones de otros entornos de Power Platform, la conexión de Microsoft Dataverse que se usa al configurar la solución debe tener Read permisos en los ConversationTranscript registros de tabla en los entornos de destino. Solo puede tener como destino entornos dentro del mismo inquilino.
    Dataverse URL Depende Cuando Enrich With Conversation Transcripts se habilita, escriba la dirección URL del entorno de Dataverse (por ejemplo, https://org123.crm.dynamics.com). Puede obtener la dirección URL en Copilot Studio en Configuración ( ) seleccionando Detalles de la sesión. Busque URL de instancia.
    Copiar transcripción completa No Cuando se habilita "Enriquecer con transcripciones de conversación" (Enrich With Conversation Transcripts), esta opción copia el JSON completo de la transcripción de conversación como un archivo adjunto al registro de resultados de la prueba para su posterior análisis.
    Análisis de respuestas generadas No Al habilitar esta opción, un modelo de lenguaje grande (LLM) analiza las pruebas generadas por IA. Compara la respuesta con una respuesta de ejemplo o instrucciones de validación.
    Proveedor de IA generativa Depende Cuando se habilita Analizar respuestas generadas , especifique el modelo LLM que se usa para el análisis.
    Nota: Actualmente, solo se admite AI Builder.
  3. Haga clic en Guardar.

Configura un nuevo agente para los indicadores clave de rendimiento de conversación

  1. Seleccione KPI de conversación en Tipos de configuración.

  2. Además de la configuración base, proporcione la siguiente información:

    Nombre de la columna Obligatorio Description
    Dataverse URL Dirección URL de Dataverse donde se encuentran las transcripciones de conversación y el agente. Por ejemplo: https://organizationname.crm.dynamics.com
    Id. de agente Id. de bot del agente personalizado que tiene como destino. Puede encontrar este valor en Copilot Studio en Configuración ( ) seleccionando Detalles de la sesión. Busca Copilot ID.
    Copiar transcripción completa No Obligatorio si desea inspeccionar la conversación en el visualizador de transcripciones (pestaña Transcripción del registro KPI de conversación). Cuando está habilitada, la transcripción completa de la conversación se copia y se asocia con el registro de KPI.
    Variables con seguimiento No Puede especificar hasta cinco variables personalizadas para realizar un seguimiento desde las conversaciones (por ejemplo, puntuación personalizada de Net Promoter o NPS). El formato es una matriz JSON.
    Ejemplo: [ Activity. Channel, Activity.Type ]
    Componentes del agente No Campo de solo lectura rellenado con los componentes del agente especificado, como temas, orígenes de conocimiento, etc.
  3. Haga clic en Guardar.

Captura de pantalla de la configuración de KPI de conversación en Copilot Studio Kit.

Configuración de un nuevo agente para la sincronización de archivos

  1. Seleccione Sincronización de archivos en Tipos de configuración.

  2. Escriba la siguiente información además de la configuración base:

    Nombre de la columna Obligatorio Description
    Id. del agente (id. de bot) Id. de bot del agente personalizado que tiene como destino. Puede encontrar este identificador en Copilot Studio en Configuración ( ) seleccionando Detalles de la sesión. Busque Copilot ID.
    Dataverse URL Dirección URL de Dataverse donde se encuentra el agente personalizado y se sincroniza el contenido. Por ejemplo: https://organizationnname.crm.dynamics.com. Obtenga la dirección URL en Copilot Studio desde los detalles de la sesión. Busque URL de instancia.
  3. Agregue al menos una configuración del indexador de archivos y escriba la siguiente información:

    Nombre de la columna Obligatorio Description
    Nombre Nombre de la configuración del indexador de archivos. Por ejemplo: documentos de RR. HH.
    Configuración de agente La configuración del agente a la que pertenece este registro. Este valor se rellena automáticamente si crea un nuevo registro a través de la vista de configuración del agente.
    Dirección del sitio Dirección del sitio de SharePoint desde el que está sincronizando el contenido. Por ejemplo: https://organizationname.sharepoint.com/sites/sitename
    Nombre de la biblioteca La biblioteca del sitio de SharePoint desde la que está sincronizando el contenido. Ejemplo: Documentos
    Incluir elementos anidados Especifica si la sincronización de contenido está limitada a la ubicación exacta que especifique (No), o si los elementos secundarios de esa ubicación también se incluyen en la sincronización (Sí, valor predeterminado).
    Limitar entradas a la carpeta No Opcionalmente, especifique una carpeta en la biblioteca que se va a sincronizar. Ejemplo: /documentos-RRHH
    Filtro de consulta de archivos de SharePoint No Opcionalmente, especifique los filtros que se usarán al seleccionar los archivos que se van a sincronizar. Deje vacío para ningún filtrado adicional. Ejemplo: PublicContent eq 'true'
    Incluir páginas de SharePoint No Opcionalmente, incluya páginas de SharePoint en la sincronización.
    Consulta de filtrado de páginas en SharePoint No Opcionalmente, especifique filtros que se usarán al seleccionar páginas para sincronizar. Deje vacío para ningún filtrado adicional. Ejemplo: PublicContent eq 'true'
  4. Opcionalmente, puede validar la configuración del indexador de archivos seleccionando Validar conexión en la barra de comandos.

  5. Haga clic en Guardar.

Captura de pantalla de la interfaz de configuración del indexador de archivos en copilot Studio Kit.

Paso siguiente