دمج بروتوكول Model Context Protocol ‏ (MCP)

تتيح Travel Impact Model (TIM) API بروتوكول سياق النموذج (MCP)، وهو معيار مفتوح مصمّم لوكلاء الذكاء الاصطناعي والنماذج اللغوية الكبيرة (LLMs) للتفاعل مع واجهات برمجة التطبيقات والأدوات. باستخدام نقطة نهاية MCP، يمكن لوكلاء الذكاء الاصطناعي اكتشاف إمكانات TIM API واستخدامها بشكل ديناميكي لحساب انبعاثات الرحلات الجوية.

لمزيد من المعلومات عن البروتوكول، يُرجى الاطّلاع على مواصفات بروتوكول سياق النموذج.

نقطة نهاية

نقطة نهاية MCP لـ نموذج تأثير السفر API هي:

https://travelimpactmodel.googleapis.com/mcp

يتم إجراء جميع التفاعلات مع MCP من خلال إرسال طلبات JSON-RPC 2.0 POST إلى نقطة النهاية هذه.

المصادقة

تستخدم نقطة نهاية MCP طرق المصادقة نفسها التي تستخدمها Travel Impact Model API العادية. يجب تقديم مفتاح واجهة برمجة تطبيقات صالح من مشروعك على Google Cloud، مع التأكّد من تفعيل "واجهة برمجة تطبيقات Travel Impact Model" .

طُرق MCP الأساسية

تستخدم التفاعلات مع نقطة نهاية MCP بشكل أساسي طريقتَين:

  • tools/list: تكتشف هذه الطريقة الأدوات المتاحة وأوصافها ومخططات JSON الخاصة بالمدخلات والمخرجات.
  • tools/call: تنفّذ هذه الطريقة أداة معيّنة باستخدام الوسيطات المحدّدة.

الأدوات المتاحة

يتم عرض الوظائف التالية كأدوات:

  • compute_detailed_flight_emissions: تسترد هذه الطريقة الانبعاثات التفصيلية وتقدّم إسنادًا شاملاً للبيانات لرحلات جوية معيّنة قادمة.
  • compute_flight_emissions: تسترد هذه الطريقة الانبعاثات التفصيلية لرحلات جوية معيّنة قادمة.
  • compute_typical_flight_emissions: تسترد هذه الطريقة الانبعاثات المعتادة بين زوجَين من المطارات، بدون الحاجة إلى تفاصيل رحلة جوية معيّنة.
  • compute_scope3_flight_emissions: تسترد هذه الطريقة الانبعاثات للرحلات الجوية السابقة، وهي مناسبة لإعداد تقارير النطاق 3.

يتم توفير المخططات الدقيقة للمدخلات والمخرجات في الردّ على tools/list.

الدمج مع وكلاء الذكاء الاصطناعي

يمكنك ضبط تطبيقات الذكاء الاصطناعي الشائعة باستخدام هذه التعليمات. يُرجى استبدال YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات لنموذج تأثير السفر.

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 CLI من خلال تنفيذ gemini في نافذة الأوامر.

  4. نفِّذ /mcp list للتأكّد من ضبط خادم travel-impact-model وتوفُّر أدواته.

Antigravity

لضبط Antigravity لاستخدام خادم MCP:

  1. في Antigravity، انقر على قائمة خيارات إضافية في لوحة "الوكيل" > خوادم MCP > إدارة خوادم MCP.

  2. في أعلى لوحة "إدارة خوادم MCP" التي تفتح، انقر على عرض الإعدادات الأولية لتعديل ملف mcp_config.json:

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

  3. ارجع إلى إدارة خوادم MCP وانقر على إعادة تحميل.

أمثلة على التفاعلات

بعد ضبط الإعدادات، يمكنك التفاعل مع TIM API من خلال وكيل الذكاء الاصطناعي باستخدام لغة طبيعية.

المستخدم: ما هي الانبعاثات للرحلة الجوية LX 52 من زيورخ إلى بوسطن؟

الوكيل: إنّ انبعاثات الكربون المتوقّعة لكل مسافر على متن الرحلة الجوية LX 52 التابعة للخطوط الجوية السويسرية الدولية من زيورخ (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
  • الدرجة الأولى: ‎1,817.35 كلغ من CO2e