Instalar Kit de Agente do Copilot

O Kit de Agente do Copilot é um kit de ferramentas open source para testar e avaliar agentes do Copilot Studio. Por exemplo, ajuda-te a definir casos de teste, simular consultas de utilizadores e validar respostas de agentes. Este artigo fornece instruções passo a passo para instalar o kit do Marketplace ou do GitHub, juntamente com passos pós-implementação e opções de configuração.

Note

Antes de transferir e instalar o Kit de Agente do Copilot, certifique-se de que cumpre todos os pré-requisitos.

Instalar o Kit de Agente do Copilot a partir do Marketplace

Se preferir instalar o Kit de Agente do Copilot a partir do GitHub, continue para Instalar o Kit de Agente do Copilot a partir do GitHub.

Implementar a partir do Marketplace

Para instalar o Kit de Agente do Copilot a partir do Marketplace, siga estes passos:

1. Aceda ao Kit de Agente do Copilot no Marketplace.
2. Selecione Obtenha agora.
3. Inicie sessão na conta, se necessário.
4. Na vista Instalar o Kit de Agente do Copilot, selecione o ambiente onde deseja instalar o Kit de Agente do Copilot.
5. Analise os termos e declarações. Se concordar, marque as caixas e selecione Instalar.

A instalação do Copilot Agent Kit tem início.

Etapas pós-implementação (Marketplace)

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

1. Inicia sessão no Power Apps.
2. Aceda a Soluções.
3. Selecione Solução Predefinida.
4. Selecione Referências de conexão.
5. Localiza o Copilot Agent 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.

Instalar Kit de Agente do Copilot a partir do GitHub

Siga estes passos para instalar o Kit de Agente do Copilot a partir do GitHub. Se preferir instalar através do Marketplace, aceda a Instalar o Kit do Agente do Copilot no Marketplace.

Baixe a versão mais recente do GitHub

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

Instalar o ficheiro zip gerido do Kit de Agente do Copilot

Para instalar a solução gerida do Kit de Agente do Copilot:

1. Inicia sessão no Power Apps.
2. Selecione o ambiente onde quer instalar o Kit de Agente do Copilot.
3. Aceda a Soluções.
4. Selecione Importar solução.
5. Selecione Procurar.
6. Selecione o ficheiro CopilotStudioKit*_managed.zip.
7. Selecione Seguinte.
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)

Para atualizar para a versão mais recente do Kit de Agente do Copilot, siga estes passos:

1. Inicia sessão no Power Apps.
2. Selecione o ambiente onde quer atualizar o Kit de Agente do Copilot.
3. Aceda a Soluções.
4. Selecione Importar solução.
5. Selecione Procurar.
6. Selecione CopilotStudioKit*_managed.zip.
7. Selecione Seguinte. 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.

Note

Ao atualizar o Copilot Agent Kit, poderá deparar-se com o seguinte erro: A solução "Power CAT Copilot Agent Kit" falhou ao importar: ImportAsHolding falhou com a exceção: Não é possível eliminar o atributo: cat_copilottestrunid da 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

Estes passos de configuração aplicam-se quer tenha instalado o Kit de Agente do Copilot a partir do Marketplace ou do GitHub.

Sugestão

O Copilot Agent Kit inclui um Assistente de Configuração para configurar referências de ligação, variáveis de ambiente e fluxos da cloud. Saiba mais em utilizar 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.

Aponte a ligação ao SharePoint para o site 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 SharePoint.

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

1. Instale o Kit de Agente do Copilot, descrito anteriormente neste artigo.
2. Inicia sessão no Power Apps.
3. Aceda a Soluções.
4. Selecione Solução Predefinida.
5. Selecione Referências de conexão.
6. Localiza a referência de ligação Copilot Agent Kit - SharePoint e abre-a 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.

Mais informações: saiba mais sobre a configuração de agentes no Kit de Agente do Copilot, incluindo como configurar um novo agente para sincronizar ficheiros.

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.

• Kit do Agente do Copilot - Power Platform for Admins obtém a lista de ambientes no inquilino. Requer permissões de nível de administrador da Power Platform.
• Copilot Agent Kit - Dataverse recolhe informações sobre o agente dos 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.

Depois de configuradas as referências de ligação, configura o âmbito do ambiente, tipos de agentes, grupos de ambiente, opções de inventário e o cronograma de sincronização a partir do Agent Inventory. Saiba mais em Configurar inventário de agentes.

Para usar o recurso Inventário de agentes:

1. Instale o Kit de Agente do Copilot, descrito anteriormente neste artigo.
2. Inicia sessão no Power Apps.
3. Aceda a Soluções.
4. Selecione Solução Predefinida.
5. Selecione Referências de conexão.
6. Localiza a referência de ligação do Copilot Agent 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. Localiza a referência de ligação do Copilot Agent Kit - Dataverse e abre-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 fluxos

Note

Se planeia usar a sincronização do SharePoint, Configure a sincronização do SharePoint antes de ativar os fluxos relacionados (os nomes começam por Sincronização do SharePoint).

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

1. Instale o Kit de Agente do Copilot, descrito anteriormente neste artigo.
2. Inicia sessão em Power Automate.
3. Certifique-se de que o ambiente com o Kit de Agentes do Copilot está selecionado.
4. Selecione Soluções.
5. Selecione o Kit de Agente do Copilot.
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 Hub de Conformidade

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

Configurar o painel de KPI de Conversação incorporado

Siga estes passos apenas se planear usar o painel de KPIs de Conversa incorporado.

Durante as etapas, anote os seguintes valores:

• Nome do espaço de trabalho
• GUID do espaço 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 Kit de Agente do Copilot, descrito anteriormente neste artigo.

2. Descarregue Conversation.KPIs.zip do repositório do GitHub Power CAT Copilot Agent Kit.

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

4. Abra o ficheiro Conversation KPIs.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. Inicie sessão no Power Apps e selecione o ambiente onde instalou o Kit de Agente do Copilot.
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.

Saiba mais sobre como configurar agentes no Kit de Agente do Copilot, incluindo como configurar um novo agente para KPIs de Conversa.

Aceder à aplicação Kit de Agente do Copilot

Para aceder à aplicação Copilot Agent Kit:

1. Inicie sessão no Power Apps e selecione o ambiente onde instalou o Kit de Agente do Copilot.
2. Vai a Apps.
3. Encontre e selecione o Kit de Agente Power CAT Copilot.
4. Selecione Reproduzir.
5. (Opcional) Marque o aplicativo.

Partilhar a aplicação Copilot Agent Kit

Depois de verificar se a aplicação foi aberta com sucesso, o proprietário (ou o administrador de sistemas que instalou o Kit) precisa de partilhar a aplicação Kit de Agente do Copilot com a equipa.

1. Inicia sessão no Power Apps.
2. Selecione Aplicações.
3. Procure por "Copilot Agent Kit" e localize o que tem o tipo Code (não a aplicação orientada por modelos).
4. Selecione os três pontos (...) e depois selecione Partilhar ao lado do nome da aplicação.
5. Procure e adicione os utilizadores ou grupos de segurança que necessitem de acesso.
6. Selecione Partilhar para confirmar.

Saiba mais em Partilhe uma aplicação Canvas com a sua organização.

Passo seguinte

Configurar usuários e equipes