Empezar ADK desde la documentación oficial en tu idioma preferido

Para quién es

Esta habilidad encaja con quien quiere un conjunto de herramientas de código abierto, código primero, para construir, evaluar y desplegar agentes de IA complejos. El nombre oficial es Agent Development Kit（ADK）. También encaja con quien ya tiene un idioma de programación preferido y va a empezar por la entrada oficial de «idioma preferido». El texto de origen dice que puedes usar ADK en tu idioma preferido, pero este pasaje no da direcciones concretas de idioma.

No encaja tratar este repositorio como un comando de instalación. Aquí hay un repositorio de documentación. ADK está optimizado para Gemini y el ecosistema Google, pero se escribe como independiente del modelo y del despliegue, y compatible con otros marcos. Si solo quieres leer docs primero y aún no quieres un despliegue en contenedor, no empieces por Cloud Run o GKE.

El repositorio oficial es https://github.com/google/adk-docs Opera con las notas ya escritas. No inventes un instalador ni una dirección de documentación que no aparecieron.

Completar el primer intento en 3 minutos

Sigue solo este camino de documentación oficial: primero elige tu idioma preferido, luego busca la entrada correspondiente en las notas oficiales, en vez de ejecutar un comando de instalación que no apareció.

Requisito: puedes abrir el repositorio de documentación oficial y ya tienes un idioma que piensas usar. La primera vez no despliegues ni escribas secretos en la conversación.

Ubicación de instalación: abre https://github.com/google/adk-docs Sigue «usar ADK en el idioma preferido» para hallar la entrada oficial. El texto de origen no escribe comandos pip o npm; no los completes.

Tarea de bajo riesgo: haz que el agente solo lea y resuma tres hechos — es un kit de herramientas código primero; aunque está optimizado para Gemini y el ecosistema Google, es independiente del modelo y del despliegue; y ofrece contexto de documentación optimizado compatible con editores de código IA. No lo dejes inventar direcciones de archivos de docs ni desplegar a Cloud Run, GKE o Agent Runtime.

Señal de éxito: puedes señalar que el siguiente paso debe volver a la documentación oficial y empezar en tu idioma, y no se ejecutó un comando de instalación inventado. Si el agente da una URL o un nombre de paquete que no apareció, detente.

Casos de uso

Caso 1: empezar un agente en un idioma que ya conoces. El texto de origen dice que se puede usar un idioma preferido. Encaja con quien primero elige un idioma y luego solo abre la página de entrada oficial. Si la ruta concreta de idioma no aparece en las notas actuales, detente en contrastar el directorio del repositorio; no inventes una dirección get-started.

Caso 2: dar a un editor de código IA contexto de documentación optimizado. El texto de origen dice que ADK ofrece contexto de documentación optimizado compatible con editores de código IA, para acelerar el desarrollo. Encaja con quien ya usa un editor y solo quiere confirmar que debe cargar la documentación oficial optimizada, no pegar un blog cualquiera. Si nombres de archivo y direcciones no están listados, no los inventes.

Límites de uso

Este repositorio es documentación, no un instalador. No escribas un comando de gestor de paquetes que no apareció en el camino principal. La cobertura es construir, evaluar y desplegar. En despliegue solo escribe que se puede contenerizar y poner en Cloud Run o GKE, o ampliar con Agent Runtime. Todo eso tiene efectos secundarios y no puede ser el primer intento.

Está optimizado para Gemini y el ecosistema Google, pero oficialmente también es independiente del modelo, del despliegue y compatible con otros marcos. No lo escribas como «solo Gemini». El contexto de documentación optimizado es compatible con editores de código IA, pero no hay lista de clientes. La página oficial es https://github.com/google/adk-docs Si una dirección o comando que sugiere el agente discrepa de esa página, esa página manda.