Class AssistantStreamEvent
-
- All Implemented Interfaces:
public final class AssistantStreamEvent
Represents an event emitted when streaming a Run.
Each event in a server-sent events stream has an
event
anddata
property:event: thread.created data: {"id": "thread_123", "object": "thread", ...}
We emit events whenever a new object is created, transitions to a new state, or is being streamed in parts (deltas). For example, we emit
thread.run.created
when a new run is created,thread.run.completed
when a run completes, and so on. When an Assistant chooses to create a message during a run, we emit athread.message.created event
, athread.message.in_progress
event, manythread.message.delta
events, and finally athread.message.completed
event.We may add additional events over time, so we recommend handling unknown events gracefully in your code. See the Assistants API quickstart to learn how to integrate the Assistants API with streaming.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description public interface
AssistantStreamEvent.Visitor
public final class
AssistantStreamEvent.Deserializer
public final class
AssistantStreamEvent.Serializer
public final class
AssistantStreamEvent.ThreadCreated
Occurs when a new thread is created.
public final class
AssistantStreamEvent.ThreadRunCreated
Occurs when a new run is created.
public final class
AssistantStreamEvent.ThreadRunQueued
Occurs when a run moves to a
queued
status.public final class
AssistantStreamEvent.ThreadRunInProgress
Occurs when a run moves to an
in_progress
status.public final class
AssistantStreamEvent.ThreadRunRequiresAction
Occurs when a run moves to a
requires_action
status.public final class
AssistantStreamEvent.ThreadRunCompleted
Occurs when a run is completed.
public final class
AssistantStreamEvent.ThreadRunIncomplete
Occurs when a run ends with status
incomplete
.public final class
AssistantStreamEvent.ThreadRunFailed
Occurs when a run fails.
public final class
AssistantStreamEvent.ThreadRunCancelling
Occurs when a run moves to a
cancelling
status.public final class
AssistantStreamEvent.ThreadRunCancelled
Occurs when a run is cancelled.
public final class
AssistantStreamEvent.ThreadRunExpired
Occurs when a run expires.
public final class
AssistantStreamEvent.ThreadRunStepCreated
Occurs when a run step is created.
public final class
AssistantStreamEvent.ThreadRunStepInProgress
Occurs when a run step moves to an
in_progress
state.public final class
AssistantStreamEvent.ThreadRunStepDelta
Occurs when parts of a run step are being streamed.
public final class
AssistantStreamEvent.ThreadRunStepCompleted
Occurs when a run step is completed.
public final class
AssistantStreamEvent.ThreadRunStepFailed
Occurs when a run step fails.
public final class
AssistantStreamEvent.ThreadRunStepCancelled
Occurs when a run step is cancelled.
public final class
AssistantStreamEvent.ThreadRunStepExpired
Occurs when a run step expires.
public final class
AssistantStreamEvent.ThreadMessageCreated
Occurs when a message is created.
public final class
AssistantStreamEvent.ThreadMessageInProgress
Occurs when a message moves to an
in_progress
state.public final class
AssistantStreamEvent.ThreadMessageDelta
Occurs when parts of a Message are being streamed.
public final class
AssistantStreamEvent.ThreadMessageCompleted
Occurs when a message is completed.
public final class
AssistantStreamEvent.ThreadMessageIncomplete
Occurs when a message ends before it is completed.
public final class
AssistantStreamEvent.ErrorEvent
Occurs when an error occurs. This can happen due to an internal server error or a timeout.
-
Method Summary
-
-
Method Detail
-
threadCreated
final Optional<AssistantStreamEvent.ThreadCreated> threadCreated()
Occurs when a new thread is created.
-
threadRunCreated
final Optional<AssistantStreamEvent.ThreadRunCreated> threadRunCreated()
Occurs when a new run is created.
-
threadRunQueued
final Optional<AssistantStreamEvent.ThreadRunQueued> threadRunQueued()
Occurs when a run moves to a
queued
status.
-
threadRunInProgress
final Optional<AssistantStreamEvent.ThreadRunInProgress> threadRunInProgress()
Occurs when a run moves to an
in_progress
status.
-
threadRunRequiresAction
final Optional<AssistantStreamEvent.ThreadRunRequiresAction> threadRunRequiresAction()
Occurs when a run moves to a
requires_action
status.
-
threadRunCompleted
final Optional<AssistantStreamEvent.ThreadRunCompleted> threadRunCompleted()
Occurs when a run is completed.
-
threadRunIncomplete
final Optional<AssistantStreamEvent.ThreadRunIncomplete> threadRunIncomplete()
Occurs when a run ends with status
incomplete
.
-
threadRunFailed
final Optional<AssistantStreamEvent.ThreadRunFailed> threadRunFailed()
Occurs when a run fails.
-
threadRunCancelling
final Optional<AssistantStreamEvent.ThreadRunCancelling> threadRunCancelling()
Occurs when a run moves to a
cancelling
status.
-
threadRunCancelled
final Optional<AssistantStreamEvent.ThreadRunCancelled> threadRunCancelled()
Occurs when a run is cancelled.
-
threadRunExpired
final Optional<AssistantStreamEvent.ThreadRunExpired> threadRunExpired()
Occurs when a run expires.
-
threadRunStepCreated
final Optional<AssistantStreamEvent.ThreadRunStepCreated> threadRunStepCreated()
Occurs when a run step is created.
-
threadRunStepInProgress
final Optional<AssistantStreamEvent.ThreadRunStepInProgress> threadRunStepInProgress()
Occurs when a run step moves to an
in_progress
state.
-
threadRunStepDelta
final Optional<AssistantStreamEvent.ThreadRunStepDelta> threadRunStepDelta()
Occurs when parts of a run step are being streamed.
-
threadRunStepCompleted
final Optional<AssistantStreamEvent.ThreadRunStepCompleted> threadRunStepCompleted()
Occurs when a run step is completed.
-
threadRunStepFailed
final Optional<AssistantStreamEvent.ThreadRunStepFailed> threadRunStepFailed()
Occurs when a run step fails.
-
threadRunStepCancelled
final Optional<AssistantStreamEvent.ThreadRunStepCancelled> threadRunStepCancelled()
Occurs when a run step is cancelled.
-
threadRunStepExpired
final Optional<AssistantStreamEvent.ThreadRunStepExpired> threadRunStepExpired()
Occurs when a run step expires.
-
threadMessageCreated
final Optional<AssistantStreamEvent.ThreadMessageCreated> threadMessageCreated()
Occurs when a message is created.
-
threadMessageInProgress
final Optional<AssistantStreamEvent.ThreadMessageInProgress> threadMessageInProgress()
Occurs when a message moves to an
in_progress
state.
-
threadMessageDelta
final Optional<AssistantStreamEvent.ThreadMessageDelta> threadMessageDelta()
Occurs when parts of a Message are being streamed.
-
threadMessageCompleted
final Optional<AssistantStreamEvent.ThreadMessageCompleted> threadMessageCompleted()
Occurs when a message is completed.
-
threadMessageIncomplete
final Optional<AssistantStreamEvent.ThreadMessageIncomplete> threadMessageIncomplete()
Occurs when a message ends before it is completed.
-
errorEvent
final Optional<AssistantStreamEvent.ErrorEvent> errorEvent()
Occurs when an error occurs. This can happen due to an internal server error or a timeout.
-
isThreadCreated
final Boolean isThreadCreated()
-
isThreadRunCreated
final Boolean isThreadRunCreated()
-
isThreadRunQueued
final Boolean isThreadRunQueued()
-
isThreadRunInProgress
final Boolean isThreadRunInProgress()
-
isThreadRunRequiresAction
final Boolean isThreadRunRequiresAction()
-
isThreadRunCompleted
final Boolean isThreadRunCompleted()
-
isThreadRunIncomplete
final Boolean isThreadRunIncomplete()
-
isThreadRunFailed
final Boolean isThreadRunFailed()
-
isThreadRunCancelling
final Boolean isThreadRunCancelling()
-
isThreadRunCancelled
final Boolean isThreadRunCancelled()
-
isThreadRunExpired
final Boolean isThreadRunExpired()
-
isThreadRunStepCreated
final Boolean isThreadRunStepCreated()
-
isThreadRunStepInProgress
final Boolean isThreadRunStepInProgress()
-
isThreadRunStepDelta
final Boolean isThreadRunStepDelta()
-
isThreadRunStepCompleted
final Boolean isThreadRunStepCompleted()
-
isThreadRunStepFailed
final Boolean isThreadRunStepFailed()
-
isThreadRunStepCancelled
final Boolean isThreadRunStepCancelled()
-
isThreadRunStepExpired
final Boolean isThreadRunStepExpired()
-
isThreadMessageCreated
final Boolean isThreadMessageCreated()
-
isThreadMessageInProgress
final Boolean isThreadMessageInProgress()
-
isThreadMessageDelta
final Boolean isThreadMessageDelta()
-
isThreadMessageCompleted
final Boolean isThreadMessageCompleted()
-
isThreadMessageIncomplete
final Boolean isThreadMessageIncomplete()
-
isErrorEvent
final Boolean isErrorEvent()
-
asThreadCreated
final AssistantStreamEvent.ThreadCreated asThreadCreated()
Occurs when a new thread is created.
-
asThreadRunCreated
final AssistantStreamEvent.ThreadRunCreated asThreadRunCreated()
Occurs when a new run is created.
-
asThreadRunQueued
final AssistantStreamEvent.ThreadRunQueued asThreadRunQueued()
Occurs when a run moves to a
queued
status.
-
asThreadRunInProgress
final AssistantStreamEvent.ThreadRunInProgress asThreadRunInProgress()
Occurs when a run moves to an
in_progress
status.
-
asThreadRunRequiresAction
final AssistantStreamEvent.ThreadRunRequiresAction asThreadRunRequiresAction()
Occurs when a run moves to a
requires_action
status.
-
asThreadRunCompleted
final AssistantStreamEvent.ThreadRunCompleted asThreadRunCompleted()
Occurs when a run is completed.
-
asThreadRunIncomplete
final AssistantStreamEvent.ThreadRunIncomplete asThreadRunIncomplete()
Occurs when a run ends with status
incomplete
.
-
asThreadRunFailed
final AssistantStreamEvent.ThreadRunFailed asThreadRunFailed()
Occurs when a run fails.
-
asThreadRunCancelling
final AssistantStreamEvent.ThreadRunCancelling asThreadRunCancelling()
Occurs when a run moves to a
cancelling
status.
-
asThreadRunCancelled
final AssistantStreamEvent.ThreadRunCancelled asThreadRunCancelled()
Occurs when a run is cancelled.
-
asThreadRunExpired
final AssistantStreamEvent.ThreadRunExpired asThreadRunExpired()
Occurs when a run expires.
-
asThreadRunStepCreated
final AssistantStreamEvent.ThreadRunStepCreated asThreadRunStepCreated()
Occurs when a run step is created.
-
asThreadRunStepInProgress
final AssistantStreamEvent.ThreadRunStepInProgress asThreadRunStepInProgress()
Occurs when a run step moves to an
in_progress
state.
-
asThreadRunStepDelta
final AssistantStreamEvent.ThreadRunStepDelta asThreadRunStepDelta()
Occurs when parts of a run step are being streamed.
-
asThreadRunStepCompleted
final AssistantStreamEvent.ThreadRunStepCompleted asThreadRunStepCompleted()
Occurs when a run step is completed.
-
asThreadRunStepFailed
final AssistantStreamEvent.ThreadRunStepFailed asThreadRunStepFailed()
Occurs when a run step fails.
-
asThreadRunStepCancelled
final AssistantStreamEvent.ThreadRunStepCancelled asThreadRunStepCancelled()
Occurs when a run step is cancelled.
-
asThreadRunStepExpired
final AssistantStreamEvent.ThreadRunStepExpired asThreadRunStepExpired()
Occurs when a run step expires.
-
asThreadMessageCreated
final AssistantStreamEvent.ThreadMessageCreated asThreadMessageCreated()
Occurs when a message is created.
-
asThreadMessageInProgress
final AssistantStreamEvent.ThreadMessageInProgress asThreadMessageInProgress()
Occurs when a message moves to an
in_progress
state.
-
asThreadMessageDelta
final AssistantStreamEvent.ThreadMessageDelta asThreadMessageDelta()
Occurs when parts of a Message are being streamed.
-
asThreadMessageCompleted
final AssistantStreamEvent.ThreadMessageCompleted asThreadMessageCompleted()
Occurs when a message is completed.
-
asThreadMessageIncomplete
final AssistantStreamEvent.ThreadMessageIncomplete asThreadMessageIncomplete()
Occurs when a message ends before it is completed.
-
asErrorEvent
final AssistantStreamEvent.ErrorEvent asErrorEvent()
Occurs when an error occurs. This can happen due to an internal server error or a timeout.
-
accept
final <T extends Any> T accept(AssistantStreamEvent.Visitor<T> visitor)
-
validate
final AssistantStreamEvent validate()
-
ofThreadCreated
final static AssistantStreamEvent ofThreadCreated(AssistantStreamEvent.ThreadCreated threadCreated)
Occurs when a new thread is created.
-
ofThreadRunCreated
final static AssistantStreamEvent ofThreadRunCreated(AssistantStreamEvent.ThreadRunCreated threadRunCreated)
Occurs when a new run is created.
-
ofThreadRunQueued
final static AssistantStreamEvent ofThreadRunQueued(AssistantStreamEvent.ThreadRunQueued threadRunQueued)
Occurs when a run moves to a
queued
status.
-
ofThreadRunInProgress
final static AssistantStreamEvent ofThreadRunInProgress(AssistantStreamEvent.ThreadRunInProgress threadRunInProgress)
Occurs when a run moves to an
in_progress
status.
-
ofThreadRunRequiresAction
final static AssistantStreamEvent ofThreadRunRequiresAction(AssistantStreamEvent.ThreadRunRequiresAction threadRunRequiresAction)
Occurs when a run moves to a
requires_action
status.
-
ofThreadRunCompleted
final static AssistantStreamEvent ofThreadRunCompleted(AssistantStreamEvent.ThreadRunCompleted threadRunCompleted)
Occurs when a run is completed.
-
ofThreadRunIncomplete
final static AssistantStreamEvent ofThreadRunIncomplete(AssistantStreamEvent.ThreadRunIncomplete threadRunIncomplete)
Occurs when a run ends with status
incomplete
.
-
ofThreadRunFailed
final static AssistantStreamEvent ofThreadRunFailed(AssistantStreamEvent.ThreadRunFailed threadRunFailed)
Occurs when a run fails.
-
ofThreadRunCancelling
final static AssistantStreamEvent ofThreadRunCancelling(AssistantStreamEvent.ThreadRunCancelling threadRunCancelling)
Occurs when a run moves to a
cancelling
status.
-
ofThreadRunCancelled
final static AssistantStreamEvent ofThreadRunCancelled(AssistantStreamEvent.ThreadRunCancelled threadRunCancelled)
Occurs when a run is cancelled.
-
ofThreadRunExpired
final static AssistantStreamEvent ofThreadRunExpired(AssistantStreamEvent.ThreadRunExpired threadRunExpired)
Occurs when a run expires.
-
ofThreadRunStepCreated
final static AssistantStreamEvent ofThreadRunStepCreated(AssistantStreamEvent.ThreadRunStepCreated threadRunStepCreated)
Occurs when a run step is created.
-
ofThreadRunStepInProgress
final static AssistantStreamEvent ofThreadRunStepInProgress(AssistantStreamEvent.ThreadRunStepInProgress threadRunStepInProgress)
Occurs when a run step moves to an
in_progress
state.
-
ofThreadRunStepDelta
final static AssistantStreamEvent ofThreadRunStepDelta(AssistantStreamEvent.ThreadRunStepDelta threadRunStepDelta)
Occurs when parts of a run step are being streamed.
-
ofThreadRunStepCompleted
final static AssistantStreamEvent ofThreadRunStepCompleted(AssistantStreamEvent.ThreadRunStepCompleted threadRunStepCompleted)
Occurs when a run step is completed.
-
ofThreadRunStepFailed
final static AssistantStreamEvent ofThreadRunStepFailed(AssistantStreamEvent.ThreadRunStepFailed threadRunStepFailed)
Occurs when a run step fails.
-
ofThreadRunStepCancelled
final static AssistantStreamEvent ofThreadRunStepCancelled(AssistantStreamEvent.ThreadRunStepCancelled threadRunStepCancelled)
Occurs when a run step is cancelled.
-
ofThreadRunStepExpired
final static AssistantStreamEvent ofThreadRunStepExpired(AssistantStreamEvent.ThreadRunStepExpired threadRunStepExpired)
Occurs when a run step expires.
-
ofThreadMessageCreated
final static AssistantStreamEvent ofThreadMessageCreated(AssistantStreamEvent.ThreadMessageCreated threadMessageCreated)
Occurs when a message is created.
-
ofThreadMessageInProgress
final static AssistantStreamEvent ofThreadMessageInProgress(AssistantStreamEvent.ThreadMessageInProgress threadMessageInProgress)
Occurs when a message moves to an
in_progress
state.
-
ofThreadMessageDelta
final static AssistantStreamEvent ofThreadMessageDelta(AssistantStreamEvent.ThreadMessageDelta threadMessageDelta)
Occurs when parts of a Message are being streamed.
-
ofThreadMessageCompleted
final static AssistantStreamEvent ofThreadMessageCompleted(AssistantStreamEvent.ThreadMessageCompleted threadMessageCompleted)
Occurs when a message is completed.
-
ofThreadMessageIncomplete
final static AssistantStreamEvent ofThreadMessageIncomplete(AssistantStreamEvent.ThreadMessageIncomplete threadMessageIncomplete)
Occurs when a message ends before it is completed.
-
ofErrorEvent
final static AssistantStreamEvent ofErrorEvent(AssistantStreamEvent.ErrorEvent errorEvent)
Occurs when an error occurs. This can happen due to an internal server error or a timeout.
-
-
-
-