MCP Tools Reference: developerknowledge.googleapis.com

Araç: get_documents

Tek bir belgenin veya tek bir çağrıda en fazla 20 belgenin tam içeriğini almak için bu aracı kullanın. Doküman adları, search_documents aracına yapılan bir çağrıdan elde edilen sonuçların parent alanından veya answer_query aracının döndürdüğü references alanından alınmalıdır. names parametresini bir belge adı listesi (documents/...) olarak ayarlayın ve nihai yanıtınızda kullanılan yetkili kaynak belgelere atıfta bulunun.

Aşağıdaki kod örneğinde, get_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": "get_documents",
    "arguments": {
      // Provide these details according to the MCP tool 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 sonuçlarının parent alanı veya answer_query'nin references alanı 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ı. Dokümanın 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ış. Dokümanın başlığı.

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 olurken bellek aracı açık dünya olmaz.

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