parallel-memory

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Parallel Memory

Parallel 内存

Action: $ARGUMENTS
Requires
parallel-cli >=0.8.1
. If the installed version is older, or
parallel-cli memory --help
fails with
no such command
or similar, tell the user to update
parallel-cli
, then retry.
操作:$ARGUMENTS
要求
parallel-cli >=0.8.1
。如果已安装版本较旧,或者执行
parallel-cli memory --help
时出现“no such command”或类似错误,请告知用户更新
parallel-cli
后重试。

When to use

使用场景

  • Inspect memory only when prior Parallel work may help fulfill the request or the user asks to retrieve, evict, or clear it.
  • Memory results are excerpts from past runs; fetch the source run for full records, and launch a fresh run when current information is required.
  • 仅当过往的Parallel工作成果有助于完成当前请求,或者用户要求调取、移除或清除内存记录时,才查看内存。
  • 内存结果是过往运行记录的片段;如需完整记录请调取源运行记录,若需要最新信息则启动新的运行任务。

Choose the operation

选择操作

User intentOperation
Recall prior work about a topicRetrieve with a concise query
Show recent past runsRetrieve without
query
Remove one saved Task, Monitor, or FindAll sourceEvict by exact
kind
and
id
Permanently remove all entries from your personal MemoryClear memory
Turn memory offDirect the user to account settings; do not clear as a substitute
用户意图操作
调取某主题的过往工作记录使用简洁查询语句进行调取
展示近期的过往运行记录不带
query
参数进行调取
删除一条已保存的Task、Monitor或FindAll源记录通过精确的
kind
id
进行移除
永久删除个人内存中的所有条目清除内存
关闭内存功能引导用户前往账户设置;请勿用清除内存替代关闭操作

Use the CLI

使用CLI

Use
parallel-cli memory
for retrieve, evict, and clear operations.
  • If memory is not eligible, report the returned reason; it distinguishes rollout, organization settings, account opt-in, and key eligibility.
  • On a key-eligibility error, tell the user to reauthenticate.
使用
parallel-cli memory
命令执行调取、移除和清除操作。
  • 如果无法使用内存功能,请告知返回的原因;原因包括功能部署状态、组织设置、账户选择加入状态以及密钥有效性。
  • 若出现密钥有效性错误,请告知用户重新认证。

Retrieve memory

调取内存

Form a short semantic query that describes the prior work to find. Apply filters when they help. Empty
results
is a successful retrieval with no matches, not an error.
  • Set
    kind
    to
    task
    ,
    monitor
    , or
    findall
    when it clearly narrows the retrieval.
  • Set
    since
    for an explicit timestamp boundary (RFC 3339, e.g.
    2026-08-01T00:00:00Z
    ).
  • Omit
    query
    when retrieving recent memories rather than a topic.
Retrieve by query:
bash
parallel-cli memory retrieve \
  --query "serverless inference vendors"
For recent memories:
bash
parallel-cli memory retrieve \
  --limit 5
编写一段简短的语义查询语句来描述要查找的过往工作记录。如有需要可使用筛选条件。
results
为空表示调取成功但无匹配记录,并非错误。
  • 当明确需要缩小调取范围时,将
    kind
    设置为
    task
    monitor
    findall
  • 设置
    since
    参数指定时间戳边界(遵循RFC 3339标准,例如
    2026-08-01T00:00:00Z
    )。
  • 当调取近期内存记录而非特定主题时,省略
    query
    参数。
按查询语句调取:
bash
parallel-cli memory retrieve \
  --query "serverless inference vendors"
调取近期记录:
bash
parallel-cli memory retrieve \
  --limit 5

Use results

使用结果

Available fields vary by
kind
:
  • task
    : use
    id
    ,
    updated_at
    ,
    input_excerpt
    , and
    output_excerpt
    .
  • monitor
    : use the monitor
    id
    , status, query excerpt, and matching event IDs, timestamps, and excerpts.
  • findall
    : use
    id
    ,
    updated_at
    , objective excerpt, and
    matched_count
    .
  • Fetch the original Task result, Monitor events, or FindAll result when exact output, entities, citations, or provenance matter.
  • Summarize the useful findings and unresolved questions.
  • Lead with what the prior work established, then list the contributing saved runs with kind, ID, and timestamp.
  • Distinguish recalled information from any fresh verification.
  • Parallel runs do not consult Memory. If recalled information may be useful, include the relevant details in the new run's input.
Expect ingestion to be asynchronous. Do not promise that a newly completed run will be immediately retrievable.
可用字段因
kind
类型而异:
  • task
    类型:使用
    id
    updated_at
    input_excerpt
    output_excerpt
    字段。
  • monitor
    类型:使用监控
    id
    、状态、查询片段、匹配的事件ID、时间戳和片段。
  • findall
    类型:使用
    id
    updated_at
    、目标片段和
    matched_count
    字段。
  • 当需要精确输出、实体、引用或来源信息时,调取原始的Task结果、Monitor事件或FindAll结果。
  • 总结有用的发现和未解决的问题。
  • 先说明过往工作已确认的内容,再列出相关的已保存运行记录,包括类型、ID和时间戳。
  • 区分调取的信息与新验证的信息。
  • Parallel运行任务不会参考内存记录。如果调取的信息可能有用,请将相关细节纳入新运行任务的输入中。
请注意记录 ingestion 是异步的。不要承诺刚完成的运行记录可立即调取。

Evict or clear memory

移除或清除内存

Evict a single run from your personal Memory, or clear it entirely. These do not delete the underlying Parallel runs. Ask for confirmation before clearing unless the user already asked for it.
bash
parallel-cli memory evict \
  --kind task \
  --id "trun_example"
bash
parallel-cli memory clear \
  --confirm-clear
从个人内存中移除单条运行记录,或清除所有内存记录。这些操作不会删除底层的Parallel运行任务。清除前需确认,除非用户已明确要求清除。
bash
parallel-cli memory evict \
  --kind task \
  --id "trun_example"
bash
parallel-cli memory clear \
  --confirm-clear