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

API Mô hình ước tính tác động của việc đi lại (TIM) hỗ trợ Giao thức bối 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 phát hiện và sử dụng các tính năng của API TIM để tính toán lượng khí thải từ chuyến bay.

Để biết thêm thông tin về giao thức này, hãy xem phần Thông số kỹ thuật của Giao thức bối cảnh mô hình.

Điểm cuối

Điểm cuối MCP cho API Mô hình ước tính tác động của việc đi lại là:

https://travelimpactmodel.googleapis.com/mcp

Tất cả lượt tương tác với MCP đều được thực hiện bằng cách gửi các 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 ước tính tác động của việc đi lại tiêu chuẩn. Bạn phải cung cấp 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

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

  • tools/list: Phát hiện 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ụ sẵn có

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

  • compute_detailed_flight_emissions: Truy xuất lượng khí thải chi tiết và cung cấp thông tin phân bổ dữ liệu toàn diện cho các chuyến bay sắp tới cụ thể.
  • compute_flight_emissions: Truy xuất lượng khí thải chi tiết cho các chuyến bay sắp tới cụ thể.
  • compute_typical_flight_emissions: Truy xuất lượng khí thải điển hình giữa các cặp sân bay mà không cần thông tin chi tiết cụ thể về chuyến bay.
  • compute_scope3_flight_emissions: Truy xuất lượng khí thải cho các chuyến bay trong quá khứ, phù hợp với việc 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 các tác nhân AI

Định cấu hình các ứng dụng AI phổ biến bằng các 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ủ đó đã sẵn sàng.

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 Tác nhân > Máy chủ MCP > 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ề các lượt tương tác

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

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

Tác nhân: Lượng khí thải cacbon 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
  • Thương gia: 1.416,38 kg CO2e
  • Hạng nhất: 1.770,48 kg CO2e

Chuyến bay này có tác động vừa phải dự kiến từ vệt khói trắng.

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

Tác nhân: Lượng khí thải cacbon điển hình 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,00 kg CO2e
  • Thương gia: 1.473,95 kg CO2e
  • Hạng nhất: 1.817,35 kg CO2e