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

סוכנים חיצוניים (ACP)

הריצו סוכן קוד פתוח (OpenCode,‏ Goose או OpenHands) או כל סוכן Agent Client Protocol שאתם מוסיפים בתוך Ingot, לצד הסוכן של Ingot עצמו. הסוכן מציג את התוכנית והכלים שלו ומבקש רשות לפני עריכה.

‏Agent Client Protocol ‏(ACP) הוא תקן פתוח לחיבור סוכני קוד לעורכים. Ingot מפעיל את הסוכן כתהליך נפרד בתיקיית הפרויקט ומדבר איתו ב-ACP: אתם מקבלים סביבו את החלונית של Ingot, כרטיסי ההרשאה ומעקב אחרי קבצים.

חלונית External Agents: קודם Ingot Agent, אחריו סוכני הקוד הפתוח OpenCode,‏ Goose ו-OpenHands עם הרישיונות שלהם, והסוכנים שהוספתםחלונית External Agents: קודם Ingot Agent, אחריו סוכני הקוד הפתוח OpenCode,‏ Goose ו-OpenHands עם הרישיונות שלהם, והסוכנים שהוספתם
חלונית External Agents: קודם Ingot Agent, אחריו סוכני הקוד הפתוח OpenCode,‏ Goose ו-OpenHands עם הרישיונות שלהם, והסוכנים שהוספתם

הפעלה

סוכנים חיצוניים כבויים עד שמפעילים אותם. יש שלוש דרכים, כמו לכל תכונה אופציונלית:

  • בצ׳אט. כתבו את שם הסוכן בצ׳אט של הסוכן ("ש-OpenCode יטפל בזה", "תבקש מ-Goose…", או השם שנתתם לסוכן שלכם) ושורה קטנה תציע Enable. היא מפעילה את התכונה, פותחת את החלונית על הסוכן הזה ומכניסה את ההודעה שלכם לתיבת הכתיבה שלו. ‏**×** מסתיר את ההצעה לתמיד.
  • בהגדרות. ‏Settings › Features › External agents הוא מתג ההפעלה. ‏Settings › Tools › External agents (ACP) מכיל את שאר האפשרויות.
  • בלחיצה אחת. הכפתור Agents בשורת המצב מפעיל את התכונה ופותח את החלונית. קיצור המקשים הוא ⌥⇧⌘End ב-macOS ו-Ctrl+Alt+Shift+End ב-Windows וב-Linux; ב-Find Action חפשו "External Agents".
הצ׳אט של הסוכן אחרי בקשה מ-Team Bot, סוכן שנוסף ב-.ingot/acp.json, לסכם את ה-README: הצעה בתוך הצ׳אט עם Enable וכפתור סגירה מעל תיבת הכתיבההצ׳אט של הסוכן אחרי בקשה מ-Team Bot, סוכן שנוסף ב-.ingot/acp.json, לסכם את ה-README: הצעה בתוך הצ׳אט עם Enable וכפתור סגירה מעל תיבת הכתיבה
הצ׳אט של הסוכן אחרי בקשה מ-Team Bot, סוכן שנוסף ב-.ingot/acp.json, לסכם את ה-README: הצעה בתוך הצ׳אט עם Enable וכפתור סגירה מעל תיבת הכתיבה

רשימת הסוכנים

החלונית מציגה את הסוכנים בשלוש קבוצות:

  1. Ingot. הסוכן של Ingot תמיד ראשון. ‏Open Ingot chat פותח אותו בצ׳אט של הסוכן, עם המודלים, הכללים, שרתי ה-MCP והבדיקות שלכם. אין מה להתקין.
  2. Open-source agents (ACP). סוכני קוד פתוח שנבדקו ומדברים ACP, כל אחד ברישיון מתירני. הם משתמשים בספק שהגדרתם בסוכן עצמו, ולכן החלונית אף פעם לא מבקשת בשבילם מפתח API של ספק.
  3. Your agents. סוכנים שאתם מוסיפים ב-.ingot/acp.json או ב-~/.ingot/acp.json, עם השם שנתתם להם.
