0Pricing
AI Agents · 강의

OpenAI Assistants API와 스레드

OpenAI의 관리형 에이전트입니다. 인프라가 필요 없지만, 공급업체 종속이 발생하고 관측 가능성에 빠진 부분이 있습니다.

OpenAI Assistants API와 스레드은(는) CoddyKit의 무료 AI Agents 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 AI Agents 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. AI Agents 강의에는 총 4개의 강의가 포함되어 있습니다.

이 강의의 일부는 아직 번역되지 않았으며 영어로 표시됩니다.

무엇입니까

OpenAI Assistants API는 관리형 에이전트 제품입니다. 도우미(모델 + 지침 + 도구)를 정의하고, 사용자는 "스레드"(대화)를 통해 상호 작용합니다. OpenAI가 상태, RAG, 코드 해석기, 파일 저장소를 관리합니다.

두 가지 큰 매력 포인트

  1. 내장 파일 검색 — 관리형 RAG로, 실행할 벡터 데이터베이스가 필요하지 않습니다
  2. 내장 코드 인터프리터 — 샌드박스 Python 실행

이러한 기능을 직접 구축하지 않고 사용하려면 Assistants가 빠른 선택입니다.

Creating an Assistant

from openai import OpenAI
client = OpenAI()

assistant = client.beta.assistants.create(
    name='Support Bot',
    instructions='You help customers with orders.',
    model='gpt-4o-mini',
    tools=[{'type': 'file_search'}, {'type': 'code_interpreter'}]
)

Threads = Conversations

thread = client.beta.threads.create()

client.beta.threads.messages.create(
    thread_id=thread.id,
    role='user',
    content='Where is my order?'
)

run = client.beta.threads.runs.create(
    thread_id=thread.id,
    assistant_id=assistant.id
)

완료 여부 확인

실행은 비동기입니다. 완료될 때까지 폴링합니다:

import time
while run.status not in ('completed', 'failed', 'requires_action'):
    time.sleep(1)
    run = client.beta.threads.runs.retrieve(thread_id=thread.id, run_id=run.id)

함수 호출

chat.completions 도구와 같은 패턴입니다. run.status == '작업 필요'가 되면 도구 호출을 전달하고 결과를 제출합니다:

if run.status == 'requires_action':
    tool_outputs = []
    for tc in run.required_action.submit_tool_outputs.tool_calls:
        result = dispatch(tc)
        tool_outputs.append({'tool_call_id': tc.id, 'output': json.dumps(result)})
    client.beta.threads.runs.submit_tool_outputs(thread_id=thread.id, run_id=run.id, tool_outputs=tool_outputs)

File Search (Vector Store)

vector_store = client.beta.vector_stores.create(name='docs')
client.beta.vector_stores.file_batches.upload_and_poll(
    vector_store_id=vector_store.id,
    files=[open('handbook.pdf', 'rb')]
)
assistant = client.beta.assistants.update(assistant.id, tool_resources={'file_search': {'vector_store_ids': [vector_store.id]}})

코드 인터프리터

code_interpreter를 추가하면 어시스턴트가 샌드박스 Python 환경을 사용할 수 있습니다. 데이터 작업에 매우 유용합니다:

{'type': 'code_interpreter'}

Streaming

with client.beta.threads.runs.stream(thread_id=thread.id, assistant_id=assistant.id) as stream:
    for event in stream:
        print(event)

장단점

  • + 벡터 저장소와 샌드박스를 위한 인프라가 전혀 필요하지 않음
  • + 관리형 메모리와 스레드 상태
  • + file_search에서 제공하는 내장 인용
  • - 특정 공급업체에 종속됨
  • - 검색 전략에 대한 제어력이 낮음
  • - 직접 chat.completions를 사용하는 것보다 지연 시간이 김
  • - 관측성이 더 제한적임

향후 계획

OpenAI는 Assistants의 후속 제품으로 Responses API를 발표했습니다. 일부 팀은 Responses가 안정될 때까지 Assistants 도입을 보류하고 있습니다.

프로토타입에 사용하기

50줄로 문서 QA 봇을 구축하려면 Assistants만큼 좋은 선택을 찾기 어렵습니다. 엄격한 서비스 수준 계약과 맞춤 검색이 필요한 프로덕션 환경이라면 직접 구축하십시오.

비용

Assistants의 과금 항목은 다음과 같습니다:

  • 일반 토큰 비용
  • 파일 검색: GB당 일일 저장 비용
  • 코드 인터프리터: 세션당 비용

사용량이 적으면 저렴하지만, 많이 사용하면 비용이 빠르게 늘어날 수 있습니다.

Assistants에 가장 적합한 경우

어떤 사용 사례가 Assistants API에 가장 적합할까요?

복습

Assistants = 관리형 에이전트 제품입니다. 파일 검색 + 코드 인터프리터 + 스레드로 구성됩니다. 프로토타입에는 매우 적합하지만 대규모 프로덕션에는 덜 적합합니다. Responses API의 동향을 지켜보십시오.

자주 묻는 질문

“OpenAI Assistants API와 스레드” 강의는 무료인가요?

네 — “OpenAI Assistants API와 스레드” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 AI Agents 강의 전체를 잠금 해제할 수 있습니다. AI Agents 강의에는 총 4개의 강의가 포함되어 있습니다.

“OpenAI Assistants API와 스레드”에서 뭘 배우나요?

OpenAI의 관리형 에이전트입니다. 인프라가 필요 없지만, 공급업체 종속이 발생하고 관측 가능성에 빠진 부분이 있습니다. 브라우저에서 직접 실행하는 실습 코드로 AI Agents을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

AI Agents을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 AI Agents은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.

“OpenAI Assistants API와 스레드” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 AI Agents 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 AI Agents 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. LangGraph 대 CrewAI 대 AutoGen
  2. 장기 실행 에이전트를 위한 Letta(이전 이름 MemGPT)
  3. OpenAI Assistants API와 스레드
  4. 사용 사례에 맞는 프레임워크 선택
← AI Agents(으)로 돌아가기