Configurar o Gemini no Firebase nos espaços de trabalho

O Firebase Studio facilita seus fluxos de trabalho de desenvolvimento com os seguintes recursos de código com assistência de IA:

  • Preenchimento de código sugerido enquanto você digita.

  • Assistência de IA com chat, que é compatível com o espaço de trabalho e totalmente integrada ao seu código. Ele pode gerar, traduzir e explicar o código. Com sua revisão e aprovação, o Gemini no Firebase pode interagir diretamente com seu espaço de trabalho para atualizar arquivos, executar comandos de terminal, interpretar a saída de comandos e determinar as próximas etapas. Saiba mais em Teste o chat com Gemini.

  • Ações inline que podem ser realizadas em partes selecionadas do código. Por exemplo, você pode pedir a Gemini para tornar o código selecionado mais legível.

  • Assistência de código inline.

É possível personalizar a forma como o Gemini no Firebase ajuda você ajustando as configurações e adicionando arquivos de regras de IA:

Usar o Gemini no Firebase no seu espaço de trabalho

Use o Gemini no Firebase para aumentar a produtividade de programação com a ajuda do painel de chat ou do código inline.

  1. Use a assistência de código inline ou de chat no seu espaço de trabalho:

    • Para usar o chat: no espaço de trabalho aberto, clique em spark Gemini na parte de baixo do espaço de trabalho.

    • Para usar a assistência de código inline: comece a digitar o código e pressione Tab para aceitar as sugestões.

  2. As duas opções a seguir são ativadas por padrão:

    • Sugestões enquanto você digita, que oferece preenchimento de código inline.
    • Indexação de base de código, que oferece personalização melhor e respostas mais úteis.

    Para mudar essas seleções nas configurações do espaço de trabalho no futuro, faça o seguinte:

    Também é possível excluir arquivos e diretórios específicos da indexação de IA. Consulte Excluir arquivos de Gemini com arquivos .aiexclude.

Gemini nos atalhos do Firebase

Para abrir rapidamente o chat com Gemini, pressione Ctrl+Shift+Space (ou Cmd+Shift+Space no macOS).

Para conferir os comandos Gemini na paleta de comandos:

  1. Abra a paleta de comandos pressionando Ctrl+Shift+P (ou Cmd+Shift+P no MacOS).

  2. Pesquise Gemini.

    Uma lista de comandos Gemini vai aparecer.

Ajustar as configurações de conclusão de código

Para ajudar você a escrever código, o Firebase Studio oferece preenchimento automático de código de IA que prevê e preenche automaticamente o código em qualquer arquivo aberto assim que você começa a digitar.

A preenchimento de código está ativado por padrão.

Para ativar ou desativar a conclusão de código, ajuste as configurações usando um destes métodos:

  • Se você usar um arquivo settings.json, defina "IDX.aI.enableInlineCompletion" como true ou false.

  • Para atualizar as configurações no espaço de trabalho Firebase Studio:

    1. Clique em Ícone de engrenagem Gerenciar (no canto inferior esquerdo do espaço de trabalho) e escolha Configurações ou pressione Ctrl+, (Cmd+, no Mac).

      Se você estiver usando o App Prototyping agent em Prototyper view, click Code switch icon Switch to Code to open Code view.

    2. Selecione a guia Espaço de trabalho e procure a configuração Firebase Studio > IA > Ativar a conclusão inline.

    3. Para desativar a conclusão de código, desmarque a opção Ativar a conclusão de código inline enquanto você digita.

Ajustar as configurações de indexação da base de código

Você pode controlar se o Gemini indexa seu código. A indexação do código oferece resultados mais úteis ao usar o chat ou a assistência de IA inline.

A indexação do repositório de código está ativada por padrão.

