תיעוד מוצר

תרגום זה הופק באופן אוטומטי (בטא). המדריך באנגלית הוא המקור המוסמך.

עבודה יומיומית

שימוש ב-bot של סביבת העבודה

הפעילו את Archibot בתוך code-server ושלחו אותו לעבודה: מה הוא יודע על סביבת ה-Archibus שלכם, מה הוא יכול ולא יכול לעשות, פקודות מוכנות לשימוש, ובמה הוא נבדל מצ'אט Console.

חברי לקוחמנהלי לקוחותמפעילי פלטפורמה

עודכן לאחרונה

טרמינל של code-server שבו ה-bot של סביבת העבודה, שהופעל עם archibot start, עונה אילו משימות Archibus הוא יכול לעזור בהן; פאנל Archibot מעוגן מצד ימין.
שואלים את ה-bot של סביבת העבודה במה הוא יכול לעזור, בטרמינל שהופעל עם archibot start. ל-Archibot יש גם פאנל בסרגל הצד של העורך.

כל סביבת עבודה של Archibus מגיעה עם Archibot, עוזר AI מנוהל שרץ בתוך סביבת העבודה וכבר מבין את סביבת ה-Archibus שלכם. הוא יכול לקרוא את הקוד שלכם, לאמת תצוגות AXVW, להריץ שאילתות לקריאה בלבד מול בסיס הנתונים של סביבת העבודה, לחפש דברים במדריך ההפניה של Archibus, ולהפעיל את האפליקציה הרצה — והכל מבלי שתחווטו מפתחות או הקשר. מדריך זה מיועד לכל מי שעובד ב-code-server, יהיה תפקידכם אשר יהיה.

עבור שאר הסביבה שמסביב — העורך, האפליקציה, בסיס הנתונים — ראו Work inside your workspace.

הפעלת ה-bot

יש לכם שתי דרכים להיכנס:

  • טרמינל. פתחו טרמינל ב-code-server (Terminal ← New Terminal) והריצו archibot start. הפקודה משיקה סשן מנוהל — מאחורי הקלעים זהו Codex CLI מנוהל המכוונן ל-Archibus.
  • פאנל העורך. פתחו את פאנל Archibot מסרגל הצד של העורך והקלידו בתיבת ההודעות שלו — ללא צורך בטרמינל. Start Archibot בפאנל מתחיל סשן.

אינכם נכנסים עם משתמש. סביבת העבודה כבר מחזיקה מפתח מנוהל, כך שה-bot מוכן ברגע שסביבת העבודה מוכנה. אם archibot אינו נמצא, ייתכן שתבנית סביבת העבודה שלכם אינה כוללת Archibot מנוהל — בדקו עם מנהל החשבון שלכם.

טרמינל של code-server שבו ה-bot של סביבת העבודה עונה אילו משימות Archibus הוא יכול לעזור בהן, עם פאנל Archibot מעוגן מצד ימין.

צ’אט מפאנל העורך

מעדיפים להישאר בעורך במקום בטרמינל? פתחו את פאנל Archibot מסרגל הצד והשתמשו בתיבת ההודעות שבתחתית. לפאנל יש מצבי Chat, Agent ו-Full Access: השתמשו ב-Chat לשאלות על הקובץ או הפרויקט שאתם נמצאים בהם, ב-Agent כדי לתת ל-Archibot לבצע שינויים בסביבת העבודה שלכם, וב-Full Access כדי להעניק לו חופש פעולה רחב יותר בסביבת העבודה. הוא משוחח עם אותו bot מנוהל, עם אותם כישורי Archibus, כמו בטרמינל — בחרו את מה שמתאים לרגע.

פאנל Archibot בסרגל הצד של code-server עונה על שאלה, עם מצבי Chat, Agent ו-Full Access ותיבת הודעות.

מה הוא יודע ומה הוא יכול לעשות

Archibot מוגדר כעוזר של מפתח Archibus ו-WebCentral. מהקופסה הוא יכול:

  • לעבוד עם תצוגות AXVW — לבנות תצוגה חדשה, להסביר תצוגה קיימת, ולאמת אותה מול כללי Archibus, תוך דיווח על הבעיות הספציפיות שיש לתקן.
  • לקרוא את בסיס הנתונים, בבטחה — להריץ שאילתות מסוג SELECT מול בסיס הנתונים של סביבת העבודה כדי לבדוק סכמה, לעיין בשורות לדוגמה, או לאמת מקור נתונים. התוצאות מוגבלות במספר השורות ומכבדות את הגבלות התצוגה.
  • ליצור מקורות נתונים, כללי workflow וטפסים — ולבדוק אותם מול מוסכמות Archibus לפני שתחווטו אותם.
  • לחפש דברים — לחפש במדריך ההפניה ובעזרת המוצר המצורפים של Archibus במקום לנחש.
  • לראות את האפליקציה הרצה — לפתוח את האפליקציה החיה בדפדפן headless כדי לוודא שתצוגה נטענת או כדי לשחזר בעיה.
  • לטפל במטלות build והרצה — לקרוא יומנים, להפעיל מחדש את Tomcat, ולעבור צעד-צעד על פריסה או שלבי מיגרציה.

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

מה הוא לא יעשה

  • הוא לא ישנה את בסיס הנתונים. כלי השאילתות שלו הוא לקריאה בלבד — אין UPDATE, INSERT או DELETE. שינויי סכמה ונתונים עדיין עוברים דרך מיגרציות ודרך הסקירה הרגילה שלכם.
  • הוא לא ידליף סודות. מפתחות ספק מצונזרים וקריאה חוזרת של אישורים גולמיים מושבתת, והוא מונחה לשמור טוקנים, מפתחות ונתוני לקוח גולמיים מחוץ לקבצים, להערות ולכל דבר שהוא שומר. החזיקו את עצמכם באותו קו.
  • הוא פועל על קבצי סביבת העבודה שלכם — סקרו את העריכות שלו כמו שהייתם סוקרים עריכה של עמית לפני commit.

