도구와 리소스 탐색하기

클라이언트는 서버가 무엇을 할 수 있는지 절대 추측해서는 안 됩니다. 연결되면 서버에 항목을 나열해 달라고 요청하여 사용 가능한 기능을 검색합니다.

session.list_tools()를 호출하면 서버가 제공하는 모든 도구가 반환되며, 코드에서 이를 살펴볼 수 있습니다.

결과에는 도구 목록이 포함됩니다. 각 항목에는 이름과 사람이 읽을 수 있는 설명이 있어 해당 도구의 기능을 파악할 수 있습니다.

모든 도구는 허용하는 인수를 설명하는 JSON 스키마인 inputSchema도 제공합니다. 이를 통해 무엇을 보내야 하는지 알 수 있습니다.

서버는 읽기 전용 데이터도 제공할 수 있습니다. session.list_resources()를 호출하여 읽을 수 있는 리소스 집합을 가져옵니다.

각 리소스는 파일 경로나 사용자 지정 스킴과 같은 URI로 지정됩니다. 나중에 이 URI를 사용하여 콘텐츠를 가져옵니다.

세 번째 기본 요소는 프롬프트입니다. session.list_prompts()는 서버가 게시한 재사용 가능한 지침 템플릿을 보여 줍니다.

핸드셰이크에서 서버가 알린 항목만 가져올 수 있습니다. 서버가 리소스를 선언하지 않았다면 리소스를 나열해도 빈 집합이 반환됩니다.

검색을 사용하면 클라이언트가 실행 중에 적응할 수 있습니다. 새 서버를 연결하면 클라이언트 코드를 변경하지 않아도 해당 서버의 도구가 그대로 나타납니다.

검색한 도구 이름, 설명, 스키마는 나중에 요청에 적합한 도구를 결정하는 데 모델에 꼭 필요한 정보입니다.

도구 목록은 변경될 수 있으므로 신중한 클라이언트는 오래된 스냅샷을 신뢰하기보다 업데이트 알림을 받은 후 다시 나열할 수 있습니다.

실행 중에 서버를 검색하는 방법을 배웠습니다. 서버의 도구, 리소스, 프롬프트를 나열한 다음 행동하기 전에 각각의 이름, 설명, 스키마를 읽습니다.