Araç: search_documents
Google geliştirici ürünleriyle ilgili dokümanları bulmak için bu aracı kullanın. Belgeler; resmi API'ler, kod snippet'leri, sürüm notları, en iyi uygulamalar, kılavuzlar, hata ayıklama bilgileri ve daha fazlasını içerir. Aşağıdaki ürünler ve alanlar kapsamındadır:
- Android: developer.android.com
- Apigee: docs.apigee.com
- Chrome: developer.chrome.com
- Firebase: firebase.google.com
- Fuchsia: fuchsia.dev
- Google AI: ai.google.dev
- Google Cloud: docs.cloud.google.com
- Google Developers, Ads, Search, Google Haritalar, YouTube: developers.google.com
- Google Home: developers.home.google.com
- TensorFlow: www.tensorflow.org
- Web: web.dev
Bu araç, eşleşen belgeler için metin parçaları, adlar ve URL'ler döndürür. Döndürülen parçalar, kullanıcının sorusunu yanıtlamak için yeterince ayrıntılı değilse tam belge içeriğini almak üzere bu aracın çıktısındaki parent ile birlikte get_documents kullanın.
Aşağıdaki örnekte, curl kullanılarak search_documents MCP aracının nasıl çağrı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": "search_documents", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
Giriş Şeması
search_documents için istek şeması. İlgili Google geliştirici belgelerini aramak için sorgu alanını kullanın.
SearchDocumentChunksRequest
| JSON gösterimi |
|---|
{ "query": string } |
| Alanlar | |
|---|---|
query |
Zorunlu. Kullanıcı tarafından sağlanan ham sorgu dizesi (ör. "Cloud Storage paketi nasıl oluşturulur?"). |
Çıkış şeması
search_documents için yanıt şeması.
SearchDocumentChunksResponse
| JSON gösterimi |
|---|
{
"results": [
{
object ( |
| Alanlar | |
|---|---|
results[] |
Belirtilen sorgunun arama sonuçları. Bu listedeki her doküman, arama sorgusuyla alakalı bir içerik snippet'i içerir. Tam belge içeriğini almak için get_documents ile her sonucun DocumentChunk.name alanını kullanın. |
DocumentChunk
| JSON gösterimi |
|---|
{ "parent": string, "id": string, "content": string } |
| Alanlar | |
|---|---|
parent |
Yalnızca çıkış. Bu parçanın geldiği belgenin kaynak adı. Biçim: |
id |
Yalnızca çıkış. Bu parçanın doküman içindeki kimliği. Parça kimliği, bir doküman içinde benzersizdir ancak dokümanlar arasında genel olarak benzersiz değildir. Parça kimliği sabit değildir ve zaman içinde değişebilir. |
content |
Yalnızca çıkış. Doküman parçasının içeriği. |
Araç Ek Açıklamaları
Yıkıcı İpucu: ❌ | İdempotent İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