에이전트가 더 자율적으로 작업할 수 있도록 세션에서 에이전트의 동작을 자동으로 검토하도록 설정하세요.
자동 검토는 ChatGPT와 Codex의 자동 승인 기능처럼 에이전트가 작업하는 동안 지원되는 승인 요청을 승인하거나 거부합니다. 에이전트의 세션을 만들 때 review 필드로 자동 검토를 설정하세요. 이 설정은 루트 턴과 각 루트 턴에서 생성하는 모든 하위 에이전트에 적용됩니다.
자동 검토를 사용하면 에이전트에서도 Codex 하네스의 “대신 승인” 기능을 사용할 수 있습니다. 세션 중에 에이전트가 수행하려는 동작에 추가 권한이 필요하면 승인 요청이 발생할 수 있습니다. 다음은 승인 요청이 발생할 수 있는 예입니다.
권한을 높이거나 위험할 수 있는 명령어를 실행하는 경우처럼 승인이 필요한 셸 명령어와 터미널 입력
승인이 필요한 파일 변경
파일 시스템이나 네트워크에 대한 접근 범위 확대 등 추가 권한 요청
승인이 필요한 네트워크 접근 요청(환경의 네트워크 제한이 적용됨)
승인 규칙에 따라 확인이 필요한 MCP 도구 호출
OpenAI가 관리하는 검토 모델은 대화 컨텍스트를 바탕으로 해당 동작을 실행하면 어떤 일이 일어나는지, 어떤 위험이 있는지, 사용자의 의도에 부합하는지 평가합니다. 그런 다음 모델이 요청을 승인하거나 거부합니다.
검토에 사용한 토큰에는 에이전트의 모델 사용료와 별도로 요금이 부과됩니다.
브라우저의 출처(origin) 접근 요청과 로그인 요청은 계속 애플리케이션에서 처리합니다. 입력이 필요한 MCP 양식과 사용자를 URL로 안내하는 요청은 기존 플로우를 따릅니다. 자동 검토를 위해 승인 이벤트 핸들러를 새로 추가할 필요는 없습니다. 이벤트 및 항목을 참고해 에이전트의 진행 상황을 추적하고 턴의 결과를 확인하세요.
검토 모드 선택
세션의 review 필드를 설정해 검토 방식을 선택하세요.
값
동작
"auto_review"
동작에 따르는 위험과 사용자가 대화에서 제시한 지침을 바탕으로 지원되는 요청을 자동으로 승인하거나 거부합니다.
"none"
자동 검토를 적용하지 않습니다. 대부분의 동작은 환경의 권한과 제한 범위 내에서 바로 실행됩니다.
review를 생략하면 기본값은 "none"입니다. 세션을 재개해도 설정은 유지됩니다. 설정을 변경하려면 "auto_review" 또는 "none"을 보내세요. null은 허용되지 않습니다. review를 "none"으로 설정해도 해당 동작이 수동 승인을 위해 애플리케이션으로 전달되지는 않습니다.
실행 환경 준비
OpenAI 호스팅 환경에서 실행하려면 새 환경으로 세션을 만드세요. 필요하면 환경 템플릿으로 새 환경을 만들 수 있습니다. environment_id로 기존 호스팅 환경을 재사용하는 경우에는 자동 검토가 지원되지 않습니다.
업데이트에 성공하면 API는 200 OK와 업데이트된 세션을 반환합니다. 다른 세션 설정을 업데이트할 때 검토 모드를 유지하려면 요청에서 review를 생략하세요. 자동 검토를 다시 활성화하려면 "review": "auto_review"를 보내세요. 요청 필드는 세션 업데이트 API 레퍼런스에서 확인하세요.
기본 작업이 진행 중이거나 입력 제출 처리가 끝나기 전에 모드 변경을 요청하면 API는 409 Conflict를 반환합니다. 이 경우 해당 요청에 포함된 변경 사항은 하나도 적용되지 않습니다. 작업이 유휴 상태가 되고 입력 제출 처리가 완료된 후에 다시 시도하세요. 세션 상태를 확인한 뒤에도 업데이트 전에 새 입력이 도착할 수 있으므로 409 응답을 처리하세요. 작업이 진행 중이어도 현재 검토 모드와 같은 값은 보낼 수 있습니다.
개별 세션을 조회하거나 세션 목록을 조회해 저장된 review 값을 확인하세요. 응답에 이 필드가 없으면 "none"으로 간주하세요.