跳至内容

流式事件

StreamEvent module-attribute 

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

来自代理的流式事件。

RawResponsesStreamEvent dataclass

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

Source code in src/agents/stream_events.py 
12
13
14
15
16
17
18
19
20
21
22
@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."""

数据 instance-attribute 

data: TResponseStreamEvent

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

类型 class-attribute instance-attribute 

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

事件的类型。

RunItemStreamEvent dataclass

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

Source code in src/agents/stream_events.py 
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
@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",
        "handoff_occured",
        "tool_called",
        "tool_output",
        "reasoning_item_created",
    ]
    """The name of the event."""

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

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

名称 instance-attribute 

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

事件名称。

项目 instance-attribute 

item: RunItem

已创建的条目。

AgentUpdatedStreamEvent dataclass

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

Source code in src/agents/stream_events.py 
47
48
49
50
51
52
53
54
@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]

新代理。