OpenAI Responses API 가이드: 백그라운드 실행과 컨텍스트 관리

InYourLeague 리서치 · 2026-08-31

Answer in brief

백그라운드 실행에는 CLI의 선택적 --background 제어를 사용하고, 목적이 서로 다르게 설명된 --context-management와 --conversation은 별개의 제어 항목으로 다뤄야 합니다. 제공된 발췌문은 --context-management에 대응하는 HTTP 필드 표기, 도구 선택 모드, 폴링 간격, 수명 주기 상태, 재시도 동작 또는 복구 보장을 정의하지 않으므로 관련 작업의 전체 계약에서 확인해야 합니다.

Key facts at a glance

Failure modes and verification

FAQ

--background는 어떤 역할을 합니까?

제공된 CLI 참조에서 --background는 모델 응답을 백그라운드에서 실행할지 제어하는 선택적 불리언입니다. 발췌문에는 완료 시점, 수명 주기 상태 또는 내구성 보장이 명시되어 있지 않습니다.

--context-management를 HTTP JSON 본문에 그대로 사용할 수 있습니까?

제공된 근거만으로는 그렇게 판단할 수 없습니다. --context-management는 발췌문에 나온 CLI 표기이며, 이에 대응하는 원시 JSON 속성 이름은 제시되지 않았습니다. 요청을 작성하기 전에 전체 HTTP 또는 SDK 스키마를 확인해야 합니다.

--context-management와 --conversation 중 하나만 선택해야 합니까?

발췌문은 두 항목을 모두 선택적 제어로 설명하지만, 서로 배타적이거나 대체 가능하다고 밝히지 않습니다. 각 항목을 문서화된 목적에 맞게 사용하고, 함께 사용할 경우에는 전체 계약에서 조합 가능 여부를 확인해야 합니다.

--conversation은 어떤 연속성을 제공합니까?

기존 대화 항목은 응답 입력 앞에 추가됩니다. 응답이 완료되면 그 응답의 입력 항목과 출력 항목이 대화에 자동으로 추가된다고 제공된 공식 참조에 설명되어 있습니다.

응답의 도구는 어떻게 선택합니까? 주어진 정보만으로 특정 도구를 강제할 수 있습니까?

발췌문은 응답이 사용자 정의 코드를 호출하거나 웹 검색과 파일 검색 같은 기본 제공 도구를 사용할 수 있다고 설명합니다. 그러나 구성 문법, 자동 선택, 특정 도구 강제 또는 도구 사용 필수화 방식은 정의하지 않습니다.

백그라운드 응답은 어떻게 폴링해야 합니까?

참조 탐색 메뉴에 Retrieve a response가 있으므로 응답 조회를 폴링 후보로 검토할 수 있습니다. 다만 이는 문서화된 폴링 절차가 아닙니다. 전체 Retrieve 계약에서 조회 입력, 상태, 종료 결과, 오류를 확인한 뒤 간격, 백오프, 제한 시간을 클라이언트 정책으로 정해야 합니다.

중단된 장시간 작업은 어떻게 복구해야 합니까?

프로세스 재시작 후에도 남는 애플리케이션 작업 기록을 보관합니다. 전체 Retrieve 계약이 적절한 조회 수단을 제공하는 것으로 확인된 경우에는 대체 작업을 만들기 전에 기존 작업을 확인하고, 필요하면 클라이언트에서 중복 생성을 방지합니다. 발췌문은 자동 재개나 중복 제거를 보장하지 않습니다.

Sources and freshness

• Official source
• Last verified: 2026-08-31

Extended guide

직접 답변

제공된 근거는 POST /responses에 대응하는 openai responses create 명령의 CLI 형식 참조입니다. 이 CLI 문맥에서 --background는 모델 응답을 백그라운드에서 실행할지 정하는 선택적 불리언입니다. 같은 페이지에는 --context-management와 --conversation도 표시되어 있지만, 두 항목이 서로 대체 가능하거나 상호 배타적이라는 설명은 없습니다. 한 요청에서 둘 중 하나만 선택해야 한다는 근거도 없습니다. 따라서 각 제어 항목은 발췌문에 설명된 고유한 목적에 맞춰 사용해야 합니다.

CLI 옵션 표기와 HTTP 또는 SDK의 요청 문법은 구분해야 합니다. 특히 발췌문에 나온 --context-management는 하이픈이 포함된 CLI 옵션입니다. 제공된 내용에는 이에 대응하는 원시 JSON 속성 이름이 나오지 않습니다. 그러므로 하이픈이 들어간 CLI 표기를 HTTP 요청 키로 그대로 사용해도 된다고 가정해서는 안 됩니다. 애플리케이션이 실제로 사용하는 HTTP 또는 SDK의 전체 스키마에서 정확한 속성 이름, 중첩 구조, 값 인코딩 방식을 확인해야 합니다.

