实验性功能 - Amazon Q 开发者版
管理实验性功能知识管理切线模式检查点上下文使用百分比Delegate待办事项清单增强的思维模式设置集成其他资源

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

实验性功能

Amazon Q 开发者版 CLI 包含实验性功能，可提供高级功能以提高工作效率。这些功能正在积极开发中，在使用前必须显式启用。

重要

实验性功能可能随时更改或移除。您可以自行决定在生产工作流程中使用它们。

管理实验性功能

使用 /experiment 命令可查看和切换实验性功能：

/experiment

这将显示一个交互式菜单，供您：

  • 查看每个实验的当前状态（开/关）

  • 通过选择实验来切换实验

  • 查看每个实验的用途的描述

知识管理

知识管理功能提供跨聊天会话的持久上下文存储和检索。使用以下命令启用此功能：

q settings chat.enableKnowledge true

基本用法

启用后，请在聊天会话中使用 /knowledge 命令：

/knowledge add <name> <path>

向知识库中添加文件或目录

/knowledge show

显示知识库中的所有条目

/knowledge remove <identifier>

按名称、路径或上下文 ID 移除条目

/knowledge update <path>

使用新内容更新现有知识库条目

/knowledge clear

从知识库中移除所有条目（要求确认）

/knowledge status

查看后台索引编制操作的状态

索引类型

添加内容时，有两种索引编制方法可供选择：

快速（--index-type Fast）

使用 BM25词法搜索。快如闪电般的索引编制和基于关键字的即时搜索。非常适合日志、配置和大型代码库。

最佳（--index-type Best）

使用 AI 嵌入进行语义搜索。理解上下文和含义的智能搜索。非常适合文档和研究。

示例用法：

/knowledge add "project-docs" /path/to/docs --index-type Best
/knowledge add "log-files" /path/to/logs --index-type Fast

特定于代理的知识库

每个代理都维护其自己的独立知识库，确保知识上下文的范围仅限于您正在使用的特定代理。当您在代理之间切换时，知识命令会自动与该代理的特定知识库配合使用。

切线模式

切线模式创建对话检查点，可让您在不中断主要对话流程的情况下探索附带话题。使用以下命令启用此功能：

q settings chat.enableTangentMode true

使用切线模式

启用后，使用 /tangent 或 Ctrl+T 来切换切线模式：

  1. 进入切线模式：创建对话检查点

    /tangent
Created a conversation checkpoint (↯). Use ctrl + t or /tangent to restore the conversation later.

  2. 在切线模式下：您会在提示中看到一个黄色 ↯ 符号

    ↯ > What is the difference between async and sync functions?

  3. 退出切线模式：返回主对话

    ↯ > /tangent
Restored conversation from checkpoint (↯). - Returned to main conversation.

最佳实践

使用切线模式可以：

  • 提出和澄清有关当前话题的问题

  • 在做决定之前探索替代方法

  • 获取有关 Q 开发者版 CLI 命令或功能的帮助

  • 测试对概念的理解

避免对完全无关的话题或冗长而复杂的讨论使用切线模式。

检查点

Checkpointing 启用会话范围的快照，以便使用 Git CLI 命令跟踪文件更改。此功能可创建一个 shadow bare git 存储库，用于管理聊天会话中的文件状态。

使用以下命令启用检查点功能：

q settings chat.enableCheckpoint true

特征

  • 快照文件更改为影子裸露 git 存储库

  • 列出、扩展、比较和恢复到任何检查点

  • 恢复检查点时，对话历史记录会随之消失

  • 在 git 存储库中自动启用（临时，会话结束时清理）

  • 非 git 目录可以手动初始化

基本用法

启用后，请在聊天会话中使用 /checkpoint 命令：

/检查点初始化

手动启用检查点（如果不在 git 存储库中，则为必填项）

/检查点列表 [--limit N]

使用文件统计信息显示回合级检查点

/检查点展开 <tag>

在特定回合下显示工具级检查点

/checkpoint 差异 <tag1>[tag2|Head]

比较检查点或与当前状态进行比较

/checkpoint 恢复 [<tag>] [--hard]

恢复到检查点（如果未指定标签，则显示交互式选择器）

/检查点清理

删除会话影子存储库

还原选项

默认还原行为：

  • 恢复跟踪的更改和删除内容

  • 保留检查点之后创建的文件

硬恢复（--hard标记）：

  • 使工作空间与检查点状态完全匹配

  • 删除检查点之后创建的跟踪文件

重要

Checkpointing 会创建临时的 git 存储库，这些存储库会在会话结束时被清理。请谨慎使用--hard恢复，因为它会永久删除文件。

上下文使用百分比

