MCP Tools Reference: paydeveloper.googleapis.com

Araç: search_documentation

Resmi Google Pay ve Google Cüzdan geliştirici belgelerindeki ve kod örneklerindeki en alakalı ve güncel bölümleri arar ve alır.

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

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

Giriş Şeması

Belgelerde arama yapmak için mesaj isteği.

SearchDocumentationRequest

JSON gösterimi 
{
  "userQuery": string,
  "languageCode": string
}
Alanlar
userQuery

string

Zorunlu. Aranacak sorgu.
languageCode

string

İsteğe bağlı. Arama sorgusunun IETF BCP-47 dil kodu.

Çıkış şeması

Belge arama için yanıt mesajı.

SearchDocumentationResponse

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

object (DocumentChunk)

Arama sorgusuyla eşleşen ve kullanıcının sorgusu ile parçanın içeriği arasındaki benzerliği değerlendiren bir alaka düzeyi puanı kullanılarak sıralanan belge parçaları.

DocumentChunk

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

string

Parçanın ait olduğu belgenin başlığını belirtir.
uri

string

Parçanın ait olduğu dokümanın URI'sini belirtir.
content

string

Parçanın içeriğini barındırır.

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