OpenAI API 파일 검색에서 특정 종류의 문서만 찾을 수 있나요? 초보자 filters 설정법

attributes
벡터 저장소에 연결된 파일에 붙이는 분류 정보입니다. 본문과는 별도입니다.

filters
Responses의 file_search 안에 넣는 검색 조건입니다. 결과 수 제한과 다릅니다.

eq
지정한 속성 값과 같은 파일을 고르는 비교 연산입니다. 우선 조건 하나부터 시험합니다.

1단계. 시험 파일의 분류와 준비 상태를 확인합니다.
민감 정보가 없는 정책·블로그 시험 자료를 고르세요. 기존 저장소와 파일 ID로 POST /v1/vector_stores/{vector_store_id}/files/{file_id} 에 {"attributes": {"category": "policy"}} 처럼 해당 파일의 분류를 보냅니다. 읽어 온 속성과 status=completed 를 확인한 뒤 검색을 진행합니다.

2단계. 파일 검색 도구에 같은 조건을 넣습니다.
기존 요청의 tools에 둔 file_search 객체에서 vector_store_ids는 유지하고 "filters": {"type": "eq", "key": "category", "value": "policy"} 를 추가하세요. key는 저장한 속성 이름, value는 비교할 값입니다. 요청 최상위나 max_num_results 안에 넣지 않습니다.

3단계. 실제로 찾은 파일과 답변을 대조합니다.
요청 최상위에 include=["file_search_call.results"] 를 추가하세요. output의 file_search_call 에서 호출 상태와 results를 보고 파일 ID·이름·attributes를 원래 자료와 비교합니다. policy 자료만 남았는지 확인하고 필요한 예외가 답변에서 빠지지 않았는지도 원문으로 검토하세요.

위험 신호 1
속성 이름·값을 실제 파일과 다르게 적습니다. 파일 이름만 보고 분류가 저장됐다고 생각하지 말고 연결된 파일의 attributes를 확인하세요.

위험 신호 2
결과가 없다는 이유로 원문에 해당 내용이 없다고 단정합니다. 분류가 잘못 붙었거나 필터 때문에 필요한 자료가 빠졌을 수도 있습니다.

위험 신호 3
필터를 접근 권한 관리로 대체합니다. 요청을 보내는 사용자의 권한은 앱에서 별도로 검증하고, 고객 자료나 비공개 검색 결과를 공개 로그에 남기지 마세요.

설정 위치는 공식 웹 문서에서

File search의 Metadata filtering과 Responses 참조를 나란히 읽으세요. 파일 속성 설정과 검색 조건 추가가 서로 다른 작업임을 먼저 확인합니다.

실제 시험은 API 개발 환경에서

ChatGPT 웹·모바일 앱의 파일 첨부 메뉴에서 바꾸는 옵션이 아닙니다. API 키를 안전하게 불러오는 개발 환경에서 공개 가능한 자료로 비교하고, 원본 파일을 삭제해 검색 범위를 맞추려 하지 마세요.