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.

Há suporte para os seguintes tipos de configuração:

• Automação de teste: permite o teste em massa de agentes personalizados.
• KPIs de conversa: analisa transcrições de conversa de agentes personalizados selecionados e gera registros de KPI de Conversa (Indicador de Desempenho Chave).
• Sincronização de Arquivos: permite sincronizar seletivamente o conteúdo de locais do SharePoint para a base de dados de conhecimento do agente personalizado como arquivos.

Você pode dar suporte a vários tipos de configuração em um único registro de configuração de agente. No modo de exibiçã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. Acesse o aplicativo 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 corresponder ao agente alvo.
   Tipos 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 a Automação de Teste

1. Selecione Automação de Teste dos Tipos de Configuração.

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

   Nome da coluna	Obrigatório	Description
   Região	Yes	Região em que o agente é implantado. Necessário direcionar o endpoint apropriado da Direct Line API.
   Endpoint de Token	Depende	Se a Segurança do Canal não for usada ou imposta, use o ponto de extremidade de token disponível no canal do aplicativo Email.
   Segurança do Canal	Depende	Habilite essa opção se a segurança do canal da Web e do Direct Line estiver habilitada para garantir que um token possa ser obtido em troca de um segredo. Nota: A segurança do canal precisará ser habilitada se a autenticação do usuário estiver habilitada.
   Localização secreta	Depende	Quando a Segurança do Canal estiver ativada, escolha onde armazenar o segredo do canal Direct Line. O Dataverse armazena o segredo em uma coluna protegida, enquanto o Azure Key Vault usa uma variável de ambiente do tipo segredo e armazena o segredo no Azure Key Vault.
   Segredo	Depende	Quando o Dataverse é selecionado como o Local Secreto, essa coluna armazena o segredo do canal de Linha Direta.
   Variável de ambiente	Depende	Quando o Key Vault é selecionado como o Local Secreto, essa coluna armazena o nome do esquema para a variável de ambiente do tipo segredo que está vinculada a um segredo do Azure Key Vault. Siga as etapas em Configurar segredos no Azure Key Vault.
   Autenticação de Usuário	Depende	Selecione Entra ID v2 se a autenticação do usuário for necessária. Para usar a Autenticação da Microsoft, siga as etapas em Configurar a autenticação da Microsoft para testes do Copilot Studio Kit Observação:A Segurança do Canal precisa ser habilitada se a autenticação do usuário estiver habilitada.
   ID do cliente	Depende	Insira a 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 a ID do Microsoft Entra.
   ID do locatário	Depende	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 (autenticação do usuário)	Depende	Quando a Autenticação de Usuário estiver selecionada, escolha onde você prefere armazenar o segredo do cliente. O Dataverse armazena o segredo em uma coluna protegida, enquanto o Key Vault requer uma variável de ambiente do tipo segredo e armazena o segredo no Azure Key Vault.
   Segredo do cliente	Depende	Insira o segredo do cliente que você criou ao habilitar o suporte à autenticação. Por exemplo: KitAuthApp secret.
   Âmbito	Depende	Insira o escopo personalizado que você criou ao habilitar o suporte à autenticação. Use o formato de URI de escopo completo; por exemplo: api://1234-4567/scope.name.
   Enriquecimento com Azure Application Insights	Depende	Habilite essa opção para enriquecer os resultados do teste para testes de Respostas Generativas com dados de telemetria do Azure Application Insights. Nota: 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	Depende	Insira a ID do aplicativo (cliente) do aplicativo que tem permissão para ler dados do recurso do Application Insights.
   ID do aplicativo do App Insights	Depende	Insira a AppId do seu recurso do Application Insights. Consulte as etapas para localizar AppId.
   Local secreto do App Insights	Depende	Escolha onde armazenar o segredo do aplicativo Application Insights. O Dataverse armazena o segredo em uma coluna protegida, enquanto o Azure Key Vault requer uma variável de ambiente do tipo secreto e armazena o segredo no Azure Key Vault.
   ID do locatário do App Insights	Depende	Insira a ID do locatário do recurso do Application Insights e do aplicativo.
   Segredo do App Insights	Depende	Quando o Dataverse é selecionado como o Local Secreto, essa coluna armazena o segredo do aplicativo App Insights.
   Variável de ambiente do Aplicativo Insights	Depende	Quando Key Vault é selecionado como o Local Secreto, essa coluna armazena o nome do esquema para a variável de ambiente do tipo segredo que se vincula ao segredo do aplicativo do App Insights.
   Enriquecer com transcrições de conversa	Não	Habilite essa opção para enriquecer os resultados do teste com dados de transcrições de conversa armazenadas no Dataverse. Nota: Para que o Copilot Studio Kit recupere registros de transcrição de conversa de outros ambientes do Power Platform, a conexão do Microsoft Dataverse usada ao configurar a solução deve ter Read acesso aos registros da tabela ConversationTranscript nos ambientes de destino. Você só pode direcionar ambientes dentro do mesmo locatário.
   Dataverse URL	Depende	Quando Enriquecer com transcrições de conversa estiver habilitada, insira a URL do ambiente do Dataverse (por exemplo, https://org123.crm.dynamics.com). Você pode obter a URL no Copilot Studio de Configurações ( ) selecionando os detalhes da sessão. Busque a URL da Instância.
   Copiar Transcrição Completa	Não	Quando o Enrich With Conversation Transcripts está habilitado, essa opção copia o JSON completo da Transcrição de Conversa como um anexo ao registro de resultado do teste para análise adicional.
   Analisar respostas geradas	Não	Quando você habilita essa opção, um LLM (modelo de linguagem grande) analisa testes gerados por IA. Ele compara a resposta com uma resposta de exemplo ou instruções de validação.
   Provedor de IA generativo	Depende	Quando Analisar Respostas Geradas estiver habilitado, especifique o modelo LLM usado para a análise. Nota: Atualmente, há suporte apenas para o Construtor de IA.

3. Clique em Salvar.

Configurar um novo agente para Indicadores de Desempenho de Conversas

1. Selecione KPIs de conversa nos Tipos de Configuração.

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

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

3. Clique em Salvar.

Configurar um novo agente para Sincronização de Arquivos

1. Selecione Sincronização de Arquivos dos Tipos de Configuração.

2. Insira as seguintes informações além da configuração base:

   Nome da Coluna	Obrigatório	Description
   ID do agente (id do bot)	Yes	ID do bot do agente personalizado que você deseja alcançar. Você pode encontrar essa ID no Copilot Studio em Configurações ( ) selecionando detalhes da sessão. Procure o ID do Copilot.
   Dataverse URL	Yes	URL do Dataverse em que o agente personalizado está localizado e o conteúdo é sincronizado. Por exemplo: https://organizationnname.crm.dynamics.com. Obtenha a URL no Copilot Studio nos 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 Indexador de Arquivos. Por exemplo: documentos de RH.
   Configuração do Agente	Yes	A configuração do agente à qual este registro pertence. Esse valor será preenchido automaticamente se você criar um novo registro por meio do modo de exibição de configuração do agente.
   Endereço do Site	Yes	Endereço do site do SharePoint do qual você está sincronizando o conteúdo. Por exemplo: https://organizationname.sharepoint.com/sites/sitename
   Nome da biblioteca	Yes	A biblioteca no site do SharePoint da qual você está sincronizando 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 a uma Pasta	Não	Opcionalmente, especifique uma pasta na biblioteca para sincronizar. Exemplo: /HR-documents
   Consulta de filtro de arquivos do SharePoint	Não	Opcionalmente, especifique filtros a serem usados ao selecionar arquivos a serem sincronizados. Deixe vazio para nenhuma 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 filtros a serem usados ao selecionar páginas para sincronizar. Deixe vazio para nenhuma 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. Clique em Salvar.

Próxima etapa