Configurar um conector de modelo de linguagem grande (LLM) genérico

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 4 min. de leitura
  • Conecte um LLM externo ao Now Platform usando um conector de LLM genérico. Com um conector, você pode escrever seus próprios prompts para enviar ao LLM e criar suas próprias capacidades de IA generativa.

    Antes de Iniciar

    Você deve configurar as credenciais de API para o seu LLM antes de configurar o conector. Para obter mais informações, consulte configuração de credenciais de API para um LLM genérico.

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Controlador de IA generativa oferece várias conexões de sistema de base com provedores de serviços de IA populares, como Azure OpenAI e Google Vertex. No entanto, você pode incorporar um LLM do setor, um LLM específico do caso em seus fluxos de trabalho personalizados ou um LLM que adere às políticas de manipulação de dados da sua organização.
    Nota:
    Controlador de IA generativa só oferece suporte à geração de texto.

    Procedimento

    1. No filtro de navegação, acesse a tabela Configuração do modelo de IA generativa [sys_generative_ai_model_config] inserindo sys_generative_ai_model_config.list.
    2. Selecione Novo.
    3. No campo Modelo, insira o nome do modelo.
      Se você estiver usando o OpenAI do Azure, o nome do modelo será o nome da implantação do seu recurso.
    4. No campo Provedor, selecione LLM personalizado.
    5. No campo Alias de conexão e credencial, selecione o alias que você criou ao configurar suas credenciais.
      Se você ainda não configurou suas credenciais de API, consulte configuração de credenciais de API para um modelo de idioma genérico grande para saber como. Registro de configuração do modelo de IA generativa com o campo Provedor definido como LLM personalizado e o campo Alias de conexão e credenciais definido como My_Model_Alias.
    6. Crie a configuração do modelo selecionando Enviar.
      A configuração do modelo está associada à chave de API do modelo externo.
    7. No filtro de navegação, acesse a tabela Configuração da IA generativa [sys_generative_ai_config] inserindo sys_generative_ai_config.list.
    8. Selecione Novo.
    9. Selecione o ícone de pesquisa de lista ( Ícone de pesquisa de lista com lupa.) ao lado do campo Definição.
    10. No modal Selecionar o documento, selecione uma capacidade que você deseja configurar com o provedor LLM personalizado.
      Por exemplo, se você estiver configurando uma capacidade de resumo, selecione Resumir (LLM personalizado).
    11. Selecione OK para salvar sua seleção e fechar o modal.
    12. No campo Modelo, escolha a configuração do modelo que você criou na etapa 6.
      Depois de selecionar uma Definição, o campo Modelo muda para um menu suspenso com opções que usam o provedor LLM personalizado. A configuração do modelo que você fez deve aparecer nesta lista. Caso contrário, volte para a etapa 1 e verifique se a configuração do modelo tem o campo Provedor definido como LLM personalizado.
    13. No campo Modelo de prompt, insira o prompt da capacidade.
      O modelo de prompt é a instrução enviada ao LLM para executar uma capacidade. Use duas chaves em torno dos nomes de atributo de capacidade para incorporá-los ao modelo de prompt. Por exemplo, se você estiver configurando uma capacidade de resumo, o modelo de prompt poderá ser resumir o seguinte para mim em um tom amigável e útil: {{textToSumarize}}. Para saber quais atributos estão disponíveis para inclusão no prompt, acesse a tabela Capacidade do OneExtend [sys_one_extend_capability], localize o registro da capacidade que você está configurando e consulte a lista relacionada Atributos da capacidade do OneExtend. Registro de configuração da IA generativa com campos de modelo Definição, Modelo e Prompt preenchidos. Resumir registro de capacidade aberto com a lista relacionada de Atributos de capacidade do OneExtend realçada e os atributos identificados: erro, errorCode, provedor, resposta, status e textToSumarize. Pode ser necessário experimentar diferentes avisos para determinar o que funciona melhor para seus casos de uso.
    14. Crie a nova configuração de IA generativa selecionando Enviar.
    15. No filtro de navegação, acesse a tabela Transformador de LLM personalizado de IA generativa [sys_generative_ai_custom_llm_transformer] inserindo sys_generative_ai_custom_llm_transformer.
    16. Selecione Novo.
    17. Escreva scripts de transformador.
      Para que Controlador de IA generativa entenda o formato das entradas e saídas do seu LLM personalizado, você deve escrever scripts de transformador. Quando você cria um registro de transformador, o código e os comentários são fornecidos para você usar como um guia durante a edição. Esses scripts dependem dos objetos de solicitação e resposta esperados que são interpretados pelo seu modelo.

      Por exemplo, a estrutura de solicitação Azure OpenAI é semelhante ao seguinte script:

      {"messages": [{"role":"user", "content":"Summarize the following text: <<content>>"}], "max_tokens": 800, "temperature": 0.7}
      O script do transformador de solicitação para essa estrutura de solicitação é o seguinte:
      (function(inputs) {
          /* write code here to construct the request body and any custom headers needed using the inputs object.
          inputs structure: {
              prompt_data: object,
              request_data: object
          } */
          var requestData = inputs.request_data;    
          var promptData = inputs.prompt_data;
          var prompt = promptData.prompt;
          var model = promptData.model;
      
          // construct body using the inputs
          var body = {
              messages: [{
              "role": "user",
              "content": prompt
              }],
              max_tokens: parseInt(promptData.max_tokens),
              temperature: parseInt(promptData.temperature)    
          };
      
          //construct headers using the inputs
          var headers = {};                        
          return {
              body: body,
              headers: headers
          };
      })(inputs);
      A estrutura de resposta de Azure OpenAI é semelhante a este script:
      {
          "choices": [{
          "finish_reason": "stop",
          "index": 0,
          "message": {
              "content": "<<response>>",
              "role": "assistant"
              }
          }],
          "created": 1714994995,
          "id": "chatcmpl-9LqpXeLVXDAi6kciPfLeIDjmALeea",
          "model": "gpt-35-turbo-16k",
          "object": "chat.completion",
          "usage": {    
              "completion_tokens": 47,
              "prompt_tokens": 70,
              "total_tokens": 117
          }
      }
      Por causa dessa estrutura de resposta, o script do transformador de resposta é semelhante a este script:
      (function(inputs) {
          /* write code here to transform the llm response into an array of text responses, using the inputs object
          inputs structure: {
              prompt_data: object,
              request_data: object,
              response_body: string,
              response_headers: string
          } */
          var requestData = inputs.request_data;
          var promptData = inputs.prompt_data;
          var responseBody = JSON.parse(inputs.response_body);
          gs.info("response : " + inputs.response_body);
          var responseTexts = [];
      
          // write code here to populate the responseTexts array.
          responseTexts.push(responseBody.choices[0].message.content);
      
          return responseTexts;
      
      })(inputs);
    18. Crie os scripts do transformador selecionando Enviar.

    Resultado

    Seu LLM externo está conectado a Controlador de IA generativa. Você pode usar o provedor de serviços de IA para capacidades de IA generativa no Now Platform.

    O que Fazer Depois

    Depois de conectar o LLM, você pode definir um provedor para as capacidades de IA generativa de Controlador de IA generativa. As capacidades são Prompt genérico, Gerar conteúdo, Análise de sentimento e Resumir. Para obter mais informações sobre como escolher um provedor, consulte Definir um provedor para uma capacidade de IA generativa.