Klavis Strata

Strata

Yapay zeka ajanlarının her ölçekte araçları aşamalı olarak kullanabilmesi için tek bir MCP sunucusu

<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 Nedir?

Strata, yapay zeka ajanlarının araçları her karmaşıklık seviyesinde güvenilir şekilde kullanmasını sağlayan tek bir MCP sunucusudur. Ajanları her şeyle aynı anda boğmak yerine, insanların araçlarla etkileşim biçimi düşünülerek tasarlanmıştır ve günümüzde yapay zeka ajanlarını etkileyen üç büyük sorunu çözer:

• Araç Aşırı Yükü: Çok fazla araç, LLM'de seçim felcine neden olur
• Bağlam Aşırı Yükü: Uzun araç listeleri token sayısını ve maliyetleri artırır
• Kapsam Boşluğu: Çoğu sunucu 40~50 araçta takılı kalır ve neler inşa edebileceğinizi sınırlar

Strata'yı web sitemiz, API veya hatta kendi verileriniz üzerinde açık kaynak olarak kullanabilirsiniz!

Video Eğitimi

Strata'nın nasıl çalıştığını tam olarak anlamak için bu video eğitimini izleyin:

Metin Eğitimi

İpucu

Strata'yı çalışırken görmek için bu paylaşılan Claude konuşmasına göz atın!

1. Sunucu Kategorilerini veya Eylemlerini Keşfedin

discover_server_categories_or_actions - kullanıcı niyetine göre ilgili kategorileri veya eylemleri bulun. Anlamsal arama yok!

**Açıklama**: **TERCİH EDİLEN BAŞLANGIÇ NOKTASI**. Kullanıcı sorgusuna göre mevcut kategorileri veya eylemleri keşfedin. Sunucular arasında hangi eylemlerin mevcut olduğunu keşfederken önce bu aracı deneyin. Bu, mevcut eylemleri keşfetmek için birincil giriş noktasıdır ve diğer arama yöntemlerinden önce kullanılmalıdır. Çıktı, ayrıntı düzeyi ve ayrıntılarla birlikte sunucuların bir listesi olacaktır.

Ayrıntı düzeyi 'categories_only' ise, ayrıntılar yalnızca kategori adlarının bir listesi olacaktır. Sonraki adımda kategoriler için eylemleri almak üzere get_category_actions aracını kullanmayı tercih edin.

Ayrıntı düzeyi 'full_details' ise, ayrıntılar kategori adlarının ve eylem ayrıntılarının dahil olduğu bir liste olacaktır. Bu, sunucunun yalnızca birkaç eylemi olduğunda gerçekleşir. Sonraki adımda eylemleri yürütmek için execute_action aracını kullanmayı tercih edin.

Ayrıntı düzeyi 'categories_and_actions' ise, ayrıntılar kategori adlarının ve eylem adlarının bir listesi olacaktır. Bu, harici araçlar kullanıldığında gerçekleşir. Sonraki adımda eylemlerin ayrıntılarını almak için get_action_details aracını kullanmayı tercih edin.

Parametreler:

• user_query (string, zorunlu): Sonuçları filtrelemek için doğal dil kullanıcı sorgusu.
• server_names (dizi, zorunlu): Kategorileri veya eylemleri keşfetmek için sunucu adlarının listesi.

2. Kategori Eylemlerini Alın

get_category_actions - belirtilen kategorilerdeki tüm eylem adlarını alın.

**Açıklama**: Belirli kategorilerde bulunan API eylemlerine kapsamlı bir genel bakış edinin. Belirli hizmet kategorilerinde hangi eylemlerin mevcut olduğunu keşfetmek veya kategori yeteneklerinin ayrıntılı bir görünümünü almak istiyorsanız bu aracı kullanın. \*\* Önemli \*\*: Yalnızca discover_server_categories aracından sunucu kategorilerini aldıktan sonra çağrılmalıdır.

Parametreler:

• category_names (dizi, zorunlu): Eylemlerin alınacağı kategorilerin listesi

3. Eylem Ayrıntılarını Alın

get_action_details - belirli bir eylem için tam şemayı ve parametreleri alın.

**Açıklama**: Zorunlu ve isteğe bağlı parametreler dahil olmak üzere belirli bir eylem hakkında ayrıntılı bilgi edinin. Kategori adı ve eylem adı sağlanmalıdır. \*\* Önemli \*\*: Yalnızca önceki araç çağrılarından sunucu kategorilerini aldıktan sonra çağrılmalıdır.

Parametreler:

• category_name (string, zorunlu): Kategorinin adı
• action_name (string, zorunlu): Kategori içindeki eylemin/işlemin adı

4. Eylemi Yürütün

execute_action - parametrelerle eylemleri çalıştırın ve sonuçları alın.

**Açıklama**: Sağlanan parametrelerle belirli bir eylemi yürütün. Sunucu adı, eylem adı ve eylem parametreleri sağlanmalıdır. \*\* Önemli \*\*: Yalnızca get_action_details aracından eylem ayrıntılarını aldıktan sonra çağrılmalıdır.

Parametreler:

