איך להפוך תיעוד למוכן ל-AI עבור ChatGPT ו-Claude

עודכן ב-3 בנובמבר 2026

כדי להפוך תיעוד למוכן ל-AI, התחילו עם הבסיס שהוכח כחשוב: סורקי AI חייבים להיות מסוגלים למשוך את הדפים שלכם כ-HTML פשוט, ה-robots.txt שלכם חייב לאפשר לבוטי חיפוש להיכנס, וכל מאמר חייב לענות על שאלה אחת בבירור, עם ציון התוכנית, התפקיד והמגבלות. שמרו על דפים מעודכנים, לאחר מכן הוסיפו עותקי Markdown, קובץ llms.txt ושרת MCP עבור סוכני AI. התוספות האלו זולות, אך ההשפעה המדודה שלהן על תשובות AI קטנה עד כה.

מדריך זה מיועד למובילי תמיכה שהלקוחות שלהם שואלים כעת את ChatGPT, Perplexity או AI Overviews של גוגל איך להשתמש במוצר שלכם, ולצוותים שהמפתחים שלהם מפנים את Claude Code או Cursor לתיעוד שלכם. הוא מפריד בין מה שיש לו הוכחות לבין מה שעדיין נחשב להימור.

מה זה אומר תיעוד מוכן ל-AI?#

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

• מנועי תשובות (חיפוש ChatGPT, Perplexity, Claude, Google AI Overviews ו-AI Mode) עונים על שאלות הלקוחות שלכם ומצטטים דפים כמקורות.
• סוכני AI (Claude Code, Cursor, Codex, עוזרים מותאמים אישית) קוראים את התיעוד שלכם כדי לבצע משימה, לרוב דרך קבצי Markdown או שרת MCP.

שניהם צומחים במהירות. סקר 2025 של Stack Overflow מצא ש-84% מהמפתחים משתמשים או מתכננים להשתמש בכלי AI, ו-Similarweb ספר 1.13 מיליארד ביקורי הפניה מפלטפורמות AI ביוני 2025, עלייה של 357% לעומת השנה הקודמת, כאשר ChatGPT אחראי ליותר מ-80% מהם. וכאשר גוגל מציגה סיכום AI, אנשים לוחצים פחות: Pew Research מצא שמשתמשים לחצו על קישור תוצאה ב-8% מהביקורים עם סיכום AI, לעומת 15% ללא סיכום. אם התשובה מוצגת ללא לחיצה, מוטב שהתשובה תהיה נכונה, והיא נכונה רק כפי שהתיעוד שלכם נכון. מספרים נוספים על המקומות שבהם לקוחות מחפשים עזרה נמצאים ב-סטטיסטיקות השירות העצמי ללקוחות שלנו.

האם סורקי AI באמת יכולים לקרוא את מרכז העזרה שלכם?#

בדקו זאת קודם, כי שום דבר אחר לא משנה אם התשובה היא לא.

האם הטקסט נמצא ב-HTML? ניתוח תעבורת סורקים של Vercel מדצמבר 2024 מצא ש-אף אחד מסורקי ה-AI הגדולים לא מרנדר JavaScript, למעט הסורק של Gemini של גוגל וזה של אפל. מרכז עזרה שטוען את המאמרים שלו עם JavaScript בצד הלקוח יכול להיראות ריק לסורקים של ChatGPT ו-Claude. בדקו זאת:

curl -s -A "GPTBot" https://help.example.com/your-article \
  | grep "a sentence from the article"

אם המשפט לא מופיע בתגובה, גם הסורק לא רואה אותו. דפים מרונדרים בצד השרת או מרונדרים מראש פותרים זאת.

האם ה-URLs שלכם נפתחים? באותם נתונים של Vercel, כ-35% מהמשיכות של סורקי ChatGPT ו-Claude הגיעו לדפי 404. שמרו על הפניות (redirects) כשאתם מעבירים או משנים שמות של מאמרים, ושמרו על מפת האתר מעודכנת. אם אתם מחליפים פלטפורמות, עקבו אחר רשימת תיוג להגירה של מרכז עזרה.

האם הדף ציבורי? מנועי תשובות לא יכולים לקרוא דפים שנמצאים מאחורי התחברות. אם יש לכם תיעוד פרטי ללקוחות, קבלו את העובדה שתשובות ה-AI יגיעו מהדפים הציבוריים, הפורומים ואתרים צד-שלישי שלכם במקום.

