MCP Tools Reference: developerknowledge.googleapis.com

Araç: search_documents

Google Developers ürünleriyle ilgili belgeleri 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ünleri ve alanları kapsar:

  • 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

  • Genkit: genkit.dev

  • 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 Haritalar, YouTube: developers.google.com

  • Google Home: developers.home.google.com

  • Google Haritalar Platformu: mapsplatform.google.com

  • Google Workspace: knowledge.workspace.google.com

  • TensorFlow: www.tensorflow.org

  • Web: web.dev

Bu araç, eşleşen dokümanlar için metin parçaları, adlar ve URI'ler döndürür. Tam kod örnekleri, CLI işaretleri, belirli hata mesajları, tam eğitim adımları veya kesin anahtar kelime araması gerektiğinde search_documents ve ardından get_documents kullanın. Döndürülen parçalar kullanıcının sorusunu yanıtlayacak kadar ayrıntılı değilse bu aracın çıkışındaki parent ile get_documents aracını kullanarak belgenin tüm içeriğini alın. Kullanıcıya yanıt verirken her zaman yetkili kaynak doküman kaynak adlarını (documents/...) veya URI'larını belirtin.

Aşağıdaki kod örneğinde, search_documents MCP aracını çağırmak için curl öğesinin 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 MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş Şeması

search_documents için istek şeması. İlgili Google geliştirici belgelerini aramak için query 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)

Belirli bir sorgu için arama sonuçları. Bu listedeki her DocumentChunk, arama sorgusuyla alakalı bir içerik snippet'i içerir. Doküman içeriğinin tamamını almak için her sonucun DocumentChunk.parent alanını get_documents ile kullanın.

DocumentChunk

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

string

Yalnızca çıkış. Bu parçanın ait olduğu dokümanın kaynak adı. Biçim: documents/{uri_without_scheme} Örnek: documents/docs.cloud.google.com/storage/docs/creating-buckets
id

string

Yalnızca çıkış. Bu parçanın dokümandaki 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ç Notları

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

Başlık dizesiyle birlikte aşağıdaki boole ipuçları şu şekilde tanımlanır:

  • readOnlyHint: Doğru ise araç, ortamını değiştirmez. Varsayılan: false.
  • destructiveHint: Doğru ise 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ğru ise aracın aynı bağımsız değişkenlerle tekrar tekrar çağrılması, ortamı üzerinde ek bir etki yaratmaz. Varsayılan: false.
  • openWorldHint: Doğru ise araç, harici varlıkların "açık dünyası" ile etkileşime girebilir. Yanlış ise araç yalnızca dahili varlıklarla etkileşim kurabilir. Örneğin, web arama aracı açık dünya iken bellek aracı açık dünya değildir.

Yıkıcı İpucu: ❌ | Eşgüçlü İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