Instalar o Kit de Agente Copilot

O Copilot Agent Kit é 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 a partir do Marketplace ou GitHub, juntamente com passos pós-implementação e opções de configuração.

Instalar o Kit de Agente Copilot no Marketplace

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

Implementar a partir do Marketplace

Para implementar o Copilot Agent Kit do Marketplace, siga estes passos:

1. Vai ao Copilot Agent Kit no Marketplace.
2. Selecione Obtenha agora.
3. Inicie sessão na conta, se necessário.
4. Na vista Install Copilot Agent Kit, seleciona o ambiente onde queres implementar o Copilot Agent Kit.
5. Analise os termos e declarações. Se concordar, marque as caixas e selecione Instalar.

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

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 o Copilot Agent Kit a partir do GitHub

Siga estes passos para instalar o Copilot Agent Kit a partir do GitHub. Se preferir instalar a partir do Marketplace, vá a Install Copilot Agent Kit a partir do 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 Copilot Agent Kit

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

1. Inicia sessão no Power Apps.
2. Selecione o ambiente onde quer instalar o Copilot Agent Kit.
3. Aceda a 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)

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

1. Inicia sessão no Power Apps.
2. Seleciona o ambiente onde queres melhorar o Kit de Agente Copilot.
3. Aceda a 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.

Etapas de configuração adicionais e opcionais

Estes passos de configuração aplicam-se quer tenha instalado o Copilot Agent Kit no Marketplace ou no GitHub.

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 a 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 Copilot Agent Kit, 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 como configurar agentes no Copilot Agent Kit, incluindo como configurar um novo agente para sincronização de 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.

• Copilot Agent Kit - Power Platform for Admins recupera a lista de ambientes no tenant. Requer permissões de nível de administrador da Power Platform.
• Copilot Agent Kit - O Dataverse recolhe a informação do 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.

Para usar o recurso Inventário de agentes:

1. Instale o Copilot Agent Kit, 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

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

1. Instale o Copilot Agent Kit, descrito anteriormente neste artigo.
2. Inicia sessão em Power Automate.
3. Certifica-te de que o ambiente com o Kit de Agente Copilot está selecionado.
4. Selecione Soluções.
5. Selecione o Kit de Agente 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 o Neto.
   2. Fluxos que terminam com Child.
   3. Resto dos fluxos conforme necessário, em qualquer ordem.

Configurar o Hub de Conformidade

Para configurar o Compliance Hub, siga os passos em Configurar e configurar o Copilot Agent Kit Compliance Hub. 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 Copilot Agent Kit, descrito anteriormente neste artigo.

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

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 você publicar em "Meu espaço de trabalho", o GUID do espaço de trabalho será 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. Inicia sessão no Power Apps e seleciona o ambiente onde instalaste o Copilot Agent 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.

Saiba como configurar agentes no Copilot Agent Kit, incluindo como configurar um novo agente para os KPIs de Conversa.

Aceda à aplicação Copilot Agent Kit

Para aceder à aplicação Copilot Agent Kit:

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

Partilhe a aplicação Copilot Agent Kit

Depois de verificar se a aplicação é lançada com sucesso, o proprietário (ou administrador do sistema que instalou o Kit) precisa de partilhar a aplicação Copilot Agent Kit com a equipa.

1. Inicia sessão no Power Apps.
2. Selecione Aplicações.
3. Procura por "Copilot Agent Kit" e localiza aquele com código de tipo (não a aplicação orientada a 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