Habilitar plug-ins para IA generativa (versão preliminar)

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

Os representantes do serviço de atendimento ao consumidor (representantes de serviço ou representantes) contam com dados e informações de uma ampla variedade de sistemas. Com plug-ins, você pode interagir diretamente com seus dados que não são do Microsoft CRM. Esta interação direta ajuda a reduzir a necessidade de os representantes de serviço de atendimento de alternarem para outras guias e ferramentas para fazer seu trabalho e melhorar o tempo de resolução e a satisfação do cliente.

Pré-requisitos

• No Copilot Studio, se você quiser usar um plug-in de prompt em seu agente de IA incorporado, crie um plug-in de prompt.
• No Copilot Studio, se você quiser usar um plug-in de conector em seu agente de IA incorporado, crie um plug-in de conector personalizado.

Configurar plug-ins

Para usar o plug-in de prompt ou plug-in de conector em seu agente de IA incorporado depois de criar o plug-in no Copilot Studio, você deve ativar o plug-in no centro de administração. As seções a seguir descrevem como habilitar e configurar plug-ins.

Plug-in de prompt

1. No Centro de administração do Copilot Service, selecione Produtividade.
2. Na página Produtividade, selecione Gerenciar para Plug-ins para IA generativa (versão preliminar). A página Plug-ins para IA generativa (Visualização) aparece com todos os prompts de plug-in gerados para o ambiente.
3. Selecione o plug-in de prompt que deseja habilitar e, em seguida, na barra de comandos, selecione Ativar.
4. Em Selecionar tipo de acesso, selecione um dos seguintes tipos:
   • Todos os agentes com o Copilot: agentes com o Copilot habilitado por meio dos perfis de experiência do agente.
   • Funções de usuário específicas: selecione as funções na lista.
5. A tela Definir entradas (opcional) é exibida. Esta etapa é opcional e permite que você forneça contexto que Copilot pode usar automaticamente para gerar respostas. Se você não adicionar uma entrada, os representantes de serviço terão que especificar manualmente o contexto quando executarem o plug-in. Para configurar entradas e saber mais sobre como esse recurso funciona, execute as etapas na seção Definir entradas.
6. Selecione Avançar, e então na tela Dados do plug-in, selecione Armazenar os dados deste plug-in. Os dados são armazenados no banco de dados do Dataverse como parte das interações do representante do serviço com o Copilot como transcrições de chat. Saiba mais em Transcrições e os dados de interação do Copilot.
7. Selecione Ativar plug-in.
8. Selecione Publicar alterações na mensagem de alerta na parte superior da página e selecione Confirmar na caixa de diálogo de confirmação exibida. Pode demorar até 15 minutos para que as alterações sejam publicadas.

Plug-in de conector personalizado

1. No mapa do site do centro de administração do serviço Copilot, escolha uma das seguintes etapas para acessar os plug-ins:

   • Selecione Produtividade>Plug-ins para IA generativa (versão preliminar) em Experiência do Agente.
   • Selecione Insights>Plug-ins para IA generativa (versão preliminar) em Operações.

2. Selecione Gerenciar.

3. Na página Plug-ins para IA generativa (versão preliminar), selecione o plug-in do conector personalizado e, em seguida, selecione Ativar na barra de comandos.

4. Na caixa de diálogo Selecionar autenticação do usuário, selecione o botão de reticências (...) em Configurar um link para o conector e, em seguida, selecione a conexão necessária. Uma marca de seleção verde indica que a fonte de dados foi conectada com êxito.

5. Em Autenticação do usuário, selecione uma das seguintes opções:

   • Administrador: usa a autenticação de administrador para conceder acesso a representantes do serviço.
   • Agente: exige que os representantes do serviço forneçam autenticação em runtime. Essa opção é recomendada se os dados forem restritos ou confidenciais.

6. Na tela Gerenciar acesso do usuário, selecione um dos seguintes tipos de acesso:

   • Todos os agentes com o Copilot: representantes com o Copilot habilitado por meio dos perfis de experiência do agente.
   • Funções de usuário específicas: selecione as funções na lista.

7. Selecione Avançar.

8. A tela Definir entradas (opcional) é exibida. Esta etapa é opcional e permite que você forneça o contexto que Copilot pode usar automaticamente para gerar respostas. Se você não adicionar uma entrada, os representantes de serviço terão que especificar manualmente o contexto quando executarem o plug-in. Para configurar entradas e saber mais sobre como esse recurso funciona, execute as etapas na seção Definir entradas.

9. Em Respostas, selecione Não resumir respostas de plug-in se você não quiser que o Copilot interprete as respostas e, em vez disso, apresente toda a resposta disponível no plug-in.

10. Selecione Avançar e, na tela Salvar dados do plug-in no Dynamics 365, depois selecione Salvar os dados deste plug-in na transcrição do Dynamics 365 Copilot. Os dados são armazenados no banco de dados do Dataverse como parte das interações do representante do serviço com o Copilot como transcrições de chat. Saiba mais em Transcrições e os dados de interação do Copilot.

    Importante

    Independentemente de você marcar a caixa de seleção, o Copilot Studio salva todos os dados de plug-in como parte das transcrições de conversa do representante do serviço. A Microsoft não tem acesso a essas informações.

11. Selecione Ativar plug-in.

12. Selecione Publicar Alterações na mensagem de alerta na parte superior da página e selecione Confirmar na caixa de diálogo de confirmação exibida. Pode demorar até 15 minutos para que as alterações sejam publicadas.

Definir entradas para prompts

Ao adicionar entradas na tela Definir entradas (opcional), você habilita o prompt para se tornar sensível ao contexto incorporando automaticamente os dados relevantes. Essa entrada permite que Copilot acesse diretamente os campos especificados sem exigir que os representantes do serviço de atendimento ao consumidor insiram manualmente informações que já existem no sistema.