Para ativar ou desativar a indexação de código, ajuste as configurações de indexação da base de código usando um dos seguintes métodos:

  • Se você usar um arquivo settings.json, defina "IDX.aI.enableCodebaseIndexing" como true ou false.

  • Para atualizar as configurações no espaço de trabalho Firebase Studio:

    1. Clique em Ícone de engrenagem Gerenciar (no canto inferior esquerdo do espaço de trabalho) e escolha Configurações ou pressione Ctrl+, (Cmd+, no Mac).

      Se você estiver usando o App Prototyping agent em Prototyper view, click Code switch icon Switch to Code to open Code view.

    2. Selecione a guia Espaço de trabalho e procure a configuração Firebase Studio > IA > Ativar preenchimento inline.

    3. Selecione Firebase Studio > AI: Ativar a indexação de códigos.

    4. Para desativar a indexação de código, desmarque AI: Ativar a indexação da base de código. É necessário atualizar as configurações de indexação de código para cada um dos seus espaços de trabalho.

Personalizar instruções para o Gemini no Firebase com um arquivo de regras de IA

É possível adicionar informações de contexto e comando do sistema criando um arquivo de regras de IA (.idx/airules.md). O Gemini no Firebase usa suas regras como instruções e contexto do sistema, garantindo que as respostas sejam personalizadas para seu caso de uso.

Use o arquivo de regras de IA para compartilhar solicitações personalizadas, práticas recomendadas e até contexto importante sobre seu projeto com Gemini para alcançar metas como:

  • Influenciar a persona de Gemini e especializar o conhecimento dela.
  • Aplicar padrões em todo o projeto, como estilo de programação, convenções e preferências de tecnologia.
  • Reduzir a quantidade de informações que você precisa compartilhar explicitamente no código ou no chat fornecendo o contexto essencial sobre seu projeto.

As regras configuradas são usadas pelo Gemini no chat.

Criar e testar o arquivo de regras de IA

Para criar e testar o arquivo de regras de IA:

  1. Crie um novo arquivo em .idx/airules.md no espaço de trabalho Firebase Studio (no mesmo diretório do arquivo dev.nix). Você pode usar uma das seguintes opções:

    • No Explorer (Ctrl+Shift+E), clique com o botão direito do mouse em .idx e selecione Novo arquivo. Nomeie o arquivo como airules.md e pressione Enter.
    • No terminal, use seu editor de texto preferido para abrir .idx/airules.md.

  2. Adicione conteúdo ao arquivo. Você pode adicionar informações sobre o perfil Gemini (como "Você é um desenvolvedor experiente e um assistente útil que sabe tudo sobre o Next.js"), padrões de programação e conversa e contexto sobre o projeto. Confira o exemplo abaixo para ver um exemplo de arquivo de regras de IA.

  3. Salve o arquivo e abra o Gemini em Firebase.

  4. Para começar a usar as regras de IA, siga um destes procedimentos:

    • Atualize a página para recriar o espaço de trabalho. Depois da recriação, o Gemini no Firebase vai usar o arquivo de regras no chat. As mudanças no arquivo de regras de IA devem ser refletidas no chat imediatamente.
    • Se você não quiser recriar seu espaço de trabalho, peça para Gemini usar o chat para load airules.md. Se você fizer alterações no arquivo durante a sessão atual, talvez seja necessário solicitar novamente Gemini para carregar o arquivo de regras.

  5. Faça perguntas sobre seu código. O Gemini responde usando as informações que você incluiu no arquivo de regras como contexto.

Exemplo

Confira a seguir um exemplo básico de um arquivo de regras que pode ser usado para um jogo casual desenvolvido com o Next.js:

# Persona

You are an expert developer proficient in both front- and back-end development
with a deep understanding of Node.js, Next.js, React, and Tailwind CSS. You
create clear, concise, documented, and readable TypeScript code.

You are very experienced with Google Cloud and Firebase services and how
you might integrate them effectively.

# Coding-specific guidelines

- Prefer TypeScript and its conventions.
- Ensure code is accessible (for example, alt tags in HTML).
- You are an excellent troubleshooter. When analyzing errors, consider them
  thoroughly and in context of the code they affect.
- Do not add boilerplate or placeholder code. If valid code requires more
  information from the user, ask for it before proceeding.
- After adding dependencies, run `npm i` to install them.
- Enforce browser compatibility. Do not use frameworks/code that are not
  supported by the following browsers: Chrome, Safari, Firefox.