上下文使用百分比在聊天提示中以百分比形式显示您当前的上下文窗口使用情况，从而帮助您监控可用上下文窗口的使用量。

使用以下选项启用上下文使用百分比：

q settings chat.enableContextUsageIndicator true

特征

  • 显示提示中使用的上下文窗口的百分比（例如，“[rust-agent] 6% >”）

  • 带有颜色编码的指示器，便于快速直观参考

  • 帮助监控长时间对话期间的上下文窗口使用情况

视觉对象指示符

百分比显示使用颜色编码来指示使用级别：

绿色：使用率低于 50%

在有充足上下文空间的情况下正常运行

黄色：使用率 50-89%

适度使用，考虑上下文管理

红色：使用率为 90-100%

使用率高，上下文窗口快满了

Delegate

Delegate 支持启动和管理异步任务流程，允许您在主对话的同时与特定代理并行运行 Amazon Q 聊天会话。

使用以下方式启用委托：

q settings chat.enableDelegate true

特征

  • 使用自然语言启动后台任务

  • 与特定代理进行并行 Amazon Q 聊天会话

  • 独立监控任务进度

  • 用于安全执行任务的代理批准流程

使用量

使用自然语言要求模型启动后台任务：

Can you create a background task to analyze the performance of our API endpoints?

任务准备就绪后，请检查结果：

Check the status of my API analysis task
Show me the results from the background analysis

代理批准流程

与代理一起执行的任务：在执行之前需要明确批准并显示代理的详细信息

没有代理的任务：运行时会显示有关所有信任权限的警告

委派任务后，任务将独立运行，您可以：

  • 随时查看进度

  • 完成后读取结果

  • 在不再需要时删除任务

重要

委托任务以提升的权限运行。在批准任务执行之前，请仔细查看代理的详细信息。

待办事项清单

TODO 列表使 Amazon Q 能够自动创建和修改任务列表，同时为您提供查看和管理现有待办事项列表的命令。

使用以下命令启用待办事项列表：

q settings chat.enableTodoList true

特征

  • Amazon Q 会在适当时或在被要求时自动创建待办事项清单

  • TODOs 使用/todos命令查看、管理和删除

  • 恢复存储在中的现有待办事项列表 .amazonq/cli-todo-lists

  • 跨聊天会话的永久存储

基本用法

启用后，Amazon Q 将在对话期间自动创建待办事项列表。使用/todos命令来管理它们：

/todos 清晰完成

TODOs 在您的工作目录中删除已完成

/todos 简历

选择并恢复现有的待办事项列表

/todos 视图

选择并查看现有的待办事项列表

/todos 删除

选择并删除现有的待办事项列表

工作流集成

在以下情况下，Amazon Q 会创建待办事项清单：

  • 你要求提供任务明细

  • 讨论了复杂的多步骤流程

  • 进行项目规划对话

  • 您明确要求提供待办事项清单

待办事项列表会自动保存到聊天会话中.amazonq/cli-todo-lists并在聊天会话中保留，这样您就可以继续处理长期项目。

增强的思维模式

思维模式支持通过 step-by-step思维过程进行复杂的推理，从而为 Amazon Q 的决策过程提供透明度。

通过以下方式启用思维模式：

q settings chat.enableThinking true

特征

  • 显示复杂问题的 AI 推理过程

  • Step-by-step 多步推理的思维过程

  • 帮助了解如何得出结论

  • 对调试和学习很有用

  • 复杂任务的透明决策

何时使用

思维模式在以下方面特别有价值：

  • 复杂问题的解决：了解解决方案背后的原因

  • 调试帮助：查看故障排除的分析过程

  • 学习场景：了解概念是如何相互关联和相互依存的

  • 多步骤工作流程：遵循逻辑完成复杂的过程

设置集成

所有实验性功能都与 Amazon Q CLI 设置系统集成，并且可以跨会话持续使用。您可以通过以下方式管理实验：

交互式实验菜单：

/experiment

直接设置命令：

q settings chat.enableCheckpoint true
q settings chat.enableContextUsageIndicator true
q settings chat.enableKnowledge true
q settings chat.enableTangentMode true
q settings chat.enableThinking true
q settings chat.enableDelegate true
q settings chat.enableTodoList true

所有实验命令均可通过模糊搜索 (Ctrl+S) 获得：

  • /experiment-管理实验功能

  • /knowledge-知识库命令（启用后）

  • /checkpoint-检查点命令（启用时）

  • /todos-待办事项列表命令（启用时）

  • /tangent-切线模式切换（启用时）

这种集成使实验功能在您的工作流程中可以轻松发现和访问。

其他资源

有关实验性功能（包括高级配置选项和故障排除）的完整详细信息，请参阅 Amazon Q 开发者版 CLI 补充文档：