Terminology

• Organization
  • 租户边界；资源与 run 的归属单位。
• Agent
  • 可执行资源，包含 card、执行配置、secret refs、灰度规则等。
• Tool
  • 可被 Agent 或 runtime 调用的能力定义。
• Run
  • 一次任务执行实例；由一个资源目标与一份输入触发。
• Attempt
  • run 的一次具体执行尝试；重试会产生新 attempt。
• Thread
  • 对话或事件展示维度；同一 run 内可能只有一个主 thread，也可能包含子 thread。
• Context
  • 跨 run 的业务上下文标识。
• Runtime
  • 在 provider 环境中运行的执行代理，负责接收输入、发送输出和管理本地工具。
• Provider
  • 提供实际执行环境的后端，例如 local、sandbox、faas。
• Runtime Session
  • runtime 与平台之间的有状态连接上下文。
• Input Event
  • 平台发给 runtime 的消息、通知或取消事件。
• Output Event
  • runtime 发给平台的文本、reasoning、tool call、artifact、状态等事件。
• Event Log
  • append-only 的运行事实存储。
• Projection
  • 从事件流构建读模型的过程。
• Trace
  • 一次 runtime 内部执行链路的追踪根对象，由多个 span 组成。
• Span
  • trace 中的单个工作单元，拥有开始/结束时间、状态、父子关系和资源指标。
• Agent Tracer
  • runtime 内部的追踪控制器，负责创建 span、维护上下文、采集指标并导出 span 记录。
• Propagation Carrier
  • traceparent、tracestate、baggage 等用于跨进程传播 trace context 的载体。
• Baggage
  • 附着在 trace context 上的键值上下文，用于跨边界携带受治理的小型属性。
• Span Event
  • 归属于某个 span 的细粒度结构化事件，例如 LLM 输入输出详情。
• GenAI Operation Details
  • 面向 LLM / agent 调用的输入消息、输出消息、tool context、usage 和 provider 参数详情。
• Trace Export
  • span 结束后导出的结构化遥测记录。
• Message Record
  • 面向查询与 UI 的稳定消息视图。
• Artifact
  • run 产出物；可由输出事件增量构建。
• Checkpoint
  • 可恢复的文件系统或逻辑状态快照。
• Cursor
  • 流式消费位置标识；最常见为 (runId, sequence)。
• Idempotency Key
  • 写命令去重键。
• Trace Context
  • 当前执行上下文中的 traceId 与 spanId，用于日志相关性和父子 span 继承。
  • 在跨边界场景中还包括 traceparent、tracestate 与 baggage 等 carrier 视图。