סוכןרישיוןאיך Ingot מפעיל אותוהתחברות
OpenCodeMITopencode acp כש-OpenCode מותקן, אחרת npx -y opencode-ai acpopencode auth login פעם אחת בטרמינל
GooseApache-2.0goose acp (התקינו קודם את Goose)goose configure פעם אחת בטרמינל
OpenHandsMITopenhands acp (התקינו קודם את ה-CLI של OpenHands)הריצו openhands פעם אחת ובחרו מודל עם /settings

סוכן שלא מותקן מסומן not installed, עם קישור How to install לדף הפרויקט שלו. ההפעלה הראשונה של OpenCode דרך npx מורידה אותו, אז היא יכולה לקחת דקה; צריך Node.js 18 ומעלה ב-PATH.

סוף הרשימה: Your agents, עם Home Helper מ-~/.ingot/acp.json ו-Team Bot מה-.ingot/acp.json של הפרויקטסוף הרשימה: Your agents, עם Home Helper מ-~/.ingot/acp.json ו-Team Bot מה-.ingot/acp.json של הפרויקט
סוף הרשימה: Your agents, עם Home Helper מ-~/.ingot/acp.json ו-Team Bot מה-.ingot/acp.json של הפרויקט

הרצת משימה

  1. פתחו את החלונית ובחרו סוכן בכותרת, או לחצו Start בכרטיס שלו.
  2. תארו את המשימה ולחצו Enter ‏(Shift+Enter לשורה חדשה). ההודעה הראשונה פותחת סשן בתיקיית הפרויקט הראשונה.
  3. התשובה של הסוכן זורמת לחלונית עם החשיבה שלו (מקופלת), התוכנית שלו וכרטיס לכל קריאה לכלי: מה הוא קרא, מה הוא הריץ ו-diff לכל עריכה.
  4. כשהסוכן רוצה לערוך קובץ או להריץ פקודה, כרטיס הרשאה מציג את השינוי עם Allow,‏ Always allow ו-Reject (האפשרויות מגיעות מהסוכן).
  5. הקבצים שהסוכן שינה מופיעים מעל תיבת הכתיבה; לחיצה פותחת אותם.
חלונית External Agents: ‏Team Bot קרא את README.md, מציג את התוכנית שלו ומבקש רשות לכתוב את NOTES.md עם diffחלונית External Agents: ‏Team Bot קרא את README.md, מציג את התוכנית שלו ומבקש רשות לכתוב את NOTES.md עם diff
חלונית External Agents: ‏Team Bot קרא את README.md, מציג את התוכנית שלו ומבקש רשות לכתוב את NOTES.md עם diff

תפריט המצב מתחת לתיבת הכתיבה מחליף בין המצבים של הסוכן עצמו (למשל Code או Ask) כשיש לו כאלה. ‏Stop מבטל את התור, הכפתור + פותח סשן חדש, ו-Agent log מציג מה הסוכן כתב ל-stderr, וזה עוזר כשהוא לא עולה.

הרשאות ובטיחות

הגדרהמה Ingot עונה כשהסוכן שואל
ask (ברירת מחדל)מציג את כרטיס ההרשאה ומחכה לכם
allowמאשר פעם אחת, אוטומטית; השרשור מציין "(automatic)"
denyדוחה, אוטומטית: הסוכן יכול לקרוא אבל לא לשנות כלום
  • ‏Ingot קורא וכותב קבצים בשביל הסוכן רק בתוך תיקיית הפרויקט. בקשה לכל נתיב אחר נדחית, לא משנה מה הסוכן מבקש.
  • ‏Ingot לא נותן לסוכן טרמינל. פקודות שהסוכן מריץ עם הכלים שלו רצות תחת ה-sandbox וההגדרות של הסוכן עצמו, ועדיין מבקשות רשות דרך כרטיס ההרשאה.
  • הסוכן רץ עם ההרשאות של המשתמש שלכם, כמו כל תוכנה שאתם מפעילים. הריצו רק סוכנים שאתם סומכים עליהם, ובדקו את הפקודה בכרטיס הסוכן לפני שאתם מפעילים סוכן שהוספתם.
  • כיבוי התכונה עוצר כל סוכן שרץ.

מפתחות API לסוכנים שלכם