אילו בוטים של AI צריכים להיות מורשים ב-robots.txt שלכם?#

כל חברת AI מפעילה בוטים נפרדים לאימון ולחיפוש. חסימת "כל בוט ה-AI" מסירה אתכם גם מתשובות ה-AI.

הפרטים מגיעים מהתיעוד של כל חברה: OpenAI, Anthropic ו-Perplexity. מרכז עזרה שרוצה שיצטטו אותו אך לא ישתמשו בו לאימון יכול לומר:

User-agent: GPTBot
Disallow: /

User-agent: ClaudeBot
Disallow: /

User-agent: Google-Extended
Disallow: /

User-agent: *
Allow: /

Sitemap: https://help.example.com/sitemap.xml

בוט שיש לו קבוצה משלו מתעלם מחוקי *, לכן חזרו על כל שורות ה-Disallow (כמו /admin) בכל קבוצה בעלת שם. חסימת Google-Extended גם עוצרת את יישומי Gemini מלבסס תשובות על הדפים שלכם; חיפוש גוגל ו-AI Overviews אינם מושפעים.

בדקו גם את ה-CDN או חומת האש שלכם. מתג "חסימת בוטים של AI" שם יכול לעקוף robots.txt מתירני.

איך כדאי לכתוב מאמרי עזרה כדי ש-AI יענה נכון?#

מנועי תשובות מושכים פסקה, לא את כל האתר שלכם. כל פסקה חייבת לעמוד בפני עצמה.

• משימה אחת למאמר, בשם שבו הלקוחות שואלים. "ביטול או השהיית המנוי", לא "ניהול מנויים".
• תשובה תחילה. שני המשפטים הראשונים תחת כל כותרת צריכים לענות על אותה כותרת. תבנית מאמר מרכז העזרה שלנו בנויה כך.
• ציינו את התנאים. איזו תוכנית, איזה תפקיד, איזו פלטפורמה. "רק מנהלים יכולים למחוק סביבת עבודה" הוא ציטוט ראוי; "אתה יכול למחוק סביבת עבודה" מייצר תשובות שגויות לכל השאר.
• אמרו מה המוצר לא יכול לעשות. עוזרים נשאלים לעיתים קרובות "האם אני יכול…?" אם התיעוד שלכם מתאר רק מה שקיים, המודל מנחש.
• השתמשו בשם אחד לכל דבר, והגדירו אותו פעם אחת. אם "סביבת עבודה", "חשבון" ו-"ארגון" אומרים את אותו הדבר, בחרו אחד, ושמרו דף מילון מונחים קצר שמגדיר את המונחים של המוצר שלכם.
• תנו לכל דף מטא-דאטה נקי. כותרת ספציפית, תיאור בשורה אחת, תאריך עדכון אחרון, ובמידת הצורך, התוכנית או אזור המוצר. מנועי תשובות והחיפוש שלכם משתמשים באלו כדי להחליט איזה דף עונה על שאלה.
• אל תחביאו שלבים בתמונות או סרטונים. תנו לכל צילום מסך טקסט חלופי (alt text) אמיתי, וודאו שכל שלב שסרטון מציג קיים גם כטקסט.
• כסו את הבסיס לפני מקרי הקצה. אם אתם עדיין בונים את מרכז העזרה, התחילו עם איך לבנות בסיס ידע עם AI.
• שמרו על עדכניות. מאמר מיושן הוא כעת תשובה מיושנת, שחוזרת על עצמה בביטחון. המדריך שלנו ל-שמירה על תיעוד מעודכן מכסה שגרה של שחרור אחר שחרור, ו-איך לעדכן תיעוד אוטומטית בכל שחרור מראה איך להתחיל זאת מהשחרור עצמו.

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

האם כדאי להוסיף llms.txt עבור תיעוד?#

זה עוזר פחות ממה שספקים מציעים. llms.txt הוא קובץ Markdown בשורש האתר שלכם שמפרט את הדפים השימושיים ביותר שלכם עם תיאורים קצרים. ג'רמי הווארד הציע זאת בספטמבר 2024 כמפה עבור מודלי שפה.

העובדות עד כה:

