parallel-memory

Parallel Memory

操作：$ARGUMENTS

需要 parallel-cli >=0.8.1。如果已安装的版本较旧，或者 parallel-cli memory --help 报错 no such command 或类似错误，请告知用户更新 parallel-cli，然后重试。

适用场景

• 仅当先前的 Parallel 工作可能有助于完成请求，或用户要求检索、移除或清除记忆时，才检查记忆。
• 记忆结果是过去运行的摘录；如需完整记录，请获取源运行结果；如需当前信息，请启动新的运行。

选择操作

用户意图	操作
回忆某个主题的先前工作	使用简洁查询进行检索
显示近期的过去运行	不带 query 进行检索
移除某个已保存的 Task、Monitor 或 FindAll 来源	按确切的 kind 和 id 移除
永久移除个人记忆中的所有条目	清除记忆
关闭记忆	指引用户前往账户设置；不要以清除记忆代替

使用 CLI

使用 parallel-cli memory 执行检索、移除和清除操作。

• 如果记忆不符合使用条件，请报告返回的原因；该原因会区分推出计划、组织设置、账户主动选择和密钥资格。
• 如果出现密钥资格错误，请告知用户重新进行身份验证。

检索记忆

构造简短的语义查询，描述要查找的先前工作。适用时使用筛选条件。results 为空表示检索成功但没有匹配项，并非错误。

• 如果将 kind 设为 task、monitor 或 findall 能明显缩小检索范围，则设置该值。
• 对于明确的时间戳边界，请设置 since（RFC 3339 格式，例如 2026-08-01T00:00:00Z）。
• 检索近期记忆而非特定主题时，省略 query。

按查询检索：

parallel-cli memory retrieve \
  --query "serverless inference vendors"

检索近期记忆：

parallel-cli memory retrieve \
  --limit 5

使用结果

可用字段因 kind 而异：

• task：使用 id、updated_at、input_excerpt 和 output_excerpt。

• monitor：使用 monitor 的 id、状态、查询摘录，以及匹配事件的 ID、时间戳和摘录。

• findall：使用 id、updated_at、目标摘录和 matched_count。

• 如果需要精确输出、实体、引用或来源信息，请获取原始 Task 结果、Monitor 事件或 FindAll 结果。

• 总结有用的发现和未解决的问题。

• 先说明先前工作得出的结论，然后列出提供依据的已保存运行，包括 kind、ID 和时间戳。

• 明确区分回忆的信息与任何新近核实的信息。

• Parallel 运行不会查询 Memory。如果回忆的信息可能有用，请将相关详情纳入新运行的输入。

请注意，记忆摄取可能是异步的。不要承诺新完成的运行会立即可供检索。

移除或清除记忆

可以从个人记忆中移除单次运行，也可以将其全部清除。这些操作不会删除底层的 Parallel 运行。除非用户已明确提出清除请求，否则请先征求确认。

parallel-cli memory evict \
  --kind task \
  --id "trun_example"

parallel-cli memory clear \
  --confirm-clear