MCP Tools Reference: developerknowledge.googleapis.com

Araç: answer_query

Google Developers ürünleriyle ilgili üst düzey bir soruya kaynağa dayalı, sentezlenmiş kavramsal bir yanıt almak için answer_query'yi kullanın. Tam kod örnekleri, CLI işaretleri, belirli hata mesajları veya tam doküman açıklamaları için search_documents ve ardından get_documents kullanmayı tercih edin. Bu aracın kotası sınırlıdır. Bu araç, sorguya yanıt oluşturmak için derlemdeki bilgileri sentezler. answer_query, yanıtları search_documents ile aynı derlemi kullanarak temellendirir. Bu araç, oluşturulan answer_text değerini ve yanıtı oluşturmak için kullanılan doküman adlarının (referanslar) listesini döndürür. Kullanıcıya vereceğiniz nihai yanıtta her zaman references (documents/...) içindeki yetkili kaynak doküman adlarından alıntı yapın. Gerekirse tüm doküman içeriğini almak için references adresindeki doküman adlarıyla get_documents kullanın.

Kota dışında 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 öğ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": "answer_query",
    "arguments": {
      // Provide these details according to the MCP tool 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 belgelerin kaynak adları (ör. documents/docs.cloud.google.com/storage/docs/creating-buckets). Bu kaynak adlarını nihai yanıtta belirtin ve tam belge içeriği gerekiyorsa get_documents aracına iletin.

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