Configurar agentes no Copilot Studio Kit

Para testar agentes personalizados do Copilot Studio, crie um registro de Configuração do Agente que inclua as informações necessárias para se conectar aos agentes e executar testes.

Os seguintes tipos de configuração são suportados:

• Automação de testes: Permite testes em massa de agentes personalizados.
• KPIs de conversação: analisa transcrições de conversas de agentes personalizados selecionados e gera registros de KPI de conversação (Key Performance Indicator).
• Sincronização de ficheiros: Permite sincronizar seletivamente o conteúdo de localizações do SharePoint para a base de conhecimento do agente personalizado como ficheiros.

Você pode oferecer suporte a vários tipos de configuração em um único registro de configuração do agente. Na visualização Configuração do Agente, você verá apenas as seções de configuração relevantes.

Criar um novo registro de Configuração do Agente

1. Aceda à aplicação Copilot Studio Kit.

2. Vá para Agentes.

3. Crie um novo registro de configuração do agente.

4. Insira as seguintes informações, necessárias para todos os tipos de configuração:

   Nome da coluna	Obrigatório	Description
   Nome	Yes	Nome da configuração do agente. O nome não precisa de corresponder ao agente que tem como destino.
   Tipo(s) de configuração	Yes	Selecione um ou mais tipos de configuração.

5. Siga as etapas de configuração a seguir para cada tipo de configuração selecionado.

Configurar um novo agente para automação de teste

1. Selecione Automação de Teste do Tipo(s) de Configuração.

