Como Configurar Chaves de API do Gemini para Discourse AI
Introdução
Este tópico aborda como configurar sua chave de API do Google Gemini com um projeto existente na conta do Google Cloud. O Gemini não é um serviço gratuito e, portanto, você precisará garantir que o faturamento esteja configurado em seu administrador do Google Cloud.
Há algumas informações importantes com links na página de geração de chaves do Gemini Developer Studio sobre isso:
Ok, vamos começar!
NOTA: É necessário acesso de nível de administrador ao Google Cloud e ao seu fórum Discourse.
Etapa 1: Configurando um Projeto do Google Cloud
A configuração correta de uma chave de API do Gemini requer que você tenha acesso de administrador à sua conta do Google Cloud e que crie um projeto de faturamento lá que possa usar para o uso da sua chave de API do Gemini.
Você pode criar sua chave no Gemini Studio e se conectar ao seu Google Cloud, mas é um pouco mais fácil fazer tudo pelo console do Google Cloud para que você não precise ir e voltar.
Acesse o administrador do Google Cloud para API de sua organização e certifique-se de estar na organização pai (você pode vê-la no campo superior ao lado do logotipo do Google Cloud).
Você terá que criar um projeto para sua chave Gemini se ainda não tiver um que queira usar (observe que o link para selecionar ou criar um novo projeto fica no canto superior esquerdo da página).
Para um novo projeto, preencha a página de criação de novo projeto (certifique-se de que sua organização esteja selecionada no campo suspenso apropriado).
Para gerenciar o faturamento do seu projeto, você precisará configurar uma conta de faturamento para o projeto no faturamento do Google Cloud, assumindo que você tenha o faturamento configurado para sua organização. Você (ou seu gerente de conta de faturamento) poderá fazer isso mais tarde, após a criação da chave. Observe que existem cotas para projetos e projetos de faturamento, dependendo da conta do Google Cloud de sua organização. Para habilitar o faturamento em seu projeto, vá para a guia Faturamento no menu de navegação do Google Cloud e vincule uma conta de faturamento (consulte o link “Gerenciar Contas de Faturamento”) e habilite o faturamento para o projeto na página de projetos de faturamento.
Etapa 2: Criar uma Chave de API do Gemini
IMPORTANTE! Lembre-se de usar suas chaves de API com segurança. Leia atentamente Mantenha sua chave de API segura e Melhores práticas para usar chaves de API com segurança antes de prosseguir.
Agora você está pronto para criar uma chave de API no projeto. Vá para as credenciais desse projeto, clique no link “+ criar credenciais” no topo e selecione “Chave de API” nas opções suspensas.
Uma nova chave de API será criada para você. Copie-a e guarde-a em um local seguro, como um gerenciador de senhas. Não compartilhe chaves. Esta é a chave que você precisará inserir nas configurações do seu Discourse AI.
A chave agora deve estar listada em suas chaves de API. Clique nela para editar a chave de API.
Dê um nome apropriado à chave e, em seguida, vá para a seção Restrições de API e selecione “Restringir chave”, depois escolha “Generative Language API”.
Salve sua chave atualizada. Clique no link “Mostrar chave” para sua nova chave e copie-a.
Etapa 3: Configurar o Gemini nas Configurações do Discourse AI
Agora vá para sua instância do Discourse e cole sua chave de API nas configurações do Discourse AI em Admin > Plugins > AI > LLMs para qualquer Gemini LLM que você desejar usar:
Etapa 4: Rastreando o Uso da Chave de API do Gemini
Você pode rastrear o uso da sua chave de API do Gemini no painel do Google Cloud em faturamento, em “Gerenciar Conta de Faturamento”.
Em seguida, selecione seu projeto específico na lista de projetos de faturamento, e ele exibirá o relatório de faturamento onde você pode especificar os projetos e vários outros detalhes que deseja usar para rastrear seus projetos de chave de API (você também pode rastrear outras chaves de API do Google associadas à sua conta do Google Cloud aqui, por exemplo, se você tiver Google Custom Search API e Programmable Search Engine configurado).
