Instalar o Copilot Studio Kit

O Copilot Studio Kit é um kit de ferramentas de código aberto para testar e avaliar agentes do Copilot Studio. Por exemplo, ele permite definir casos de teste, simular consultas de usuários e validar respostas de agentes. Este artigo fornece instruções passo a passo para instalar o kit do AppSourceouGitHub, juntamente com etapas pós-implantação e opções de configuração.

Observação

Antes de baixar e instalar o Copilot Studio Kit, verifique se todos os pré-requisitos foram atendidos.

Instale o Copilot Studio Kit a partir do AppSource

Se preferir instalar o Copilot Studio Kit a partir do GitHub, salte para Instalar o Copilot Studio Kit a partir do GitHub.

Implantar a partir do AppSource

Para implantar o Copilot Studio Kit a partir do AppSource, siga estas etapas:

1. Navegue até o Copilot Studio Kit no AppSource.
2. Selecione Obter agora.
3. Inicie sessão na conta, se necessário.
4. Na visualização Instalar o Copilot Studio Kit , selecione o ambiente onde deseja implantar o Copilot Studio Kit.
5. Analise os termos e declarações. Se concordar, marque as caixas e selecione Instalar.

Começa a instalação do Copilot Studio Kit.

Etapas pós-implantação (AppSource)

Após a conclusão da instalação, siga estas etapas pós-implantação:

1. Inicie sessão no Power Apps.
2. Vá para Soluções.
3. Selecione Solução Predefinida.
4. Selecione Referências de conexão.
5. Localize o Copilot Studio Kit - Dataverse e abra-o para edição.
6. Verifique se todos os campos obrigatórios estão preenchidos e se a conexão selecionada é válida. Crie uma nova conexão com o Dataverse conforme necessário.
7. Selecione Guardar.
8. Siga as etapas de configuração adicionais e opcionais.

Instale o Copilot Studio Kit a partir do GitHub

Siga estas etapas para instalar o Copilot Studio Kit do GitHub. Se preferir instalar a partir do AppSource, vá para Install Copilot Studio Kit from AppSource.

Baixe a versão mais recente do GitHub

Transfira a versão mais recente da solução gerida para o Power CAT Copilot Studio Kit.

Instalar o arquivo zip gerenciado do CopilotStudioKit

Para instalar a solução gerenciada Copilot Studio Kit:

1. Inicie sessão no Power Apps.
2. Selecione o ambiente onde deseja instalar o Copilot Studio Kit.
3. Vá para Soluções.
4. Selecione Importar solução.
5. Selecione Procurar.
6. Selecione o ficheiro CopilotStudioKit*_managed.zip.
7. Selecione Avançar.
8. Depois de analisar as informações da solução, selecione Avançar.
9. Se solicitado, crie as conexões necessárias e selecione Importar.
10. Deixe os valores do relatório de KPIs de Conversação como estão por enquanto. Você pode atualizar esses valores mais tarde.
11. Aguarde a conclusão da operação de importação.

Atualizar a solução existente (GitHub)

Se você instalou uma versão anterior do Copilot Studio Kit e deseja atualizar para a versão mais recente, siga estas etapas:

1. Inicie sessão no Power Apps.
2. Selecione o ambiente onde deseja atualizar o Copilot Studio Kit.
3. Vá para Soluções.
4. Selecione Importar solução.
5. Selecione Procurar.
6. Selecione CopilotStudioKit*_managed.zip.
7. Selecione Avançar. O Power Apps reconhece que esta atualização é uma solução gerida existente.
8. Confirme que deseja atualizar a solução existente selecionando Avançar.
9. Deixe os valores do relatório de KPIs de Conversação como estão por enquanto. Você pode atualizar esses valores mais tarde.
10. Selecione Importar.

Observação

Ao atualizar o Copilot Studio Kit, você pode encontrar o seguinte erro: "Solução "Power CAT Copilot Studio Kit" falhou ao importar: ImportAsHolding falhou com exceção: Não é possível excluir atributo: cat_copilottestrunid de Entidade: cat_CopilotTestRun uma vez que o atributo não é um campo personalizado."

