title: “התחלה עם AgentEye” description: “תיעוד התחלה עם AgentEye.”
מדריך זה מלמד אתכם על הגדרת AgentEye מלאה: פריסת השרת והלוח הבקרה, התקנת המאסף על מכונת סוכן, ואינסטרומנטציה של קוד סוכן Python.מה זה AgentEye?
AgentEye היא פלטפורמה לצפייה והערכה של סוכנים AI, המתפעלת בעצמאות. היא מתעדת מה הסוכנים שלכם עושים — כל שלב של ריצה — וציוני באופן אוטומטי את איכות כל ריצה שהושלמה, כדי שתוכלו לראות כיצד הסוכנים שלכם מתנהגים בייצור וללכוד רגרסיות לפני שהמשתמשים שלכם עושים זאת. הנתונים זורמים בכיוון אחד: קוד הסוכן שלכם פולט אירועים דרך ה-SDK של Python → דמון מאסף קל משקל מקבצ וקרוא שהם לשרת → אירועים וניתוחים מאוחסנים ב-ClickHouse (מצב תפעולי כמו ארגונים, משתמשים, מפתחות API, לוחות בקרה וחיפושים שמורים גרים ב-Postgres) → אתה חוקר הכל ב-לוח הבקרה. מה אתה מקבל:- אירועים — שביל גולמי, לכל שלב של כל ריצת סוכן (קריאות כלים, קריאות מודל, hooks, שגיאות).
- סשנים — אירועים אלה מגולגלים לשורה אחת לכל ריצה, כל אחת מוערכת באופן אוטומטי וציונים.
- הערכות — ציוני איכות המיוצרים על ידי שירותי ההערכה שלך, כך שירידות בציון איכות מופיעות ללא בדיקה ידנית.
- חיפושים ולוחות בקרה — SQL ClickHouse שמור על הנתונים שלך, מעוצב לתוך לוחות בקרה משותפים בהיקף ארגוני.
- התראות ותקריות — כללי סף שמתריעים אותך (דוא”ל, Slack, webhook, בלוח בקרה) בתוספת זרימת עבודה של תקריות לטיפול בהן.
- CLI ועוזר AI — לקוח טרמינל (
agenteye) ועוזר בלוח בקרה לשאלות בשפה טבעית.
שלב 1: אימות
כל עדויות AgentEye מופצות מהארגון ב-GitHubagenteye-enterprise. כמפתח ארגון, אתה יכול ליצור את ה-GitHub PAT שלך. עקוב אחר enterprise-docs/github-token.md לדרכים מדויקים והרשאות נדרשות.
שלב 2: פרסם את השרת ולוח הבקרה
השרת מקבל אירועים ממאספים וגורם להם להיות שאילתים; לוח הבקרה הוא המקום שבו אתה חוקר אותם. אירועים מודעים וניתוחים חיים ב-ClickHouse (חנות הניתוחים הנדרשת), בעוד Postgres מחזיק מצב תפעולי כמו ארגונים, משתמשים, מפתחות API, לוחות בקרה וחיפושים שמורים. הורד את קובץ ה-compose שפורסם:.env כך שההפריסה לא תפעל על ה-admin שקבוע כברירת מחדל. לפחות קבע ADMIN_KEY ו-POSTGRES_PASSWORD:
http://localhost:8080 ולוח הבקרה ב-http://localhost:3000.
לפריסות ייצור (Postgres מותאם, TLS, reverse proxy), ראה enterprise-docs/deployment.md.
שלב 3: צור מפתח API עבור המאסף
כל מאסף מתחייב עם מפתח API בהיקף. השתמש ב-ADMIN_KEY שקבעת בשלב 2 ליצירת אחד:
key בעצמך; השתמש בו בתצורת המאסף בשלב 4. ראה enterprise-docs/api-keys.md לניהול מפתח מלא.
שלב 4: התקן את המאסף
על כל מכונה שמריצה את סוכני ה-AI שלך, התקן את דמון המאסף. הורד את הבינארי (Linux x86_64):זה מוריד את הבנייה של Linux x86_64. עבור macOS (Apple Silicon או Intel), Linux arm64, או Docker / systemd / launchd setup, ראה collector-installation.md, המפרטת את ההורדה לכל פלטפורמה — הפקודה לעיל מתקינה בינארי Linux שלא יעבוד במקומות אחרים.קבע תצורה:
שלב 5: התקן את ה-SDK של Python
על כל מכונה שבה אתה רוצה להטביע קוד סוכן, התקן את ה-wheel מ-GitHub Releases.שלב 6: הטמע את הסוכן שלך
הוסף אירועים לקוד הסוכן שלך. לפחות, פלטagent_start ו-agent_end:
$AGENTEYE_HOME/events/ (או ~/.agenteye/events/ אם AGENTEYE_HOME לא מוגדר) כל 500 ms. המאסף בוקט אותם באופן אוטומטי.
ראה enterprise-docs/python-sdk.md ל-API של אירועים מלא.
שלב 7: צפה באירועים בלוח הבקרה
פתחhttp://your-dashboard-host:3000 והכנס. AgentEye שולח לך קוד כלילי (או קישור קסום למשימה אחת), ולכן אין סיסמה לניהול.

session_id או agent_id כדי להעמיק לריצה ספציפית.



שלב 8: חקור, תרשם והתריע
עם אירועים זורמים, דפי ניתוח הופכים פעילות גולמית לתשובות, כך שתוכל למדוד התנהגות סוכן, לשתף ממצאים עם הצוות, ולקבל עמוד כל פעם שמשהו רוגרס. דפי לוח בקרה הם בהיקף ארגוני, כך שכתובות ה-URL שאתה רואה בסרגל הכתובות מקדימות בקיצור הארגון שלך (/<org>/…).
- חיפושים (
/<org>/queries): התחל מספרייה של חיפושים שמורים וישימה מחדש על פני האירועים וההערכות שלך (ערכות מובנות בתוספת שלך בעצמך)…


- לוחות בקרה (
/<org>/dashboards): סימן חיפושים כרעולים, בר, אזור או עוגה לתוך לוחות בקרה משותפים בהיקף ארגוני.

- התראות (
/<org>/alerts): קדם כל סף לתוך כלל עמוד המודיע בדוא”ל, Slack, webhook או בלוח בקרה. ראה enterprise-docs/alerts.md.
השלבים הבאים
- פריסה: התקשה לייצור
- מפתחות API: נהל גישה
- פתרון בעיות: אבחן בעיות

