MCP Tools Reference: developerknowledge.googleapis.com

Araç: search_documents

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

  • Android: developer.android.com
  • Apigee: docs.apigee.com
  • Chrome: developer.chrome.com
  • Firebase: firebase.google.com
  • Fuchsia: fuchsia.dev
  • Google AI: ai.google.dev
  • Google Cloud: docs.cloud.google.com
  • Google Developers, Ads, Search, Google Haritalar, YouTube: developers.google.com
  • Google Home: developers.home.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 örnekte, curl kullanılarak search_documents MCP aracının nasıl çağrı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ış. Bu parçanın doküman içindeki 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ı

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