OpenAI API 웹 검색에서 새 웹페이지를 가져오지 않게 할 수 있나요? 초보자 캐시 전용 설정법

external_web_access
웹 검색 도구가 새 외부 콘텐츠를 가져올지 정하는 불리언 값입니다.

캐시·색인 결과
캐시 전용 모드에서 사용하는 검색 자료입니다. 내 앱의 이전 답변 저장소와 다릅니다.

web_search_preview
이 설정을 무시하는 미리보기 도구입니다. web_search와 혼동하지 마세요.

1단계. 현재 요청의 검색 도구를 확인합니다.
이미 동작하는 Responses 요청에서 모델의 웹 검색 지원과 tools의 type을 읽으세요. web_search_preview라면 해당 설정을 무시한다는 공식 제한부터 확인합니다. 연습에는 비밀 정보나 내부 주소를 넣지 않습니다.

2단계. web_search 객체 안에 값을 넣습니다.
기존 tools의 검색 객체를 {"type": "web_search", "external_web_access": false} 처럼 구성하세요. JSON에서는 false, Python 딕셔너리에서는 False를 씁니다. 최상위 요청에 같은 이름을 새로 붙이지 말고 모델·질문·나머지 설정은 유지합니다.

3단계. 호출과 인용을 나눠 확인합니다.
실제로 보낸 설정을 기록하고 완료 응답의 output에서 web_search_call과 action을 확인하세요. 도구를 등록했어도 검색하지 않을 수 있습니다. 검색한 답변의 인용을 열어 사실과 날짜를 대조하고, 검색이 없으면 캐시 검색을 확인했다고 기록하지 않습니다.

위험 신호 1
offline이라는 표현을 보고 API 요청도 인터넷 없이 된다고 생각합니다. 이 값은 웹 검색 도구의 새 외부 콘텐츠 접근을 제어하며 앱의 네트워크 전체를 끄는 설정이 아닙니다.

위험 신호 2
캐시 전용이니 최신 공지까지 모두 반영되거나 같은 답이 매번 나온다고 가정합니다. 자료의 시점과 근거를 직접 확인하고 결과가 없다는 이유만으로 정보가 없다고 단정하지 마세요.

위험 신호 3
이 설정을 개인정보 보관 정책이나 무료 검색 옵션으로 봅니다. API 입력·로그·접근 권한은 따로 관리하고 검색 호출과 사용량도 확인하세요. 사용자에게 표시할 인용은 클릭할 수 있게 유지합니다.

설정 확인은 공식 웹 문서에서

Web search의 Live internet access와 Responses의 WebSearch 객체를 함께 읽으세요. ChatGPT 웹사이트의 검색 버튼을 끄는 절차나 Codex CLI의 검색 옵션과는 다릅니다.

실제 점검은 API 개발 환경에서

앱이 전송하는 tools 설정과 반환된 검색 항목을 나란히 보세요. 휴대전화 앱도 같은 API 요청을 쓰면 같은 필드를 지정합니다. 키와 원문 자료는 공개 로그에서 빼고 시험 결과를 최신성 보장으로 설명하지 않습니다.