Instalar o kit de Copilot Studio

Copilot Studio Kit é um kit de ferramentas de software livre para testar e avaliar agentes 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 de MarketplaceorGitHub, juntamente com as etapas pós-implantação e as opções de configuração.

Instalar Copilot Studio Kit do Marketplace

Se preferir instalar Copilot Studio Kit de GitHub, pule para Instale o Kit de Copilot Studio de GitHub.

Implantar a partir do Marketplace

Para implantar Copilot Studio Kit do Marketplace, siga estas etapas:

1. Navegue até o kit de Copilot Studio em Marketplace.
2. Selecione Obtenha agora.
3. Entre, se necessário.
4. Na exibição Instalar Copilot Studio Kit, selecione o ambiente no qual deseja implantar o kit de Copilot Studio.
5. Examine os termos e declarações. Se você concordar, marque as caixas e selecione Instalar.

A instalação do kit de Copilot Studio começa.

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

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

1. Faça login no Power Apps.
2. Acesse Soluções.
3. Selecione Solução Padrão.
4. Selecione referências de conexão.
5. Localize Copilot Studio Kit – Dataverse e abra-o 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 Copilot Studio Kit de GitHub

Siga estas etapas para instalar Copilot Studio Kit do GitHub. Se você preferir instalar do Marketplace, vá para Instalar Copilot Studio Kit do Marketplace.

Baixar a versão mais recente do GitHub

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

Instalar o arquivo zip gerenciado CopilotStudioKit

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

1. Faça login no Power Apps.
2. Selecione o ambiente em que você deseja instalar Copilot Studio Kit.
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 solução existente (GitHub)

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

1. Faça login no Power Apps.
2. Selecione o ambiente em que você deseja atualizar Copilot Studio Kit.
3. Acesse Soluções.
4. Selecione Importar Solução.
5. Selecione Procurar.
6. Selecione CopilotStudioKit*_managed.zip.
7. Selecione Próximo. 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 se você instalou o kit de Copilot Studio do Marketplace ou GitHub.

Configurar SharePoint sincronização

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

Aponte a conexão para o SharePoint ao 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 SharePoint:

1. Instale Copilot Studio Kit, descrito anteriormente neste artigo.
2. Faça login no 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 Copilot Studio - SharePoint e abra-a 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 para SharePoint conforme necessário.
8. Clique em Salvar.

Mais informações: saiba mais sobre configurando agentes em Copilot Studio Kit, incluindo como configurar um novo agente para 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 Studio Kit – Power Platform para Administradores busca a lista de ambientes no locatário. Requer permissões de nível de administrador do Power Platform.
• Copilot Studio Kit – Dataverse coleta as 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.

Para usar o recurso Inventário de Agente:

1. Instale Copilot Studio Kit, descrito anteriormente neste artigo.
2. Faça login no 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 Copilot Studio Kit - Power Platform for Admins e abra-a 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 Copilot Studio Kit – Dataverse e abra-a 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 métricas de uso

Para habilitar métricas de uso opcionais no Inventário de Agentes, conclua as seguintes etapas:

1. Verifique se o conector HTTP com Microsoft Entra ID (pré-autenticado) é 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

Para habilitar os fluxos de nuvem incluídos no Kit Copilot Studio, se siga estas etapas ou use o assistente Setup.

1. Instale Copilot Studio Kit, descrito anteriormente neste artigo.
2. Faça login no Power Automate.
3. Verifique se o ambiente com o Copilot Studio Kit está selecionado.
4. Selecione Soluções.
5. Selecione Copilot Studio 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. Resto dos fluxos conforme necessário, em qualquer ordem.

Configurar o Centro de Conformidade

Para configurar o Compliance Hub, siga as etapas em Set up and configure Copilot Studio Kit Compliance Hub. 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 Copilot Studio Kit, descrito anteriormente neste artigo.

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

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 em que você instalou Copilot Studio Kit.
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 configurando agentes no Copilot Studio Kit, incluindo como configure um novo agente para KPIs de Conversa.

Acessar o aplicativo Copilot Studio Kit

Para acessar o aplicativo Copilot Studio Kit:

1. Entre no Power Apps e selecione o ambiente em que você instalou Copilot Studio Kit.
2. Acesse Aplicativos.
3. Localize e selecione Power CAT Copilot Studio Kit.
4. Selecione Reproduzir.
5. (Opcional) Marque o aplicativo.

Compartilhar o aplicativo Copilot Studio-Kit

Depois de verificar se o aplicativo é iniciado com êxito, o proprietário (ou administrador do sistema que instalou o Kit) precisa compartilhar o aplicativo kit Copilot Studio com a equipe.

1. Faça login no Power Apps.
2. Selecione Aplicativos.
3. Pesquise "Copilot Studio Kit" e localize aquele com o tipo Code (não o aplicativo controlado por modelos).
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óxima etapa