Klavis Strata

chính thức

Một máy chủ MCP để các tác nhân AI sử dụng bất kỳ công cụ nào một cách đáng tin cậy ở mọi quy mô

Bạn có thể làm gì với Klavis Strata MCP?

  • Khám phá các hành động phù hợp — Yêu cầu trợ lý tìm các danh mục hoặc hành động trên những máy chủ được chỉ định dựa trên ý định diễn đạt bằng ngôn ngữ tự nhiên thông qua discover_server_categories_or_actions.
  • Liệt kê các hành động trong danh mục — Truy xuất tên của tất cả hành động thuộc các danh mục cụ thể bằng get_category_actions trước khi tìm hiểu chi tiết.
  • Kiểm tra lược đồ hành động — Lấy các tham số bắt buộc và tùy chọn của một hành động cụ thể thông qua get_action_details bằng cách cung cấp danh mục và tên hành động.
  • Thực thi hành động — Chạy một hành động với các tham số đường dẫn, truy vấn và nội dung thông qua execute_action, đồng thời có thể giới hạn các trường được trả về bằng include_output_fields.
  • Tìm kiếm tài liệu máy chủ — Tìm các endpoint theo từ khóa trong tài liệu của máy chủ bằng search_documentation khi kết quả khám phá chưa đủ chi tiết.
  • Khắc phục lỗi xác thực — Lấy hướng dẫn xác thực hoặc lưu thông tin xác thực sau khi gặp lỗi xác thực bằng handle_auth_failure.

Tài liệu

Strata

Một máy chủ MCP để các tác nhân AI sử dụng công cụ theo từng bước ở mọi quy mô

Strata Hero - Progressive tool discovery for AI agents

Strata là gì?

Strata là một máy chủ MCP hướng dẫn các tác nhân AI sử dụng công cụ một cách đáng tin cậy ở mọi mức độ phức tạp. Thay vì khiến chúng choáng ngợp với mọi thứ cùng lúc, Strata được thiết kế dựa trên cách con người tương tác với công cụ, nhằm giải quyết ba vấn đề lớn đang gây khó khăn cho các tác nhân AI hiện nay:

  • Quá tải công cụ: Quá nhiều công cụ khiến LLM khó đưa ra lựa chọn
  • Quá tải ngữ cảnh: Danh sách công cụ dài làm tăng số lượng token và chi phí
  • Khoảng trống về phạm vi: Hầu hết máy chủ chỉ có 40~50 công cụ, hạn chế những gì bạn có thể xây dựng

Bạn có thể sử dụng Strata qua trang web, API hoặc thậm chí mã nguồn mở trên dữ liệu của riêng mình!

Hướng dẫn bằng video

Xem video hướng dẫn này để hiểu đầy đủ cách Strata hoạt động:

Strata

Hướng dẫn bằng văn bản

[!TIP]

Xem cuộc trò chuyện Claude được chia sẻ này để thấy Strata hoạt động!

1. Khám phá danh mục hoặc hành động của máy chủ

discover_server_categories_or_actions - tìm các danh mục hoặc hành động phù hợp dựa trên ý định của người dùng. Không tìm kiếm ngữ nghĩa!

[accordion] Chi tiết công cụ

Mô tả: ĐIỂM BẮT ĐẦU ĐƯỢC ƯU TIÊN. Khám phá các danh mục hoặc hành động hiện có dựa trên truy vấn của người dùng. Hãy thử công cụ này trước khi tìm hiểu những hành động nào có sẵn trên các máy chủ. Đây là điểm truy cập chính để khám phá các hành động hiện có và nên được sử dụng trước các phương thức tìm kiếm khác. Kết quả sẽ là danh sách máy chủ cùng cấp độ chi tiết và thông tin chi tiết.

Nếu cấp độ chi tiết là 'categories_only', thông tin chi tiết sẽ chỉ là danh sách tên danh mục. Bước tiếp theo nên dùng công cụ get_category_actions để lấy các hành động thuộc những danh mục đó.