• גוגל מתעלמת מזה. המדריך של גוגל מציין שאין צורך בקבצים חדשים לקריאת מכונה, קבצי טקסט ל-AI, תגיות סימון או Markdown כדי להופיע בחיפוש של גוגל, וקבצי llms.txt לא יועילו ולא יזיקו כי החיפוש מתעלם מהם. עוד ב-2025, ג'ון מולר מגוגל השווה את llms.txt לתגית המטא של מילות מפתח.
• מעט בוטים מבקשים את זה. Ahrefs בחנה 137,210 דומיינים ומצאה ש97% מקבצי ה-llms.txt לא קיבלו אף בקשה במאי 2026. בוטים של שליפת מידע ל-AI היוו רק 1.1% מהבקשות שהגיעו (עוזרי AI היוו 2.5% נוספים); סוכני קידוד כמו Claude Code היו בין הקוראים העיקריים שזוהו.

אז: הוסיפו llms.txt אם פלטפורמת התיעוד שלכם מציעה זאת בחינם, במיוחד אם מפתחים משתמשים בתיעוד שלכם עם סוכני קידוד, אך אל תצפו שזה ישנה את מה ש-ChatGPT אומר עליכם. llms-full.txt (כל הדפים בקובץ אחד) הוא מוסכמה נפוצה, לא חלק מההצעה.

האם התיעוד שלכם צריך להיות זמין ב-Markdown?#

כן, אם זה לא עולה לכם דבר. סוכנים שמושכים דף עובדים טוב יותר עם Markdown נקי מאשר עם HTML עמוס בניווט וסקריפטים, והצעת ה-llms.txt מציעה להגיש כל דף באותה כתובת URL עם תוספת .md. שלושה פרטים:

• סמנו את עותקי ה-Markdown כ-noindex (תגית X-Robots-Tag עובדת), כדי שמנועי חיפוש לא יתייחסו אליהם כאל כפילויות של דפי ה-HTML.
• שמרו עליהם ככאלה שנוצרים מאותו מקור של ה-HTML, כדי שלעולם לא ייווצר פער.
• אפשרו לסוכנים למצוא אותם: ההצעה מציעה תגית <link rel="alternate" type="text/markdown"> בכל דף HTML.

כיצד סוכני AI משתמשים בתיעוד דרך MCP?#

פרוטוקול הקשר המודל (Model Context Protocol) הוא תקן פתוח המאפשר ליישום AI להפעיל כלים ולקרוא נתונים ממערכות אחרות. שרת MCP לתיעוד מאפשר לסוכן לחפש בתיעוד שלכם לפי דרישה במקום להסתמך על מה שלמד באימון, ועם ההרשאות הנכונות, גם לנסח או לעדכן דפים. להשוואה בין השרתים הזמינים, ראו שרתי MCP לתיעוד.

אותם כללים חלים אם אתם בונים עוזר משלכם על התיעוד שלכם (RAG - Retrieval-Augmented Generation): הוא יכול להיות מדויק רק כמידת הדיוק של הקטעים שהוא שולף. שתי אזהרות: תנו גישה לקריאה בלבד לכל מה שפונה ללקוחות אלא אם אדם בודק את הכתיבה, וזכרו ש-MCP עוזר לסוכנים שהמשתמשים שלכם מחברים בעצמם. זה לא משנה מה מנועי תשובות ציבוריים אומרים.

איך בודקים מה עוזרי AI אומרים על המוצר שלכם?#

אף אחד לא יכול לראות בתוך המודלים, אז בדקו את הפלט. פעם בחודש:

1. רשמו 20 שאלות לקוח אמיתיות מתוך כרטיסי תמיכה וחיפושים שנכשלו במרכז העזרה.
2. שאלו כל אחת מהן ב-ChatGPT, Perplexity, Claude וגוגל (מצב AI או AI Overviews).
3. תעדו האם התשובה נכונה ואיזה דף היא מצטטת.

4. תקנו את המאמר שממנו התשובה השגויה הייתה אמורה להגיע, ואז שאלו שוב בחודש הבא.

כדי לראות את צד התעבורה, פלחו ביקורים לפי מפנה (chatgpt.com, perplexity.ai, claude.ai), ובדקו את יומני השרת שלכם עבור שמות הבוטים בטבלה לעיל (למעט Google-Extended, שאין לו סוכן משתמש משלו). גוגל סופרת קליקים מתכונות AI ב-Search Console, תחת סוג החיפוש Web.

איך להפוך תיעוד למוכן ל-AI: רשימת תיוג#