סוכן שאתם מוסיפים יכול לציין את משתנה הסביבה שמחזיק את מפתח ה-API שלו (keyEnv). כשהוא צריך התחברות, החלונית מציגה Set API Key…, את שיטות ההתחברות של הסוכן עצמו ו-Retry. המפתח נשמר במאגר המפתחות של Ingot (מחזיק המפתחות של מערכת ההפעלה), אף פעם לא בהגדרות או בקבצי הפרויקט, ונמסר רק לסוכן הזה, במשתנה הזה. ‏Set External Agent API Key… ב-Find Action משנה או מוחק אותו (השאירו ריק כדי למחוק). לסוכני הקוד הפתוח המובנים אין כפתור מפתח: הם מתחברים דרך ה-CLI שלהם.

הוספת סוכנים משלכם

כל תוכנה שמדברת ACP אפשר להוסיף ב-.ingot/acp.json בפרויקט, או ב-~/.ingot/acp.json לכל הפרויקטים. כפתור גלגל השיניים בחלונית יוצר את קובץ הפרויקט.

{
  "agents": {
    "team-bot": { "name": "Team Bot", "command": "team-bot", "args": ["--acp"], "keyEnv": "TEAM_BOT_API_KEY" },
    "goose": { "command": "/opt/tools/goose", "args": ["acp"] }
  }
}
מפתחמה הוא עושה
command,‏ argsאיך להפעיל את הסוכן (חובה לסוכן חדש)
name,‏ descriptionמוצגים בחלונית ומשמשים בהצעות בצ׳אט
envמשתני סביבה נוספים לסוכן
keyEnvהמשתנה שמקבל את המפתח שנשמר עם Set API Key…

המזהה הוא המפתח (team-bot), באותיות קטנות, ספרות, נקודות, מקפים או קווים תחתונים. שימוש במזהה מובנה (opencode,‏ goose,‏ openhands) משנה את הדרך שבה הסוכן הזה עולה. קובץ הפרויקט גובר על הקובץ הגלובלי.

מהטרמינל

npx @ingotide/cli acp agents                      # the agents you can run, how each starts and its licence
npx @ingotide/cli acp doctor goose --session      # check the ACP handshake and whether it needs a sign-in
npx @ingotide/cli acp run opencode --prompt "Add a test for the cart total" --allow
npx @ingotide/cli acp run team-bot --file task.md --read-only --json
npx @ingotide/cli acp add team-bot --command team-bot --args="--acp" --key-env TEAM_BOT_API_KEY

‏run מדפיס את התשובה ל-stdout ואת המחשבות, התוכנית והכלים ל-stderr. בלי --allow או --deny הוא שואל בטרמינל ודוחה ב-CI ובצינורות. כל האפשרויות נמצאות ב-CLI.

הגדרות

הגדרהברירת מחדלמה היא עושה
External agentsכבוימתג התכונה (גם ב-Settings › Features)
Default agentOpenCodeסוכן הקוד הפתוח שהחלונית מתחילה איתו
When the agent asks for permissionask‏ask,‏ allow או deny (למעלה)
Agents button in the status barפועלהכפתור בלחיצה אחת
Suggest features in chatפועל‏Settings › Features: כל ההצעות בתוך הצ׳אט, לכל התכונות
Suggestions you closedריק‏Settings › Features: תכונות שסגרתם את ההצעה שלהן עם × (‏External Agents הוא acp.external-agents); מחקו אחת כדי לראות אותה שוב

שאלות נפוצות

זה משתמש בתוכנית או ביחידות שלי ב-Ingot? לא. הסוכן משתמש בספק שלו; Ingot רק מריץ אותו ומציג את העבודה שלו.

‏Ingot שולח את הקוד שלי למקום כלשהו? לא. הסוכן מדבר עם הספק שלו, כמו בטרמינל.

למה סוכן שהשתמשתי בו קודם לא מופיע ברשימה? הרשימה המובנית כוללת רק סוכני קוד פתוח שנבדקו. כל סוכן ACP אחר עדיין עובד: הוסיפו אותו ב-.ingot/acp.json או ב-~/.ingot/acp.json והוא יופיע עם השם שתתנו לו.

למה סוכן קוד פתוח אומר שהוא צריך התחברות? הוא משתמש בספק שהוגדר בסוכן עצמו: הריצו את ההתחברות שלו פעם אחת בטרמינל (ראו את הטבלה למעלה) ולחצו Retry.