בטא בקרוב. הפיצ׳ר עדיין בפיתוח, ולכן שמות ופרטים עשויים להשתנות לפני השחרור.

חיפוש בקוד

חיפוש בקוד הוא הדרך שבה הסוכן של 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 ו-RubyCartService.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.enabledtrueלבנות את האינדקס ולהשתמש בו
ingot.index.hybridSearchtrueלשלב את כל המקורות; כבוי: וקטורים בלבד
ingot.chat.codebaseMentiontrue‏@codebase בהודעה מוסיף לה קוד
ingot.chat.codebaseMention.tokenBudget3000מקסימום טוקנים ש-@codebase מוסיף (ההתאמה הטובה ביותר תמיד נכנסת)
ingot.index.maxFiles50000מקסימום קבצים שהאינדקס קורא
ingot.index.embeddingProviderlocal‏local, ‏ollama או gateway
ingot.index.ollamaModelnomic-embed-textמודל Ollama כשהספק הוא ollama
ingot.agent.repoMap.enabledtrueלתת לסוכן את מפת הפרויקט

ההגדרות נמצאות בהגדרות › כלי הסוכן › Codebase search, ואפשר להפעיל או לכבות את החיפוש בקוד בהגדרות › תכונות.

מגבלות

  • ‏@codebase קורא את ההודעה שבה הוא נמצא; הוא לא מחפש שוב בסבבים הבאים של אותה ריצה.
  • ה-embedder המקומי משווה מילים, לא משמעות בשפות אחרות; לשם כך השתמשו ב-ollama או ב-gateway.
  • קבצים גדולים מאוד (מעל 256 KB) וקבצים עם שורות ארוכות מאוד לא נכנסים.