MCP Tools Reference: developerknowledge.googleapis.com

Narzędzie: search_documents

Użyj tego narzędzia, aby znaleźć dokumentację produktów Google dla programistów. Dokumenty zawierają oficjalne interfejsy API, fragmenty kodu, informacje o wersji, sprawdzone metody, przewodniki, informacje o debugowaniu i inne. Obejmuje te produkty i domeny:

  • ADK: adk.dev

  • Android: developer.android.com

  • Apigee: docs.apigee.com

  • Chrome: developer.chrome.com

  • Dart: dart.dev

  • Firebase: firebase.google.com

  • Flutter: docs.flutter.dev

  • Fuchsia: fuchsia.dev

  • Gemini CLI: geminicli.com

  • Go: go.dev

  • Google AI: ai.google.dev

  • Google Antigravity: antigravity.google

  • Google Cloud: cloud.google.com i docs.cloud.google.com

  • Google Developers, Ads, Search, Google Maps, YouTube: developers.google.com

  • Google Home: developers.home.google.com

  • Google Maps Platform: mapsplatform.google.com

  • TensorFlow: www.tensorflow.org

  • Web: web.dev

To narzędzie zwraca fragmenty tekstu, nazwy i adresy URL pasujących dokumentów. Jeśli zwrócone fragmenty nie są wystarczająco szczegółowe, aby odpowiedzieć na pytanie użytkownika, użyj narzędzia get_documents z parametrem parent z danych wyjściowych tego narzędzia, aby pobrać pełną treść dokumentu.

Poniższy przykładowy kod pokazuje, jak użyć narzędzia curl do wywołania narzędzia MCP search_documents.

Żądanie Curl 
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
}'

Schemat wejściowy

Schemat żądania dla narzędzia search_documents. Użyj pola zapytania, aby wyszukać powiązaną dokumentację Google dla programistów.

SearchDocumentChunksRequest

Zapis JSON 
{
  "query": string
}
Pola
query

string

Wymagane. Surowy ciąg zapytania podany przez użytkownika, np. „Jak utworzyć zasobnik Cloud Storage?”.

Schemat wyjściowy

Schemat odpowiedzi dla narzędzia search_documents.

SearchDocumentChunksResponse

Zapis JSON 
{
  "results": [
    {
      object (DocumentChunk)
    }
  ]
}
Pola
results[]

object (DocumentChunk)

Wyniki wyszukiwania dla danego zapytania. Każdy dokument na tej liście zawiera fragment treści związany z zapytaniem. Aby pobrać pełną treść dokumentu, użyj pola DocumentChunk.name każdego wyniku z narzędziem get_documents.

DocumentChunk

Zapis JSON 
{
  "parent": string,
  "id": string,
  "content": string
}
Pola
parent

string

Tylko dane wyjściowe. Nazwa zasobu dokumentu, z którego pochodzi ten fragment. Format: documents/{uri_without_scheme} Przykład: documents/docs.cloud.google.com/storage/docs/creating-buckets
id

string

Tylko dane wyjściowe. Identyfikator tego fragmentu w dokumencie. Identyfikator fragmentu jest unikalny w ramach dokumentu, ale nie jest unikalny globalnie w różnych dokumentach. Identyfikator fragmentu nie jest stały i może się zmieniać w czasie.
content

string

Tylko dane wyjściowe. Treść fragmentu dokumentu.

Adnotacje narzędzia

Adnotacje narzędzia są wysyłane do klientów MCP, aby opisać podstawowe ryzyko związane z danym narzędziem. Większość klientów traktuje te wskazówki jako niezaufane, ale można ich użyć do określenia, kiedy należy wysłać do użytkownika prośbę o potwierdzenie.

Oprócz ciągu tytułu zdefiniowane są te wskazówki logiczne:

  • readOnlyHint: jeśli ma wartość true, narzędzie nie modyfikuje swojego środowiska. Domyślnie: false.
  • destructiveHint: jeśli ma wartość true, narzędzie może wykonywać działania destrukcyjne. Jeśli ma wartość false, narzędzie może wykonywać tylko działania dodające. Domyślnie: true.
  • idempotentHint: jeśli ma wartość true, wielokrotne wywoływanie narzędzia z tymi samymi argumentami nie będzie miało dodatkowego wpływu na jego środowisko. Domyślnie: false.
  • openWorldHint: jeśli ma wartość true, narzędzie może wchodzić w interakcje z „otwartym światem” podmiotów zewnętrznych. Jeśli ma wartość false, narzędzie może wchodzić w interakcje tylko z podmiotami wewnętrznymi. Na przykład narzędzie do wyszukiwania w internecie będzie narzędziem typu „otwarty świat”, a narzędzie do zarządzania pamięcią nie.

Wskazówka dotycząca działań destrukcyjnych: ❌ | Wskazówka dotycząca działań idempotentnych: ✅ | Wskazówka dotycząca działań tylko do odczytu: ✅ | Wskazówka dotycząca otwartego świata: ❌