跳到主要内容

概览

Python 核心包 ag_ui.core:类型与事件的基础层。

ag_ui.core

AG-UI Python SDK 采用基于流式事件的架构与强类型数据结构。本包提供连接智能体系统的基础。

pip install ag-ui-protocol
from ag_ui.core import ...

类型

  • RunAgentInput — 运行智能体的输入参数
  • Message — 用户与助手的交流及工具使用
  • Context — 提供给智能体的上下文信息
  • Tool — 定义智能体可调用的函数
  • State — 智能体状态管理

完整定义见类型参考。

事件

完整定义见事件参考。

与其它包的关系

包/模块 用途
ag_ui.core 协议类型、事件模型与 Pydantic 校验
ag_ui.encoder 把事件编码为 SSE 字符串
ag_ui.* 框架适配 把各智能体框架的流式输出映射为 AG-UI 事件

Python 模型使用 snake_case 字段名,序列化到线路时输出 camelCase(例如 message_id → messageId)。

示例

from ag_ui.core import (
    RunAgentInput,
    UserMessage,
    TextMessageStartEvent,
    TextMessageContentEvent,
    TextMessageEndEvent,
    EventType,
)

event = TextMessageContentEvent(
    type=EventType.TEXT_MESSAGE_CONTENT,
    message_id="msg_123",
    delta="你好",
)

Type to search…

↑↓ navigate↵ selectEsc close