• server_name (string, zorunlu): Sunucunun adı
• category_name (string, zorunlu): Eylemin yürütüleceği kategorinin adı
• action_name (string, zorunlu): Yürütülecek eylemin/işlemin adı
• path_params (string, isteğe bağlı): Eylem için yol parametrelerini içeren JSON dizesi
• query_params (string, isteğe bağlı): Eylem için sorgu parametrelerini içeren JSON dizesi
• body_schema (string, isteğe bağlı, varsayılan: "{}"): Eylemler için istek gövdesini içeren JSON dizesi
• include_output_fields (dizi, isteğe bağlı): Önceki araç çağrılarından bu eylemin response_schema'sını biliyorsanız isteğe bağlı ancak güçlü şekilde önerilir: Yanıta dahil edilecek alan yollarının dizisi. Yalnızca bu alanlar döndürülür. İç içe alanlar için nokta gösterimi kullanın (ör. "author.displayName").
• maximum_output_characters (tamsayı, isteğe bağlı): İsteğe bağlı: Yanıtta döndürülecek maksimum karakter sayısı. Yanıt bu sınırı aşarsa kısaltılır. Bunun yerine include_output_fields'ı tercih edin.

5. Dokümantasyonu Arayın

search_documentation - yalnızca gerektiğinde ilgili bilgileri bulun.

**Açıklama**: **İKİNCİL SEÇENEK**: Bu aracı yalnızca discover_server_categories yeterli ayrıntı sağlamadığında veya belirli bir sunucunun dokümantasyonu içinde arama yapmanız gerektiğinde kullanın. Anahtar kelime eşleştirme kullanarak kategori, işlem, etiket veya işlevselliğe göre sunucu eylem dokümantasyonlarını arayın. Bu doğal dil araması değildir - tam anahtar kelimeleri ve ifadeleri eşleştirir. Alaka düzeyine göre sıralanmış uç noktaları döndürür. En iyi eşleşmeleri bulmak için birkaç hedefli anahtar kelime kullanın. Yaygın kalıplar: kategori adları ('projects', 'users', 'pipelines'), eylemler ('create', 'delete', 'list', 'get') veya kombinasyonlar ('create user', 'list projects'). Arama algoritması, ayrıntılı açıklama alanlarının sonuçları boğmasını önlemek için akıllı puanlama kullanır.

Parametreler:

• query (string, zorunlu): API dokümantasyon terimleriyle eşleşen arama anahtar kelimeleri. En iyi uygulamalar: (1) 'users', 'projects', 'files' gibi kaynak adlarını kullanın, (2) Hassasiyet için 'user create' veya 'project delete' gibi eylemler ekleyin, (3) 'how to', 'show me', 'all the' gibi dolgu kelimelerinden kaçının - uç nokta adlarında ve açıklamalarında görünen temel terimlere odaklanın.
• server_name (string, zorunlu): İçinde arama yapılacak sunucunun adı.
• max_results (tamsayı, isteğe bağlı, varsayılan: 10, minimum: 1, maksimum: 50): Döndürülecek sonuç sayısı. Varsayılan: 10

6. Kimlik Doğrulama Hatasını Ele Alın

handle_auth_failure - kimlik doğrulamayı yalnızca gerektiğinde ele alın.

**Açıklama**: Eylemleri yürütürken oluşan kimlik doğrulama hatalarını ele alın. KRİTİK: Bu araç YALNIZCA execute_action özellikle kimlik doğrulama sorunları nedeniyle başarısız olduğunda çağrılmalıdır (401 Yetkisiz, geçersiz kimlik bilgileri, süresi dolmuş belirteçler vb.). Kimlik doğrulama durumunu kontrol etmek veya başka herhangi bir amaç için bu aracı ÇAĞIRMAYIN. Kullanım: (1) execute_action bir kimlik doğrulama hatası döndürdüğünde, kimlik doğrulama talimatlarını almak için bu aracı 'get_auth_url' ile çağırın. (2) Kullanıcı bir hatadan sonra kimlik doğrulama verisi sağladığında, kimlik bilgilerini kaydetmek için bu aracı 'save_auth_data' ile çağırın. Hata bir kimlik doğrulama hatası değilse (ör. 404 Bulunamadı, 500 İç Sunucu Hatası vb.) bu aracı ASLA çağırmayın.

Parametreler:

• server_name (string, zorunlu): execute_action sırasında kimlik doğrulaması başarısız olan sunucunun adı
• intention (string, zorunlu, enum: ["get_auth_url", "save_auth_data"]): execute_action kimlik doğrulama hatalarıyla başarısız olduğunda kimlik doğrulama talimatlarını almak için 'get_auth_url' kullanın. Kullanıcı bir kimlik doğrulama hatasından sonra kimlik doğrulama kimlik bilgileri sağladığında 'save_auth_data' kullanın.
• auth_data (nesne, isteğe bağlı): Kullanıcı tarafından bir kimlik doğrulama hatasından sonra sağlanan kimlik doğrulama verisi (ör. {"token": "...", "api_key": "..."}). Yalnızca kimlik doğrulama hatalarını çözerken 'save_auth_data' niyetiyle kullanılır.

Değerlendirme

Strata gerçek sonuçlar sunar:

• MCPMark Karşılaştırması: Resmi GitHub sunucusuna kıyasla +15,2% daha yüksek pass@1 oranı ve resmi Notion sunucusuna kıyasla +13,4% daha yüksek pass@1 oranı elde eder. (Kaynak)
• İnsan Değerlendirmesi: >2 bin gerçek dünya sorgusu değerlendirme setinde %83+ doğruluk oranına ulaşır

Sonraki Adımlar

İlk Strata sunucunuzu dakikalar içinde oluşturun Kapsamlı Strata API'sini keşfedin

Bu dokümantasyon, bir geliştirici dokümantasyon platformu olan Mintlify üzerinde oluşturulmuş ve barındırılmaktadır.