Thử nghiệm, gỡ lỗi và đánh giá trong Chế độ nhà phát triển của Các ứng dụng Gemini

Sử dụng Chế độ nhà phát triển của Các ứng dụng Gemini để kiểm thử máy chủ Model Context Protocol (MCP) theo cách tương tác, chẩn đoán lỗi giản đồ hoặc lỗi thời gian chạy và đánh giá chất lượng công cụ trước khi gửi ứng dụng đã kết nối để xem xét trong Google Connected Console.

Hướng dẫn này bao gồm các nhiệm vụ sau:

  • Bật Chế độ nhà phát triển của Các ứng dụng Gemini trong Gemini, tạo một ứng dụng MCP tuỳ chỉnh và xác minh khả năng khám phá công cụ ban đầu.
  • Gỡ lỗi các lệnh gọi công cụ không thành công, đồng bộ hoá giản đồ đã cập nhật và kiểm thử quy trình xác thực.
  • Mô phỏng bối cảnh môi trường người dùng và định cấu hình xác thực ứng dụng.

Để xem thông tin giới thiệu về bố cục không gian làm việc và các thẻ trình kiểm tra, hãy xem phần Tổng quan về Chế độ nhà phát triển của Các ứng dụng Gemini.

Bật Chế độ nhà phát triển của Các ứng dụng Gemini

Nếu bạn đang tham gia máy chủ MCP trong Google Connected Console, thì ứng dụng đã đăng ký của bạn sẽ có sẵn khi bạn bật Chế độ nhà phát triển của Các ứng dụng Gemini và bạn có thể bỏ qua Bước 2. Nếu bạn muốn kiểm thử trực tiếp một điểm cuối máy chủ MCP HTTPS đã triển khai trong Gemini trước khi đăng ký điểm cuối đó trong bảng điều khiển, hãy làm theo cả hai bước để bật Chế độ nhà phát triển của Các ứng dụng Gemini và kết nối máy chủ của bạn dưới dạng một ứng dụng MCP tuỳ chỉnh.

Bước 1: Bật Chế độ nhà phát triển của Các ứng dụng Gemini

  1. Mở Gemini trong trình duyệt web.
  2. Nhấp vào Cài đặt > Chế độ nhà phát triển của Các ứng dụng Gemini (hoặc truy cập trực tiếp vào gemini.google.com/devmode).

(Không bắt buộc) Bước 2: Tạo và thử nghiệm một ứng dụng MCP tuỳ chỉnh