מתכונים

פקודות קונקרטיות לניסיון. היו ספציפיים והפנו אותו לקובץ או לטבלה שאתם מתכוונים אליהם; ככל שתהיו מדויקים יותר, כך התוצאה תהיה טובה יותר.

בניית תצוגת AXVW

“צור תצוגת AXVW שמציגה חדרים עבור בניין נבחר, עם מסנן בניין ועמודות לשם החדר, שטח וקטגוריה. אמת אותה ותקן כל בעיה לפני שתסיים.”

אימות ותיקון של תצוגה קיימת

“אמת את schema/ab-products/.../my-view.axvw והדרך אותי בתיקון כל שגיאה שתמצא.”

בדיקת נתונים לפני שאתם בונים

“הצג לי את העמודות בטבלה rm, ואז החזר 20 חדרים לדוגמה עם הבניין והקומה שלהם.”

הוספת כלל workflow

“הוסף כלל workflow ששולח דוא”ל למנהל המרחב כשקטגוריה של חדר משתנה, והראה לי היכן הוא נרשם.”

עבודה על טופס

“בטופס הזה, הוסף שדה מסמך לתוכניות קומה ואמת את פקדי הטופס.”

מעקב אחר מקור נתונים

“מצא את מקור הנתונים שמאחורי הפאנל הזה והוסף הגבלה כך שיציג רק רשומות פעילות.”

בירור מדוע שינוי אינו מופיע

“השינוי בתצוגה שלי אינו מופיע באפליקציה. בדוק את יומני Tomcat, אמור לי מה הבעיה, והפעל מחדש את Tomcat אם זה הפתרון.”

אישור שזה נטען

“פתח את רשימת החדרים החדשה בדפדפן ואשר שהיא נטענת ללא שגיאות.”

חיפוש משהו

“כיצד Archibus מטפל בריבוי מטבעות ברשומות חכירה? צטט את ההפניה.”

שליחה לסקירה

“סכם את השינויים שביצעתי, ואז שלח אותם לסקירת CI.”

האחרון משתמש ב-archibot-submit-review, שאורז את השינויים שלכם עבור זרימת CI Review של Console — ראו Persistent environments and CI Review.

אימות וחיפושים בבסיס הנתונים רצים דרך כלי ה-Archibus המובנים של Archibot — כאן הוא מאמת תצוגת AXVW:

ה-bot של סביבת העבודה מאמת תצוגת AXVW בטרמינל ומדווח על התוצאה.

כשאתם מבקשים ממנו לשנות משהו, Archibot עורך את הקבצים במקום והשינוי מופיע ב-Source Control, מוכן שתסקרו אותו כמו כל עריכה אחרת.

Archibot עורך קובץ תצוגה של Archibus: השינוי מופיע ברשימת Source Control וה-bot מאשר בטרמינל מה הוא שינה.

שמירה על הסשן שלכם

שיחה קשורה לזמן הריצה של סביבת העבודה. הציגו סשנים קודמים עם archibot sessions list ופתחו מחדש אחד מהם עם archibot start --session <name>; הפקודה archibot start לבדה מתחילה שיחה חדשה. סשן אינו שורד עצירה/הפעלה או rebuild של סביבת העבודה, ולכן כשה-bot מפיק משהו שחשוב לכם — סיכום, תוכנית, קובץ שנוצר — שמרו אותו: בצעו לו commit ב-git, או העתיקו אותו אל Shared Drive. אל תסתמכו על גלילה לאחור בטרמינל שהפעלה מחדש תנקה.

ה-bot של סביבת העבודה לעומת צ’אט Console

Archibot קיים גם כצ’אט בדפדפן ב-Console (Using ArchibotChat). הם חולקים את אותם כישורים ואת אותו ידע ב-Archibus, אבל הם עובדים במקומות שונים:

  • ל-bot של סביבת העבודה יש ידיים על סביבת העבודה שלכם — הוא קורא את הקבצים שלכם, מריץ שאילתות מול בסיס הנתונים שלכם, מפעיל מחדש את האפליקציה שלכם, ועורך קוד במקום.
  • צ’אט Console מבוסס דפדפן וטוב לשאלות, לתכנון ולהפניה כשאתם לא בסביבת עבודה.

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

פקודות נוספות

  • archibot status ו-archibot doctor — בדקו שהסשן המנוהל והכלים שלו תקינים.
  • archibot capabilities — הציגו מה ה-bot המנוהל יכול לעשות בסביבת עבודה זו.
  • archibot skills list — ראו את כישורי Archibus הזמינים לו.
  • archibot versions — הציגו את גרסאות הכלי המנוהל והתמונה שבשימוש.
  • archibot feedback — שלחו משוב מסונן לצוות הפלטפורמה.
  • archibot-v2, archibot-cc ו-cursor-agent — עוזרים מנוהלים בסגנון Cursor ובסגנון Claude, אם אתם מעדיפים את הממשקים האלה. הם משתמשים באותה גישה מנוהלת.

מדריכים קשורים

הושלם כאשר

  • יש לכם סביבת עבודה פעילה פתוחה ב-code-server.
  • הרצת archibot start בטרמינל פותחת סשן.
  • ה-bot יכול לקרוא קבצים בתיקיית האפליקציה.
  • אתם שומרים כל דבר שברצונכם לשמור לפני עצירת סביבת העבודה.