MCP Tools Reference: developerknowledge.googleapis.com

Araç: search_documents

Google geliştirici ürünleriyle ilgili dokümanları bulmak için bu aracı kullanın. Belgelerde resmi API'ler, kod snippet'leri, sürüm notları, en iyi uygulamalar, kılavuzlar, hata ayıklama bilgileri ve daha fazlası yer alır. Aşağıdaki ürünler ve alanlar bu kapsamdadır:

  • ADK: adk.dev

  • Android: developer.android.com

  • Apigee: docs.apigee.com

  • Chrome: developer.chrome.com

  • Dart: dart.dev

  • Firebase: firebase.google.com

  • Flutter: docs.flutter.dev

  • Fuchsia: fuchsia.dev

  • Gemini CLI: geminicli.com

  • Go: go.dev

  • Google AI: ai.google.dev

  • Google Antigravity: antigravity.google

  • Google Cloud: cloud.google.com ve docs.cloud.google.com

  • Google Developers, Ads, Search, Google Maps, YouTube: developers.google.com

  • Google Home: developers.home.google.com

  • Google Haritalar Platformu: mapsplatform.google.com

  • TensorFlow: www.tensorflow.org

  • Web: web.dev

Bu araç, eşleşen belgeler için metin parçaları, adlar ve URL'ler döndürür. Döndürülen parçalar, kullanıcının sorusunu yanıtlamak için yeterince ayrıntılı değilse tam belge içeriğini almak üzere bu aracın çıktısındaki parent ile birlikte get_documents kullanın.

Aşağıdaki kod örneğinde, search_documents MCP aracını çağırmak için curl simgesinin nasıl kullanılacağı gösterilmektedir.

Curl İsteği 
curl --location 'https://developerknowledge.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_documents",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş Şeması

search_documents için istek şeması. İlgili Google geliştirici belgelerini aramak için sorgu alanını kullanın.

SearchDocumentChunksRequest

JSON gösterimi 
{
  "query": string
}
Alanlar
query

string

Zorunlu. Kullanıcı tarafından sağlanan ham sorgu dizesi (ör. "Cloud Storage paketi nasıl oluşturulur?").

Çıkış şeması

search_documents için yanıt şeması.

SearchDocumentChunksResponse

JSON gösterimi 
{
  "results": [
    {
      object (DocumentChunk)
    }
  ]
}
Alanlar
results[]

object (DocumentChunk)

Belirtilen sorgunun arama sonuçları. Bu listedeki her doküman, arama sorgusuyla alakalı bir içerik snippet'i içerir. Tam belge içeriğini almak için get_documents ile her sonucun DocumentChunk.name alanını kullanın.

DocumentChunk

JSON gösterimi 
{
  "parent": string,
  "id": string,
  "content": string
}
Alanlar
parent

string

Yalnızca çıkış. Bu parçanın geldiği belgenin kaynak adı. Biçim: documents/{uri_without_scheme} Örnek: documents/docs.cloud.google.com/storage/docs/creating-buckets
id

string

Yalnızca çıkış. Dokümandaki bu parçanın kimliği. Parça kimliği, bir doküman içinde benzersizdir ancak dokümanlar arasında genel olarak benzersiz değildir. Parça kimliği sabit değildir ve zaman içinde değişebilir.
content

string

Yalnızca çıkış. Doküman parçasının içeriği.

Araç Ek Açıklamaları

Araç açıklamaları, belirli bir aracın temel riskini açıklamak için MCP istemcilerine gönderilir. Çoğu istemci bu ipuçlarını güvenilmeyen olarak değerlendirir ancak onay isteminin kullanıcıya ne zaman gönderileceğine karar vermek için kullanılabilirler.

Başlık dizesinin yanı sıra aşağıdaki Boole ipuçları şu şekilde tanımlanır:

  • readOnlyHint: Doğruysa araç ortamını değiştirmez. Varsayılan: false.
  • destructiveHint: Doğruysa araç, yıkıcı işlemler gerçekleştirebilir. Yanlış ise araç yalnızca ekleme işlemleri gerçekleştirebilir. Varsayılan: true.
  • idempotentHint: Doğruysa aynı bağımsız değişkenlerle aracı tekrar tekrar çağırmanın ortamı üzerinde ek bir etkisi olmaz. Varsayılan: false.
  • openWorldHint: Doğruysa araç, harici öğelerden oluşan bir "açık dünya" ile etkileşim kurabilir. Yanlışsa araç yalnızca dahili öğelerle etkileşim kurabilir. Örneğin, bir web arama aracı açık dünya olurken bir bellek aracı açık dünya olmaz.

Yıkıcı İpucu: ❌ | İdempotent İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