Configurando as Funções de IA Generativa do Oracle APEX com o Groq (de graça)

Faz algum tempo eu queria testar as funções nativas de IA generativa no Oracle APEX, mas não consegui avançar com a API da OpenAI por não ter um plano pago.

Recentemente, vi uma postagem no LinkedIn sobre a Groq, uma alternativa interessante que concorre com a OpenAI, utilizando modelos de linguagem open source de empresas como Google, Meta e DeepSeek. Pesquisando mais a fundo, fiquei impressionado com a velocidade absurda de geração dos textos — algo fácil de entender para quem já minerou criptomoedas, já que eles utilizam chips ASIC para processar as respostas.

Indo direto ao ponto: neste artigo, vou mostrar como habilitar os serviços de IA generativa no Builder do APEX utilizando a API da Groq (compatível com o padrão da OpenAI).

Primeira coisa: você precisa se cadastrar em https://groq.com/ e obter uma chave de API. Um detalhe importante: a versão do seu APEX precisa ser no mínimo 24.1 para isso funcionar.

Dentro de qualquer aplicação APEX, vá em Generative AI → AI Services, como mostrado na imagem abaixo.

Crie um novo serviço preenchendo os dados conforme o exemplo, colocando a sua chave em API Key. Ainda nessa tela, você pode testar a conexão.

Se aparecer uma mensagem de erro informando que apenas um serviço pode ser usado no App Builder, volte à tela anterior, desmarque o serviço ativo e marque o novo, da Groq.

Na configuração do modelo, você pode escolher qualquer um dos seguintes:

gemma2-9b-it
meta-llama/llama-guard-4-12b
llama-3.3-70b-versatile
llama-3.1-8b-instant
whisper-large-v3
whisper-large-v3-turbo
distil-whisper-large-v3-en

O LLaMA pode não ser o modelo ideal, mas serve bem para testes iniciais.

Se tiver problemas de permissão, logue como SYS ou ADMIN e execute os comandos abaixo (substitua your_schema_name pelo nome do seu schema).

grant execute on DBMS_CLOUD to your_schema_name;
grant execute on DBMS_CLOUD_AI to your_schema_name;

Aproveite e libere o groq na ACL. (lembre de mudar your_schema_name para o nome do seu schema)

BEGIN
    DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE(
          HOST => 'api.groq.com',
          ACE => XS$ACE_TYPE(PRIVILEGE_LIST => XS$NAME_LIST('http'), 
                             PRINCIPAL_NAME => 'your_schema_name',
                             PRINCIPAL_TYPE => XS_ACL.PTYPE_DB)
);
END;

Pronto, agora é hora de testar!

No SQL Workshop, você verá o botão APEX Assistant. Basta selecionar um trecho de código para começar a interagir com a IA — seja para tirar dúvidas ou pedir sugestões de melhoria.