משימות
משימה לוקחת מטרה מתוכנית ועד pull request. הסוכן כותב תוכנית, אתם בודקים אותה, ואז הוא עובד צעד אחר צעד ומריץ את הבדיקות של הפרויקט אחרי כל צעד. בסוף מקבלים הוכחה למה שהשתנה וכפתור Ship שפותח את ה-pull request.
התחלת משימה
כתבו /mission <מטרה> בצ'אט של הסוכן. זה נמצא גם בתפריט /.
הסוכן קורא קודם את הפרויקט בתור לקריאה בלבד, ואז כותב תוכנית:
- המטרה
- הקבצים שהוא מצפה לגעת בהם
- הצעדים, כל אחד עם הקבצים שהוא נוגע בהם
- הבדיקות שהוא יוסיף או יריץ
- הסיכונים
בדיקת התוכנית
כרטיס Mission מעל תיבת הצ'אט מציג את התוכנית עם שלושה כפתורים:
- Approve and run מתחיל את הצעד הראשון.
- Edit plan פותח את התוכנית כטקסט רגיל באותו פורמט. Ctrl/Cmd+Enter שומר, Escape מבטל.
- Cancel מבטל את המשימה.
סמנו Let missions run without plan review כדי לדלג על הכרטיס הזה ולהתחיל מיד אחרי שהתוכנית נכתבה.
צעד אחר צעד
כל צעד רץ כתור נפרד של הסוכן. אחרי הצעד Ingot מריץ את בדיקות הפרויקט שהוא מצא:
- הסקריפטים
gate,test,lintו-typecheckב-package.json - או פקודת הבדיקות של קובץ המניפסט של הפרויקט, כמו
pytest,go testאוcargo test
בדיקה שנכשלת הופכת לתור תיקון: הסוכן מקבל את הכישלון ומתקן אותו, ואז הבדיקות רצות שוב. צעד יכול לקחת עד 3 תורות תיקון (הגדרה). אם הבדיקות עדיין נכשלות, המשימה נעצרת ואומרת למה.
הצעדים מסומנים בזמן אמת בכרטיס וברשימת המשימות בצ'אט.
עריכות עדיין עוברות סקירת סוכן (Accept / Reject), אלא אם אישור אוטומטי פעיל. הבדיקות רצות אחרי שהחלטתם על העריכות של הצעד.
הוכחה
כשהמשימה מסתיימת, הכרטיס מציג את ההוכחה:
- מה השתנה, עם שורות שנוספו והוסרו בכל קובץ
- התוצאה האחרונה של כל בדיקה
- קבצים ששונו מחוץ לתוכנית
- צעדים שלא בוצעו
- הסיכונים של התוכנית
התוכנית וההוכחה נשמרות ב-.ingot/artifacts/missions/<date>-<goal>.md. מבנה הפרויקט שומר את התיקייה הזאת מחוץ ל-git.
Ship
משימה שהסתיימה מגיעה עד ל-pull request. לחצו על Ship: commit, push and open a pull request בהוכחה, או תנו לזה לקרות לבד במשימה מאומתת כשהגדרת "אחרי המשימה" היא שליחה אוטומטית. Ingot:
- יוצר
feature/<goal>, אלא אם אתם כבר על ענף feature - עושה commit רק לקבצים שהמשימה שינתה, עם ה-trailer של הייחוס (
Co-Authored-By: Ingot) - עושה push עם upstream
- פותח pull request שהתיאור שלו הוא התוכנית וההוכחה, דרך חשבון Git Hosts המחובר
בלי חשבון מחובר, הוא מקשר לדף ה-pull request החדש של הספק. ראו Ship.
כש-Follow PR to green פעיל, הסוכן עוקב אחר כך אחרי ה-pull request ומתקן כישלונות CI והערות סקירה.
מפת הפרויקט
כל ריצה של הסוכן, כולל משימות, מתחילה בסקירה מדורגת של הפרויקט הפתוח:
- שפות ו-frameworks
- נקודות כניסה
- פקודות build ובדיקות
- התיקיות העיקריות
- הקבצים שמיובאים הכי הרבה, עם השמות שהם מייצאים
היא נכנסת ב-2,000 טוקנים כברירת מחדל. Ingot בונה אותה ב-backend, שומר אותה ב-cache ובונה אותה מחדש כמה שניות אחרי שקבצים משתנים. הריצו Ingot: Show Project Map כדי לכתוב אותה ל-.ingot/cache/repo-map.md ולפתוח אותה.
כלי סמלים
שני כלים של הסוכן מוצאים קוד לפי שם:
| כלי | מה הוא מחזיר |
|---|---|
ingot/find_symbol | איפה מוצהרים פונקציה, מחלקה, טיפוס או משתנה: סמלי workspace משרתי השפה ועוד חיפוש הצהרות |
ingot/document_symbols | המתאר של קובץ אחד |
כשאין שרת שפה לקובץ, שניהם עוברים לחיפוש הצהרות ואומרים זאת.
הרצת משימה בלי ממשק
ingot agent run מריץ משימה אחת משורת הפקודה, ל-CI ולסקריפטים. הוא משתמש באותם prompts, באותו מנוע משימות ובאותה מפת פרויקט כמו ה-IDE.
בינתיים מריצים אותו מעותק של מאגר Ingot עם npm run ingot -- agent run …; ה-CLI ingot המותקן יקבל אותו בגרסה הקרובה.
ingot agent run --task <file> [--repo <dir>] [--json]
- המשימה רצה בתיקייה זמנית, worktree מנותק של git מתוך
--repo. התיקייה נמחקת בסוף;--keepשומר אותה. - הריצה מקבלת ציון לפי התוצאה מקצה לקצה: הפיצ'ר עובד (בדיקות נסתרות שמועתקות אחרי הריצה), בדיקות הפרויקט עוברות, pull request עם ההוכחה פתוח, וה-diff נשאר בתחום. הציון מציג גם צעדים שבוצעו, תורות תיקון, טוקנים וזמן.
--jsonמדפיס אותו כ-JSON. - כברירת מחדל ה-pull request נרשם במאגר bare ליד התיקייה הזמנית.
--ship ghעושה push ל-originומריץgh pr createבמקום זאת. - בחרו מודל עם
--model anthropic/<id>(ANTHROPIC_API_KEY),--model openrouter/<id>(OPENROUTER_API_KEY) או--model ingot/<id>(INGOT_EVAL_TOKEN, עם--server), או הגדירוINGOT_AGENT_MODEL. בלי המפתח, הריצה מדווחת skipped.
הגדרות
תחת Settings › Agent tools › Missions:
| הגדרה | ברירת מחדל |
|---|---|
| משימות פעילות או כבויות | פעיל |
| Let missions run without plan review | כבוי |
| תורות תיקון לכל צעד | 3 |
להריץ בקשות מרובות צעדים כמשימות בלי /mission | כבוי |
| אחרי המשימה: כפתור Ship, שליחה אוטומטית או כלום | כפתור Ship |
תחת Settings › Agent tools › Project map: פעיל או כבוי, והגודל שלה (2,000 טוקנים כברירת מחדל).
Settings › Features וההגדרה הראשונית מציגים אותה בשם Missions.
אפליקציית הדסקטופ והדפדפן עובדים אותו דבר.