Nếu cấp độ chi tiết là 'full_details', thông tin chi tiết sẽ là danh sách tên danh mục kèm thông tin chi tiết về các hành động. Trường hợp này xảy ra khi máy chủ chỉ có một vài hành động. Bước tiếp theo nên dùng công cụ execute_action để thực thi các hành động.

Nếu cấp độ chi tiết là 'categories_and_actions', thông tin chi tiết sẽ là danh sách tên danh mục và tên hành động. Trường hợp này xảy ra khi sử dụng công cụ bên ngoài. Bước tiếp theo nên dùng công cụ get_action_details để lấy thông tin chi tiết về các hành động.

Tham số:

  • user_query (string, required): Truy vấn bằng ngôn ngữ tự nhiên của người dùng để lọc kết quả.
  • server_names (array, required): Danh sách tên máy chủ cần khám phá danh mục hoặc hành động.

2. Lấy các hành động trong danh mục

get_category_actions - lấy tất cả tên hành động trong các danh mục được chỉ định.

[accordion] Chi tiết công cụ

Mô tả: Lấy thông tin tổng quan đầy đủ về các hành động API có trong những danh mục cụ thể. Dùng công cụ này nếu bạn muốn khám phá các hành động có trong những danh mục dịch vụ cụ thể hoặc xem chi tiết các khả năng của danh mục. ** Quan trọng **: Chỉ gọi công cụ này sau khi lấy được các danh mục máy chủ từ công cụ discover_server_categories.

Tham số:

  • category_names (array, required): Danh sách danh mục cần lấy hành động

3. Lấy thông tin chi tiết về hành động

get_action_details - lấy lược đồ và tham số đầy đủ của một hành động cụ thể.

[accordion] Chi tiết công cụ

Mô tả: Lấy thông tin chi tiết về một hành động cụ thể, bao gồm các tham số bắt buộc và tùy chọn. Phải cung cấp tên danh mục và tên hành động. ** Quan trọng **: Chỉ gọi công cụ này sau khi lấy được danh mục máy chủ từ các lần gọi công cụ trước đó.

Tham số:

  • category_name (string, required): Tên danh mục
  • action_name (string, required): Tên hành động/thao tác trong danh mục

4. Thực thi hành động

execute_action - chạy hành động với các tham số và nhận kết quả.

[accordion] Chi tiết công cụ

Mô tả: Thực thi một hành động cụ thể với các tham số được cung cấp. Phải cung cấp tên máy chủ, tên hành động và các tham số của hành động. ** Quan trọng **: Chỉ gọi công cụ này sau khi lấy được thông tin chi tiết về hành động từ công cụ get_action_details.

Tham số:

  • server_name (string, required): Tên máy chủ
  • category_name (string, required): Tên danh mục cần thực thi hành động
  • action_name (string, required): Tên hành động/thao tác cần thực thi
  • path_params (string, optional): Chuỗi JSON chứa các tham số đường dẫn cho hành động
  • query_params (string, optional): Chuỗi JSON chứa các tham số truy vấn cho hành động
  • body_schema (string, optional, default: "{}"): Chuỗi JSON chứa phần thân yêu cầu cho các hành động
  • include_output_fields (array, optional): Không bắt buộc nhưng rất nên dùng khi bạn biết response_schema của hành động này từ các lần gọi công cụ trước đó: Mảng các đường dẫn trường cần đưa vào phản hồi. Chỉ những trường này mới được trả về. Dùng ký hiệu dấu chấm cho các trường lồng nhau (ví dụ: "author.displayName").
  • maximum_output_characters (integer, optional): Không bắt buộc: Số ký tự tối đa cần trả về trong phản hồi. Nếu phản hồi vượt quá giới hạn này, nội dung sẽ bị cắt bớt. Ưu tiên dùng include_output_fields thay cho tham số này.

5. Tìm kiếm tài liệu

search_documentation - chỉ tìm thông tin liên quan khi cần.

[accordion] Chi tiết công cụ

