이벤트 스트림

이벤트 스트림 (1.0) (Event Streams)

여덟 가지 이벤트 패밀리와, 각각에 누가 반응하는지 다루는 페이지예요. 생산자가 말할 모든 것은 여덟 패밀리의 이벤트로 도착합니다.

출처: 문서

본문

생산자가 말할 모든 것은 여덟 패밀리의 이벤트로 도착합니다. 각 패밀리는 이벤트 패턴 중 하나를 묶고 자기만의 규칙을 더합니다. 각각은 소비자의 다른 부분에게 보내집니다:

패밀리 이벤트 패턴 소비 주체
실행과 단계 RUN_STARTED · RUN_FINISHED · RUN_ERROR · STEP_STARTED · STEP_FINISHED lifecycle 클라이언트 자신
텍스트 메시지 TEXT_MESSAGE_* streaming UI
도구 호출 TOOL_CALL_* streaming 애플리케이션
추론 (Reasoning) REASONING_* streaming UI
상태 (State) STATE_SNAPSHOT · STATE_DELTA · MESSAGES_SNAPSHOT snapshot–delta 애플리케이션 저장소
Activity ACTIVITY_SNAPSHOT · ACTIVITY_DELTA snapshot–delta UI
하위 에이전트 SUBAGENT_STARTED · SUBAGENT_FINISHED · SUBAGENT_ERROR lifecycle 클라이언트 자신
패스스루 RAW · CUSTOM standalone 애플리케이션, 옵트인

이 패밀리들이 이루는 서른한 가지 이벤트 타입은 이벤트 모델 (The Event Model)에 열거되고, 그 형태는 스키마의 것입니다. 실행 수명주기만이 생산자에게 필수입니다 — 다른 모든 패밀리는 그것으로 말할 것이 있을 때 내보내는 기능입니다. 소비자는 그것들을 전부 받아들여야 합니다(MUST): 소비자가 쓸모없어 하는 패밀리의 이벤트도 여전히 잘 만들어진 이벤트이지 인식되지 않는 자료가 아닙니다.

실행과 단계 (Runs and steps) — lifecycle 실행이 언제 시작하고 끝나는지, 그리고 단계가 어떻게 그 단계들을 표시하는지.

텍스트 메시지 (Text messages) — text-messages 대화 그 자체로, 생성되면서 스트리밍됩니다.

도구 호출 (Tool calls) — tool-calls 에이전트가 제안하고, 애플리케이션이 처리합니다.

추론 (Reasoning) — reasoning 모델의 사고가 스트리밍되고, 그것을 왕복시키는 암호화 아티팩트.

상태 (State) — state 공유 상태와 대화가 교체되고 수정됩니다.

Activity — activity UI가 대화록 밖에서 렌더링하는 구조적 진행.

하위 에이전트 (Subagents) — subagents 귀속(attribution), 소유, 중첩, 그리고 위임된 작업이 어떻게 종료되는지.

원시·커스텀 이벤트 (Raw and custom events) — passthrough 탈출구들과 그 한계.

더 알아보기 (Learn more)