Để kết nối máy chủ MCP dưới dạng một ứng dụng tuỳ chỉnh trong Chế độ nhà phát triển của Các ứng dụng Gemini, hãy làm như sau:

  1. Trong hộp thoại Chọn ứng dụng, hãy nhấp vào + Tạo mới.
  2. Trong hộp thoại Kết nối với máy chủ MCP, hãy nhập điểm cuối HTTPS công khai của máy chủ vào URL máy chủ MCP (đảm bảo URL của bạn bắt đầu bằng https://, ví dụ: https://your-app-link.com/mcp).
  3. Nếu máy chủ của bạn yêu cầu thông tin đăng nhập OAuth đã đăng ký trước, hãy nhấp vào Cài đặt bổ sung > Hiện thêm để nhập Mã ứng dụng khách và Khoá bí mật của ứng dụng khách OAuth, sau đó nhấp vào Tiếp theo.
  4. Trong hộp thoại xác nhận về bảo mật và quyền riêng tư, hãy xem cách Gemini tương tác với máy chủ MCP tuỳ chỉnh của bạn:
    • Thực thi công cụ: Gemini thực thi các công cụ của máy chủ MCP để kích hoạt và chạy các chức năng có sẵn nhằm xử lý yêu cầu của bạn.
    • Truy xuất và chia sẻ dữ liệu: Gemini truy xuất và quản lý các tài nguyên, giản đồ và ngữ cảnh do các điểm cuối của máy chủ MCP cung cấp, đồng thời có thể chia sẻ thông tin mà Gemini có quyền truy cập dựa trên chế độ cài đặt Tài khoản Google của bạn hoặc khi tương tác với các ứng dụng được kết nối khác.
    • Tin tưởng và ngắt kết nối: Hãy đảm bảo rằng bạn tin tưởng máy chủ MCP và xem xét chính sách quyền riêng tư của máy chủ đó trước khi tiếp tục. Bạn có thể ngắt kết nối máy chủ bất cứ lúc nào trên trang Các ứng dụng có thể kết nối hoặc xoá đường liên kết của máy chủ đó khỏi các kết nối trong Tài khoản Google của bạn.
  5. Chọn Tôi hiểu và chấp nhận các rủi ro về bảo mật và quyền riêng tư khi kết nối ứng dụng tuỳ chỉnh này. Sau đó, nhấp vào Kết nối.
  6. Trong hộp thoại Lưu ứng dụng tuỳ chỉnh, hãy nhập tên hiển thị cho ứng dụng tuỳ chỉnh, xác minh rằng các công cụ của máy chủ xuất hiện trong danh sách Hành động có sẵn rồi nhấp vào Kết nối.
  7. Trong bảng điều khiển bên của Chế độ nhà phát triển trong Các ứng dụng Gemini, hãy chọn thẻ Lược đồ công cụ để xem thông tin về từng công cụ trong ứng dụng đã kết nối, bao gồm cả định nghĩa tham số, huy hiệu an toàn (Chỉ đọc, Có tính huỷ diệt, Yêu cầu xác thực), Lược đồ thô và Cấu trúc phản hồi.
  8. Trong ngăn trò chuyện bên trái, hãy nhập câu lệnh bằng ngôn ngữ tự nhiên hoặc @mention (ví dụ: @MyApp show my profile) và theo dõi thẻ Nhật ký sự kiện để xem cách công cụ của bạn hoạt động.

Gỡ lỗi lệnh gọi công cụ

Khi một lệnh gọi công cụ không thành công hoặc tạo ra các đối số không mong muốn, bạn có thể kiểm tra dữ liệu đo từ xa chẩn đoán, cập nhật máy chủ MCP phụ trợ và tải lại giản đồ mà không cần xoá nhật ký trò chuyện.

Để gỡ lỗi một lệnh gọi công cụ không thành công, hãy làm như sau:

  1. Trong ngăn bên phải, hãy chọn thẻ Event Log (Nhật ký sự kiện).
  2. Nhấp vào sự kiện không thành công trong danh sách Đo từ xa để mở rộng thông tin chi tiết và kiểm tra tải trọng yêu cầu Tool call cũng như phản hồi Tool result:
    • Lỗi kết nối và lỗi mạng: Kiểm tra thông báo lỗi và độ trễ để xác minh rằng bạn có thể kết nối với điểm cuối.
    • Lỗi xác thực: Nếu sự kiện trả về 401 hoặc 403, hãy xác minh trạng thái mã thông báo OAuth hoặc thông tin xác thực ứng dụng trong thẻ Xác thực.
    • Lỗi xác thực giản đồ: Nếu máy chủ trả về lỗi tham số không hợp lệ của MCP (-32602), hãy so sánh các đối số JSON do mô hình tạo trong Tool call với các loại tham số, thuộc tính bắt buộc và hướng dẫn định dạng trong thẻ Giản đồ công cụ.
    • Ngoại lệ về thời gian chạy của máy chủ: Kiểm tra mã lỗi JSON-RPC và thông báo trong Tool result để chẩn đoán các ngoại lệ về phần phụ trợ.
  3. Để giải quyết vấn đề này, hãy cập nhật cách triển khai máy chủ MCP hoặc tinh chỉnh nội dung mô tả về công cụ và tham số. Để được hướng dẫn về cách viết giản đồ công cụ rõ ràng và phản hồi lỗi, hãy xem phần Tiêu chuẩn tích hợp ứng dụng được kết nối MCP.
  4. Trong thẻ Lược đồ công cụ, hãy nhấp vào Đồng bộ hoá lược đồ. Gemini tìm nạp lại tools/list từ máy chủ MCP của bạn và cập nhật các định nghĩa công cụ đang hoạt động trong khi vẫn giữ nguyên chuỗi trò chuyện hiện tại.
  5. Thử lại truy vấn của bạn. Trong thẻ Nhật ký sự kiện, hãy xác nhận rằng lệnh gọi công cụ được phát lại trả về 200 OK và hiển thị phản hồi dự kiến trong bản xem trước cuộc trò chuyện.

Mô phỏng bối cảnh môi trường và quy trình xác thực

Bạn có thể kiểm tra cách các công cụ MCP phản hồi với nhiều vị trí, múi giờ, ngôn ngữ và phương pháp xác thực của người dùng ngay trong ngăn trình kiểm tra.

Ghi đè bối cảnh môi trường

Để mô phỏng bối cảnh người dùng cho các công cụ nhạy cảm với ngày, giờ hoặc ngôn ngữ, hãy làm như sau:

  1. Trong ngăn phải, chọn thẻ Environment (Môi trường).
  2. Trong phần Date and Time (Ngày và giờ), hãy chọn Simulated Date (Ngày mô phỏng) và Simulated Time (Giờ mô phỏng) để kiểm tra các biểu thức thời gian tương đối (chẳng hạn như "sáng mai" hoặc "chiều thứ Bảy này").
  3. Trong phần Preferences (Lựa chọn ưu tiên), hãy chọn một Language (Ngôn ngữ) để mô phỏng ngôn ngữ của người dùng (ví dụ: en-US).
  4. Chạy câu lệnh kiểm thử trong ngăn trò chuyện để đánh giá công cụ của bạn bằng bối cảnh mô phỏng.
  5. Để khôi phục chế độ cài đặt môi trường mặc định, hãy nhấp vào Đặt lại.

Định cấu hình chế độ xác thực ứng dụng

Để định cấu hình hoặc chuyển đổi phương pháp xác thực được dùng trong phiên Chế độ nhà phát triển của Các ứng dụng Gemini, hãy làm như sau:

  1. Trong ngăn bên phải, hãy chọn thẻ Authentication (Xác thực).
  2. Trong phần Client Authentication Configuration (Cấu hình xác thực ứng dụng), hãy chọn một trong các chế độ xác thực sau:
    • Đăng ký ứng dụng khách linh động: Sử dụng quy trình OAuth để tự động thương lượng thông tin xác thực với máy chủ uỷ quyền của bạn. Để biết thêm thông tin, hãy xem hướng dẫn triển khai OAuth 2.1. Nếu có, hãy nhập điểm cuối của bạn vào mục Thêm đường liên kết đến ứng dụng tuỳ chỉnh.
    • Đăng ký ứng dụng khách theo cách thủ công: Cho phép bạn cung cấp Mã ứng dụng khách và Khoá bí mật của ứng dụng khách đã đăng ký trước theo cách thủ công. Mở rộng phần Cài đặt nâng cao để định cấu hình các chế độ ghi đè luồng bổ sung.
  3. Nhấp vào Lưu rồi đợi thông báo Đã lưu xuất hiện. Sau đó, hãy chạy một câu lệnh kiểm thử để xác minh rằng các công cụ đã xác thực hoạt động thành công.

Tài nguyên khác