Klavis Strata

Strata

Một MCP server để các tác nhân AI sử dụng công cụ một cách tiến bộ ở mọi quy mô

<img src="https://mintcdn.com/klavisai/7Siw7A5JJSHURM5d/images/concepts/strata_hero.png?fit=max&auto=format&n=7Siw7A5JJSHURM5d&q=85&s=b581fdb821699a32b260d124789396bd" alt="Strata Hero - Progressive tool discovery for AI agents" className="w-full rounded-lg" style={{ maxWidth: '100%', height: 'auto' }} width="2533" height="496" data-path="images/concepts/strata_hero.png" />

Strata là gì?

Strata là một MCP server 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ì làm chúng choáng ngợp với mọi thứ cùng một lúc. Nó được thiết kế dựa trên cách con người tương tác với công cụ, 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ụ gây ra tình trạng tê liệt khi lựa chọn của LLM
• 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 bao phủ: Hầu hết các server bị giới hạn ở 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 website, API, hoặc thậm chí mã nguồn mở trên dữ liệu của riêng bạn!

Video Hướng dẫn

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

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

Mẹo

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

1. Khám phá Danh mục hoặc Hành động của Server

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 cần tìm kiếm ngữ nghĩa!

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

Nếu mức độ 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 sử dụng công cụ get_category_actions để lấy các hành động cho các danh mục.

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

Nếu mức độ 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. Điều này xảy ra khi sử dụng các công cụ bên ngoài. Bước tiếp theo nên sử dụng công cụ get_action_details để lấy chi tiết của các hành động.

Tham số:

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

2. Lấy Hành động của Danh mục

get_category_actions - truy xuất tất cả tên hành động trong các danh mục đã chỉ định.

**Mô tả**: Lấy tổng quan toàn diện về các hành động API có sẵn trong các danh mục cụ thể. Sử dụng công cụ này nếu bạn muốn khám phá những hành động nào có sẵn trong các danh mục dịch vụ cụ thể hoặc xem chi tiết về khả năng của danh mục. \*\* Quan trọng \*\*: Chỉ nên gọi công cụ này sau khi bạn nhận được danh mục server từ công cụ discover_server_categories.

Tham số:

• category_names (mảng, bắt buộc): Danh sách các danh mục để lấy hành động

3. Lấy Chi tiết Hành động

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

**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ỉ nên gọi công cụ này sau khi bạn nhận được danh mục server từ các lệnh gọi công cụ trước đó.

Tham số:

• category_name (chuỗi, bắt buộc): Tên của danh mục
• action_name (chuỗi, bắt buộc): Tên của hành động/thao tác trong danh mục

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

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

**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 server, tên hành động và tham số hành động. \*\* Quan trọng \*\*: Chỉ nên gọi công cụ này sau khi bạn nhận được chi tiết hành động từ công cụ get_action_details.

Tham số:

• server_name (chuỗi, bắt buộc): Tên của server
• category_name (chuỗi, bắt buộc): Tên của danh mục để thực thi hành động
• action_name (chuỗi, bắt buộc): Tên của hành động/thao tác để thực thi
• path_params (chuỗi, tùy chọn): Chuỗi JSON chứa các tham số đường dẫn cho hành động
• query_params (chuỗi, tùy chọn): Chuỗi JSON chứa các tham số truy vấn cho hành động
• body_schema (chuỗi, tùy chọn, mặc định: "{}"): Chuỗi JSON chứa nội dung yêu cầu cho các hành động
• include_output_fields (mảng, tùy chọn): Tùy chọn nhưng được khuyến nghị mạnh mẽ khi bạn biết response_schema của hành động này từ các lệnh gọi công cụ trước đó: Mảng các đường dẫn trường để đưa vào phản hồi. Chỉ các trường này sẽ được trả về. Sử dụng ký hiệu dấu chấm cho các trường lồng nhau (ví dụ: "author.displayName").
• maximum_output_characters (số nguyên, tùy chọn): Tùy chọn: Số ký tự tối đa để trả về trong phản hồi. Nếu phản hồi vượt quá giới hạn này, nó sẽ bị cắt ngắn. Ưu tiên include_output_fields hơn 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 thiết.

**Mô tả**: **TÙY CHỌN THỨ HAI**: Chỉ sử dụng công cụ này khi discover_server_categories không cung cấp đủ chi tiết hoặc khi bạn cần tìm kiếm trong tài liệu của một server cụ thể. Tìm kiếm tài liệu hành động của server theo danh mục, thao tác, thẻ hoặc chức năng bằng cách khớp từ khóa. Đây không phải là tìm kiếm ngôn ngữ tự nhiên - nó khớp chính xác các từ khóa và cụm từ. Trả về các điểm cuối được xếp hạng theo mức độ liên quan. Sử dụng một vài từ khóa có mục tiêu để tìm kết quả tốt nhất. Các mẫu phổ biến: 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 tính điểm thông minh để ngăn các trường mô tả dài dòng làm lấn át kết quả.

Tham số:

• query (chuỗi, bắt buộc): Từ khóa tìm kiếm khớp với các thuật ngữ tài liệu API. Các phương pháp tốt nhất: (1) Sử dụng tên tài nguyên như 'users', 'projects', 'files', (2) Thêm hành động để chính xác hơn như 'user create' hoặc 'project delete', (3) Tránh các từ đệm 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 điểm cuối và mô tả.
• server_name (chuỗi, bắt buộc): Tên của server để tìm kiếm bên trong.
• max_results (số nguyên, tùy chọn, mặc định: 10, tối thiểu: 1, tối đa: 50): Số lượng kết quả để 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 thiết.

**Mô tả**: Xử lý các lỗi xác thực xảy ra khi thực thi hành động. QUAN TRỌNG: Công cụ này CHỈ nên được gọi khi execute_action thất bại cụ thể do các 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, hãy 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 lỗi, hãy 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à lỗi xác thực (ví dụ: 404 Not Found, 500 Internal Server Error, v.v.).

Tham số:

• server_name (chuỗi, bắt buộc): Tên của server đã thất bại xác thực trong execute_action
• intention (chuỗi, bắt buộc, enum: ["get_auth_url", "save_auth_data"]): Sử dụng 'get_auth_url' khi execute_action thất bại với lỗi xác thực để nhận hướng dẫn xác thực. Sử dụng 'save_auth_data' khi người dùng cung cấp thông tin xác thực sau lỗi xác thực.
• auth_data (đối tượng, tùy chọn): Dữ liệu xác thực do người dùng cung cấp sau lỗi xác thực (ví dụ: {"token": "...", "api_key": "..."}). Chỉ được sử dụng với ý định 'save_auth_data' khi giải quyết các 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 server GitHub chính thức và tỷ lệ pass@1 cao hơn +13.4% so với server Notion chính thức. (Nguồn)
• Đánh giá của con người: Đạt độ chính xác 83%+ trên hơn 2k bộ đánh giá truy vấn thực tế

Các bước tiếp theo

Tạo server Strata đầu tiên của bạn trong vài phút 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.