Começar o ADK a partir da documentação oficial na língua preferida

Para quem serve

Esta competência serve a quem quer um conjunto de ferramentas open source, código primeiro, para construir, avaliar e implantar agentes de IA complexos. O nome oficial é Agent Development Kit（ADK）. Serve também a quem já tem uma língua de programação preferida e vai começar pela entrada oficial de «língua preferida». O texto de origem diz que pode usar o ADK na língua preferida, mas este passo não dá endereços concretos de língua.

Não serve tratar este repositório como um comando de instalação. Aqui está um repositório de documentação. O ADK está otimizado para Gemini e o ecossistema Google, mas escreve-se como independente do modelo e da implantação, e compatível com outros quadros. Se só quiser ler docs primeiro e ainda não quiser implantação em contentor, não comece por Cloud Run ou GKE.

O repositório oficial é https://github.com/google/adk-docs Opere com as notas já escritas. Não invente um instalador nem um endereço de documentação que não apareceram.

Concluir a primeira tentativa em 3 minutos

Siga só este caminho de documentação oficial: primeiro escolha a língua preferida, depois encontre a entrada correspondente nas notas oficiais, em vez de executar um comando de instalação que não apareceu.

Pré-requisito: consegue abrir o repositório de documentação oficial e já tem uma língua que tenciona usar. Na primeira vez não implante nem escreva segredos na conversa.

Local de instalação: abra https://github.com/google/adk-docs Siga «usar o ADK na língua preferida» para achar a entrada oficial. O texto de origem não escreve comandos pip ou npm; não os complete.

Tarefa de baixo risco: faça o agente só ler e resumir três factos — é um kit de ferramentas código primeiro; embora otimizado para Gemini e o ecossistema Google, é independente do modelo e da implantação; e oferece contexto de documentação otimizado compatível com editores de código IA. Não o deixe inventar endereços de ficheiros de docs nem implantar para Cloud Run, GKE ou Agent Runtime.

Sinal de sucesso: consegue apontar que o passo seguinte deve voltar à documentação oficial e começar na sua língua, e não se executou um comando de instalação inventado. Se o agente der um URL ou um nome de pacote que não apareceu, pare.

Casos de uso

Caso 1: começar um agente numa língua que já conhece. O texto de origem diz que se pode usar uma língua preferida. Serve a quem primeiro escolhe uma língua e depois só abre a página de entrada oficial. Se o caminho concreto de língua não aparecer nas notas atuais, pare no confronto do diretório do repositório; não invente um endereço get-started.

Caso 2: dar a um editor de código IA contexto de documentação otimizado. O texto de origem diz que o ADK oferece contexto de documentação otimizado compatível com editores de código IA, para acelerar o desenvolvimento. Serve a quem já usa um editor e só quer confirmar que deve carregar a documentação oficial otimizada, não colar um blog qualquer. Se nomes de ficheiro e endereços não estiverem listados, não os invente.

Limites de uso

Este repositório é documentação, não um instalador. Não escreva um comando de gestor de pacotes que não apareceu no caminho principal. A cobertura é construir, avaliar e implantar. No lado da implantação só escreve que se pode contentorizar e pôr em Cloud Run ou GKE, ou alargar com Agent Runtime. Tudo isso tem efeitos secundários e não pode ser a primeira tentativa.

Está otimizado para Gemini e o ecossistema Google, mas oficialmente também é independente do modelo, da implantação e compatível com outros quadros. Não o escreva como «só Gemini». O contexto de documentação otimizado é compatível com editores de código IA, mas não há lista de clientes. A página oficial é https://github.com/google/adk-docs Se um endereço ou comando que o agente sugerir discrepar dessa página, essa página manda.