API do Firebase: o que dá para fazer e como usar com agentes de IA
O Firebase reúne serviços do Google para apps, com APIs REST e SDKs administrativos para Firestore, Realtime Database, Authentication, Cloud Messaging e Storage. É usado por times de produto e engenharia que constroem apps web e mobile. O acesso administrativo é por conta de serviço do projeto no Google Cloud.
Os grandes recursos da API, em português claro.
Leitura, escrita e consultas em coleções e documentos.
Dados em árvore JSON sincronizados em tempo real.
Gestão de usuários: busca, desativação e redefinição de acesso.
Envio de notificações push a dispositivos e tópicos.
Arquivos enviados pelos usuários do app.
Parâmetros de configuração do app alterados sem nova versão.
Como se acessa a API do Firebase.
- Com credencial da sua empresaConta de serviço do projeto com chave privada ou credenciais padrão do Google Cloud, com papéis do IAM limitados. O acesso de clientes do app segue as regras de segurança do Firebase.
- Documentação oficialfirebase.google.com/docs
- A conta de serviço ignora as regras de segurança do app: restrinja papéis no IAM.
- Leituras e escritas são cobradas por uso; evite varreduras completas frequentes.
- Dados de usuários do app são pessoais (LGPD).
- api firebase
- firebase rest api
- firestore api
- firebase admin sdk
- firebase cloud messaging api
- integração api firebase
- firebase api documentação
O que um agente do iTeam faz com a API do Firebase.
Quando o cliente reclama que não consegue entrar, o agente consulta o usuário no Authentication e o documento de perfil e explica ao suporte o que está acontecendo.
O time de produto descreve a campanha e o agente monta o envio pelo Cloud Messaging para o tópico certo, aguardando aprovação.
O agente verifica documentos do Firestore fora do formato esperado e lista os casos para engenharia.
Com aprovação, o agente altera um parâmetro do Remote Config para desativar uma função com erro.
Da credencial ao agente trabalhando, com aprovação.
Crie uma conta de serviço restrita
No Google Cloud do projeto, crie a conta com papéis mínimos, por exemplo só leitura no Firestore.
Cadastre no cofre do iTeam
A chave fica no cofre e cada agente usa só os serviços liberados.
Teste com aprovação
Escritas, envio de push e mudanças de configuração passam por aprovação humana.
Dúvidas sobre a API do Firebase.
A API do Firebase é gratuita?
Depende do uso: há uma camada gratuita e, acima dela, cobrança por leituras, escritas, armazenamento e outros recursos no plano pago.
Preciso programar para usar a API do Firebase com o iTeam?
Não necessariamente. A ferramenta HTTP do iTeam usa as APIs REST com a documentação, e o time de implantação configura com o seu time técnico.
O agente acessa o banco do meu app em produção?
Só se você liberar. O ideal é começar com leitura e papéis restritos.
Como um agente de IA acessa o Firestore do Firebase com segurança?
Pelo Admin SDK ou pela API REST, usando uma conta de serviço do projeto no Google Cloud com papéis do IAM limitados. Essa conta ignora as regras de segurança do app, então o controle vem das permissões do IAM e do desenho das consultas. Crie uma conta só para o agente, com leitura nas coleções necessárias.
O agente pode ler a base do meu app em produção?
Pode, mas o recomendado é começar com leitura e, de preferência, em um projeto de teste ou em uma réplica. A conta de serviço enxerga tudo o que o papel permitir, inclusive dados de usuários. Restrinja a coleções específicas, evite consultas que varrem tudo e só libere produção depois de validar o que o agente consulta.
O Firebase tem ambiente de teste para validar o agente?
Tem: o Emulator Suite roda localmente Firestore, Realtime Database, Authentication e outros serviços, sem custo e sem tocar na produção. É o lugar certo para testar as consultas e as regras de segurança do agente. Outra opção é um projeto Firebase separado de desenvolvimento, com dados fictícios.
Quanto custa deixar o agente de IA consultando o Firestore?
O Firestore cobra por leitura, escrita e exclusão de documentos, além de armazenamento e tráfego, então varreduras frequentes pesam. O agente deve buscar só o necessário, usar filtros, índices e paginação, e guardar resultados. Confira na página oficial de preços as cotas gratuitas e o plano de pagamento por uso do seu projeto.
Dá para o agente enviar notificações push pelo Firebase Cloud Messaging?
Dá: a API do Cloud Messaging permite enviar mensagens a dispositivos e tópicos, autenticada por token de acesso da conta de serviço. Um agente pode avisar o usuário de um pedido enviado ou de uma pendência. Disparos em massa devem ter aprovação e respeitar o consentimento do usuário para receber comunicações.
O agente deve ter acesso ao Authentication do Firebase?
Só se a tarefa exigir, como consultar se um e-mail está cadastrado para suporte. A API administrativa permite listar, criar e desativar usuários, e esse poder não deve ficar solto. Dê leitura mínima e deixe ações como desativar contas ou redefinir senhas sob aprovação humana, com registro do motivo.
Os dados de usuários do app no Firebase entram na LGPD quando o agente os lê?
Entram: e-mail, telefone, localização e histórico de uso são dados pessoais. O agente deve acessar apenas os campos necessários, e o acesso fica registrado. A conta de serviço é poderosa e exige cuidado. Este texto não é parecer jurídico: defina com o responsável por privacidade a base legal e a retenção.
Quando não vale a pena ligar um agente de IA ao Firebase?
Quando o modelo de dados é um emaranhado de coleções sem documentação, ou quando um painel de consultas fixas já resolve a necessidade. O agente funciona melhor com dados bem descritos. Antes, vale documentar as coleções principais e os campos sensíveis.
