דלגו לתוכן
גיליון 001·חי·20:20 IL
→ יומן/2026-10-19·6 דק׳

Developer Knowledge API ושרת MCP של גוגל: תיעוד רשמי לסוכן הקוד שלכם, והמגבלות שגוגל מפרטת

מה ה-Developer Knowledge API של גוגל, שרת ה-MCP, פקודות gcloud וה-agent skill עושים, איך האימות עובד, ומגבלות הטריות וההיקף שגוגל מתעדת. נקרא מהתיעוד של גוגל עצמה.

מאת Harel Asaf·בונה בינה מלאכותית·תל אביב

סוכני קוד לעתים קרובות כותבים מול תיעוד מיושן. התשובה של גוגל למוצרים שלה עצמה היא ה-Developer Knowledge API ושרת MCP תואם שמשרתים את התיעוד הציבורי למפתחים של גוגל כ-Markdown.

ה-API עצמו לא חדש. גוגל הכריזה על public preview ב-4 בפברואר 2026, וב-7 באוקטובר פרסמה פוסט שמוסיף ממשק gcloud, agent skill וספריות לקוח. המאמר הזה קורא את הפוסט ההוא ועוד את עמוד ה-API, עמוד שרת ה-MCP ואת ההכרזה המקורית. לא השתמשתי בו.

מה הוא מציע

גוגל מתארת את ה-API כמקור האמת התכנותי לתיעוד הציבורי למפתחים שלה, מכסה מוצרים כמו Firebase, Google Cloud, Android ו-Google Maps Platform. הוא חושף שלוש פונקציות:

  • SearchDocumentChunks: מציאת URIs וקטעים רלוונטיים של עמודים לשאילתה.
  • GetDocument ו-BatchGetDocuments: שליפת ה-Markdown המלא של תוצאות.
  • AnswerQuery: יצירת תשובות שאוחזו מקורפוס התיעוד.

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

דרכים להשתמש בו

לפי התיעוד של גוגל:

  • נקודות קצה REST ו-RPC, ועוד ספריות לקוח ל-C#, Go, Java, Node.js ו-TypeScript, PHP, Python ו-Ruby.
  • gcloud CLI, למשל gcloud developer-knowledge answer-query --query="...", documents search-chunks ו-documents describe. הפוסט של גוגל אומר שזה בא מותקן מראש ב-Cloud Shell.
  • שרת MCP, לעוזרי קוד. גוגל מכנה את Claude Code, Cursor, GitHub Copilot, Codex ו-Antigravity ככלים שזה עובד איתם.
  • Agent skill, מותקן עם npx skills add google/skills --skill retrieving-developer-knowledge. הוא אומר לעוזר איזה כלי לבחור, איך לטפל בשגיאות, ואיך ליפול חזרה ל-REST API עם curl אם שרת ה-MCP לא זמין.

ההדרכה של גוגל לבחירה: השתמשו ב-API ישירות אם אתם רוצים כלים מותאמים, צריכים לסנן תוצאות לפי data_source או update_time, או רוצים לעבד תוצאות לפני שהן מגיעות למודל. השתמשו בשרת ה-MCP וב-skill אם אתם רוצים לחבר עוזר בלי לכתוב הגדרות כלים ורוצים עדכונים אוטומטיים כשהשרת מוסיף יכולות.

אימות

עמוד ה-MCP מתאר שתי גישות:

  • מפתח API, מועבר בכותרת X-Goog-Api-Key על HTTPS. גוגל ממליצה עליו ל-IDEs של צד שלישי וסוכני CLI. צריך פרויקט Google Cloud, ומפעילים את ה-Developer Knowledge API שם. העמוד מציע להגביל את המפתח ל-Developer Knowledge API.
  • OAuth ו-Application Default Credentials, מתאים ל-Antigravity או התקנות ארגוניות שצריכות טוקן bearer של OAuth 2.0.

עמוד ה-API מפרט שני scopes מקובלים של OAuth: cloud-platform ו-devprofiles.full_control. הוא אומר שלא צריך תפקידי IAM ספציפיים כדי להפעיל או להשתמש ב-API.

פרט אחד מעמוד ה-MCP: אם אתם מתכננים לעשות שימוש חוזר באותו מפתח לקריאות מודל כמו GEMINI_API_KEY, צריך גם לאפשר את ה-Generative Language API עליו. חשבו על זה לפני שמשתפים מפתח אחד על פני שימושים.

מגבלות שגוגל מפרטת

  • היקף. רק עמודים ציבוריים בקורפוס המפורסם כלולים. תוכן מ-GitHub, אתרי קוד פתוח, בלוגים ו-YouTube לא.
  • איכות Markdown. ה-Markdown נוצר מ-HTML, אז יכולות להיות אי-התאמות או בעיות פורמט.
  • טריות. עמוד ה-API מצהיר על יעד של אינדוקס מחדש תוך 48 שעות מפרסום, אז עדכונים זמינים תוך יומי עסקים. ההכרזה מפברואר אמרה שהתיעוד אונדקס מחדש תוך 24 שעות במהלך ה-public preview, והפוסט מאוקטובר אומר שהתוכן מאונדקס בתדירות גבוהה. שלוש ההצהרות נבדלות, אז אל תניחו פיגור ספציפי.
  • סטטוס. הסטטוס היחיד שמצאתי הוא הכרזת ה-public preview מפברואר. לא מצאתי הצהרת זמינות כללית בעמודים שקראתי.

מה הייתי בודק

אלה הצעות שלי שלא נבדקו.

1. שאלו את הסוכן שאלה על API של גוגל שהשתנה לאחרונה והשוו את תשובתו עם עמוד התיעוד החי.

2. בדקו אם מקרה השימוש שלכם צריך תוכן מחוץ לקורפוס, כמו דוגמאות GitHub, כי אלה מוחרגות.

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

4. החליטו איפה מפתח ה-API גר ומי יכול לקרוא אותו.

מה לא הייתי מסיק

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

שאלות נפוצות

מהו ה-Developer Knowledge API?

הגישה התכנותית של גוגל לתיעוד הציבורי למפתחים שלה: חיפוש, שליפה כ-Markdown, ותשובות ממולחות.

אילו כלים שרת ה-MCP חושף?

search_documents, get_documents ו-answer_query.

איך מאמתים?

עם מפתח API בכותרת X-Goog-Api-Key, או עם OAuth ו-Application Default Credentials.

האם זה מכסה ריפוזיטוריים של GitHub או בלוגים?

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

כמה טרי התוכן?

עמוד ה-API של גוגל מצהיר על יעד של אינדוקס מחדש תוך 48 שעות מפרסום. הצהרות קודמות אמרו 24 שעות במהלך ה-preview.

האם זה זמין באופן כללי?

מצאתי רק את הכרזת ה-public preview מפברואר 2026 ואף הצהרת סטטוס מאוחרת יותר בעמודים שקראתי.

יש אפשרות שורת פקודה?

כן. ל-gcloud developer-knowledge יש answer-query, documents search-chunks ו-documents describe.

מקורות

קריאה נוספת

יומן הבנייה

לעקוב אחרי העבודה.

מאמרים ואבטיפוסים חדשים, ישר לקורא ה-RSS שלכם. מנויי המייל בהשהיה זמנית, עד שאחבר שירות משלוח עובד. לא נאסף כאן אימייל.

עקבו ב-RSS