근거로 확인되는 사실과 한계

클라이언트 실행 및 복구 지침

1. 생성 호출과 별개로 애플리케이션이 작업을 추적할 수 있을 때 백그라운드 실행을 선택합니다. 다만 이는 클라이언트 설계 판단입니다. 발췌문에는 서비스가 작업이나 결과를 얼마나 오래 보관하는지, 연결이 끊겨도 처리가 계속되는지, 완료 결과가 언제까지 조회되는지에 관한 보장이 없습니다.
2. 기존 대화 항목을 입력 앞에 붙이고 완료된 입력과 출력을 대화에 추가하는 동작이 필요할 때 --conversation을 사용합니다. --context-management는 전체 계약에서 허용 값과 정확한 문법을 확인한 뒤 구성합니다. 두 제어 항목의 목적이 다르므로 하나가 다른 하나를 자동으로 대신한다고 간주하지 않습니다.
3. 사용자 정의 코드, 웹 검색 또는 파일 검색은 작업 목적, 데이터 경계, 권한에 맞춰 선택합니다. 발췌문은 사용할 수 있는 도구의 예를 제시할 뿐, 도구 선택 프로토콜을 정의하지 않습니다. 자동 선택이나 특정 도구 강제가 필요하다면 실제 도구 스키마에서 지원 여부와 구성 방법을 확인합니다.
4. 탐색 메뉴에 응답 조회 작업인 Retrieve a response가 있으므로 이를 폴링 후보로 검토할 수는 있습니다. 그러나 이는 문서화된 폴링 절차가 아니라 작업 이름을 바탕으로 한 설계상 추론입니다. 반복 조회를 구현하기 전에 Retrieve 작업의 전체 계약에서 조회에 필요한 입력, 반환되는 상태 정보, 종료 결과, 오류 유형을 확인해야 합니다.
5. 폴링 간격, 지수형 백오프 여부, 전체 제한 시간, 요청별 제한 시간, 최대 재시도 횟수는 클라이언트 정책으로 명시합니다. 제공된 발췌문에는 권장 간격이나 안전한 재시도 규칙이 없으므로 특정 숫자를 API 권장 사항으로 표현하지 않습니다. 재시도 가능한 오류와 즉시 중단해야 하는 오류도 전체 계약을 확인한 뒤 구분합니다.
6. 프로세스가 다시 시작되어도 남아 있는 저장소에 애플리케이션 작업 기록을 보관합니다. 전체 Retrieve 계약이 필요한 조회 수단을 제공하는 것으로 확인된 경우에만 그 수단으로 기존 작업을 먼저 확인합니다. 그 결과를 확인하기 전에 대체 응답을 무조건 생성하지 않습니다. 중복 생성이 비용이나 부작용을 낳을 수 있다면 애플리케이션 수준의 중복 방지 규칙을 둡니다. 이는 운영상 권고이며, 발췌문이 자동 재개나 중복 제거를 보장한다는 뜻은 아닙니다.
7. 응답 취소 작업인 Cancel a response와 응답 압축 작업인 Compact a response는 각각의 전체 계약을 검토한 뒤 사용합니다. 탐색 메뉴에 작업 이름이 표시된다는 사실만으로 실행 가능한 상태, 요청 형식, 처리 결과 또는 상태 변화를 단정할 수 없습니다.

문서화된 동작과 애플리케이션 정책

문서화된 사실은 --background의 기본 목적, 두 컨텍스트 관련 CLI 옵션의 일부 형태와 동작, 사용자 정의 코드와 일부 기본 제공 도구의 사용 가능성, 관련 응답 작업 이름의 존재입니다. 반면 폴링 주기, 백오프 방식, 제한 시간, 재시도 한도, 중복 방지, 장애 이후의 복구 순서는 애플리케이션이 결정할 정책입니다. 구현 문서에서도 이 두 범주를 분리해야 운영 선택을 API 보장으로 오해하지 않습니다.

게시 근거의 범위

공식 Create a response 참조는 위에서 문서화된 사실로 분류한 내용만 뒷받침합니다. 폴링과 복구에 관한 내용은 클라이언트 설계 지침으로 명확히 구분했습니다. 제공된 발췌문에는 선택 가능한 모델 ID가 나오지 않으므로, 이 문안은 모델 제공 여부나 선택 가능 범위를 주장하지 않습니다.

모델 제공 범위 안내: 공식 출처는 선택 가능한 모델 ID를 지정하지 않습니다.