איך מרכזי העזרה של Clevera בנויים עבור קוראי AI#

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

• דפים מרונדרים מראש ומפת אתר, כך שטקסט המאמר נמצא ב-HTML שהזחלנים מושכים.
• llms.txt, llms-full.txt ועותק .md של כל דף, תחת ההגדרה llms.txt ועותקי Markdown ("אפשר לכלי AI לקרוא את התיעוד שלך"), שמופעלת כברירת מחדל. במרכז העזרה שלנו עותקי ה-Markdown מוגשים עם noindex. מרכזי עזרה פרטיים (Pro ומעלה) שומרים על כל זה מאחורי התחברות.
• שאל את ה-AI עבור הקוראים שלכם (הפעילו את הצג את העוזר ב-הגדרות → עוזר AI; 300 תשובות בחודש בחינם). העוזר המובנה עונה מתוך הדפים שפרסמתם בלבד, מקשר למקורותיו, מציין זאת כשהתיעוד לא מכסה שאלה, ומרכז את השאלות הללו תחת שאלות ללא מענה כדי שתדעו מה לכתוב בהמשך (המדריך שלנו לפערי תוכן במרכז העזרה מראה איך לעבוד איתם).
• סוכני AI ו-MCP (Pro ומעלה). Claude Code, Codex, Cursor, Claude או ChatGPT יכולים לחפש, לנסח ועם הרשאות פרסום, לעדכן את מרכז העזרה שלכם דרך שרת ה-MCP וה-API של Clevera. אסימון עוזר תמיכה יכול לחפש רק בדפים ציבוריים שפורסמו.

זהו החלק העליון של ה-llms.txt שמרכז העזרה שלנו מפרסם (מקוצר):

# Clevera Help Center

> Clevera turns screen recordings into polished videos: record your screen
> or let the AI record a website, edit with zooms, captions and AI
> voice-overs, then share or embed the result. ...

Every page is also available as Markdown: append `.md` to its URL.
The full text of all pages is at https://help.clevera.ai/llms-full.txt.

### Getting started

- [Understand what Clevera makes](https://help.clevera.ai/docs/getting-started/what-clevera-makes.md): ...

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

התחילו בחינם עם מרכז עזרה מארח, או ייבאו את הנוכחי שלכם מ-Zendesk, Intercom, GitBook ופלטפורמות אחרות. הגדרות נמצאות ב-שליטה במי יכול לקרוא אתר תיעוד, הגדרת עוזר אתר התיעוד ו-חיבור סוכני AI לאתרי התיעוד שלכם. סקירת המוצר נמצאת בדף תוכנת מרכז עזרה ובפוסט השקת אתרי התיעוד שלנו.

שאלות נפוצות#

האם כדאי להוסיף llms.txt למרכז עזרה?#

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

איך לגרום ל-ChatGPT לענות על שאלות על המוצר שלי בצורה נכונה?#

וודאו ש-OAI-SearchBot יכול לזחול במרכז העזרה הציבורי שלכם, שטקסט המאמר נמצא ב-HTML, ושכל מאמר עונה על שאלה אחת עם התנאים המוצהרים. לאחר מכן בדקו שאלות לקוח אמיתיות מדי חודש ותקנו את הדפים שמאחורי תשובות שגויות. זה משפר את הסיכויים; אף אחד לא יכול לגרום ל-ChatGPT לצטט אתכם.

האם כדאי לי לחסום את GPTBot ו-ClaudeBot?#

זו החלטת אימון, לא החלטת נראות. חסימת GPTBot ו-ClaudeBot שומרת על התיעוד שלכם מחוץ לאימון מודלים; זה לא מסיר אתכם מהחיפוש של ChatGPT או Claude, שמשתמשים ב-OAI-SearchBot ו-Claude-SearchBot. אל תחסמו אותם אם אתם רוצים שיצטטו אתכם.

האם נתונים מובנים עוזרים ל-AI Overviews?#

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

מה ההבדל בין תיעוד מוכן ל-AI לבין צ'אטבוט AI במרכז העזרה שלי?#

תיעוד מוכן ל-AI מאפשר לעוזרים חיצוניים להשיב מתוך הדפים שלכם. צ'אטבוט למרכז עזרה, כמו Ask AI של Clevera, משיב לקוראים שלכם באתר שלכם מתוך אותם דפים בדיוק. שניהם מסתמכים על מאמרים ברורים ועדכניים.