Este problema é conhecido e está a ser investigado. Como solução alternativa, prepare a atualização antes de aplicá-la. Saiba mais em Fazer upgrade ou atualizar uma solução.

Etapas de configuração adicionais e opcionais

Essas etapas de configuração se aplicam se você instalou o Copilot Studio Kit do AppSource ou do GitHub.

Gorjeta

O Copilot Studio Kit inclui um Assistente de Configuração para configurar referências de ligação, variáveis de ambiente e fluxos na cloud. Saiba mais sobre como usar o Assistente de Configuração.

Configurar a sincronização do SharePoint

As etapas a seguir são opcionais e necessárias somente se você planeja usar o recurso de sincronização do SharePoint . Você pode definir esses valores a qualquer momento antes de usar o recurso.

Configure a conexão para o SharePoint de modo que aponte para o site do SharePoint de origem. Aponte o URL do Dataverse para a instância do Dataverse para os agentes personalizados de destino onde o conteúdo é sincronizado.

Pode seguir estes passos ou usar o Assistente de Configuração para configurar a referência de ligação ao SharePoint.

Para usar o recurso de sincronização do SharePoint:

1. Instale o Copilot Studio Kit, descrito anteriormente neste artigo.
2. Inicie sessão no Power Apps.
3. Vá para Soluções.
4. Selecione Solução Predefinida.
5. Selecione Referências de conexão.
6. Localize o Copilot Studio Kit - referência de conexão do SharePoint e abra-o para edição.
7. Verifique se todos os campos obrigatórios estão preenchidos e se a conexão selecionada é válida. Crie uma nova conexão com o SharePoint conforme necessário.
8. Selecione Guardar.

Para obter mais informações: Saiba mais sobre como configurar agentes no Copilot Studio Kit, incluindo como configurar um novo agente para sincronização de arquivos.

Configurar inventário de agentes

As etapas a seguir são opcionais e necessárias somente se você planeja usar o recurso Inventário de agentes . Você pode definir esses valores a qualquer momento antes de usar o recurso.

As referências de conexão na solução controlam a visibilidade dos agentes. Embora você possa usar outras contas, use essas permissões para obter visibilidade total.

• Copilot Studio Kit - Power Platform for Admins obtém a lista de ambientes no inquilino. Requer permissões de nível de administrador da Power Platform.
• Copilot Studio Kit - Dataverse reúne as informações do agente dos vários ambientes. Requer permissões de nível de administrador do sistema para todos os ambientes.

Pode seguir estes passos ou usar o Assistente de Configuração para configurar as referências de ligação ao Inventário de Agentes.

Para usar o recurso Inventário de agentes:

1. Instale o Copilot Studio Kit, descrito anteriormente neste artigo.
2. Inicie sessão no Power Apps.
3. Vá para Soluções.
4. Selecione Solução Predefinida.
5. Selecione Referências de conexão.
6. Localize a referência de conexão do Copilot Studio Kit - Power Platform for Admins e abra-a para edição.
7. Verifique se todos os campos obrigatórios estão preenchidos e se a conexão selecionada é válida.
8. Selecione Guardar.
9. Localize a referência de conexão Copilot Studio Kit - Dataverse e abra-a para edição.
10. Verifique se todos os campos obrigatórios estão preenchidos e se a conexão selecionada é válida.
11. Selecione Guardar.

Habilitar métricas de uso

Para habilitar as métricas de uso opcionais no inventário do agente, conclua as seguintes etapas:

1. Certifique-se de que o conector HTTP com ID do Microsoft Entra (pré-autorizado) é permitido em seu ambiente.
2. Importe o arquivo AgentInventoryUsage*_managed.zip do repositório Power CAT Copilot Studio Kit GitHub.
3. Durante o processo de importação, crie uma conexão usando a URL do host de licenciamento: https://licensing.powerplatform.microsoft.com/

Habilitar fluxos

Observação

Se você planeja usar a sincronização do SharePoint, configure a sincronização do SharePoint antes de habilitar os fluxos relacionados (os nomes começam com a Sincronização do SharePoint).

