MCP Tools Reference: developerknowledge.googleapis.com

도구: answer_query

answer_query를 사용하여 Google Developers 제품에 관한 개략적인 질문에 대해 그라운딩된 종합적인 개념적 답변을 얻습니다. 정확한 코드 샘플, CLI 플래그, 특정 오류 메시지 또는 전체 문서 둘러보기를 보려면 search_documents 다음에 get_documents를 사용하세요. 이 도구에는 할당량이 제한되어 있습니다. 이 도구는 코퍼스의 정보를 합성하여 쿼리에 대한 답변을 생성합니다. answer_query는 search_documents와 동일한 코퍼스를 사용하여 답변을 그라운딩합니다. 이 도구는 생성된 answer_text와 답변을 생성하는 데 사용된 문서 이름 (참조) 목록을 반환합니다. 사용자에게 제공하는 최종 대답에는 항상 references (documents/...)의 공신력 있는 소스 문서 이름을 인용하세요. 필요한 경우 references의 문서 이름과 함께 get_documents를 사용하여 전체 문서 콘텐츠를 가져옵니다.

429 할당량 초과 오류가 발생하면 대신 search_documents를 사용하세요.

다음 코드 샘플은 curl를 사용하여 answer_query MCP 도구를 호출하는 방법을 보여줍니다.

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
}'

입력 스키마

AnswerQuery에 대한 요청 메시지입니다.

AnswerQueryRequest

JSON 표현 
{
  "query": string
}
필드
query

string

필수 항목입니다. 답변할 질문입니다.

출력 스키마

AnswerQuery의 응답 메시지입니다.

AnswerQueryResponse

JSON 표현 
{
  "answerText": string,
  "references": [
    string
  ]
}
필드
answerText

string

쿼리에 대한 답변입니다.
references[]

string

출력 전용입니다. 답변을 생성하는 데 사용된 문서의 리소스 이름 (예: documents/docs.cloud.google.com/storage/docs/creating-buckets)입니다. 최종 대답에서 이러한 리소스 이름을 인용하고 전체 문서 콘텐츠가 필요한 경우 get_documents에 전달합니다.

도구 주석

도구 주석은 MCP 클라이언트에 전송되어 특정 도구의 기본 위험을 설명합니다. 대부분의 클라이언트는 이러한 힌트를 신뢰할 수 없는 것으로 취급하지만, 확인 메시지를 사용자에게 보낼 시기를 결정하는 데 사용할 수 있습니다.

제목 문자열과 함께 다음 불리언 힌트가 정의됩니다.

  • readOnlyHint: true인 경우 도구가 환경을 수정하지 않습니다. 기본값: false.
  • destructiveHint: true인 경우 도구에서 파괴적인 작업을 수행할 수 있습니다. false이면 도구는 추가 작업만 수행할 수 있습니다. 기본값은 true입니다.
  • idempotentHint: true인 경우 동일한 인수로 도구를 반복적으로 호출해도 환경에 추가적인 영향을 미치지 않습니다. 기본값: false.
  • openWorldHint: true인 경우 도구는 외부 항목의 '오픈 월드'와 상호작용할 수 있습니다. false이면 도구는 내부 항목과만 상호작용할 수 있습니다. 예를 들어 웹 검색 도구는 오픈 월드이지만 메모리 도구는 오픈 월드가 아닙니다.

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