流式事件

StreamEvent module-attribute

StreamEvent: TypeAlias = Union[
    RawResponsesStreamEvent,
    RunItemStreamEvent,
    AgentUpdatedStreamEvent,
]

来自代理的流式事件。

RawResponsesStreamEvent dataclass

来自 LLM 的流式事件。这些是“原始”事件，即它们直接从 LLM 传递而来。

源代码位于 src/agents/stream_events.py

@dataclass
class RawResponsesStreamEvent:
    """Streaming event from the LLM. These are 'raw' events, i.e. they are directly passed through
    from the LLM.
    """

    data: TResponseStreamEvent
    """The raw responses streaming event from the LLM."""

    type: Literal["raw_response_event"] = "raw_response_event"
    """The type of the event."""

data instance-attribute

data: TResponseStreamEvent

来自 LLM 的原始响应流式事件。

type class-attribute instance-attribute

type: Literal['raw_response_event'] = 'raw_response_event'

事件的类型。

RunItemStreamEvent dataclass

包装 RunItem 的流式事件。当代理处理 LLM 响应时，它将为新消息、工具调用、工具输出、交接等生成这些事件。

源代码位于 src/agents/stream_events.py

@dataclass
class RunItemStreamEvent:
    """Streaming events that wrap a `RunItem`. As the agent processes the LLM response, it will
    generate these events for new messages, tool calls, tool outputs, handoffs, etc.
    """

    name: Literal[
        "message_output_created",
        "handoff_requested",
        # This is misspelled, but we can't change it because that would be a breaking change
        "handoff_occured",
        "tool_called",
        "tool_output",
        "reasoning_item_created",
        "mcp_approval_requested",
        "mcp_approval_response",
        "mcp_list_tools",
    ]
    """The name of the event."""

    item: RunItem
    """The item that was created."""

    type: Literal["run_item_stream_event"] = "run_item_stream_event"

name instance-attribute

name: Literal[
    "message_output_created",
    "handoff_requested",
    "handoff_occured",
    "tool_called",
    "tool_output",
    "reasoning_item_created",
    "mcp_approval_requested",
    "mcp_approval_response",
    "mcp_list_tools",
]

事件的名称。

item instance-attribute

item: RunItem

创建的项目。

AgentUpdatedStreamEvent dataclass

事件，通知有新的代理正在运行。

源代码位于 src/agents/stream_events.py

@dataclass
class AgentUpdatedStreamEvent:
    """Event that notifies that there is a new agent running."""

    new_agent: Agent[Any]
    """The new agent."""

    type: Literal["agent_updated_stream_event"] = "agent_updated_stream_event"

new_agent instance-attribute

new_agent: Agent[Any]

新的代理。