> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting started

title: "התחלה עם AgentEye"
description: "תיעוד התחלה עם AgentEye."
---------------------------------------

מדריך זה מלמד אתכם על הגדרת AgentEye מלאה: פריסת השרת והלוח הבקרה, התקנת המאסף על מכונת סוכן, ואינסטרומנטציה של קוד סוכן Python.

***

## מה זה AgentEye?

AgentEye היא **פלטפורמה לצפייה והערכה של סוכנים AI, המתפעלת בעצמאות**. היא מתעדת מה הסוכנים שלכם עושים — כל שלב של ריצה — וציוני באופן אוטומטי את איכות כל ריצה שהושלמה, כדי שתוכלו לראות כיצד הסוכנים שלכם מתנהגים בייצור וללכוד רגרסיות לפני שהמשתמשים שלכם עושים זאת.

הנתונים זורמים בכיוון אחד: קוד הסוכן שלכם פולט **אירועים** דרך **ה-SDK של Python** → דמון **מאסף** קל משקל מקבצ וקרוא שהם לשרת → אירועים וניתוחים מאוחסנים ב-**ClickHouse** (מצב תפעולי כמו ארגונים, משתמשים, מפתחות API, לוחות בקרה וחיפושים שמורים גרים ב-**Postgres**) → אתה חוקר הכל ב-**לוח הבקרה**.

מה אתה מקבל:

