MCP Tools Reference: developerknowledge.googleapis.com

Araç: get_documents

Tek bir dokümanın veya tek bir çağrıda en fazla 20 dokümanın tam içeriğini almak için bu aracı kullanın. Belge adları, search_documents aracına yapılan bir çağrının sonuçlarındaki parent alanından alınmalıdır. names parametresini bir doküman adı listesine ayarlayın.

Aşağıdaki kod örneğinde, get_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": "get_documents",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş Şeması

get_documents için istek şeması.

GetDocumentsRequest

JSON gösterimi 
{
  "names": [
    string
  ]
}
Alanlar
names[]

string

Zorunlu. search_documents tarafından döndürülen, alınacak dokümanların adları. Tek bir çağrıda en fazla 20 belge alınabilir. Dokümanlar, istekteki names ile aynı sırada döndürülür. Biçim: documents/{uri_without_scheme} Örnek: documents/docs.cloud.google.com/storage/docs/creating-buckets

Çıkış şeması

get_documents için yanıt şeması.

GetDocumentsResponse

JSON gösterimi 
{
  "documents": [
    {
      object (Document)
    }
  ]
}
Alanlar
documents[]

object (Document)

Belgeler istendi.

Doküman

JSON gösterimi 
{
  "name": string,
  "uri": string,
  "content": string,
  "description": string,
  "title": string
}
Alanlar
name

string

Tanımlayıcı. Belgenin kaynak adı. Biçim: documents/{uri_without_scheme} Örnek: documents/docs.cloud.google.com/storage/docs/creating-buckets
uri

string

Yalnızca çıkış. İçeriğin URI'si (ör. https://cloud.google.com/storage/docs/creating-buckets).
content

string

Yalnızca çıkış. Dokümanın Markdown biçimindeki içeriği.
description

string

Yalnızca çıkış. Belgenin açıklaması.
title

string

Yalnızca çıkış. Belgenin başlığı.

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: ❌