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 assistido por IA:

  • Sugestão de preenchimento de código enquanto você digita.

  • Assistência de IA por conversa, que é baseada no espaço de trabalho e totalmente integrada ao seu código. Ela 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 resposta ao comando e definir as próximas etapas. Saiba mais em Testar conversa com o Gemini.

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

  • Assistência de código inline.

É possível ajustar as configurações dele e adicionar arquivos de regras de IA para personalizar o modo como o Gemini no Firebase ajudará você:

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 da conversa ou do código inline.

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

    • Para usar a conversa: no espaço de trabalho aberto, clique em spark Gemini na parte inferior 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 ao digitar, que fornece preenchimento de código inline.
    • Indexação da base de código, que fornece melhor personalização e respostas mais úteis.

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

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

Atalhos do Gemini no Firebase

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

Para ver os comandos do 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 do Gemini será exibida.

Ajustar as configurações de preenchimento de código

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

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

Para ativar ou desativar o preenchimento 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 do Firebase Studio:

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

      Se você usa o App Prototyping agent na 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 sugestão inline.

    3. Para desativar o preenchimento de código, desmarque a opção Ativar preenchimento de código inline ao digitar.

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

É possível controlar se o Gemini indexa seu código. A indexação do código fornece resultados mais úteis ao usar a assistência de IA inline ou por conversa.

A indexação da base 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 do Firebase Studio:

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

      Se você usa o App Prototyping agent na 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 sugestão inline.

    3. Selecione Firebase Studio > AI: ativar indexação da base de código.

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

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

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

Use o arquivo de regras de IA para compartilhar comandos, práticas recomendadas e até contextos importantes personalizados sobre seu projeto com o Gemini para alcançar metas como:

  • Influenciar a persona do 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 na conversa fornecendo o contexto essencial sobre o projeto.

As regras configuradas são usadas pelo Gemini na conversa.

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 do Firebase Studio (no mesmo diretório do arquivo dev.nix). É possível usar uma das seguintes opções:

    • No Explorador (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 o editor de texto de usa preferência para abrir o .idx/airules.md.

  2. Adicione conteúdo ao arquivo. É possível adicionar informações sobre a persona que o Gemini usará (como "Você é um desenvolvedor experiente e um assistente útil que sabe tudo sobre o Next.js"), os padrões de programação e conversa e o contexto do projeto. Confira a seguir um exemplo de arquivo de regras de IA.

  3. Salve o arquivo e abra o Gemini no 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. Após a recriação, o Gemini no Firebase usará o arquivo de regras na conversa. As mudanças no arquivo de regras de IA serão refletidas na conversa imediatamente.
    • Se você não quiser recriar o espaço de trabalho, use a conversa para pedir ao Gemini que realize esta ação: load airules.md. Se você fizer alterações no arquivo durante a sessão atual, talvez seja necessário pedir novamente para o Gemini carregar o arquivo de regras.

  5. Faça perguntas sobre o código. Para responder, o Gemini usa 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 do Gemini com arquivos .aiexclude

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

Assim como um arquivo .gitignore, um arquivo .aiexclude rastreia arquivos que não serão compartilhados com o Gemini, incluindo a experiência de conversa 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 pelo Gemini quando a indexação da base de código estiver ativada. Além disso, .aiexclude afetará a assistência inline para arquivos cobertos das seguintes maneiras:

  • Assistência por conversa: o Gemini não conseguirá responder perguntas nem dar sugestões sobre arquivos cobertos por .aiexclude.
  • Preenchimento de código: as sugestões do preenchimento 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 respeitar arquivos .aiexclude.

Como escrever 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 respectivo diretório e em todos os subdiretórios. Ele é igual a um arquivo que contém **/*.
  • Arquivos .aiexclude não aceitam negação (padrões de prefixo com !).

Exemplos

Confira alguns exemplos de configurações de arquivo .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 de arquivo .key no diretório ou abaixo dele que contém o arquivo .aiexclude:

    *.key

  • Bloqueie apenas o arquivo apikeys.txt no mesmo diretório de .aiexclude, mas não 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 do Gemini na conversa

É possível configurar o modelo do Gemini usado pela conversa do Gemini no Firebase. É possível escolher o modelo integrado, os modelos configurados na janela da conversa (incluindo os modelos do Gemini 2.5) ou qualquer modelo do Gemini a que você tem acesso.

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

Para configurar sua chave e selecionar um modelo diferente do Gemini:

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

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

  3. No campo IDX > AI: chave da API Gemini, digite sua chave da Gemini API.

Agora é possível selecionar qualquer um dos modelos pré-configurados do Gemini na conversa.

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

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

  2. Na janela da conversa do Gemini no Firebase, clique no seletor de modelo e selecione ID do modelo personalizado. As Configurações do usuário abrem.

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

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

Próximas etapas