- When creating user documentation (README files, user guides), adhere to the
  Google developer documentation style guide
  (https://developers.google.com/style).

# Overall guidelines

- Assume that the user is a junior developer.
- Always think through problems step-by-step.

# Project context

- This product is a web-based strategy game with a marine life theme.
- Intended audience: casual game players between the ages of 17 and 100.

Excluir arquivos de Gemini com arquivos .aiexclude

É possível controlar quais arquivos da base de código precisam ser mantidos ocultos do Gemini incluindo arquivos .aiexclude no projeto. Isso permite controlar de forma granular o contexto do projeto que você compartilha com Gemini.

Assim como um arquivo .gitignore, um arquivo .aiexclude rastreia arquivos que não devem ser compartilhados com Gemini, incluindo a experiência de chat e os recursos de IA que operam no editor. Um arquivo .aiexclude opera em arquivos no diretório que o contém ou abaixo dele.

Os arquivos cobertos por .aiexclude não serão indexados por Gemini quando a indexação de base de código estiver ativada. Além disso, .aiexclude vai afetar a assistência inline para arquivos cobertos das seguintes maneiras:

  • Assistência por chat: o Gemini não vai conseguir responder perguntas nem oferecer sugestões sobre arquivos cobertos por .aiexclude.
  • Preenchimento automático de código: as sugestões de preenchimento automático de código não estarão disponíveis ao editar arquivos cobertos.
  • Assistência inline: você poderá gerar um novo código, mas não modificar o código existente ao editar arquivos cobertos.

Outros ambientes de desenvolvimento, como o Android Studio, também podem aceitar arquivos .aiexclude.

Como gravar arquivos .aiexclude

Um arquivo .aiexclude segue a mesma sintaxe de um arquivo .gitignore, com as seguintes diferenças:

  • Um arquivo .aiexclude vazio bloqueia todos os arquivos no diretório e em todos os subdiretórios. Isso é o mesmo que um arquivo que contém **/*.
  • Os arquivos .aiexclude não aceitam a negação (prefixo de padrões com !).

Exemplos

Confira alguns exemplos de configurações de arquivos .aiexclude:

  • Bloqueie todos os arquivos com o nome apikeys.txt no diretório ou abaixo dele que contenha o arquivo .aiexclude:

    apikeys.txt

  • Bloqueie todos os arquivos com a extensão .key no diretório ou abaixo dele que contém o arquivo .aiexclude:

    *.key

  • Bloqueie apenas o arquivo apikeys.txt no mesmo diretório que o .aiexclude, mas não os subdiretórios:

    /apikeys.txt

  • Bloqueie todos os arquivos no diretório my/sensitive/dir e todos os subdiretórios. O caminho precisa ser relativo ao diretório que contém o arquivo .aiexclude:

    my/sensitive/dir/

Traga sua própria chave: use outros modelos Gemini no chat

É possível configurar o modelo Gemini usado pelo Gemini no chat Firebase. Você pode escolher o modelo integrado, os modelos configurados na janela de chat (incluindo os modelos Gemini 2.5) ou qualquer modelo Gemini a que você tenha acesso.

Para conferir uma lista de todos os modelos disponíveis, consulte Modelos Gemini.

Para configurar a chave e selecionar um modelo Gemini diferente:

  1. No espaço de trabalho aberto, clique em spark Gemini na parte de baixo do espaço de trabalho ou na guia Gemini.

  2. Na janela de chat do Gemini em Firebase, clique no menu suspenso do nome do modelo e, em seguida, no link chave Gemini API. A página Configurações do usuário aparece.

  3. No campo IDX > AI: Gemini Api Key, digite a chave Gemini API.

Agora é possível selecionar qualquer um dos modelos Gemini pré-configurados no chat.

Para configurar um modelo Gemini que não está no menu suspenso:

  1. Identifique o modelo Gemini que você quer usar no chat na lista em Modelos Gemini. Por exemplo, você digitaria gemini-2.0-flash-lite para usar o modelo Gemini 2.0 Flash‑Lite mais recente.

  2. Na janela de chat do Gemini em Firebase, clique no seletor de modelo e escolha ID do modelo personalizado. As Configurações do usuário são abertas.

  3. Copie o nome do modelo selecionado no campo IDX > AI: Gemini Model.

  4. Feche a janela de chat e abra novamente clicando em spark Gemini na parte de baixo do espaço de trabalho para atualizar a lista de modelos.

Próximas etapas