Prototipagem rápida com o Gemini

A API Generativa Language do Google permite criar protótipos sem problemas usando os modelos Gemini. Com ela, você testa e explora os recursos dos modelos Gemini sem precisar configurar infraestruturas complexas ou gerenciar a implantação de modelos. O Google AI Studio, ferramenta de prototipagem baseada em navegador do Google, usa a API Generative Language para ativar a prototipagem baseada em navegador com modelos generativos.

Com o SDK da Vertex AI para ABAP, você pode usar a API Generative Language, a API Gemini, para iniciar sua jornada de prototipagem diretamente no seu ambiente ABAP. Você precisa de uma chave de API gerada no Google AI Studio para acessar os modelos do Gemini. Só é necessário gerar essa chave de API uma vez.

Gerar uma chave de API

A chave de API gerada pelo Google AI Studio é uma maneira conveniente de autenticar para a API Gemini.

  1. No Google AI Studio, crie uma chave de API:

    1. Abra a página Chaves de API.

      consiga uma chave de API

    2. Clique em Criar chave de API.

    3. Se ele for preenchido, leia e confirme o aviso legal e clique em Continuar.

    4. Se estiver preenchido, leia e confirme o lembrete de configuração de segurança.

    5. Na caixa de diálogo Criar chave de API, selecione uma das seguintes opções, conforme apropriado:

      • Criar uma chave de API em um novo projeto
      • Criar chave de API em um projeto atual

    6. Copie a string da chave e guarde-a com segurança. Você precisa dessa chave de API para configurar a autenticação da API Gemini.

    7. Copie o número do projeto do Google Cloud em que a chave de API é gerada. Você vai precisar dele em uma etapa posterior.

Configurar a autenticação

Para autenticar na API Gemini usando uma chave de API, use um dos seguintes métodos:

Autenticar usando uma chave de API armazenada no SAP SSF

Para manter a chave de API segura, armazene a chave de API gerada no SAP SSF e configure uma chave do cliente com a classe de autenticação SSF. Você pode usar essa chave de cliente para acessar a API Gemini. Veja mais informações em:

Autenticar usando uma chave de API em uma classe de autenticação personalizada

Como alternativa, crie uma classe de autenticação personalizada para manter a chave de API e configure uma chave de cliente com a classe de autenticação personalizada.

  1. No seu sistema SAP, crie uma classe Z implementando a interface /GOOG/IF_AUTH que acompanha o SDK do ABAP for Google Cloud:

    1. Na GUI do SAP, execute o código de transação SE24.
    2. No campo Tipo de objeto, digite um nome como Z_TEST_GEMINI_API e clique em Criar.
    3. Verifique se o Tipo de objeto é Classe e clique em OK.
    4. No campo Descrição, forneça uma descrição da classe, como Class for authentication to Google AI Studio, e salve a classe como um Objeto local ou em uma Solicitação de transporte.
    5. Abra a guia Interfaces, adicione a interface /GOOG/IF_AUTH e pressione Enter.
    6. Abra a guia Métodos. Os métodos da interface /GOOG/IF_AUTH são implementados automaticamente na classe Z.
    7. Clique duas vezes no método /GOOG/IF_AUTH~GET_ACCESS_TOKEN.

    8. No método /GOOG/IF_AUTH~GET_ACCESS_TOKEN, adicione o seguinte código:

      ev_auth_type = /goog/if_auth=>c_auth_type_apik_ssf.
cv_token = 'API_KEY'.
GET TIME STAMP FIELD ev_logtime.

      Substitua API_KEY pela chave de API gerada no Google AI Studio.

    9. Ative a classe Z.

  2. No sistema SAP, crie uma configuração de chave de cliente:

    1. Na GUI do SAP, execute o código de transação /GOOG/SDK_IMG.

      Como alternativa, execute o código da transação SPRO e clique em IMG de referência do SAP.

    2. Clique em ABAP SDK for Google Cloud > Configurações básicas > Configurar chave do cliente.

    3. Clique em Novas entradas.

    4. Insira valores nos campos a seguir:

      Campo Descrição
      Nome da chave do Google Cloud Especifique um nome da configuração da chave do cliente, como TEST_GEMINI_API.
      Nome da conta de serviço do Google Cloud Deixe esse campo em branco.
      Escopo do Google Cloud Deixe esse campo em branco.
      Identificador de projeto do Google Cloud Especifique o número do projeto do Google Cloud em que a chave da API está armazenada.
      Nome do comando Deixe esse campo em branco.
      Classe de autorização Especifique a classe Z que você criou na etapa anterior, como Z_TEST_GEMINI_API.
      Armazenamento de tokens em cache

      Deixe esse campo em branco.
      Token de atualização em segundos Deixe esse campo em branco.
      Parâmetro de autorização 1 Deixe esse campo em branco.
      Parâmetro de autorização 2 Deixe esse campo em branco.

    5. Salve a nova entrada.

  3. Anote a chave de cliente. Você usará essa chave de cliente para autenticação.

Executar a demonstração do AI Studio

É possível explorar os recursos da API Gemini usando a demonstração do IA Studio enviada com o SDK da Vertex AI para ABAP.

Para executar a demonstração do AI Studio, siga estas etapas:

  1. Na GUI do SAP, execute o código de transação /GOOG/SDK_IMG.

    Como alternativa, execute o código da transação SPRO e clique em IMG de referência do SAP.

  2. Acesse ABAP SDK for Google Cloud > Demonstrações.

  3. Abra o SDK da Vertex AI: demonstração: prototipagem com a API Generative Language.

  4. No campo Chave do cliente, insira a chave do cliente que você criou na seção Configurar autenticação.

  5. No campo ID do modelo, insira o ID do modelo LLM que que você quer usar, como gemini-1.5-flash. Para mais informações sobre os modelos compatíveis, consulte Variantes de modelo.

  6. Opcionalmente, forneça os seguintes parâmetros de geração, conforme apropriado:

    • Máximo de tokens de saída
    • Tipo MIME da resposta
    • Temperatura
    • TopK
    • TopP

    Para informações sobre esses parâmetros de geração de modelos, consulte Testar valores de parâmetro.

  7. No campo Inserir instruções do sistema, forneça uma instrução do sistema.

  8. No campo Inserir comando, informe o comando de entrada.

  9. Execute o programa. A área Resposta do LLM mostrará a saída gerada.

Prototipar casos de uso de IA usando ABAP

É possível criar protótipos de aplicativos SAP usando as classes /GOOG/CL_GENERATIVELANGUAGE_V1 e /GOOG/CL_GENERATIVELANG_V1BETA enviadas com o SDK. É possível invocar essas classes no ambiente ABAP usando a chave de cliente que você criou na seção Configurar autenticação.

A seguir