오픈AI 에이전츠 API 공식 예제는 파이썬 14줄입니다. 그래서 나온 글 대부분이 "이렇게 짧게 에이전트를 만든다"에서 시작해요. 줄 수로 재면 이 API가 이깁니다. 세션 관리, 대화 압축, 복구를 오픈AI가 대신 하니까요.
제가 보기에 줄 수는 잘못된 기준입니다. 붙일지 말지는 두 가지가 가릅니다. 하나, 지금 돌아가는 자동화가 있는가. 둘, 내 자료가 미국 서버로 나가도 되는가. 이 둘로 나누면 네 갈래가 나오고, 그중 하나는 제가 말리는 쪽이에요.
코덱스나 클로드코드로 자동 작업을 만드는 분이라면 아래 두 줄 중 하나엔 해당될 겁니다. 하나라도 맞으면 이 글이 맞습니다.
☐ 코덱스·클로드코드 자동 작업을 이미 갖고 있고, 잡일을 줄이고 싶다
☐ 처음 짜려는데 오픈AI의 API 세 가지 중 어디서 시작할지 모르겠다
먼저 물을 것 두 개 - 자동화가 있는지, 자료가 나가도 되는지
첫 질문은 자산입니다. 이미 세션을 넘기고 대화를 줄이는 코드를 손으로 짜 놓았다면 그건 이 API가 대신해 주는 것과 같은 물건이에요. 두 번째 질문은 위치입니다. 이 API는 데이터를 미국에만 저장하고, 기록을 남기지 않는 설정이 아직 없습니다.
두 질문을 겹치면 네 경우가 나옵니다. 제가 어디 서 있는지도 같이 적을게요.
자동화가 있고 자료도 나가도 된다 - 그대로 두는 쪽이 맞습니다
제 경우입니다. 주제 찾기에서 파일 뽑기까지 다섯 단계를 클로드코드와 코덱스로 돌리고, 세션 넘기기와 압축은 이미 손으로 만들어 놨어요.
이걸 뜯어서 옮기면 얻는 건 코드가 줄어드는 편함이고, 잃는 건 베타의 불확실성입니다. 압축률과 세션 최대 길이에 보장이 없고, 복구는 오픈AI 몫이라고만 적혀 있어요. 이미 굴러가는 걸 보장 없는 쪽으로 옮길 이유가 저한텐 없었습니다.
처음 짜고 자료도 나가도 된다 - 여기가 이 API가 맞는 곳입니다
잡일 넷을 안 짜도 됩니다. 세션 넘기기, 대화 압축, MCP 연결, 하위 작업 나누기. 이걸 손으로 만들면 저는 다섯 단계 본체보다 오래 걸렸거든요.
앞 경우가 자산 때문에 안 옮기는 쪽이라면, 이쪽은 자산이 없어서 붙이는 쪽입니다. 시작은 공식 퀵스타트의 14줄이고, 키 발급 때 권한 셋(세션 읽기·세션 쓰기·모델 호출)을 켜는 것만 먼저 챙기면 됩니다.
자동화가 있는데 자료가 못 나간다 - 실행만 내 서버로
회사 자료를 다루는 분입니다. 이 API는 실행 환경을 세 가지로 고를 수 있고, 그중 자체 호스팅은 코덱스 실행 서버를 내 서버에 띄워 잇는 방식이에요. 실행과 파일은 내 쪽에 남고 조율만 오픈AI가 합니다.
다만 세션 기록 자체는 여전히 오픈AI 쪽에 저장됩니다. 파일이 안 나가는 것과 대화 기록이 안 나가는 것은 다른 얘기라, 무엇이 기록에 실리는지부터 확인해야 합니다. 저라면 이 경우 실행만 옮기고 기록에 실리는 내용을 줄이는 쪽으로 갑니다.
처음 짜는데 자료가 못 나간다 - 이 경우엔 기다리세요
붙이면 편하지만 기록 삭제 옵션이 없는 상태로 회사 자료를 첫날부터 태우는 셈입니다. 이 갈래는 제가 말립니다. 기록을 안 남기는 옵션이 생기거나 저장 지역이 늘어날 때까지 기다리고, 그동안은 리스폰시스 API처럼 기록을 내가 들고 있는 층에서 시작하는 게 낫습니다.
오픈AI 방식 세 가지 - 저장과 실행을 누가 하나로 같은 잣대에
비교 글마다 기능 목록으로 셋을 늘어놓는데, 저는 기준 하나만 씁니다. 대화 기록과 실행을 누가 맡느냐. 가운데 에이전츠 SDK는 내 앱에 끼워 쓰는 도구 묶음(SDK) 쪽이고요.
| 리스폰시스 API | 에이전츠 SDK | 에이전츠 API | |
|---|---|---|---|
| 대화 기록 | 내가 | 내 저장소 | 오픈AI 세션 |
| 실행 환경 | 내가 | 내 실행기 | 오픈AI·자체·없음 |
| 내가 짤 코드 | 많음 | 중간 | 적음 |
| 묶이는 정도 | 낮음 | 중간 | 높음 |
위로 갈수록 코드는 줄고 묶임은 늘어요. 이 표에서 눈여겨볼 데는 마지막 줄입니다. 지시문과 도구는 어느 층이든 내 것이라 들고 나갈 수 있어요. 세션 저장과 압축하는 방법만 맨 오른쪽 층에서 저쪽 것이 됩니다. 락인 걱정이 나오는 곳이 정확히 그 줄이에요.
제 자동화도 깎입니다 - 이 API가 없애 주는 잡일 넷은 원래 없어도 됐던 것
공정하게 적으면, 제가 손으로 짠 세션 넘기기와 압축은 자랑거리가 아닙니다. 단계마다 파일 네 개를 넘기고, 대화가 꽉 차면 중간에 정리시키는 줄을 규칙 파일에 넣어 둔 건 그때 다른 길이 없어서였어요. 이 API가 나온 뒤엔 그 코드는 자산이 아니라 옮기기 귀찮은 짐에 가깝습니다.
그래도 안 옮기는 이유는 하나예요. 대본은 앞에 나온 말을 뒤에서 그대로 받아야 하는데, 자동 압축이 무엇을 버릴지 제가 모릅니다. 제 압축은 버릴 걸 제가 정했거든요. 이 차이가 확인되기 전까진 짐을 지고 갑니다.
앤트로픽에도 같은 층이 있다 - 고르는 기준은 그대로
클로드 매니지드 에이전츠가 같은 층입니다. 세션 하나에 컨테이너 하나를 붙이고, 기록은 컨테이너 바깥에 남기고, 자체 호스팅 샌드박스도 됩니다. 그래서 위 네 갈래는 오픈AI만의 얘기가 아니에요. 어느 회사 작업대를 빌리든 질문은 같습니다. 자산이 있는가, 자료가 나가도 되는가.
제가 틀릴 수 있는 곳 - 셋
첫째, 복구입니다. 문서는 오픈AI 몫이라고만 적었고, 끊긴 세션이 저절로 돌아오는지는 없어요. 자동이라면 위 첫 갈래 판정은 흔들립니다. 둘째, 압축입니다. 무엇을 남기는지 보장이 없다는 건 제 걱정이 기우일 수도 있다는 뜻입니다. 셋째, 벤더 수치입니다. 오픈AI가 낸 고객 사례(건당 비용 60% 절감, 실패 응답 86% 감소)는 독립 벤치마크가 아니라 판정에 안 넣었습니다.
반대 사례도 하나 적어 두면, 자체 호스팅에서 세션 기록까지 내 쪽에 두는 길이 제가 못 읽은 문서 어딘가에 있을 수 있습니다. 그러면 셋째 갈래와 넷째 갈래가 합쳐집니다.
정리 - 줄 수 말고 두 질문으로 고르세요
도입에서 14줄이 기준이 아니라고 했습니다. 네 갈래를 돌고 나면 남는 건 두 질문뿐이에요. 자산이 있으면 두고, 없으면 붙이고, 자료가 못 나가면 실행만 옮기거나 기다린다. 저는 첫 갈래에 있어서 짐을 지고 가고, 그 대신 문서의 실패 신호 셋을 제 복구 규칙에 옮겨 적었습니다.
오늘 할 수 있는 한 가지는 자동화 폴더를 열어 세션을 넘기는 코드가 몇 줄인지 세어 보는 겁니다. 그 줄 수가 이 API가 대신해 줄 양이에요. 문서 화면을 짚어 가며 대 본 8분은 위 영상에 있고, 문서 주소와 층 비교표를 한 장에 모은 자료는 오픈톡 '방구석모각코'에서 고정 글을 열면 받을 수 있습니다.