<div data-theme-toc="true"> </div>
# Como Configurar Chaves de API do Gemini para o Discourse AI
## Introdução
Este tópico aborda como configurar sua chave de API do Google Gemini com um projeto de conta do Google Cloud existente. O Gemini não é um serviço gratuito e, portanto, você precisará garantir que o faturamento esteja configurado em seu administrador do Google Cloud.
Existem algumas informações importantes com links na página de geração de chaves do [Gemini Developer studio](https://aistudio.google.com/) sobre isso:
Ok, vamos começar!
> :point_up: **NOTA**: É necessário acesso de nível de administrador ao Google Cloud e ao seu fórum Discourse.
***
## Passo 1: Configurando um Projeto no Google Cloud
A configuração adequada de uma chave de API do Gemini requer que você tenha acesso de administrador à sua conta do Google Cloud e crie um projeto de faturamento que possa usar para o uso da sua chave de API do Gemini.
Você pode criar sua chave no Gemini Studio e conectá-la ao seu Google Cloud, mas é um pouco mais fácil fazer tudo a partir do console do Google Cloud para não ter que ir e voltar.
Acesse o [administrador do Google Cloud para API](https://console.cloud.google.com/apis/credentials) de sua organização e certifique-se de estar na organização pai (você pode ver isso 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 deseja usar (observe que o link para selecionar ou criar um novo projeto está 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](https://console.cloud.google.com/billing/projects), presumindo que você tenha o faturamento configurado para sua organização. Você (ou seu gerente de conta de faturamento) poderá fazer isso mais tarde, depois que a chave for criada. 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](https://console.cloud.google.com/billing/projects).
***
## Passo 2: Criar uma Chave de API do Gemini
> :warning: **IMPORTANTE!** Lembre-se de usar suas chaves de API com segurança. Leia atentamente [Mantenha sua chave de API segura](https://ai.google.dev/gemini-api/docs/api-key#security) e [Melhores práticas para usar chaves de API com segurança](https://support.google.com/googleapi/answer/6310037) 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" na parte superior 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 aplicativo de cofre de senhas. Não compartilhe chaves. Esta é a chave que você precisará inserir nas configurações do 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 da API e selecione "Restringir chave" e, em seguida, escolha "Generative Language API".
Salve sua chave atualizada. Clique no link "Mostrar chave" para sua nova chave e copie-a.
***
## Passo 3: Configurar o Gemini nas Configurações de IA do Discourse
O Discourse AI agora usa um sistema centralizado de **Credenciais** para gerenciar chaves de API. Em vez de colar sua chave diretamente em cada configuração de LLM, você primeiro cria uma credencial e depois a seleciona ao configurar seu modelo Gemini.
### Passo 3a: Criar uma Credencial
Vá para `Admin > Plugins > AI > Credentials` e clique em **Nova Credencial**. Dê um nome descritivo (por exemplo, "Chave de API do Gemini") e cole a chave de API que você copiou do Google Cloud. Salve a credencial.
> :bulb: **Dica**: Você também pode criar uma credencial em linha — ao adicionar um novo LLM na próxima etapa, clique no botão **+** ao lado do seletor de credenciais para criar uma na hora.
### Passo 3b: Adicionar um LLM Gemini
Agora vá para `Admin > Plugins > AI > LLMs`. Clique em **Adicionar** e selecione um dos modelos Gemini pré-configurados (por exemplo, Gemini 3 Flash ou Gemini 3 Pro). O nome do modelo, a URL do endpoint e outras configurações serão pré-preenchidos para você. Use o menu suspenso **Credential** para selecionar a credencial que você criou na etapa anterior e, em seguida, salve.
> :information_source: **Nota**: A mesma credencial pode ser reutilizada em várias configurações de LLM, então você só precisa inserir sua chave de API do Gemini uma vez.
***
## Passo 4: Rastrear 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"
E então selecione seu projeto específico na lista de projetos de faturamento, e ele abrirá o relatório de faturamento onde você pode especificar o(s) projeto(s) 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 anexadas à sua conta do Google Cloud aqui, por exemplo, se você tiver [Google Custom Search API e Mecanismo de Pesquisa Programável](https://meta.discourse.org/t/google-search-for-discourse-ai-programmable-search-engine-and-custom-search-api/307107) configurado).
***
## Links
* [Google Cloud Console](https://cloud.google.com/cloud-console)
* [Documentação da API Gemini](https://ai.google.dev/gemini-api/docs/api-key)
* [Documentação do Discourse AI](https://meta.discourse.org/t/discourse-ai/259214)
* [API de Pesquisa Personalizada do Google para Discourse AI](https://meta.discourse.org/t/google-search-for-discourse-ai-programmable-search-engine-and-custom-search-api/307107)
* [Melhores práticas para usar chaves de API com segurança](https://support.google.com/googleapi/answer/6310037)
* [Como Habilitar o Bot de IA](https://meta.discourse.org/t/enable-ai-bot/266012)
* [Configurar Sumarização do Discourse AI](https://meta.discourse.org/t/discourse-ai-summarization/262711)
* [Preços da IA do Google](https://ai.google.dev/pricing)
5 curtidas
Olá! Boa tarde,
Obrigado pelo tutorial, estou tentando configurá-lo, mas parece que o Google mudou recentemente sua política de segurança e, desde junho, não é mais possível criar chaves da API Gemini, a menos que criemos contas de serviço. Também li que todas as chaves criadas anteriormente deixarão de funcionar a partir de setembro, se não forem migradas para chaves de contas de serviço. Ainda estou tentando entender como proceder, mas parece bem complexo… Há alguma mudança prevista na plataforma Discourse ou funcionará da mesma forma que antes?
Qual chave devemos adicionar no Discourse, a da API ou a da conta de serviço? Alguém já passou por essas atualizações?
Muito obrigado pela ajuda!
Abraços,
Terenui
1 curtida