Escreva chamadas Gemini API com gemini-api-dev segundo as boas práticas

Para quem

Use esta biblioteca de skills quando quiser que um agente escreva código de chamada para Gemini API, SDKs e interações de modelo. A fonte descreve-a como biblioteca de skills para Gemini API, SDK e interações de modelo, e nomeia à parte gemini-api-dev: desenvolvimento de aplicações contra a Interactions API, cobrindo geração de texto, diálogo em vários turnos, saída em fluxo, chamadas de funções, saída estruturada, geração de imagens, Deep Research agents, barreiras para modelos descontinuados, e os SDK Python e TypeScript. Documentação:

https://ai.google.dev/gemini-api/docs/interactions?ua=chat

Repositório oficial:

https://github.com/google-gemini/gemini-skills

A fonte escreve que pode instalar estas skills nos assistentes de programação IA e gestores de pacotes que já usa, mas não nomeia produtos concretos. Não invente uma lista de clientes nem o escreva como exclusivo de uns poucos ambientes. Sem intenção de executar o comando npx oficial nesta máquina, não continue ainda.

A fonte também escreve: isto não é um produto Google com suporte oficial e não pode participar no Google Open Source Software Vulnerability Reward Program. Os números de avaliação só mostram que, depois de instalar a skill, a proporção em que o agente gera código API correto muda. Não trate isso como critério de sucesso de uma chamada nesta máquina. Não infira que a skill só se usa nos dois modelos mencionados na avaliação. A biblioteca pode ter outras skills, mas a fonte só escreve gemini-api-dev como exemplo de instalação copiável. Na primeira vez, não nomeie skills que nunca apareceram.

Conclua a primeira tentativa em 3 minutos

Abra primeiro o repositório oficial e verifique:

https://github.com/google-gemini/gemini-skills

O caminho recomendado é o npx skills add oficial. Na primeira vez, só percorra; não instale primeiro um monte de skills. O percurso é interativo; antes de executar, confirme que só está a ver a lista:

npx skills add google-gemini/gemini-skills --list

Depois de ver a lista, o exemplo concreto da fonte é gemini-api-dev. A instalação escreve ficheiros de skill nesta máquina; antes de executar, confirme que só quer esta:

npx skills add google-gemini/gemini-skills --skill gemini-api-dev

Não mude para um nome de skill que nunca apareceu nem invente um segundo instalador. A fonte não escreve um diretório de aterragem; não invente um caminho.

Na primeira vez no agente, só verifique; não chame ainda uma API real, nem gere imagens nem inicie Deep Research. Peça ao agente que diga que capacidades da Interactions API o gemini-api-dev cobre, e que isto não é um produto Google com suporte oficial. O ponto de observação: consegue recitar geração de texto, diálogo em vários turnos, saída em fluxo, chamadas de funções, saída estruturada, e os SDK Python e TypeScript, e ainda não saiu para a rede.

Escrever código de chamada real sai para a rede e pode consumir quota. Continue só quando estiver pronto a usar as suas próprias credenciais Gemini; a fonte não dá um nome de campo de chave, por isso não escreva uma chave de preenchimento. Na primeira vez, não toque em geração de imagens nem em Deep Research.

Casos de uso

Caso 1: Percorra primeiro e depois instale uma skill. Execute npx skills add google-gemini/gemini-skills --list, confirme que vê skills na lista e depois instale gemini-api-dev. Serve a quem só quer ligar a skill Interactions API a um agente e ainda não está pronto a enviar pedidos. Sinal de sucesso: list consegue abrir e o comando de instalação da skill nomeada termina normalmente. A fonte não escreve os campos completos de list; não invente outros nomes --skill.

Caso 2: Primeiro verifique o alcance da cablagem e depois decida se escreve código. Depois de instalar gemini-api-dev, faça o agente recitar que cobre geração de texto, diálogo em vários turnos, saída em fluxo, chamadas de funções, saída estruturada, geração de imagens, Deep Research agents, barreiras para modelos descontinuados, e os SDK Python e TypeScript. Serve a quem receia que o agente saia logo para a rede ou gere imagens. Sinal de sucesso: consegue dizer o alcance com clareza e admitir que isto não é um produto com suporte oficial. Quando precisar de uma chamada real, confirme primeiro que esta execução vai aceder à Gemini API e prepare você as credenciais; a fonte não dá parâmetros de exemplo de pedido, não os invente. Não trate os números de Gemini 3 Flash e Gemini 3.1 Pro na avaliação como um referencial que tenha de reproduzir.

Limites de uso

O caminho principal é npx skills add google-gemini/gemini-skills, percurso com --list, skill de exemplo --skill gemini-api-dev. Não invente outros nomes de skill nem instaladores. A fonte diz que se pode instalar em assistentes de programação IA e gestores de pacotes habituais, mas não nomeia produtos; não acrescente uma lista de nomes nem o escreva como alcance exclusivo.

Isto não é um produto Google com suporte oficial. Notas do programa de recompensa por vulnerabilidades:

https://bughunters.google.com/open-source-security

A capacidade pára nos pontos da Interactions API acima e nos dois SDK. Geração de imagens e Deep Research têm efeitos secundários externos; não os faça na primeira vez. A fonte não escreve campos de chave, quota nem passos de desinstalação. Não complete nomes de modelo, nomes de cliente nem parâmetros de pedido não escritos. O sucesso da primeira vez é só o comando de percurso ou a instalação acabada, mais o agente a recitar o alcance; antes de sair para a rede tem de confirmar credenciais e que esta execução vai aceder à API. A fonte não escreve comandos de desinstalação ou atualização; não invente um segundo instalador. Se o agente começar a gerar imagens ou a lançar Deep Research, pare primeiro e volte à explicação só de leitura. As percentagens de avaliação não substituem o seu próprio sinal de sucesso de uma vez.