Búsqueda en el código
La búsqueda en el código es cómo el agente de Ingot encuentra el código correcto en un proyecto de cualquier tamaño antes de leer o cambiar nada. Ordena el código por significado, por declaraciones, por texto exacto y por nombres de archivo, mantiene el resultado dentro de un presupuesto de tokens y te muestra qué archivos y líneas usó. Funciona igual en un solo paquete, en un monorepo, en una app de React Native sin carpeta src, en una app de Flutter que guarda su código en lib/ o en un backend de Python junto a un cliente móvil.
Pregunta con @codebase
Escribe @codebase en cualquier parte de un mensaje del chat:
@codebase ¿dónde renovamos el token de sesión después de un 401?
Antes de que el agente empiece, Ingot busca tu mensaje en el índice y le añade los fragmentos que mejor encajan. Las etiquetas bajo tu mensaje nombran cada archivo y rango de líneas añadido, así ves exactamente qué recibió el agente. Haz clic en una etiqueta para abrir el archivo en esas líneas. Una búsqueda por mensaje: las rondas siguientes de la misma ejecución la reutilizan.
El agente también puede buscar por su cuenta con la herramienta codebase_search, por ejemplo cuando una tarea dice "arregla el redondeo de precios" sin nombrar un archivo.
Qué combina una búsqueda
| Fuente | Encuentra | Ejemplo |
|---|---|---|
| Significado (vectores) | código que hace lo que describes, aunque use otras palabras | "dónde se redondean los precios" → roundPrice |
| Texto exacto (BM25) | archivos que más usan las palabras de tu pregunta, con más peso para las palabras raras | "invoice total amount" |
| Declaraciones | funciones, clases, métodos y tipos con un nombre como la consulta, en TypeScript/JavaScript, Python, Go, Java, Rust, PHP y Ruby | CartService.total |
| Identificadores exactos | líneas que contienen un nombre de la pregunta (ripgrep) | refreshToken |
| Nombres de archivo | archivos cuya ruta coincide | billing/invoice.ts |
| Archivos abiertos | los archivos que tienes abiertos o acabas de editar, cuando encajan con la pregunta |
Cada fuente ordena por su cuenta y las listas se combinan, así que un archivo encontrado por varias fuentes sube al principio. Cada resultado dice qué fuentes lo encontraron y a qué declaración pertenece:
1. auth/session.ts:12-30 (score 0.91, refreshSession, symbol+semantic+lexical)
Sin embeddings
Cuando el proveedor de embeddings falla (sin red, cuota agotada, proveedor caído), la búsqueda sigue funcionando con texto exacto, declaraciones, identificadores y nombres de archivo. La barra de estado muestra Index ready (text only) y el motivo en su descripción; los resultados dicen "embeddings unavailable". Los vectores que faltan se calculan en una pasada posterior, cuando el proveedor vuelve a responder. En nuestro proyecto de prueba el archivo correcto siguió entre los 5 primeros en todas las preguntas sin ningún embedding.
Embeddings
| Proveedor | Adónde va el código | Coste |
|---|---|---|
local (predeterminado) | se queda en tu ordenador | gratis |
ollama | tu servidor local de Ollama | gratis |
gateway | la pasarela de modelos de Ingot si has iniciado sesión (usa la IA de tu plan); si no, OpenAI con tu propia clave de Ajustes › Modelos | por token |
Con gateway, fragmentos de tu código se envían al proveedor para calcular los embeddings. Los embeddings se guardan en caché por contenido, así que solo se vuelve a calcular el código nuevo o cambiado, y volver a una rama anterior no cuesta nada.
Mapa del proyecto
Al empezar cada tarea, el agente recibe también un mapa breve del proyecto: lenguajes, frameworks, los paquetes del proyecto, puntos de entrada, comandos de build y de tests, y los archivos más importados. Los paquetes salen de los manifiestos a cualquier profundidad (package.json, pyproject.toml, go.mod, Cargo.toml, pubspec.yaml, Gradle, Podfile, .csproj), así que un monorepo lista cada app y biblioteca con su framework. Consulta Mapa del proyecto.
Encontrar una declaración
La herramienta find_symbol del agente consulta a la vez los servidores de lenguaje, la tabla de declaraciones del índice y una búsqueda de texto, así que responde rápido incluso en lenguajes sin servidor de lenguaje activo (Herramientas de código del agente).
Qué se indexa
El índice sigue las reglas de tu propio proyecto, sea cual sea su estructura:
- cada
.gitignorey.ingot/ignore(y los archivos de ignorados de editores existentes) se aplica a su carpeta y a lo que hay debajo (también los anidados de un monorepo); - las carpetas de dependencias y de caché se omiten en todas partes (
node_modules,.venv,Pods,.gradle,vendor,dist, ...); - una carpeta con nombre de salida de build (
lib,build,out,target,obj,bin) solo se omite cuando un manifiesto a su lado dice que es salida (unoutDirde tsconfig, Cargo, Gradle, Xcode, Flutter, .NET). Si no, es código fuente: Flutter y Ruby guardan su código enlib/; - los secretos (
.env*, claves), los binarios y los archivos minificados nunca se indexan.
Hasta 50.000 archivos de forma predeterminada (ajuste abajo). En un proyecto de 50.000 archivos, el primer índice tardó unos 1,5 minutos en una máquina de 2 núcleos ocupada y ocupó 51 MB en disco; los cambios posteriores se recogen en mucho menos de un segundo.
Ajustes
| Ajuste | Predeterminado | Efecto |
|---|---|---|
ingot.index.enabled | true | construir y usar el índice |
ingot.index.hybridSearch | true | combinar todas las fuentes; desactivado: solo vectores |
ingot.chat.codebaseMention | true | @codebase en un mensaje le añade código |
ingot.chat.codebaseMention.tokenBudget | 3000 | máximo de tokens que añade @codebase (la mejor coincidencia siempre cabe) |
ingot.index.maxFiles | 50000 | máximo de archivos que lee el índice |
ingot.index.embeddingProvider | local | local, ollama o gateway |
ingot.index.ollamaModel | nomic-embed-text | el modelo de Ollama cuando el proveedor es ollama |
ingot.agent.repoMap.enabled | true | dar al agente el mapa del proyecto |
Están en Ajustes › Herramientas del agente › Codebase search, y la búsqueda en el código se puede activar o desactivar en Ajustes › Funciones.
Límites
@codebaselee el mensaje en el que está; no vuelve a buscar en las rondas siguientes de la misma ejecución.- El embedder local compara palabras, no el significado en otros idiomas; usa
ollamaogatewaypara eso. - Los archivos muy grandes (más de 256 KB) y los que tienen líneas muy largas se dejan fuera.