MCP Tools Reference: developerknowledge.googleapis.com

Narzędzie: answer_query

Użyj narzędzia answer_query, aby uzyskać odpowiedź na zapytanie dotyczące produktów Google dla deweloperów. To narzędzie ma ograniczony limit. To narzędzie będzie syntetyzować informacje z korpusu, aby wygenerować odpowiedź na zapytanie. Narzędzie answer_query opiera odpowiedzi na tym samym korpusie co narzędzie search_documents. To narzędzie zwraca wygenerowaną odpowiedź answer_text i listę nazw dokumentów (odniesień) użytych do wygenerowania odpowiedzi. Jeśli to konieczne, użyj narzędzia get_documents z nazwami dokumentów, aby pobrać całą zawartość dokumentu.

Jeśli otrzymasz błąd 429 z powodu przekroczenia limitu, użyj narzędzia search_documents.

Poniższy przykładowy kod pokazuje, jak użyć narzędzia curl, aby wywołać narzędzie 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 tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schemat danych wejściowych

Wiadomość żądania dla narzędzia AnswerQuery.

AnswerQueryRequest

Zapis JSON 
{
  "query": string
}
Pola
query

string

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

Schemat danych wyjściowych

Wiadomość odpowiedzi dla narzędzia 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.

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 destrukcyjna: ❌ | Wskazówka idempotentna: ✅ | Wskazówka tylko do odczytu: ✅ | Wskazówka dotycząca otwartego świata: ❌