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

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

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

نقطة نهاية

نقطة نهاية MCP لواجهة برمجة التطبيقات الخاصة بنموذج "تأثير السفر" هي:

https://travelimpactmodel.googleapis.com/mcp

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

المصادقة

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

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

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

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

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

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

  • 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 كلغ من مكافئ ثاني أكسيد الكربون
  • النشاط التجاري: 1,416.38 كلغ من الغازات المكافئة لثاني أكسيد الكربون
  • أولاً: 1,770.48 كلغ من الغازات المكافئة لثاني أكسيد الكربون

لهذه الرحلة الجوية تأثير معتدل متوقّع لمسارات التكاثف.

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

الوكيل: إليك معدّل انبعاثات الكربون لكل راكب في رحلة جوية من زيورخ (ZRH) إلى بوسطن (BOS):

  • الاقتصاد: 415.41 كلغ من مكافئ ثاني أكسيد الكربون
  • الدرجة الاقتصادية المميزة: 582.00 كلغ من CO2e
  • النشاط التجاري: 1,473.95 كلغ من الغازات المكافئة لثاني أكسيد الكربون
  • أولاً: 1,817.35 كلغ من الغازات المكافئة لثاني أكسيد الكربون