אימות

Agent Analytics משתמש בשלושה פרטי גישה שונים. יש להם תפקידים שונים, ולא צריך להחליף ביניהם.

סשן סוכן (aas_*)

השתמשו בסשן סוכן עבור:

• התחברות ה-CLI הרשמי דרך אישור בדפדפן
• זרימות plugin ו-skill שמתחברות דרך מסלול האישור המארח
• setup agent-native שבו הסוכן אמור להחזיק את החיבור אחרי האישור

במסלול המוצר הרגיל לא מעתיקים את הטוקן הזה ידנית. מסלול האישור המארח יוצר אותו עבור הסוכן או ה-CLI ושומר אותו מקומית לשימוש מאוחר יותר.

ניהול סשני סוכן פעילים

אם אתם רוצים לבדוק או לבטל logins של סוכנים אחר כך, פתחו את app.agentanalytics.sh ועברו אל Account Settings → Agent Sessions.

בעמוד הזה תראו סשני סוכן פעילים כמו:

• התחברויות CLI
• חיבורי macOS Live
• חיבורי Paperclip
• לקוחות MCP או לקוחות agent-session מארחים אחרים

השתמשו ב-Disconnect שם כשאתם רוצים לבטל סשן מסוים בצד השרת.

מפתח API (aak_*)

השתמשו במפתח API עבור:

• קריאת נתוני אנליטיקה
• יצירה או רשימה של פרויקטים
• נקודות קצה ברמת החשבון
• גישה ישירה ל-API מתוך סקריפטים, כלים וסוכנים

העבירו אותו עם כותרת X-API-Key או עם query parameter בשם ?key=.

curl "https://api.agentanalytics.sh/stats?project=my-site&since=7d" \
  -H "X-API-Key: aak_..."

התייחסו אליו כחומר סודי.

טוקן פרויקט (aat_*)

השתמשו בטוקן פרויקט עבור:

• POST /track
• POST /track/batch
• סניפט הטרקר בדפדפן שמוטמע באתר שלכם

הטוקן ציבורי בכוונה. הוא מזהה את הפרויקט עבור קליטת אירועים, ולכן צפוי להופיע ב-HTML.

<script defer src="https://api.agentanalytics.sh/tracker.js"
        data-project="my-site"
        data-token="aat_..."></script>

טעות נפוצה

אל תשימו את ה-API key בתוך הטרקר בצד הלקוח. הטרקר משתמש רק ב-project token הציבורי.

עזרי אימות של CLI

אם אתם משתמשים ב-CLI הרשמי, הוא מספק שלוש פקודות auth נוחות:

• npx --yes @agent-analytics/[email protected] login מפעיל אישור בדפדפן ושומר session מקומי של ה-CLI.
• npx --yes @agent-analytics/[email protected] login --detached מפעיל את אותו flow עבור runtimes חסרי ממשק או מבוססי issues, שבהם הסוכן שולח לכם קישור אישור ועלול לבקש finish code.
• npx --yes @agent-analytics/[email protected] upgrade-link --detached יוצר קישור תשלום לאדם כשחשבון free נתקל במשימת אנליטיקה בתשלום.
• npx --yes @agent-analytics/[email protected] logout מוחק את auth המקומי השמור של ה-CLI.

logout הוא מקומי בלבד עבור מצב ה-CLI. אם אתם רוצים לבטל גם את ה-session המארח עצמו, נתקו את אותו session מתוך Agent Sessions באפליקציית הווב.

Scoped agent sessions לא יכולים ליצור או לסובב API keys גולמיים. נהלו compatibility API keys מתוך הדשבורד.

אם הגדרתם AGENT_ANALYTICS_API_KEY בסביבת shell, ה-CLI ימשיך להשתמש במשתנה הזה גם אחרי logout עד שתבטלו אותו.

קשור

• התחלה מהירה
• CLI מול MCP מול API
• פורמט שגיאות
• רפרנס API