Ativar plugins para Inteligência Artificial generativa (visualização)

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

Seus representantes de atendimento ao cliente (representantes ou representantes de serviço) confiam em 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. Essa interação direta ajuda a reduzir a necessidade de os representantes de serviço mudarem para outras guias e ferramentas para fazer seu trabalho, além de melhorar o tempo de resolução e a satisfação do cliente.

Pré-requisitos

• No Copilot Studio, se quiseres usar um plugin de prompt no teu agente de IA embutido, cria um plugin prompt.
• No Copilot Studio, se quiseres usar um plugin de conector no teu agente de IA embutido, cria um plugin de conector personalizado.

Configurar plug-ins

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

Definir entradas para prompts

Ao adicionar entradas na tela Definir entradas (opcional), você habilita seu prompt para se tornar sensível ao contexto incorporando automaticamente dados relevantes. Esta entrada permite ao Copilot aceder diretamente aos campos especificados sem exigir que os representantes do serviço ao cliente introduzam manualmente informações já existentes 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 no 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 de serviço abre um caso e ativa o prompt, o Copilot recolhe automaticamente o nome do cliente e o ID do caso a partir do registo de suporte e usa-os como entradas para o prompt.

Para agentes de IA incorporados, você precisa gerar uma chave de parâmetro. A chave Parameter é 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 Dados. Você precisa especificar essas informações para gerar a chave Parameter.

2. Selecione Copiar para copiar o valor em Chave de parâmetro. O valor da chave Parameter é 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 Guardar.

   

4. Selecione Next para ir a Guardar os dados do plugin em Dynamics 365, e depois complete os passos para terminar a configuração do plugin.

5. Use a chave de parâmetro copiada na etapa 2 do arquivo JavaScript. Saiba mais em Passar a chave de parâmetro como entrada para o plugin.

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

Forneça a chave do parâmetro como entrada para o plugin

Crie um ficheiro JavaScript que use a variável Parameter Key que copiou no passo 2 do Configure a chave de parâmetros e subscreva a função Microsoft.CCaaS.EmbedSDK.Copilot.onGetPluginData dentro do Microsoft CCaaS Embed SDK. Aplicam-se as seguintes ações:

• 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 Parameter . Essa variável de chave de parâmetro é o valor copiado na etapa 2 da seção Configurar a chave de parâmetro .
• Ele retorna o valor da variável Parameter key para o plugin. O plug-in usa esse valor como entrada para o prompt.

Por exemplo, foram gerados duas chaves de parâmetros, incident____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 passados como entradas para o plugin.

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);
  });
});

Configurar a URL em CRMs que não sejam da Microsoft

Pode anexar o URL do seu ficheiro JavaScript ao URL do widget incorporável do Copilot que usa para integrar o widget Copilot no seu CRM não-Microsoft, adicionando "&copilotExtensionUrl=<URL to customer hosted .js file>" ao URL de incorporação existente.

Por exemplo, se o URL do seu ficheiro JavaScript for https://embedcopilotnonprod.blob.core.windows.net/embedcopilotnonprodcontainer/demopromptplugin.js, o URL que precisa de adicionar aos seus CRMs não Microsoft é 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 plugins

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

Considerações

• Você pode adicionar apenas uma ação de plugin.
• Se atualizares o plugin, recomendamos que guardes e republiques o plugin no Copilot Studio. Pode então selecionar Refresh no Plugins for generative AI (Preview) no centro de administração do serviço Copilot para ver as alterações.