חיבור סוכני AI לאתרי התיעוד שלך
אפשר ל-Claude Code, Codex, ChatGPT או לסקריפטים משלך לנסח, לארגן ולפרסם דפי אתר תיעוד. תוכניות (Pro ומעלה), הרשאות אתר התיעוד, הגדרת היקף האתר וכללי פרסום, עם קישורים למדריכים המלאים על סוכני AI ו-API.
סוכני AI כגון Claude Code, Codex, Cursor, Claude או ChatGPT יכולים לקרוא ולכתוב באתרי התיעוד שלך עבורך: לנסח מאמרים, לתקן דפים שקיבלו דירוג נמוך מהקוראים, לענות על פערי תוכן, לתרגם או לפרסם. מאמר זה מכסה את מה שספציפי לאתרי תיעוד. אסימונים, מחברים, הוצאות ושגיאות מוסברים ב-סוכני AI ו-API.
לפני שמתחילים
- סוכני AI ו-API זמינים בתוכניות Pro, Business ו-Custom, כולל מחברים עבור Claude ו-ChatGPT. התוכניות החינמית ו-Starter אינן כוללות זאת; אסימונים ואפליקציות יפסיקו לעבוד אם סביבת העבודה תעבור לאחת מהן.
- סוכן פועל כאדם שיצר את האסימון שלו או חיבר אותו, במסגרת התפקיד של אותו אדם. הוא לעולם לא יוכל לעשות באתר יותר ממה שהאדם עצמו יכול היה לעשות.
- קריאות API אינן עולות קרדיטים. תרגום דפים ויצירת דפי אתר באמצעות AI עולים קרדיטים, ורק עם אסימון שיכול להוציא אותם.
חיבור סוכן
פתח את תפריט סביבת העבודה ובחר ב-AI agents & API, או בחר ב-AI agents & API בתפריט הגדרות של אתר תיעוד (זה יפתח את הפעילות עבור אותו אתר).
- אסימון API עבור Claude Code, Codex, Cursor או סקריפט: Tokens → New token, ולאחר מכן אשף בעל ארבעה שלבים (מטרה, הרשאות, מגבלות, סקור). בחר הגדרה מראש לאתר תיעוד כגון Writer או Publisher, בחר את האתרים תחת Limits → Doc sites, והעתק את האסימון, שמוצג פעם אחת. ראה יצירת אסימון API.
- מחבר עבור Claude.ai או ChatGPT: הדבק את כתובת ה-URL של המחבר מתוך אפליקציות מחוברות לתוך האפליקציה, היכנס לחשבון ובחר את ה-אתרים וה-גישה. ראה חיבור אפליקציות וסוכני AI.
הגדרות מראש לאתרי תיעוד
| הגדרה מראש | תיאור על המסך | עבור |
|---|---|---|
| Writer | "סוכנים מנסחים; אדם סוקר ומפרסם." | ניסוח מאמרים וערכי יומן שינויים, העלאת תמונות |
| Publisher | "אוטומציה מהימנה שעשויה לשנות את מה שהקוראים רואים." | הכל עבור אתרי תיעוד, כולל פרסום, הגדרות ויצירת אתרים |
| Support assistant | "תשובות מתוך מסמכים שפורסמו. שום דבר אחר." | בוט עזרה שמחפש רק בדפים ציבוריים שפורסמו |
| Read-only | "מחקר, ביקורות ובדיקות תרגום." | קריאת תוכן |
| Analyst | "קורא תוכן ואותות מהקוראים כדי להציע תיקונים." | קריאת תוכן ותובנות |
Producer ו-סוכן סביבת עבודה מוסיפים סרטונים וניצול קרדיטים. כל הרשאה ומי יכול להעניק אותה: הרשאות סוכן.
הרשאות אתר תיעוד
| הרשאה | מאפשר |
|---|---|
content:read |
קריאת אתרים, דפים, מאמרים (גם טיוטות), גרסאות, יומן השינויים ודפי אתר |
articles:write |
יצירת טיוטות מאמרים ועריכת מאמרים שאינם פעילים |
structure:write |
יצירה ועריכה של מקטעים; העברה, הסתרה ושינוי שם של דפים |
site-pages:write |
עריכת דפי אתר כגון דף הבית, צור קשר ומשפטי |
changelog:write |
יצירה ועריכה של ערכי יומן שינויים כטיוטות |
media:write |
העלאת תמונות |
site:publish |
פרסום: שינוי מה שהקוראים רואים, עריכת תוכן פעיל, סימון דפים כמוכנים |
insights:read |
קריאת פערי חיפוש, שאלות ללא מענה ומשוב על דפים |
site:configure |
שינוי הגדרות אתר, מראה וניווט |
sites:create |
יצירת אתרי תיעוד חדשים |
help:read |
חיפוש בדפים ציבוריים שפורסמו בלבד (עבור עוזר תמיכה) |
הקריאה פתוחה לכל חבר. כתיבה וארגון: בעלים, מנהלים, עורכים ויוצרי תוכן. פרסום והגדרות אתר: בעלים, מנהלים ועורכים ("רק בעלים, מנהלים ועורכים יכולים להעניק הרשאות פרסום."). יצירת אתרים: בעלים ומנהלים.
אילו אתרים אסימון מכסה
תחת Limits → Doc sites, בחר ב-כל האתרים ("כל אתר תיעוד בסביבת עבודה זו, כולל חדשים.") או ב-אתרים נבחרים. אסימון או אפליקציה מחוברת רואים ומשנים רק את האתרים שהם מכסים. אם מאמר מופיע גם באתר מחוץ להיקף שלו, השינוי יסורב: "מאמר זה מוצג גם באתר שאסימון זה אינו יכול לשנות."
תוכן פעיל דורש הרשאות פרסום
ללא site:publish, סוכן לא יכול לשנות את מה שהקוראים רואים. עריכת מאמר פעיל תסורב ("תוכן זה פעיל באתר שפורסם, לכן שינויו דורש את היכולת site:publish"), והסוכן יכול להגיש את הטיוטה שלו לסקירה במקום זאת. תקבל התראה, "agent ביקש סקירה עבור page ב-site": "שום דבר לא פורסם. קרא את המאמר ופרסם אותו כשהוא מוכן."
כל שינוי שסוכן מבצע מופיע בהיסטוריה של הדף כ-"סוכן name (token)". פרסומים מוגבלים ל-10 בשעה לכל אסימון. אתר מושהה הוא לקריאה בלבד עבור סוכנים: "אתר זה מושהה או לא מקוון והוא לקריאה בלבד."
מה סוכנים יכולים לעשות באתר
לפרט אתרים ולקרוא את עץ הדפים, לחפש ולקרוא דפים, להציג תצוגה מקדימה של Markdown, ליצור ולעדכן מאמרים, להגיש אותם לסקירה, לארגן מקטעים ודפים, לערוך דפי אתר ויומן שינויים, להעלות תמונות, לקרוא תובנות ולסמן פערים כמכוסים, לשנות הגדרות, מראה, ניווט והפניות, ליצור אתרים, לתרגם דפים, ליצור דפי אתר, לפרסם ולבצע שחזור. כל פעולה דורשת את ההרשאה המתאימה.