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

返回目录 / Agent 运行时

用 query 执行一次性 Agent 任务

通过异步消息流运行单次任务,并区分文本块与最终结果。

目标

用 query() 完成可审计的一次性任务并检查终态。

步骤

  1. 安装 Python SDK,导入 query、AssistantMessage、TextBlock 与 ResultMessage。 [readme]
  2. 用 async for 遍历 query(prompt=..., options=...) 返回的消息,只从 AssistantMessage 的 TextBlock 收集正文。 [readme]
  3. 记录 ResultMessage.subtype、result 与 total_cost_usd;不要把中间消息当作任务成功。 [readme]

验证方式

确认收到终态 ResultMessage,并把结果和费用字段与任务ID关联记录。

故障处理

若无终态,检查异步迭代是否被取消或 CLI 连接是否中断;不要用最后一条文本推断成功。

权限边界

前置条件

权限边界

限制

模型输出仍需业务校验;本地 SDK 调用需配置受支持的 Claude Code 认证与 CLI 运行环境。

固定上游来源

https://github.com/anthropics/claude-agent-sdk-python/blob/b6e9d12fe1cc98dde988ab7b7713c1feeee50c6c/README.md

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

仓库指标

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

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

尚未取得指标快照。

许可证: MIT

主主题

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

相关资源