Personalizar o chat do Copilot usando o Copilot Studio (versão preliminar)

[Este artigo faz parte da documentação de pré-lançamento e está sujeito a alterações.]

Personalize o chat Copilot para torná-lo ainda mais inteligente e relevante para sua organização, adicionando tópicos adicionais, fontes de conhecimento e muito mais.

Importante

• Este é um recurso em versão preliminar.
• As versões prévias do recurso não foram criadas para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos estão sujeitos a termos de uso suplementares e são disponibilizados antes de um lançamento oficial, de maneira que os clientes possam ter acesso antecipado e fazer comentários.

Você personaliza o chat do Copilot usando o Microsoft Copilot Studio e expande os recursos para além de apenas lidar com perguntas das tabelas do Microsoft Dataverse e habilidades prontas para uso. Antes de personalizar, verifique se o Chat do Copilot está habilitado para seu ambiente.

Observação

• Licença e permissões de edição do agente do Copilot Studio são necessárias para personalizar o chat do Copilot.
• Esse recurso só está disponível em aplicativos autônomos baseados em modelo e ainda não é compatível com aplicativos Dynamics 365.

1. Vá para https://make.preview.powerapps.com.
2. Abra o aplicativo baseado em modelo no modo de edição e, na barra de navegação esquerda, selecione ...>Configurar no Copilot Studio. Você será levado para o Microsoft Copilot Studio no qual o agente do seu aplicativo está configurado. Cada aplicativo Copilot autônomo baseado em modelo tem seu próprio agente dedicado disponível para personalizações. A configuração do agente pela primeira vez leva alguns segundos.

   Importante

   • Se ... não aparece no painel de navegação esquerdo, o recurso ainda não está disponível em seu ambiente. Você pode provisionar novos ambientes de versão antecipada para acessar o recurso. Este é um recurso de visualização e está disponível apenas em ambientes de lançamento antecipado.
3. Personalize seu agente adicionando fontes de conhecimento ou tópicos. A personalização desse agente afeta apenas o chat Copilot do aplicativo específico para o qual ele foi provisionado.
4. Publique o agente depois de fazer personalizações para garantir que as alterações estejam disponíveis para os usuários.

Adicionar conhecimento ao chat do Copilot

Você pode estender a inteligência de chat do Copilot do seu aplicativo adicionando fontes de conhecimento adicionais no Copilot Studio. Por exemplo, você pode adicionar um link para um site externo voltado para o público, como documentação do Power Apps, adicionando https://learn.microsoft.com/power-apps/ como conhecimento para permitir que seu chat do Copilot responda a perguntas relacionadas ao criar aplicativos no Power Apps. Outro exemplo é carregar o conhecimento interno da sua organização como um documento para permitir que o chat Copilot responda a consultas relevantes que não fazem parte dos dados do aplicativo.

Mais informações: Adicionar um conhecimento a um agente existente - Microsoft Copilot Studio.

Observação

• Atualmente, apenas Site público, Carregamento de arquivo e tipos de fonte de conhecimento do SharePoint têm suporte. O Conhecimento do Dataverse não faz parte dessa versão preliminar.
• A Orquestração de IA Generativa do Copilot studio não tem suporte no momento. Você pode usar o tópico de orquestração clássica cujas frases de gatilho correspondem mais de perto à consulta do usuário para uma determinada habilidade.

Depois que o conhecimento estiver habilitado, os usuários do aplicativo poderão fazer perguntas relevantes para obter respostas junto com as referências de conhecimento.

Adicionar novo tópico ao chat Copilot

No Copilot Studio, você pode adicionar tópicos ao agente do Copilot do seu aplicativo. Esses tópicos podem ser personalizados para usar vários tipos de gatilho e podem responder com mensagens simples, cartões adaptáveis ou respostas generativas. Além disso, os tópicos também podem iniciar ações como fluxos, conectores e plug-ins do Dataverse, permitindo a integração perfeita em determinado momento com sistemas externos.

Mais informações: Criar e editar tópicos – Microsoft Copilot Studio.

Observação

O Copilot Studio tem capacidade em linha para "Testar seu agente" e pode ser usado para validar tópicos à medida que são adicionados. No entanto, os tópicos que usam variáveis personalizadas prontas para uso do aplicativo baseado em modelo como Global.PA__Copilot_Model_PageContext.pageContext.id só podem ser testados no Copilot publicado.

Personalizações da guia de prompts

Uma biblioteca de prompts é uma coleção de prompts pré-escritos, testados e otimizados projetados para ajudar a moldar as interações e respostas do chat Copilot. Eles garantem que o chat Copilot forneça informações relevantes, precisas e contextualmente apropriadas com base nas necessidades e preferências do usuário.

As etapas a seguir detalham como adicionar consultas específicas ao guia de prompts. Uma seção Ajuda do Power Apps é anexada ao guia de prompt do Copilot pronto para uso existente. Como alternativa, você pode copiar o código de exemplo em um novo tópico diretamente do exemplo de guia de prompt. Todos os prompts mostrados ao usuário final por meio do guia de prompts são armazenados no agente do Copilot Studio usado para o aplicativo.

1. Abra o agente que suporta o aplicativo no Copilot Studio e adicione um novo tópico em branco.

2. Renomeie o tópico para refletir a intenção do tópico e altere o gatilho do tópico para Evento recebido.

3. Selecione Evento recebido e, em seguida, defina o nome do evento como Microsoft.PowerApps.Copilot.RequestSparks, que é o nome reservado para o guia de prompt.

