Instalar o Kit do Agente do Copilot

O Kit de Agente do Copilot é um kit de ferramentas de código aberto para testar e avaliar agentes do Copilot Studio. Por exemplo, ele ajuda você a definir casos de teste, simular consultas de usuário e validar respostas do agente. Este artigo fornece instruções passo a passo para instalar o kit a partir do Marketplace ou do GitHub, com etapas pós-implantação e opções de configuração.

Instalar o Copilot Agent Kit do Marketplace

Se preferir instalar o Kit de Agente do Copilot pelo GitHub, siga para Instalar Kit de Agente do Copilot pelo GitHub.

Implantar a partir do Marketplace

Para implantar o Kit de Agente do Copilot pelo Marketplace, siga estas etapas:

1. Acesse o Kit do Agente do Copilot no Marketplace.
2. Selecione Instale agora.
3. Entre, se necessário.
4. Na exibição Instalar Kit de Agente do Copilot, selecione o ambiente onde você deseja implantar o Kit de Agente do Copilot.
5. Examine os termos e declarações. Se você concordar, marque as caixas e selecione Instalar.

A instalação do Copilot Agent Kit começa.

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

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

1. Entre em Power Apps.
2. Acesse Soluções.
3. Selecione Solução Padrão.
4. Selecione referências de conexão.
5. Localize o Copilot Agent Kit - Dataverse e abra para edição.
6. Verifique se todos os campos necessários estão preenchidos e se a conexão selecionada é válida. Crie uma nova conexão com o Dataverse conforme necessário.
7. Clique em Salvar.
8. Siga as etapas de configuração adicionais e opcionais.

Instalar o Kit de Agente do Copilot pelo GitHub

Siga estas etapas para instalar o Kit de Agente do Copilot pelo GitHub: Se preferir instalar pelo Marketplace, vá até Instalar o Kit de Agente do Copilot pelo Marketplace.

Baixar a versão mais recente do GitHub

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

Instalar o arquivo ZIP gerenciado do Kit de Agentes do Copilot

Para instalar a solução gerenciada do Kit de Agentes do Copilot:

1. Entre em Power Apps.
2. Selecione o ambiente onde você deseja instalar o Kit de Agente do Copilot.
3. Acesse Soluções.
4. Selecione Importar Solução.
5. Selecione Procurar.
6. Selecione o arquivo CopilotStudioKit*_managed.zip.
7. Selecione Próximo.
8. Depois de examinar 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 Conversas 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 estas etapas:

1. Entre em Power Apps.
2. Selecione o ambiente onde você deseja atualizar o Kit de Agente do Copilot.
3. Acesse Soluções.
4. Selecione Importar Solução.
5. Selecione Procurar.
6. Selecione CopilotStudioKit*_managed.zip.
7. Selecione Próximo. O Power Apps reconhece que essa atualização é uma solução gerenciada existente.
8. Confirme se deseja atualizar a solução existente selecionando Avançar.
9. Deixe os valores do Relatório de KPIs de Conversas como estão por enquanto. Você pode atualizar esses valores mais tarde.
10. Selecione Importar.

Etapas de configuração adicionais e opcionais

Essas etapas de configuração se aplicam independentemente de você ter instalado o Kit de Agente do Copilot pelo Marketplace ou pelo 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.

Direcione a conexão com o SharePoint para o site de origem do SharePoint. Aponte a URL do Dataverse para a instância do Dataverse para os agentes personalizados de destino em que o conteúdo é sincronizado.

Você pode seguir estas etapas ou usar o assistente Setup para configurar a referência de conexão SharePoint.

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

1. Instale o Kit de Agente do Copilot, descrito anteriormente neste artigo.
2. Entre em Power Apps.
3. Acesse Soluções.
4. Selecione Solução Padrão.
5. Selecione referências de conexão.
6. Localize a referência de conexão do Copilot Agent Kit - SharePoint e abra para edição.
7. Verifique se todos os campos necessários estão preenchidos e se a conexão selecionada é válida. Crie uma nova conexão com o SharePoint conforme necessário.
8. Clique em Salvar.

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

Configurar inventário de agente

As etapas a seguir são opcionais e necessárias somente se você planeja usar o recurso Inventário de Agente . 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 obtém a lista de ambientes do locatário. Requer permissões de nível de administrador do Power Platform.
• Kit de Agente Copilot - Dataverse coleta informações do agente dos ambientes. Requer permissões de nível de administrador do sistema para todos os ambientes.

Você pode seguir esses passos ou usar o Assistente de Configuração para configurar as referências de conexão do Inventário de Agentes.