Se você não configurar entradas, os prompts permanecerão estáticos e não terão a capacidade de acessar o contexto. Em seguida, o plug-in solicita aos representantes de serviço informações adicionais que eles devem inserir manualmente.

Por exemplo, você tem um prompt que recupera os detalhes do pedido de um cliente com base no nome do cliente e na ID do caso. Você pode adicionar os campos nome do cliente e ID do caso como uma entrada em Definir entradas (opcional).

Quando um representante do serviço abre um caso e dispara o prompt, o Copilot pega automaticamente o nome do cliente e a ID do caso do registro do caso e os usa como entradas para o prompt.

Para agentes de IA incorporados, você precisa gerar uma Chave do parâmetro. A Chave do parâmetro é um identificador exclusivo usado em um arquivo JavaScript para recuperar o contexto necessário do CRM que não é da Microsoft.

Configurar a chave de parâmetro

Para configurar os parâmetros na página Definir Entradas, execute as seguintes etapas:

1. Especifique o Tipo de registro e o Campo de dados. Você precisa especificar essas informações para gerar a Chave do parâmetro.

2. Selecione Copiar para copiar o valor na Chave do parâmetro. O valor da Chave do parâmetro é uma variável que o sistema usa em um JavaScript para armazenar o valor que o sistema passa para o plug-in como uma entrada.

3. Selecione Salvar.

   

4. Selecione Avançar para ir para Salvar dados do plug-in no Dynamics 365 e, em seguida, conclua as etapas para concluir a configuração do plug-in.

5. Use a Chave do parâmetro que você copiou na etapa 2 no arquivo JavaScript. Saiba mais em Passar a chave de parâmetro como entrada para o plug-in.

6. Configure a URL do arquivo JavaScript em CRMs não-Microsoft para concluir a instalação.

Passe a chave de parâmetro como entrada para o plugin

Crie um arquivo JavaScript que use a variável Chave de Parâmetro que você copiou na etapa 2 de Configurar a Chave de Parâmetro e assine a Microsoft.CCaaS.EmbedSDK.Copilot.onGetPluginData função no SDK Inserido do CCaaS da Microsoft. As seguintes ações são aplicáveis:

• A função escuta uma solicitação para obter dados do plugin.
• Ele recupera os dados necessários do sistema e atribui o valor à variável Chave de Parâmetro. Essa variável Chave de Parâmetro é o valor copiado na etapa 2 da seção Configurar a chave de parâmetro.
• Ela retorna o valor da variável Chave do parâmetro ao plug-in. O plug-in usa esse valor como entrada para o prompt.

Por exemplo, você gerou duas Chaves de Parâmetroincident____customerid_account____accountid e customerid_account____accountid na página Definir entrada (opcional).. Aqui está o código de exemplo da função que retorna um valor de 1 para incident____customerid_account____accountid e 2 para customerid_account____accountid que são então passados como entradas para o plug-in.

Microsoft.CCaaS.EmbedSDK.Copilot.onGetPluginData((request) => {
  return new Promise((resolve, reject) => {
    // 7 get plugin data
    const { objectData } = request;
    const pluginContext = objectData || {};
    const { entityId, entityName, parameters, parameterValues } = pluginContext;
    let responseData = null;
  console.log("External adapter plugin invoked...");
 
    if (entityName === "incident" && // sample entity name (case == incident)
      parameters.length > 0) {
      // copy parameter values
      const values = parameterValues;
      // override parameter values for 1P or 3P scenario
      parameters.forEach((param) => {
        if (param === "incident____customerid_account____accountid") {
          values[param] = "1";
        }
    
    if (param === "customerid_account____accountid") {
          values[param] = "2";
        }
      });
      // return the updated parameter values
      responseData = {
        entityId,
        entityName,
        parameters,
        parameterValues: values,
      };
    }
    const dataResponse = {
      objectId: request.objectId,
      objectType: request.objectType,
      data: responseData,
    };
  console.log("External adapter sending data from plugin:",responseData);
    resolve(dataResponse);
  });
});

Observação

Certifique-se de hospedar esse arquivo em um servidor Web e torná-lo acessível publicamente para evitar problemas de autenticação.

Configurar o URL nas CRMs não Microsoft

Você pode acrescentar a URL do arquivo JavaScript à URL do widget incorporável Copilot que você usa para incorporar o widget Copilot em seu CRM que não seja da Microsoft adicionando "&copilotExtensionUrl=<URL to customer hosted .js file>" à URL incorporada existente.

Por exemplo, se a URL do arquivo JavaScript for https://embedcopilotnonprod.blob.core.windows.net/embedcopilotnonprodcontainer/demopromptplugin.js, a URL que você precisa adicionar aos CRMs que não são da Microsoft será a seguinte:

https://copilotforservice-prod.azureedge.net/widget/index.html?dynamicsUrl=https://X<your_org_URL>&copilotExtensionUrl=https://embedcopilotnonprod.blob.core.windows.net/embedcopilotnonprodcontainer/demopromptplugin.js

Gerenciar plug-ins

Use as opções no menu de comando para gerenciar os plugins. O botão de edição permite a você atualizar as configurações do plug-in e publicar as alterações. Não é possível alterar nenhuma configuração enquanto a publicação estiver em andamento.

Considerações

• Você só pode adicionar uma ação do plug-in.
• Se você atualizar o plug-in, recomendamos que você salve e publique novamente o plug-in no Copilot Studio. Em seguida, você pode selecionar Atualizar nos Plug-ins para IA generativa (Versão preliminar) no centro de administração do Copilot Service para ver as alterações.