שילוב של Model Context Protocol‏ (MCP)

‫Travel Impact Model‏ (TIM) API תומך ב-Model Context Protocol‏ (MCP), תקן פתוח שנועד לסוכני AI ולמודלים גדולים של שפה (LLM) כדי ליצור אינטראקציה עם ממשקי API וכלים. באמצעות נקודת הקצה של MCP, סוכני AI יכולים לגלות באופן דינמי את היכולות של TIM API ולהשתמש בהן כדי לחשב את פליטות הטיסה.

למידע נוסף על הפרוטוקול, אפשר לעיין בModel Context Protocol‏ (MCP).

נקודת קצה

נקודת הקצה של ה-MCP עבור Travel Impact Model API היא:

https://travelimpactmodel.googleapis.com/mcp

כל האינטראקציות עם MCP מתבצעות על ידי שליחת בקשות JSON-RPC 2.0 POST לנקודת הקצה הזו.

אימות

נקודת הקצה של MCP משתמשת באותן שיטות אימות כמו API של מודל ההשפעה הרגיל על נסיעות. צריך לספק מפתח API תקף מהפרויקט שלכם ב-Google Cloud, ולוודא שממשק Travel Impact Model API מופעל.

שיטות הליבה של MCP

באינטראקציות עם נקודת הקצה של MCP נעשה שימוש בעיקר בשתי שיטות:

  • ‫tools/list: גילוי הכלים הזמינים, התיאורים שלהם וסכימות ה-JSON של הקלט והפלט שלהם.
  • ‫tools/call: מפעילה כלי ספציפי עם הארגומנטים שצוינו.

כלים זמינים

הפונקציות הבאות מוצגות ככלים:

  • ‫compute_flight_emissions: מאחזר פליטות מפורטות של טיסות ספציפיות שיתקיימו בעתיד.
  • ‫compute_typical_flight_emissions: מאחזר נתוני פליטות אופייניים בין זוגות של שדות תעופה, בלי לדרוש פרטי טיסה ספציפיים.
  • ‫compute_scope3_flight_emissions: מאחזר פליטות של טיסות היסטוריות, מתאים לדיווח על פליטות היקף 3.

סכימות הקלט והפלט המדויקות מופיעות בתשובה tools/list

הטמעה של סוכני AI

במאמר הזה מוסבר איך להגדיר אפליקציות פופולריות מבוססות-AI. מחליפים את הערך YOUR_API_KEY במפתח ה-API של Travel Impact Model ‏(TIM).

Gemini CLI

כדי להגדיר את Gemini CLI, פועלים לפי השלבים הבאים:

  1. יוצרים קובץ הרחבה בכתובת ~/.gemini/extensions/travel-impact-model/gemini-extension.json.

  2. שומרים את התוכן הבא בקובץ:

    {
  "name": "travel-impact-model",
  "version": "3.0.0",
  "mcpServers": {
    "travel-impact-model": {
      "httpUrl": "https://travelimpactmodel.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

  3. מריצים את הפקודה gemini בטרמינל כדי להפעיל את Gemini CLI.

  4. מריצים את הפקודה /mcp list כדי לוודא שהשרת travel-impact-model מוגדר והכלים שלו זמינים.

Antigravity

כדי להגדיר את Antigravity כך שישתמש בשרת MCP:

  1. ב-Antigravity, לוחצים על התפריט אפשרויות נוספות בחלונית Agent > MCP Servers > Manage MCP Servers.

  2. בחלק העליון של החלונית Manage MCP Servers (ניהול שרתי MCP) שנפתחת, לוחצים על View raw config (הצגת הגדרות גולמיות) כדי לערוך את הקובץ mcp_config.json:

    {
  "mcpServers": {
    "TravelImpactModel": {
      "serverUrl": "https://travelimpactmodel.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

  3. חוזרים אל ניהול שרתי MCP ולוחצים על רענון.

דוגמאות לאינטראקציות

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

משתמש: מהם ערכי הפליטה של טיסה LX 52 מציריך לבוסטון?

נציג: פליטת הפחמן החזויה לכל נוסע בטיסה LX 52 של Swiss International Air Lines מציריך (ZRH) לבוסטון (BOS) להיום, 25 במרץ 2026, היא כדלקמן:

  • כלכלה: 354.10 ק"ג CO2e
  • מחלקת תיירים פלוס: 531.14 ק"ג CO2e
  • עסקי: 1,416.38 ק"ג CO2e
  • הראשון: 1,770.48 ק"ג CO2e

לטיסה הזו יש השפעה בינונית של פסי התעבות.

משתמש: מהם שיעורי הפליטה האופייניים מציריך לבוסטון?

נציג: פליטות הפחמן הטיפוסיות לכל נוסע בטיסה מציריך (ZRH) לבוסטון (BOS) הן:

  • מחלקת תיירים: 415.41 ק"ג CO2e
  • מחלקת תיירים פלוס: 582.00 ק"ג CO2e
  • משלוח עסקי: 1,473.95 ק"ג של CO2e
  • First: 1,817.35 kg CO2e