אימות

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

סשן סוכן (`aas_*`)

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

התחברות ה-CLI הרשמי דרך אישור בדפדפן
זרימות 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] auth status מציג אם קיים auth מקומי, איפה נשמר ה-config, ואיזה credential store פעיל, בלי להדפיס ערכי token.
npx --yes @agent-analytics/[email protected] upgrade-link --detached יוצר קישור תשלום לאדם כשחשבון free נתקל במשימת אנליטיקה בתשלום.
npx --yes @agent-analytics/[email protected] logout מוחק את auth המקומי השמור של ה-CLI, וכשיש session ID שמור וחומר token usable, מנסה לבטל את אותו agent session במאמץ מיטבי.

logout אינו logout-all-devices. /auth/logout בדפדפן הוא POST-only, מוחק רק את ה-browser session הנוכחי, ולא מנתק CLI agents. כדי לנתק agent sessions נבחרים במפורש, השתמשו ב-Agent Sessions באפליקציית הווב.

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

CLI credential storage

Credential storage הוא אוטומטי. משתמשים רגילים לא צריכים להגדיר משתנה סביבה.

macOS ו-Windows שומרים כברירת מחדל את סודות ה-agent-session של ה-CLI ב-OS keychain.
Linux ו-runtimes חסרי ממשק משתמשים כברירת מחדל ב-config-file storage.
Sessions ישנים שנשמרו בקובץ יועברו אוטומטית ל-native keychain בפקודת authenticated הבאה, אם native storage זמין.
AGENT_ANALYTICS_CREDENTIAL_STORE הוא override מתקדם ל-troubleshooting בלבד. הערכים הנתמכים הם auto, native, ו-file.

אימות

סשן סוכן (aas_*)