El contexto más barato es el que su agente nunca carga. Google convierte su documentación en una API
Google sirve su documentación oficial a los agentes como fragmentos buscables, respuestas fundamentadas y páginas Markdown. Un patrón que las empresas pueden copiar.
Escuche este artículo · 4 min
Narración completa del artículo, generada con IA.
Una suposición habitual en los agentes de programación: cuanta más documentación le ponga delante al modelo, mejores serán sus respuestas. Pegue la referencia completa de la API, deje que el agente haga scraping de algunas páginas, y la precisión debería llegar sola.
En general, no ocurre así. Un contexto grande y recolectado por scraping es lento, caro y a menudo obsoleto: una publicación de foro de hace dos años le parece a un modelo tan autorizada como la referencia actual. El 7 de octubre, Google describió cómo es la alternativa para sus propias plataformas, y vale la pena leerlo como contraejemplo de esa suposición.
Qué construyó Google en su lugar
La Developer Knowledge API es, en palabras de Google, su fuente de verdad oficial y programática para la documentación de desarrolladores sobre Google Cloud, Firebase, Android y más. Ofrece búsqueda semántica y por palabras clave, recuperación por fragmentos que devuelve pasajes relevantes en lugar de páginas enteras, respuestas a preguntas fundamentadas, y páginas completas en Markdown cuando un agente necesita el texto íntegro. Google dice que el índice se actualiza con frecuencia, de modo que los agentes ven los cambios en la documentación con poco retraso.
El acceso llega a través de gcloud CLI (preinstalada en Cloud Shell), una skill de agente sobre MCP que Google incluye para Antigravity, Claude Code, Cursor y GitHub Copilot, bibliotecas cliente en siete idiomas, y un API Explorer.
El workflow recomendado es la parte interesante: busque primero los fragmentos y traiga páginas Markdown completas solo cuando haga falta. La publicación de Google no indica que la API esté en disponibilidad general ni en vista previa, ni ofrece precios. Las cuotas por defecto documentadas son 100 búsquedas de fragmentos y 100 descargas de documentos por minuto por proyecto, y 50 respuestas fundamentadas por día por proyecto, así que verifique el estado y las condiciones antes de construir pipelines de producción sobre ella.
Poner a prueba la suposición
Más contexto no es más precisión. Unos pocos pasajes relevantes le dan al modelo menos texto irrelevante que atravesar. Escalar a una página completa solo cuando los pasajes se quedan cortos suele mejorar las respuestas y recortar tokens a la vez. Los agentes ya cargan mucho los sistemas de datos, como describimos en nuestro análisis de la ruta de datos de los agentes; el diseño de la recuperación es donde se decide buena parte de esa carga.
La autoridad es una propiedad del camino, no del modelo. Un agente que recupera de la documentación actual del propio proveedor tiene menos probabilidades de usar un parámetro obsoleto que uno que hizo scraping de un foro. Ninguna actualización de modelo arregla una ruta de recuperación que apunta a la fuente equivocada.
Una sola fuente para muchos agentes. Exponer el mismo conocimiento a través de CLI, MCP y bibliotecas hace que cada herramienta de programación de una empresa lea la misma verdad, en lugar de que cada una construya su propio scraper.
El mismo error, dentro de la empresa
Los equipos de plataforma internos tienen el problema que Google acaba de resolver para su propia documentación. Las referencias de API, los runbooks, los estándares de arquitectura y las políticas de seguridad viven en wikis que los agentes scrapean mal, o se pegan enteras en los prompts.
La solución tiene la misma forma. Publique el conocimiento interno como un servicio de recuperación, con búsqueda, fragmentos y documentos completos, expuesto sobre MCP para que cada agente aprobado lo use; esa es la decisión de recuperación gestionada que comentamos en nuestro artículo sobre Compass de Cohere, aplicada al conocimiento interno. Asigne a cada fuente un responsable y una cadencia de actualización, o el agente recuperará una verdad obsoleta con total confianza. Después mida la recuperación por sí sola, si volvió el fragmento correcto, y siga los tokens gastados en contexto por tarea, que suele ser la línea más grande en la factura de un agente de programación.
El contexto más barato es el que su agente nunca tuvo que cargar. El más fiable es el que vino del dueño de la verdad.