Depois que as referências de conexão são configuradas, você configura o escopo do ambiente, tipos de agentes, grupos de ambiente, opções de inventário e o cronograma de sincronização dentro do Agent Inventory. Saiba mais em Configurar Inventário de Agente.

Para usar o recurso Inventário de Agente:

1. Instale o Kit de Agente do Copilot, descrito anteriormente neste artigo.
2. Entre em Power Apps.
3. Acesse Soluções.
4. Selecione Solução Padrão.
5. Selecione referências de conexão.
6. Localize a referência de conexão do Copilot Agent Kit - Power Platform for Admins e abra para edição.
7. Verifique se todos os campos necessários estão preenchidos e se a conexão selecionada é válida.
8. Clique em Salvar.
9. Localize a referência de conexão do Copilot Agent Kit - Dataverse e abra para edição.
10. Verifique se todos os campos necessários estão preenchidos e se a conexão selecionada é válida.
11. Clique em Salvar.

Habilitar fluxos

Para habilitar os fluxos da nuvem incluídos no Kit de Agente do Copilot, siga estas etapas ou use o Assistente de Instalação.

1. Instale o Kit de Agente do Copilot, descrito anteriormente neste artigo.
2. Faça login no Power Automate.
3. Verifique se o ambiente com o Kit de Agente do Copilot está selecionado.
4. Selecione Soluções.
5. Selecione Copilot Agent Kit.
6. Selecione Fluxos da nuvem.
7. Verifique se todos os fluxos estão habilitados (Status = Ativado).
8. Habilite todos os fluxos que não estão habilitados, na seguinte ordem:
   1. Fluxos que terminam com Neto.
   2. Fluxos que terminam com Child.
   3. Restante dos fluxos conforme necessário, em qualquer ordem.

Configurar o Centro de Conformidade

Para configurar o Hub de Conformidade, siga as etapas em Configurar e ajustar o Hub de Conformidade do Kit de Agente do Copilot. O Compliance Hub exige Inventário de Agentes.

Configurar o painel de KPI de Conversação integrado

Siga estas etapas somente se você planeja usar o painel de KPIs de conversa inserido.

Durante as etapas, anote os seguintes valores:

• Nome do espaço de trabalho
• GUID do Espaço de Trabalho
• Nome do relatório
• GUID de Relatório

Publicar o relatório

Para publicar o relatório de KPIs de Conversa:

1. Instale o Kit de Agente do Copilot, descrito anteriormente neste artigo.

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

3. Extraia o conteúdo do arquivo zip.

4. Abra o arquivo Conversation KPIs.pbit no aplicativo Power BI Desktop.

5. Insira a URL do Dataverse como a URL do Ambiente na caixa de diálogo exibida e selecione Carregar (por exemplo, org3c23948.crm.dynamics.comsem o https:// prefixo).

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

6. Atualize os dados e entre conforme necessário.

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

8. Anote o nome do relatório e o nome do workspace.

9. Entre no Power BI.

10. Abra o relatório que você publicou e anote o GUID do Workspace e o GUID de 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. Abrirconfigurações de arquivo>.

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

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

Atualizar a variável de ambiente de relatório

Para configurar o painel de KPIs de conversa inserido, atualize a variável de ambiente relacionada com os identificadores corretos. Você pode seguir esses passos ou usar o Assistente de Configuração.

1. Entre no Power Apps e selecione o ambiente onde você instalou o Kit de Agente do Copilot.
2. Selecione Soluções>Solução Padrão.
3. Selecione Variáveis de ambiente.
4. Localize e selecione Relatório de KPIs de Conversa.
5. Substitua os espaços reservados no Valor Padrão pelo 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. Clique em Salvar.

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

Acesse o aplicativo Kit de Agente do Copilot

Para acessar o aplicativo Kit de Agente do Copilot:

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

Compartilhar o aplicativo Copilot Agent Kit

Depois de verificar que o aplicativo foi iniciado com sucesso, o proprietário (ou o administrador do sistema que instalou o Kit) deve compartilhar o aplicativo Kit de Agente do Copilot com a equipe.

1. Entre em Power Apps.
2. Selecione Aplicativos.
3. Pesquise por "Copilot Agent Kit" e localize o que tem o tipo Code (não o aplicativo controlado por modelo).
4. Selecione os três pontos (...) e selecione Compartilhar ao lado do nome do aplicativo.
5. Pesquise e adicione os usuários ou grupos de segurança que precisam de acesso.
6. Selecione Compartilhar para confirmar.

Saiba mais em Como compartilhar um aplicativo de canvas com sua organização.

Próximas etapas