2. Além da Configuração básica, forneça as seguintes informações:

   Nome da coluna	Obrigatório	Description
   Região	Yes	Região onde o agente está implantado. Necessário para direcionar ao endpoint apropriado da API Direct Line.
   Endpoint de Token	Depends	Se a Segurança do Canal não for utilizada ou imposta, use o ponto final de token disponível no canal da aplicação de E-mail.
   Segurança do Canal	Depends	Habilite essa opção se a segurança do canal da Web e da Linha Direta estiver habilitada para garantir que um token possa ser obtido em troca de um segredo. Observação: A segurança do canal precisa ser habilitada se a autenticação do usuário estiver habilitada.
   Localização secreta	Depends	Quando a Segurança do Canal estiver marcada, escolha onde armazenar o segredo do canal Direct Line. O Dataverse armazena o segredo em uma coluna segura, enquanto o Azure Key Vault usa uma variável de ambiente do tipo secret e armazena o segredo no Azure Key Vault.
   Segredo	Depends	Quando Dataverse é selecionado como Local Secreto, esta coluna armazena o segredo do canal Direct Line.
   Variável de ambiente	Depends	Quando o Cofre da Chave é selecionado como o Local Secreto, esta coluna armazena o nome do esquema para a variável de ambiente do tipo secret que se vincula ao segredo do Cofre da Chave do Azure. Siga as etapas em Configurar segredos no Cofre da Chave do Azure.
   Autenticação do usuário	Depends	Selecione Entra ID v2 se a autenticação do usuário for necessária. Para usar a Autenticação Microsoft, siga as etapas em Configurar a autenticação da Microsoft para testes do Copilot Studio Kit Nota:A Segurança do Canal precisa ser habilitada se a autenticação do usuário estiver habilitada.
   ID de Cliente	Depends	Insira o ID do aplicativo (cliente) do aplicativo criado para habilitar a autenticação do usuário final para o agente personalizado. Saiba mais em Configurar a autenticação do usuário com o Microsoft Entra ID.
   ID do Inquilino	Depends	Insira a ID do locatário do aplicativo criado para habilitar a autenticação do usuário final para o agente personalizado.
   Localização secreta (user auth)	Depends	Quando a opção Autenticação do usuário estiver selecionada, escolha onde prefere armazenar o segredo do cliente. O Dataverse armazena o segredo em uma coluna segura, enquanto o Cofre da Chave requer uma variável de ambiente do tipo secret e armazena o segredo no Cofre de Chaves do Azure.
   Segredo do Cliente	Depends	Insira o segredo do cliente que você criou ao habilitar o suporte à autenticação. Por exemplo: KitAuthApp secret.
   Scope	Depends	Insira o escopo personalizado que você criou ao habilitar o suporte à autenticação. Use o formato URI de escopo completo; Por exemplo: api://1234-4567/scope.name.
   Enriqueça com o Azure Application Insights	Depends	Habilite essa opção para enriquecer os resultados do teste de Respostas Generativas com dados de telemetria do Azure Application Insights. Observação: Para enriquecer os resultados do teste do Application Insights, você precisa registrar o aplicativo no mesmo locatário que o recurso do Application Insights. O recurso do Application Insights e o aplicativo podem estar em um locatário diferente do agente personalizado que você está testando. Saiba mais sobre como registrar o aplicativo e obter as informações necessárias para o recurso do Application Insights. Verifique se o agente personalizado está configurado para enviar telemetria para o recurso do Application Insights e se ele corresponde à configuração do agente no Copilot Studio Kit. Saiba mais sobre como conectar seu agente personalizado ao Application Insights.
   ID do cliente do App Insights	Depends	Insira o ID do aplicativo (cliente) do aplicativo que tem permissão para ler dados do recurso do Application Insights.
   ID do aplicativo Insights	Depends	Insira o AppId do seu recurso do Application Insights. Consulte Etapas para localizar o AppId.
   Localização secreta do App Insights	Depends	Escolha onde armazenar o segredo do aplicativo Application Insights. O Dataverse armazena o segredo em uma coluna segura, enquanto o Azure Key Vault requer uma variável de ambiente do tipo secret e armazena o segredo no Azure Key Vault.
   ID do locatário do App Insights	Depends	Insira a ID do locatário do recurso do Application Insights e do aplicativo.
   Segredo do App Insights	Depends	Quando o Dataverse é selecionado como o Local Secreto, esta coluna armazena o segredo do aplicativo App Insights.
   Variável de ambiente da Aplicação Insights	Depends	Quando o Key Vault é selecionado como a Localização do segredo, esta coluna armazena o nome do esquema para a variável de ambiente do tipo segredo que se associa ao segredo da aplicação App Insights.
   Enriqueça com transcrições de conversas	Não	Habilite essa opção para enriquecer os resultados do teste com dados de transcrições de conversas armazenadas no Dataverse. Observação: Para que o Copilot Studio Kit recupere registros de transcrição de conversas de outros ambientes da Power Platform, a conexão Microsoft Dataverse usada ao configurar a solução deve ter Read acesso aos registros de ConversationTranscript tabela nos ambientes de destino. Só pode segmentar ambientes no mesmo inquilino.
   Dataverse URL	Depends	Quando o Enrich With Conversation Transcripts estiver habilitado, insira a URL do ambiente Dataverse (por exemplo, https://org123.crm.dynamics.com). Você pode obter a URL no Copilot Studio em Configurações ( ) selecionando Detalhes da sessão. Procure por URL da instância.
   Copiar transcrição completa	Não	Quando o Enriquecimento com Transcrições de Conversação estiver habilitado, essa opção copiará o JSON completo da Transcrição da Conversa como um anexo ao registro de resultado do teste para análise posterior.
   Analise as respostas geradas	Não	Quando você habilita essa opção, um modelo de linguagem grande (LLM) analisa testes gerados por IA. Ele compara a resposta com uma amostra de resposta ou instruções de validação.
   Provedor de IA generativa	Depends	Quando Analisar respostas geradas estiver habilitado, especifique o modelo LLM usado para a análise. Observação: Atualmente, apenas o AI Builder é suportado.

3. Selecione Guardar.

Configurar um novo agente para KPIs de Conversação

1. Selecione KPIs de conversação em Tipo(s) de configuração.

2. Além da Configuração básica, forneça as seguintes informações:

   Nome da coluna	Obrigatório	Description
   Dataverse URL	Yes	URL do Dataverse onde as transcrições da conversa e o agente estão localizados. Por exemplo: https://organizationname.crm.dynamics.com
   ID do Agente	Yes	ID do bot do agente personalizado a que se destina. Você pode encontrar esse valor no Copilot Studio em Configurações ( ) selecionando Detalhes da sessão. Procura Copilot Id.
   Copiar transcrição completa	Não	Obrigatório se quiser inspecionar a conversação no visualizador de transcrição (separador Transcrição no registo KPI da conversação). Quando habilitada, a transcrição completa da conversa é copiada e associada ao registro de KPI.
   Variáveis rastreadas	Não	Você pode especificar até cinco variáveis personalizadas para acompanhar a partir das conversas (por exemplo, Net Promoter Score personalizado ou NPS). O formato é uma matriz JSON. Exemplo: [ Activity. Channel, Activity.Type ]
   Componentes do agente	Não	Campo de apenas leitura preenchido com os componentes do agente definidos, como tópicos, fontes de conhecimento e assim por diante.

3. Selecione Guardar.

Configurar um novo agente para sincronização de arquivos

1. Selecione Sincronização de arquivos em Tipo(s) de configuração.

2. Insira as seguintes informações, além da configuração básica:

   Nome da Coluna	Obrigatório	Description
   ID do agente (id do bot)	Yes	ID do bot do agente personalizado a que se destina. Você pode encontrar esse ID no Copilot Studio em Configurações ( ) selecionando Detalhes da sessão. Procure por Copilot Id.
   Dataverse URL	Yes	URL do Dataverse onde o agente personalizado está localizado e o conteúdo está sincronizado. Por exemplo: https://organizationnname.crm.dynamics.com. Obtenha o URL no Copilot Studio a partir dos detalhes da sessão. Procure por URL da instância.

3. Adicione pelo menos uma Configuração do Indexador de Arquivos e insira as seguintes informações:

   Nome da Coluna	Obrigatório	Description
   Nome	Yes	Nome da configuração do File Indexer. Por exemplo: documentos de RH.
   Configuração de agente	Yes	A configuração do agente à qual esse registro pertence. Esse valor será preenchido automaticamente se você criar um novo registro por meio da visualização de configuração do agente.
   Endereço do site	Yes	Endereço do site do SharePoint a partir do qual está a sincronizar o conteúdo. Por exemplo: https://organizationname.sharepoint.com/sites/sitename
   Nome da biblioteca	Yes	A biblioteca no site do SharePoint a partir da qual está a sincronizar o conteúdo. Exemplo: Documentos
   Incluir itens aninhados	Yes	Especifica se a sincronização de conteúdo está limitada ao local exato especificado (Não) ou se os itens filho desse local também estão incluídos na sincronização (Sim, padrão).
   Limitar entradas ao diretório	Não	Opcionalmente, especifique uma pasta na biblioteca para sincronizar. Exemplo: /HR-documents
   Consulta de Filtros de Ficheiros do SharePoint	Não	Opcionalmente, especifique filtros a serem usados ao selecionar arquivos a serem sincronizados. Deixe em branco para que não haja filtragem adicional. Exemplo: PublicContent eq 'true'
   Incluir páginas do SharePoint	Não	Opcionalmente, inclua páginas do SharePoint na sincronização.
   Filtro de Consulta de Páginas do SharePoint	Não	Opcionalmente, especifique os filtros a serem usados ao selecionar páginas para sincronização. Deixe em branco para que não haja filtragem adicional. Exemplo: PublicContent eq 'true'

4. Opcionalmente, você pode validar sua configuração do indexador de arquivos selecionando Validar conexão na barra de comandos.

5. Selecione Guardar.

Próximo passo