חיפוש בקוד
חיפוש בקוד הוא הדרך שבה הסוכן של Ingot מוצא את הקוד הנכון בפרויקט בכל גודל, לפני שהוא קורא או משנה משהו. הוא מדרג קוד לפי משמעות, לפי הצהרות, לפי טקסט מדויק ולפי שמות קבצים, שומר על התוצאה בתוך תקציב טוקנים, ומראה לך באילו קבצים ושורות השתמש. הוא עובד אותו דבר בחבילה אחת, ב-monorepo, באפליקציית React Native בלי תיקיית src, באפליקציית Flutter ששומרת את הקוד ב-lib/, או בשרת Python לצד לקוח מובייל.
לשאול עם @codebase
כתבו @codebase בכל מקום בהודעה בצ'אט:
@codebase איפה אנחנו מחדשים את טוקן הסשן אחרי 401?
לפני שהסוכן מתחיל, Ingot מחפש את ההודעה שלכם באינדקס ומוסיף לה את הקטעים המתאימים ביותר. תגיות מתחת להודעה מציינות כל קובץ וטווח שורות שנוסף, כך שאפשר לראות בדיוק מה הסוכן קיבל. לחיצה על תגית פותחת את הקובץ בשורות האלה. חיפוש אחד לכל הודעה: הסבבים הבאים של אותה ריצה משתמשים בו שוב.
הסוכן יכול גם לחפש בעצמו עם הכלי codebase_search, למשל כשמשימה אומרת "תקן את עיגול המחירים" בלי לציין קובץ.
מה חיפוש משלב
| מקור | מוצא | דוגמה |
|---|---|---|
| משמעות (וקטורים) | קוד שעושה את מה שתיארתם, גם במילים אחרות | "איפה מעגלים מחירים" → roundPrice |
| טקסט מדויק (BM25) | קבצים שמשתמשים הכי הרבה במילים של השאלה, עם משקל גבוה יותר למילים נדירות | "invoice total amount" |
| הצהרות | פונקציות, מחלקות, מתודות וטיפוסים בשם שמתאים לשאילתה, ב-TypeScript/JavaScript, Python, Go, Java, Rust, PHP ו-Ruby | CartService.total |
| מזהים מדויקים | שורות שמכילות שם מהשאלה (ripgrep) | refreshToken |
| שמות קבצים | קבצים שהנתיב שלהם מתאים | billing/invoice.ts |
| קבצים פתוחים | הקבצים שפתוחים אצלכם או שנערכו עכשיו, כשהם מתאימים לשאלה |
כל מקור מדרג בעצמו והרשימות מתמזגות, כך שקובץ שנמצא בכמה מקורות עולה לראש. כל תוצאה מציינת אילו מקורות מצאו אותה ולאיזו הצהרה היא שייכת:
1. auth/session.ts:12-30 (score 0.91, refreshSession, symbol+semantic+lexical)
בלי embeddings
כשספק ה-embeddings נכשל (אין רשת, נגמרה המכסה, הספק לא זמין), החיפוש ממשיך לעבוד עם טקסט מדויק, הצהרות, מזהים ושמות קבצים. שורת המצב מציגה Index ready (text only) ואת הסיבה בתיאור שלה; התוצאות אומרות "embeddings unavailable". הווקטורים החסרים מחושבים במעבר מאוחר יותר, כשהספק עונה שוב. בפרויקט הבדיקה שלנו הקובץ הנכון נשאר בחמשת הראשונים בכל השאלות גם בלי embeddings בכלל.
Embeddings
| ספק | לאן הקוד הולך | עלות |
|---|---|---|
local (ברירת מחדל) | נשאר במחשב שלכם | חינם |
ollama | שרת Ollama המקומי שלכם | חינם |
gateway | שער המודלים של Ingot כשאתם מחוברים (משתמש ב-AI של התוכנית שלכם), אחרת OpenAI עם המפתח שלכם מהגדרות › מודלים | לפי טוקן |
עם gateway, קטעים מהקוד שלכם נשלחים לספק כדי לחשב embeddings. ה-embeddings נשמרים במטמון לפי התוכן, כך שרק קוד חדש או ששונה מחושב שוב, וחזרה לענף קודם לא עולה כלום.
מפת הפרויקט
בתחילת כל משימה הסוכן מקבל גם מפה קצרה של הפרויקט: שפות, frameworks, החבילות של הפרויקט, נקודות כניסה, פקודות build ובדיקות, והקבצים שמיובאים הכי הרבה. החבילות נלקחות מקובצי manifest בכל עומק (package.json, pyproject.toml, go.mod, Cargo.toml, pubspec.yaml, Gradle, Podfile, .csproj), כך ש-monorepo מציג כל אפליקציה וספרייה עם ה-framework שלה. ראו מפת הפרויקט.
מציאת הצהרה
הכלי find_symbol של הסוכן שואל בבת אחת את שרתי השפה, את טבלת ההצהרות של האינדקס וחיפוש טקסט, כך שהוא עונה מהר גם בשפות בלי שרת שפה פעיל (כלי הקוד של הסוכן).
מה נכנס לאינדקס
האינדקס הולך לפי הכללים של הפרויקט שלכם, בכל מבנה:
- כל
.gitignoreו-.ingot/ignore(וקובצי התעלמות של עורכים קיימים) חל על התיקייה שלו ועל מה שמתחתיה (גם קבצים מקוננים ב-monorepo); - תיקיות של תלויות ומטמון מדולגות בכל מקום (
node_modules,.venv,Pods,.gradle,vendor,dist, ...); - תיקייה בשם של פלט build (
lib,build,out,target,obj,bin) מדולגת רק כש-manifest לידה אומר שהיא פלט (outDirשל tsconfig, Cargo, Gradle, Xcode, Flutter, .NET). אחרת היא קוד מקור: Flutter ו-Ruby שומרות את הקוד ב-lib/; - סודות (
.env*, מפתחות), קבצים בינאריים וקבצים מכווצים לא נכנסים לאינדקס לעולם.
עד 50,000 קבצים כברירת מחדל (הגדרה בהמשך). בפרויקט של 50,000 קבצים האינדקס הראשון לקח כדקה וחצי במחשב עמוס עם 2 ליבות ותפס 51 MB בדיסק; שינויים אחר כך נקלטים בהרבה פחות משנייה.
הגדרות
| הגדרה | ברירת מחדל | השפעה |
|---|---|---|
ingot.index.enabled | true | לבנות את האינדקס ולהשתמש בו |
ingot.index.hybridSearch | true | לשלב את כל המקורות; כבוי: וקטורים בלבד |
ingot.chat.codebaseMention | true | @codebase בהודעה מוסיף לה קוד |
ingot.chat.codebaseMention.tokenBudget | 3000 | מקסימום טוקנים ש-@codebase מוסיף (ההתאמה הטובה ביותר תמיד נכנסת) |
ingot.index.maxFiles | 50000 | מקסימום קבצים שהאינדקס קורא |
ingot.index.embeddingProvider | local | local, ollama או gateway |
ingot.index.ollamaModel | nomic-embed-text | מודל Ollama כשהספק הוא ollama |
ingot.agent.repoMap.enabled | true | לתת לסוכן את מפת הפרויקט |
ההגדרות נמצאות בהגדרות › כלי הסוכן › Codebase search, ואפשר להפעיל או לכבות את החיפוש בקוד בהגדרות › תכונות.
מגבלות
-
@codebaseקורא את ההודעה שבה הוא נמצא; הוא לא מחפש שוב בסבבים הבאים של אותה ריצה. - ה-embedder המקומי משווה מילים, לא משמעות בשפות אחרות; לשם כך השתמשו ב-
ollamaאו ב-gateway. - קבצים גדולים מאוד (מעל 256 KB) וקבצים עם שורות ארוכות מאוד לא נכנסים.