ag_ui.core
AG-UI Python SDK 采用基于流式事件的架构与强类型数据结构。本包提供连接智能体系统的基础。
pip install ag-ui-protocolfrom 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="你好",
)