Agent 创收指南免费公开资源
中文 EN العربية

返回目录 / Agent 上下文

在会话开始时注入受控上下文

用 SessionStart hook 提供本次任务所需的固定提示信息,并在每次运行核验注入结果。

目标

将应用生成的任务上下文明确注入 Agent,而不是依赖隐式全局状态。

步骤

  1. 创建返回 hookSpecificOutput 的回调,设置 hookEventName="SessionStart" 和最小 additionalContext。 [hooks]
  2. 把回调放入 ClaudeAgentOptions(hooks={"SessionStart":[...]}),避免注入凭证或用户不需要的数据。 [hooks]
  3. 用测试任务在会话初始化后核对上下文是否出现,并检查新会话与恢复会话行为。 [hooks]

验证方式

init 后的 Agent 能看到规定上下文;日志记录上下文版本而不记录敏感正文。

故障处理

若上下文未生效,核对 hook key 和事件名;若恢复会话仍沿用旧内容,重新评估会话快照行为。

权限边界

前置条件

权限边界

限制

additionalContext 会进入模型上下文;避免注入秘密、过大文本或未授权文档。

固定上游来源

https://github.com/anthropics/claude-agent-sdk-python/blob/b6e9d12fe1cc98dde988ab7b7713c1feeee50c6c/examples/hooks.py

仓库
anthropics/claude-agent-sdk-python
文件路径
examples/hooks.py
固定提交
b6e9d12fe1cc98dde988ab7b7713c1feeee50c6c
来源检查
2026-10-14 · 已按固定上游来源核对

仓库指标

以下数字属于上游仓库整体,不代表单个 Skill 或指南的点赞/热度。

Stars
未取得
Forks
未取得
观测时间
未取得

尚未取得指标快照。

许可证: MIT

主主题

让编码 Agent 从理解上下文走到验证修改

相关资源