Para ativar os fluxos de cloud incluídos no Copilot Studio Kit, siga estes passos ou utilize o Assistente de Configuração.

1. Instale o Copilot Studio Kit, descrito anteriormente neste artigo.
2. Inicie sessão no Power Automate.
3. Certifique-se de que o ambiente com o Copilot Studio Kit está selecionado.
4. Selecione Soluções.
5. Selecione Copilot Studio Kit.
6. Selecione Fluxos de Cloud.
7. Certifique-se de que todos os fluxos estão ativados (Status = Ativado).
8. Habilite todos os fluxos que não estão habilitados, na seguinte ordem:
   1. Fluxos que terminam com objeto secundário.
   2. Fluxos que terminam com Child.
   3. Resto dos fluxos conforme necessário, em qualquer ordem.

Configurar o Compliance Hub

Para configurar o Compliance Hub, siga os passos em Configurar e configurar o Copilot Studio Kit Compliance Hub. O Compliance Hub exige o Inventário do Agente.

Configurar o painel de KPI de Conversação incorporado

Essas etapas são necessárias somente se você planeja usar o painel de KPIs de conversação incorporado.

Durante as etapas, anote os seguintes valores:

• Nome do espaço de trabalho
• GUID da área de trabalho
• Nome do relatório
• GUID do relatório

Publicar o relatório

Para publicar o relatório de KPIs das conversas:

1. Instale o Copilot Studio Kit, descrito anteriormente neste artigo.

2. Transfira Conversation.KPIs.zip do repositório do GitHub do Power CAT Copilot Studio Kit.

3. Extraia o conteúdo do arquivo .zip.

4. Abra o ficheiro KPIs de Conversação.pbit na aplicação Power BI Desktop.

5. Insira o URL do Dataverse como URL do ambiente na caixa de diálogo que aparece e selecione Carregar (por exemplo, org3c23948.crm.dynamics.com, sem o prefixo https://).

   Se a caixa de diálogo não aparecer, insira a URL do ambiente em Home>Transformar dados>Editar parâmetros.

6. Atualize os dados e inicie sessão conforme necessário.

7. Salve e publique em um espaço de trabalho.

8. Anote o nome do relatório e o nome do espaço de trabalho.

9. Inicie sessão no Power BI.

10. Abra o relatório publicado e anote o GUID do espaço de trabalho e o GUID do relatório na URL.

    Se publicar em "A minha área de trabalho", o GUID da área trabalho é 00000000-0000-0000-0000-000000000000.

11. Selecione os três pontos (...) e depois Visualize o modelo semântico.

12. AbraConfigurações de arquivo>.

13. Verifique se as credenciais da fonte de dados não têm problemas. Inicie sessão para corrigir quaisquer problemas.

14. Vá para Atualizar e defina a agenda de atualização.

Atualizar a variável de ambiente de relatório

Para configurar o painel de KPIs de conversação incorporado, atualize a variável de ambiente relacionada com os identificadores corretos. Pode seguir estes passos ou usar o Assistente de Configuração.

1. Entre no Power Apps e selecione o ambiente onde você instalou o Copilot Studio Kit.
2. Selecione Soluções>Solução Predefinida.
3. Selecione Variáveis de ambiente.
4. Encontre e selecione Relatório de KPIs de conversação.
5. Substitua os espaços reservados no Valor Padrão pelos valores Nome do espaço de trabalho, GUID do espaço de trabalho, Nome do relatório e GUID do relatório que você anotou durante o processo de publicação.
6. Selecione Guardar.

Para obter mais informações: Saiba mais sobre como configurar agentes no Copilot Studio Kit, incluindo como configurar um novo agente para KPIs de conversação.

Aceda à aplicação Copilot Studio Kit

Para aceder à aplicação Copilot Studio Kit:

1. Entre no Power Apps e selecione o ambiente onde você instalou o Copilot Studio Kit.
2. Aceda a Aplicações.
3. Encontre e selecione Power CAT Copilot Studio Kit.
4. Selecione Reproduzir.
5. (Opcional) Marque o aplicativo.

Próximo passo

Configurar usuários e equipes