Mô tả: LỰA CHỌN THỨ CẤP: Chỉ dùng công cụ này khi discover_server_categories không cung cấp đủ thông tin chi tiết hoặc khi bạn cần tìm kiếm trong tài liệu của một máy chủ cụ thể. Tìm tài liệu về hành động của máy chủ theo danh mục, thao tác, thẻ hoặc chức năng bằng cách so khớp từ khóa. Đây không phải là tìm kiếm bằng ngôn ngữ tự nhiên - công cụ khớp chính xác từ khóa và cụm từ. Kết quả trả về các điểm cuối được xếp hạng theo mức độ liên quan. Dùng một vài từ khóa có mục tiêu để tìm kết quả phù hợp nhất. Các mẫu thường gặp: tên danh mục ('projects', 'users', 'pipelines'), hành động ('create', 'delete', 'list', 'get') hoặc kết hợp ('create user', 'list projects'). Thuật toán tìm kiếm sử dụng cơ chế tính điểm thông minh để tránh việc các trường mô tả dài lấn át kết quả.

Tham số:

  • query (string, required): Từ khóa tìm kiếm khớp với các thuật ngữ trong tài liệu API. Cách thực hành tốt nhất: (1) Dùng tên tài nguyên như 'users', 'projects', 'files', (2) Thêm hành động để tăng độ chính xác như 'user create' hoặc 'project delete', (3) Tránh các từ thừa như 'how to', 'show me', 'all the' - tập trung vào các thuật ngữ cốt lõi xuất hiện trong tên và mô tả điểm cuối.
  • server_name (string, required): Tên máy chủ cần tìm kiếm.
  • max_results (integer, optional, default: 10, minimum: 1, maximum: 50): Số lượng kết quả cần trả về. Mặc định: 10

6. Xử lý lỗi xác thực

handle_auth_failure - chỉ xử lý xác thực khi cần.

[accordion] Chi tiết công cụ

Mô tả: Xử lý lỗi xác thực xảy ra khi thực thi hành động. QUAN TRỌNG: CHỈ gọi công cụ này khi execute_action thất bại cụ thể do vấn đề xác thực (401 Unauthorized, thông tin xác thực không hợp lệ, token hết hạn, v.v.). KHÔNG gọi công cụ này để kiểm tra trạng thái xác thực hoặc cho bất kỳ mục đích nào khác. Cách sử dụng: (1) Khi execute_action trả về lỗi xác thực, gọi công cụ này với 'get_auth_url' để nhận hướng dẫn xác thực. (2) Khi người dùng cung cấp dữ liệu xác thực sau khi xảy ra lỗi, gọi công cụ này với 'save_auth_data' để lưu thông tin xác thực. KHÔNG BAO GIỜ gọi công cụ này nếu lỗi KHÔNG phải lỗi xác thực (ví dụ: 404 Not Found, 500 Internal Server Error, v.v.).

Tham số:

  • server_name (string, required): Tên máy chủ gặp lỗi xác thực trong quá trình execute_action
  • intention (string, required, enum: ["get_auth_url", "save_auth_data"]): Dùng 'get_auth_url' khi execute_action thất bại do lỗi xác thực để nhận hướng dẫn xác thực. Dùng 'save_auth_data' khi người dùng cung cấp thông tin xác thực sau khi xảy ra lỗi xác thực.
  • auth_data (object, optional): Dữ liệu xác thực do người dùng cung cấp sau khi xảy ra lỗi xác thực (ví dụ: {"token": "...", "api_key": "..."}). Chỉ dùng với ý định 'save_auth_data' khi xử lý lỗi xác thực.

Đánh giá

Strata mang lại kết quả thực tế:

  • Điểm chuẩn MCPMark: Đạt tỷ lệ pass@1 cao hơn 15.2% so với máy chủ GitHub chính thức và tỷ lệ pass@1 cao hơn 13.4% so với máy chủ Notion chính thức. (Nguồn)
  • Đánh giá của con người: Đạt độ chính xác trên 83% trên các bộ đánh giá gồm hơn 2k truy vấn thực tế

Các bước tiếp theo

[card] Bắt đầu

Tạo máy chủ Strata đầu tiên của bạn chỉ trong vài phút

[card] Tài liệu tham khảo API

Khám phá toàn bộ API Strata

Tài liệu này được xây dựng và lưu trữ trên Mintlify, một nền tảng tài liệu dành cho nhà phát triển.