MCP Tools Reference: developerknowledge.googleapis.com

Araç: answer_query

Google geliştirici ürünleriyle ilgili bir sorguya dayalı yanıt almak için answer_query'yi kullanın. Bu aracın kotası sınırlıdır. Bu araç, sorguya yanıt oluşturmak için topluluktaki bilgileri sentezler. answer_query, yanıtları search_documents ile aynı topluluğu kullanarak temellendirir. Bu araç, oluşturulan answer_text'i ve yanıtı oluşturmak için kullanılan doküman adlarının (referanslar) listesini döndürür. Gerekirse belgenin tamamını getirmek için belge adlarıyla birlikte get_documents işlevini kullanın.

Kota dışı 429 hatası alırsanız bunun yerine search_documents'ı kullanın.

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

Giriş Şeması

AnswerQuery için istek mesajı.

AnswerQueryRequest

JSON gösterimi 
{
  "query": string
}
Alanlar
query

string

Zorunlu. Yanıtlanacak sorgu.

Çıkış şeması

AnswerQuery için yanıt mesajı.

AnswerQueryResponse

JSON gösterimi 
{
  "answerText": string,
  "references": [
    string
  ]
}
Alanlar
answerText

string

Sorgunun yanıtı.
references[]

string

Yalnızca çıkış. Yanıtı oluşturmak için kullanılan dokümanların kaynak adları.

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