MCP Tools Reference: developerknowledge.googleapis.com

Narzędzie: answer_query

Użyj metody answer_query, aby uzyskać powiązaną ze źródłem informacji, syntetyczną odpowiedź na ogólne pytanie dotyczące usług Google dla deweloperów. Jeśli potrzebujesz dokładnych przykładowych kodów, flag interfejsu wiersza poleceń, konkretnych komunikatów o błędach lub pełnych instrukcji dotyczących dokumentów, użyj search_documents, a następnie get_documents. To narzędzie ma ograniczony limit. To narzędzie będzie syntetyzować informacje z korpusu, aby wygenerować odpowiedź na zapytanie. answer_query opiera odpowiedzi na tym samym korpusie co search_documents. To narzędzie zwraca wygenerowany tekst odpowiedzi i listę nazw dokumentów (odniesień) użytych do wygenerowania odpowiedzi. W ostatecznej odpowiedzi dla użytkownika zawsze podawaj nazwy dokumentów źródłowych z references (documents/...). W razie potrzeby użyj get_documents z nazwami dokumentów z references, aby pobrać całą zawartość dokumentu.

Jeśli wystąpi błąd 429 (przekroczenie limitu), użyj metody search_documents.

Poniższy przykładowy kod pokazuje, jak używać curl do wywoływania narzędzia MCP answer_query.

Żą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": "answer_query",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schemat wejściowy

Wiadomość z prośbą o dostęp do: AnswerQuery.

AnswerQueryRequest

Zapis JSON 
{
  "query": string
}
Pola
query

string

Wymagane. Zapytanie, na które należy odpowiedzieć.

Schemat wyjściowy

Wiadomość z odpowiedzią dla: AnswerQuery.

AnswerQueryResponse

Zapis JSON 
{
  "answerText": string,
  "references": [
    string
  ]
}
Pola
answerText

string

Odpowiedź na zapytanie.
references[]

string

Tylko dane wyjściowe. Nazwy zasobów dokumentów użytych do wygenerowania odpowiedzi (np. documents/docs.cloud.google.com/storage/docs/creating-buckets). Zacytuj te nazwy zasobów w ostatecznej odpowiedzi i przekaż je do get_documents, jeśli potrzebna jest pełna treść dokumentu.

Adnotacje dotyczące narzędzi

Adnotacje narzędzi 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 wysłać użytkownikowi 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. Wartość domyślna: 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 dodawania. Wartość domyślna: 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. Wartość domyślna: 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 encjami wewnętrznymi. Na przykład narzędzie do wyszukiwania w internecie jest narzędziem typu Otwarty świat, a narzędzie do zapamiętywania – nie.

Wskazówka dotycząca niszczenia: ❌ | Wskazówka dotycząca idempotencji: ✅ | Wskazówka dotycząca tylko do odczytu: ✅ | Wskazówka dotycząca otwartego świata: ❌