Tích hợp Giao thức ngữ cảnh mô hình (MCP)

API Travel Impact Model (TIM) hỗ trợ Giao thức ngữ cảnh mô hình (MCP), một tiêu chuẩn mở được thiết kế cho các tác nhân AI và mô hình ngôn ngữ lớn (LLM) để tương tác với các API và công cụ. Bằng cách sử dụng điểm cuối MCP, các tác nhân AI có thể tự động khám phá và sử dụng các chức năng của TIM API để tính toán lượng khí thải của chuyến bay.

Để biết thêm thông tin về giao thức này, hãy xem Quy cách giao thức bối cảnh mô hình.

Điểm cuối

Điểm cuối MCP cho Travel Impact Model API là:

https://travelimpactmodel.googleapis.com/mcp

Tất cả các lượt tương tác MCP đều được thực hiện bằng cách gửi yêu cầu POST JSON-RPC 2.0 đến điểm cuối này.

Xác thực

Điểm cuối MCP sử dụng các phương thức xác thực giống như API Mô hình tác động của du lịch tiêu chuẩn. Bạn phải cung cấp một khoá API hợp lệ từ dự án trên đám mây của Google, đảm bảo rằng "Travel Impact Model API" đã được bật.

Các phương thức MCP cốt lõi

Tương tác với điểm cuối MCP chủ yếu sử dụng 2 phương thức:

  • tools/list: Khám phá các công cụ hiện có, nội dung mô tả và giản đồ JSON đầu vào/đầu ra của các công cụ đó.
  • tools/call: Thực thi một công cụ cụ thể với các đối số đã cho.

Các công cụ có sẵn

Các chức năng sau đây được cung cấp dưới dạng công cụ:

  • compute_flight_emissions: Truy xuất thông tin chi tiết về lượng khí thải của các chuyến bay sắp tới cụ thể.
  • compute_typical_flight_emissions: Truy xuất lượng khí thải thông thường giữa các cặp sân bay mà không yêu cầu thông tin cụ thể về chuyến bay.
  • compute_scope3_flight_emissions: Truy xuất lượng khí thải của các chuyến bay trước đây, phù hợp với báo cáo Phạm vi 3.

Các giản đồ chính xác cho dữ liệu đầu vào và đầu ra được cung cấp trong phản hồi tools/list.

Tích hợp với tác nhân AI

Định cấu hình các ứng dụng AI phổ biến theo hướng dẫn này. Thay thế YOUR_API_KEY bằng khoá API Travel Impact Model của bạn.

Gemini CLI

Để định cấu hình Gemini CLI, hãy làm theo các bước sau:

  1. Tạo tệp tiện ích tại ~/.gemini/extensions/travel-impact-model/gemini-extension.json.

  2. Lưu nội dung sau đây vào tệp:

    {
  "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. Khởi chạy Gemini CLI bằng cách chạy gemini trong cửa sổ dòng lệnh.

  4. Chạy /mcp list để xác minh rằng máy chủ travel-impact-model đã được định cấu hình và các công cụ của máy chủ này có sẵn.

Antigravity

Cách định cấu hình Antigravity để sử dụng máy chủ MCP:

  1. Trong Antigravity, hãy nhấp vào trình đơn Tuỳ chọn khác trong ngăn Agent (Tác nhân) > MCP Servers (Máy chủ MCP) > Manage MCP Servers (Quản lý máy chủ MCP).

  2. Ở đầu ngăn Quản lý máy chủ MCP mở ra, hãy nhấp vào Xem cấu hình thô để chỉnh sửa tệp mcp_config.json:

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

  3. Quay lại phần Quản lý máy chủ MCP rồi nhấp vào Làm mới.

Ví dụ về lượt tương tác

Sau khi định cấu hình, bạn có thể tương tác với TIM API thông qua tác nhân AI bằng ngôn ngữ tự nhiên.

Người dùng: Khí thải của chuyến bay LX 52 từ Zurich đến Boston là bao nhiêu?

Trợ lý: Lượng khí thải carbon dự kiến trên mỗi hành khách của chuyến bay LX 52 của hãng hàng không Swiss International Air Lines từ Zurich (ZRH) đến Boston (BOS) cho ngày hôm nay, 25 tháng 3 năm 2026, như sau:

  • Tiết kiệm: 354,10 kg CO2e
  • Phổ thông cao cấp: 531,14 kg CO2e
  • Doanh nghiệp: 1.416,38 kg CO2e
  • Đầu tiên: 1.770,48 kg CO2e

Chuyến bay này có tác động trung bình theo dự đoán của vệt ngưng tụ.

Người dùng: Lượng khí thải thông thường từ Zurich đến Boston là bao nhiêu?

Đại lý: Lượng khí thải cacbon thông thường trên mỗi hành khách cho một chuyến bay từ Zurich (ZRH) đến Boston (BOS) như sau:

  • Tiết kiệm: 415,41 kg CO2e
  • Phổ thông cao cấp: 582 kg CO2e
  • Doanh nghiệp: 1.473,95 kg CO2e
  • Đầu tiên: 1.817,35 kg CO2e