4. Como opção, você pode definir as condições para solicitar entradas, caso elas sejam específicas para o nome do aplicativo, contexto da página e assim por diante. Por exemplo, essa entrada de prompt verifica se o nome exclusivo do aplicativo atual ou o nome do tipo de tabela do contexto da página correspondem aos valores especificados. Se qualquer uma das condições for verdadeira, o chat Copilot será ativado.

   condition: =Global.PA_Copilot_Model_SessionContext.appUniqueName = "yourAppName" or Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName = "Entity name"

5. Adicione um valor de prioridade apropriado para que o gatilho seja acionado após os tópicos de prioridade mais alta. Os valores de prioridade podem ter um intervalo de 0 a 10K, sendo 0 o mais alto. 200 é o exemplo usado aqui.

6. Adicione uma próxima etapa para valor de análise de gerenciamento de variáveis.

7. Defina o valor de análise como a seguinte fórmula do Power Fx e o tipo de dados como tabela.

   [{displayName:"Power Apps Help",displaySubtitle:"Power Apps Help",iconName:"List24Regular",sparks:[{displayName:"What is Copilot chat?",type:"PromptText"},{displayName:"How can I use the record picker?",type:"PromptText"},{displayName:"What types of questions can I ask Copilot?",type:"PromptText"},{displayName:"How do I provide feedback on Copilot’s responses?",type:"PromptText"}]}]
   

   

8. Selecione Editar esquema e cole o esquema a seguir.

   kind: Table
   properties:
     displayName: String
     displaySubtitle: String
     iconName: String
     sparks:
       type:
         kind: Table
         properties:
           displayName: String
           eventName: String
           iconName: String
           payload: String
           type: String
   

9. Defina Salvar como para salvar como uma nova variável personalizada e nomeie-a como algo significativo, como SparkGroupCustom.

10. A definição de spark é salva em uma variável global, portanto, você precisa definir a variável Global e nomeá-la PA_Copilot_Sparks.sparkGroups e/ou Global.PA_Copilot_Sparks.sparks. Isso preenche o submenu com seus prompts. Em seguida, adicione uma etapa para definir o valor da variável.

11. Procure o nome da definição de Sparks, como Global.PA_Copilot_Sparks.sparkGroups, e defina o valor para a seguinte função de mesclagem do Power Fx. Mesclar

    ForAll(Sequence(CountRows(Global.PA_Copilot_Sparks.sparkGroups)+CountRows(Topic.SparkGroupCustom)), If(Value<=CountRows(Global.PA_Copilot_Sparks.sparkGroups),Index (Global.PA_Copilot_Sparks.sparkGroups,Value), Index(Topic.SparkGroupCustom, Value - CountRows(Global.PA_Copilot_Sparks.sparkGroups))))
    

    Substitua o nome da variável pelo nome da variável usada para os prompts personalizados.

12. Publique o agente e reproduza o aplicativo.

    

Exemplo de tópico de personalizações do guia de prompt

Aqui está o código completo do tópico, que pode ser copiado diretamente para o novo tópico.

kind: AdaptiveDialog
beginDialog:
  kind: OnEventActivity
  id: main
  priority: 200
  eventName: Microsoft.PowerApps.Copilot.RequestSparks
  actions:
    - kind: ParseValue
      id: iCepPf
      variable: Topic.SparkGroupCustom
      valueType:
        kind: Table
        properties:
          displayName: String
          displaySubtitle: String
          iconName: String
          sparks:
            type:
              kind: Table
              properties:
                displayName: String
                eventName: String
                iconName: String
                payload: String
                type: String
      value: |-
        =[{displayName:"Power Apps Help",displaySubtitle:"Power Apps Help",iconName:"List24Regular",
        sparks:[
        {displayName:"What is Copilot chat?",type:"PromptText"},
        {displayName:"How can I use the record picker?",type:"PromptText"},
        {displayName:"What types of questions can I ask Copilot?",type:"PromptText"},
        {displayName:"How do I provide feedback on Copilot’s responses?",type:"PromptText"}
        ]}]

    - kind: SetVariable
      id: setVariable_pDu9cr
      variable: Global.PA_Copilot_Sparks.sparkGroups
      value: =ForAll(Sequence(CountRows(Global.PA_Copilot_Sparks.sparkGroups)+CountRows(Topic.SparkGroupCustom)), If(Value<=CountRows(Global.PA_Copilot_Sparks.sparkGroups),Index (Global.PA_Copilot_Sparks.sparkGroups,Value), Index(Topic.SparkGroupCustom, Value - CountRows(Global.PA_Copilot_Sparks.sparkGroups))))

Observação

Se o seu agente oferece suporte a vários idiomas e precisa de tradução do guia de prompt, todas as cadeias de caracteres de perguntas voltadas para o usuário devem ser definidas usando um SetTextVariable.

Limitações conhecidas

• Copilot os agentes de bate-papo atualmente não são identificados pela plataforma como uma dependência. Você deve adicionar manualmente o agente relevante do chat do Copilot à sua solução de aplicativo baseada em modelo antes de exportar e importar para outro ambiente.
• A ação Configurar no Copilot Studio pode criar agentes com o mesmo nome de exibição para aplicativos que têm os mesmos caracteres iniciais no nome do aplicativo. Quando isso ocorrer, renomeie o agente durante a publicação para evitar confusão.
• Os tipos de mensagens de Imagem e Vídeo de agente para usuário não são compatíveis. Como solução alternativa, você pode usar Cartões Adaptáveis.

Informações relacionadas

• Adicionar chat do Copilot a aplicativos baseados em modelo
• Perguntas frequentes do chat do Copilot em aplicativos baseados em modelo
• Perguntas frequentes sobre IA responsável no Power Apps
• Habilitar recursos dos copilotos e de IA generativa no Power Apps