* **אירועים** — שביל גולמי, לכל שלב של כל ריצת סוכן (קריאות כלים, קריאות מודל, hooks, שגיאות).
* **סשנים** — אירועים אלה מגולגלים לשורה אחת לכל ריצה, כל אחת **מוערכת באופן אוטומטי** וציונים.
* **הערכות** — ציוני איכות המיוצרים על ידי שירותי ההערכה שלך, כך שירידות בציון איכות מופיעות ללא בדיקה ידנית.
* **חיפושים ולוחות בקרה** — SQL ClickHouse שמור על הנתונים שלך, מעוצב לתוך לוחות בקרה משותפים בהיקף ארגוני.
* **התראות ותקריות** — כללי סף שמתריעים אותך (דוא"ל, Slack, webhook, בלוח בקרה) בתוספת זרימת עבודה של תקריות לטיפול בהן.
* **CLI ועוזר AI** — לקוח טרמינל (`agenteye`) ועוזר בלוח בקרה לשאלות בשפה טבעית.

אתה מריץ את כל זה בתשתית שלך, כערימת Docker Compose אחת (מדריך זה), התקנת Kubernetes בייצור, או תרמיל אחד שיתופי. שאר המדריך הזה מגדיר את ערימת ה-Compose מקצה לקצה.

***

## שלב 1: אימות

כל עדויות AgentEye מופצות מהארגון ב-GitHub `agenteye-enterprise`. כמפתח ארגון, אתה יכול ליצור את ה-GitHub PAT שלך. עקוב אחר [enterprise-docs/github-token.md](/he/agenteye/github-token) לדרכים מדויקים והרשאות נדרשות.

```bash theme={null}
export AGENTEYE_TOKEN=<your-github-pat>

# Authenticate Docker against GHCR
echo $AGENTEYE_TOKEN | docker login ghcr.io -u x --password-stdin
```

***

## שלב 2: פרסם את השרת ולוח הבקרה

השרת מקבל אירועים ממאספים וגורם להם להיות שאילתים; לוח הבקרה הוא המקום שבו אתה חוקר אותם. אירועים מודעים וניתוחים חיים ב-ClickHouse (חנות הניתוחים הנדרשת), בעוד Postgres מחזיק מצב תפעולי כמו ארגונים, משתמשים, מפתחות API, לוחות בקרה וחיפושים שמורים.

**הורד את קובץ ה-compose שפורסם:**

```bash theme={null}
mkdir -p ./agenteye
curl -fsSL \
  -H "Authorization: token $AGENTEYE_TOKEN" \
  https://raw.githubusercontent.com/agenteye-enterprise/releases/main/docker-compose.yml \
  -o ./agenteye/docker-compose.yml
cd agenteye
```

**קבע את הסודות שלך:**

צור קובץ `.env` כך שההפריסה לא תפעל על ה-`admin` שקבוע כברירת מחדל. לפחות קבע `ADMIN_KEY` ו-`POSTGRES_PASSWORD`:

```bash theme={null}
POSTGRES_PASSWORD=your-db-password
ADMIN_KEY=your-admin-secret
```

**הפעל את הערימה:**

```bash theme={null}
docker compose up -d
```

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

השרת כעת מקשיב ב-`http://localhost:8080` ולוח הבקרה ב-`http://localhost:3000`.

לפריסות ייצור (Postgres מותאם, TLS, reverse proxy), ראה [enterprise-docs/deployment.md](/he/agenteye/deployment).

***

## שלב 3: צור מפתח API עבור המאסף

כל מאסף מתחייב עם מפתח API בהיקף. השתמש ב-`ADMIN_KEY` שקבעת בשלב 2 ליצירת אחד:

```bash theme={null}
curl -s -X POST http://localhost:8080/keys \
  -H "Authorization: Bearer $ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"prod-collector","key":"your-collector-secret","permissions":["events:add"]}'
```

אתה מספק את ערך `key` בעצמך; השתמש בו בתצורת המאסף בשלב 4. ראה [enterprise-docs/api-keys.md](/he/agenteye/api-keys) לניהול מפתח מלא.

***

## שלב 4: התקן את המאסף

על כל מכונה שמריצה את סוכני ה-AI שלך, התקן את דמון המאסף.

**הורד את הבינארי (Linux x86\_64):**

```bash theme={null}
VERSION=0.0.1-beta.13
GITHUB_TOKEN=$AGENTEYE_TOKEN gh release download "collector/v${VERSION}" \
  --repo agenteye-enterprise/releases \
  --pattern 'agenteye-collector-linux-x86_64'
chmod +x agenteye-collector-linux-x86_64
sudo mv agenteye-collector-linux-x86_64 /usr/local/bin/agenteye-collector
```

> זה מוריד את הבנייה של **Linux x86\_64**. עבור macOS (Apple Silicon או Intel), Linux arm64, או Docker / systemd / launchd setup, ראה [collector-installation.md](/he/agenteye/collector-installation), המפרטת את ההורדה לכל פלטפורמה — הפקודה לעיל מתקינה בינארי Linux שלא יעבוד במקומות אחרים.

**קבע תצורה:**

```bash theme={null}
mkdir -p ~/.agenteye
cat > ~/.agenteye/config.json <<EOF
{
  "url": "http://your-server-host:8080/events",
  "key": "the-key-from-step-3"
}
EOF
```

**הפעל את הדמון:**

```bash theme={null}
agenteye-collector start
```

אמת חיבור עם שטיפה חד-פעמית (יוצא לאחר ניקוז כל אירועים שמחכים):

```bash theme={null}
agenteye-collector flush
```

עבור Docker, systemd, ו-launchd setup ראה [enterprise-docs/collector-installation.md](/he/agenteye/collector-installation).

***

## שלב 5: התקן את ה-SDK של Python

על כל מכונה שבה אתה רוצה להטביע קוד סוכן, התקן את ה-wheel מ-GitHub Releases.

```bash theme={null}
VERSION=0.0.1b9
GITHUB_TOKEN=$AGENTEYE_TOKEN gh release download "python-sdk/v${VERSION}" \
  --repo agenteye-enterprise/releases \
  --pattern 'agenteye-*.whl'
pip install agenteye-${VERSION}-py3-none-any.whl
```

***

## שלב 6: הטמע את הסוכן שלך

הוסף אירועים לקוד הסוכן שלך. לפחות, פלט `agent_start` ו-`agent_end`:

```python theme={null}
import agenteye

agenteye.event.agent_start(
    session_id="run-001",
    agent_id="my-agent",
    goal="answer the user query",
)

# your agent logic here

agenteye.event.agent_end(
    session_id="run-001",
    agent_id="my-agent",
    outcome="success",
)
```

אירועים מעוספים וניקוז ל-`$AGENTEYE_HOME/events/` (או `~/.agenteye/events/` אם `AGENTEYE_HOME` לא מוגדר) כל 500 ms. המאסף בוקט אותם באופן אוטומטי.

ראה [enterprise-docs/python-sdk.md](/he/agenteye/python-sdk) ל-API של אירועים מלא.

***

## שלב 7: צפה באירועים בלוח הבקרה

פתח `http://your-dashboard-host:3000` והכנס. AgentEye שולח לך קוד כלילי (או קישור קסום למשימה אחת), ולכן אין סיסמה לניהול.

<img src="https://mintcdn.com/exosphere/RgxYS1UZshqb4m7m/agenteye/images/login.png?fit=max&auto=format&n=RgxYS1UZshqb4m7m&q=85&s=8f83cb747193d872f7883cb709587635" alt="מסך ההכנסה של AgentEye, הקולל קוד חד-פעמי לדוא&#x22;ל שלך" width="2880" height="1800" data-path="agenteye/images/login.png" />

ברגע שאתה בפנים, דף **Events** מציג ריסה חיה של כל האירועים המודעות. סנן לפי `session_id` או `agent_id` כדי להעמיק לריצה ספציפית.

<img src="https://mintcdn.com/exosphere/RgxYS1UZshqb4m7m/agenteye/images/events-stream.png?fit=max&auto=format&n=RgxYS1UZshqb4m7m&q=85&s=79714903a85d10773f4f9b36cb44b1cf" alt="זרם אירועים חי, צבעוני לפי סוג אירוע וניתן לסנון לפי סביבה, סוכן וסשן" width="2880" height="1800" data-path="agenteye/images/events-stream.png" />

דף **Sessions** מגלגל אירועים אלה לשורה אחת לכל ריצה. AgentEye מעריך אוטומטי סשנים שהושלמו, כך שכל ריצה מעוצבת וירידות איכות משטח ללא בדיקה ידנית; ציון ההערכה האחרון מופיע בכל שורה במבט ראשון:

<img src="https://mintcdn.com/exosphere/RgxYS1UZshqb4m7m/agenteye/images/sessions-list.png?fit=max&auto=format&n=RgxYS1UZshqb4m7m&q=85&s=10de161665eef64465d3d100e80b643f" alt="רשימת הסשנים, שורה אחת לכל ריצה, עם טביעות מצב וביטוחי ציון הערכה" width="2880" height="1800" data-path="agenteye/images/sessions-list.png" />

כדי להגדיר כיצד סשנים מעוצבים, ראה [enterprise-docs/evaluation-suite.md](/he/agenteye/evaluation-suite).

לחץ על כל סשן כדי לפתוח את **גרף הביצוע** שלו, תצוגה בסגנון git של כיצד סוכנים, כלים, hooks וקריאות מודל התפתחו לאורך זמן, עם תת-סוכנים מקבילים בנתיבים משלהם וחלוקת לכל ריצה בפס הימין:

<img src="https://mintcdn.com/exosphere/RgxYS1UZshqb4m7m/agenteye/images/session-detail.png?fit=max&auto=format&n=RgxYS1UZshqb4m7m&q=85&s=63cc2480e8124a05ea6a0a92d5f20690" alt="גרף ביצוע של סשן בסגנון git לצד ציר הזמן של האירועים שלו, עם לוח הפירוק של הכלים/מודל/hook" width="2880" height="1800" data-path="agenteye/images/session-detail.png" />

***

## שלב 8: חקור, תרשם והתריע

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

* **חיפושים** (`/<org>/queries`): התחל מספרייה של חיפושים שמורים וישימה מחדש על פני האירועים וההערכות שלך (ערכות מובנות בתוספת שלך בעצמך)…

<img src="https://mintcdn.com/exosphere/RgxYS1UZshqb4m7m/agenteye/images/queries.png?fit=max&auto=format&n=RgxYS1UZshqb4m7m&q=85&s=1b42be492d5b650b4bd6b8a2241f6633" alt="ספרית החיפושים השמורים: רשת של חיפושים ישימה מחדש, גם עם ערכות מובנות וגם מותאמות" width="2880" height="1800" data-path="agenteye/images/queries.png" />

…לאחר מכן פתח אחד בקומפוזר SQL כדי לתקוף אותו והשב עם תוצאות חיות:

<img src="https://mintcdn.com/exosphere/RgxYS1UZshqb4m7m/agenteye/images/query-lab.png?fit=max&auto=format&n=RgxYS1UZshqb4m7m&q=85&s=aec1a1d95bb0bf1280d62a2e2430f20e" alt="קומפוזר שאילתה SQL המריץ שאילתה שמורה, עם סרגל צד ערכה וגריד תוצאות חי" width="2880" height="1800" data-path="agenteye/images/query-lab.png" />

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

<img src="https://mintcdn.com/exosphere/RgxYS1UZshqb4m7m/agenteye/images/dashboard-fleet.png?fit=max&auto=format&n=RgxYS1UZshqb4m7m&q=85&s=d1fed0deace0ebb0bc02421f3b994107" alt="לוח בקרה שנבנה מחיפושים שמורים: אירועים לשעה קו, שגיאות לפי סוג בר, תרשימי אזור זמן עיכוב וטוקנים לפי מודל" width="2880" height="1800" data-path="agenteye/images/dashboard-fleet.png" />

* **התראות** (`/<org>/alerts`): קדם כל סף לתוך כלל עמוד המודיע בדוא"ל, Slack, webhook או בלוח בקרה. ראה [enterprise-docs/alerts.md](/he/agenteye/alerts).

***

## השלבים הבאים

* [פריסה](/he/agenteye/deployment): התקשה לייצור
* [מפתחות API](/he/agenteye/api-keys): נהל גישה
* [פתרון בעיות](/he/agenteye/troubleshooting): אבחן בעיות