附录：Agent 运行时术语表

本文是《从 0 写 Agent》系列的附录 D：术语表。案例代码基于开源项目 agents-go（OpenAI Agents SDK 的 Go 移植版）。

系列里出现的术语速查，按字母/拼音排序。

A

• Agent，围绕任务目标组织感知、决策、行动和反馈的系统闭环。核心是循环调模型 + 工具。
• Agent-as-Tool，把一个 Agent 当工具用，主 Agent 调用它拿到结果继续。控制权归还。（第 18 章）
• ApprovalStore，HITL 的审批决策存储，支持按 callID（单次）和 toolName（永久）两种粒度。（第 12 章）
• AsTool，见 Agent-as-Tool。

B

• backoff（退避），重试时等待时间逐渐增长的策略，防惊群。（第 22 章）
• BatchProcessor，Tracing 的异步批处理器，后台 goroutine 缓冲导出。（第 26 章）

C

• Channel，Go 的并发原语，用于 goroutine 间通信。流式输出用它传事件。
• CodeTool，把 Sandbox 包装成 Agent 工具。（第 32 章）
• Compaction（压缩），把长对话历史总结成短 summary，省 token。（第 11 章）
• CompactionAwareSession，能自我压缩的 Session 接口。（第 8 章）
• CrudStore，agents-server 的泛型 CRUD 存储。（第 35 章）

E

• equal jitter，退避加随机抖动的算法，delay 落在 [d/2, d]，防同步。（第 22 章）
• Exporter，Tracing 的导出层，把 trace/span 发到目的地。（第 27 章）

F

• Fallback，模型降级链，主模型失败自动切备用。（第 23 章）
• FileSession，JSONL 文件存储的 Session 实现，崩溃安全。（第 9 章）
• function calling，模型返回"我要调工具"的能力，Agent 干活的基础。（第 1 章）

G

• go:embed，Go 编译期把文件嵌进二进制的指令。（第 38 章）
• goroutine，Go 的轻量线程，并发执行单元。

H

• Handoff，Agent 之间的交接，切换 active agent。（第 15 章）
• HITL（Human-in-the-Loop），人在回路中，工具执行前人工审批。（第 12 章）
• Hook，运行时事件钩子，不修改循环代码注入自定义行为。（第 19 章）

I

• InputFilter，Handoff 的历史过滤器，改写目标 Agent 看到的对话。（第 16 章）
• InMemorySession，内存中的 Session 实现，测试用。（第 8 章）

J

• JSONL，每行一个 JSON 的文件格式，FileSession 用它存历史。（第 9 章）

L

• lingua franca（通用语），agents-go 用 OpenAI Responses API 格式作为内部统一表示。（第 2 章）

M

• MaxTurns，Agent 循环的最大轮次，防死循环。（第 1 章）
• MCP（Model Context Protocol），连接外部工具的统一标准协议。（第 28 章）
• Model 接口，屏蔽大模型差异的抽象，GetResponse（阻塞）+ StreamResponse（流式）。（第 2 章）
• ModelProvider，按模型名查 Model 的工厂。（第 21 章）

N

• NestHandoffHistory，折叠长对话避免"summary 的 summary"。（第 17 章）
• NeedsApproval，标记工具需要人工审批。（第 12 章）

O

• os.Root，Go 1.24 的目录囚禁，内核级路径遍历防护。（第 31 章）

P

• previous_response_id，OpenAI 的服务端历史机制，只发增量省 token。（第 11 章）
• PKCE，OAuth 防授权码拦截的机制。（第 39 章）
• Producer-Consumer（生产者-消费者），流式输出的并发模型。（第 6 章）

R

• Retry，模型调用失败的重试装饰器，几何退避 + jitter。（第 22 章）
• RouterProvider，按模型名前缀路由到不同 provider。（第 21 章）
• RunState，HITL 暂停时的可序列化状态快照。（第 13 章）

S

• Sandbox，隔离执行不可信代码的环境。（第 32 章）
• Session，对话历史的持久化，让 Agent 跨 Run 记住上下文。（第 8 章）
• Skill，渐进式披露的 Agent 能力，SKILL.md 格式。（第 30 章）
• Span，Tracing 的单个工作单元，组成执行树。（第 25 章）
• strict mode，OpenAI 的严格 schema 校验模式。（第 3 章）
• StreamEvent，流式输出的三种事件类型。（第 6 章）

T

• Tool，Agent 调用的能力，由 Go 函数 + 自动生成 schema 定义。（第 3 章）
• ToolContext，工具调用时的上下文（RunContext + CallID + 参数）。（第 4 章）
• Trace，一次完整 Run 的追踪根，包含多个 Span。（第 25 章）
• Tracing，Agent 运行时的可观测系统。（第 25-27 章）
• Tripwire（跳闸），Guardrail 触发时的中断行为。（第 14 章）

W

• WebSocket，浏览器与服务器的双向通信协议，流式推送用。（第 36 章）

---

术语持续更新。遇到没收录的术语，查 agents-go 源码注释或 openai-agents-python 文档。

---

本文是《从 0 写 Agent》系列附录，全系列目录见总览。