# מתחילים

בדקו את החיבור ב־Test Mode לפני שמשלבים את ה־API במוצר

Canonical: https://alef-bot.top/developers/guides/get-started

Updated: 2026-07-11

## מה נדרש לפני שמתחילים

- חשבון אלף בוט במסלול פרימיום או פלטיניום.
- מפתח Test שנוצר בהגדרות ה־API. מצב זה בודק את החיבור בלי לעבד מדיה אמיתית.
- סוכן AI שיכול לקרוא את סביבת העבודה ולהריץ פקודות, או צ׳אט שיכול להכין עבורכם את הקוד.

- [יצירת מפתח בדיקה](/dashboard?modal=settings&tab=public-api) — צרו מפתח Test ושמרו אותו במקום בטוח.
- [API Reference](/developers/api-reference) — חיפוש פעולות, פרמטרים, תשובות ודוגמאות בקשה.

## שומרים את המפתח מחוץ לשיחה

> **מפתח ה־API הוא סוד.** שמרו אותו במשתנה הסביבה `ALEFBOT_API_KEY`. אין להדביק אותו בצ׳אט, בקוד, בכתובת URL, בלוגים או בכלי אנליטיקה.

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

## מריצים בדיקה מבודדת

1. **מעתיקים את ההנחיה.** בעמוד הסקירה לחצו על ״העתקת הנחיה לסוכן״ והעבירו אותה לסוכן בסביבת העבודה.
2. **הסוכן בודק את מפרטי ה־API.** לפני שינוי הקוד, הסוכן קורא את llms.txt, את OpenAPI ואת תהליך Arazzo.
3. **מריצים Test Mode.** הסוכן יוצר בדיקה קטנה ונפרדת עבור רצף העלאה ← תמלול ← מעקב ← הורדה, בלי לעבד מדיה אמיתית.
4. **בודקים את הדוח.** הסוכן מדווח אילו קבצים שינה, אילו פקודות הריץ ומה הייתה התוצאה, בלי להציג את המפתח.

## איך יודעים שהבדיקה הצליחה

- זרימת ה־Test הסתיימה בתוצאה הצפויה לפי התיעוד.
- לא הועלתה או עובדה מדיה אמיתית.
- המפתח לא נשמר בקוד, לא הודפס ולא נשלח לשיחה.
- השינוי נשאר מבודד ואינו משפיע עדיין על המוצר.

> **רק לאחר הצלחה.** בקשו מהסוכן להציע את השילוב הקטן ביותר במוצר. מעבר ל־Live ולמדיה אמיתית דורש החלטה מפורשת ומפתח מתאים.

## ממשיכים לתיעוד הטכני

- [API Reference](/developers/api-reference) — חיפוש פעולות, פרמטרים, תשובות ודוגמאות בקשה.
- [llms.txt](/developers/llms.txt) — הפנו לכאן סוכן AI כדי שיאתר את המדריכים והמפרטים המתאימים.

## Machine-readable sources

- [OpenAPI JSON](https://alef-bot.top/api/v1/openapi.json)

- [OpenAPI YAML](https://alef-bot.top/api/v1/openapi.yaml)

- [Arazzo workflow](https://alef-bot.top/api/v1/workflows/transcribe.arazzo.yaml)