內容管理

管理內容

內容檔案包含您希望 Amazon Q 在對話期間考慮的資訊。這些可能包括專案需求、編碼標準、開發規則，或任何其他有助於 Amazon Q 提供更相關回應的資訊。

有兩種方式可以設定內容：

• 客服人員資源 （建議）：客服人員組態檔案中定義的持久性內容

• 工作階段內容：使用 /context命令在聊天工作階段期間新增的臨時內容

使用代理程式資源設定持久性內容

設定內容的建議方法是透過代理程式組態檔案中的 resources 欄位。這會建立您每次使用代理程式時都可使用的持久性內容。

將檔案路徑或 glob 模式新增至代理程式組態中的resources陣列：

{
  "name": "my-agent",
  "description": "My development agent",
  "resources": [
    "file://README.md",
    "file://.amazonq/rules/**/*.md",
    "file://docs/**/*.md",
    "file://src/config.py"
  ]
}

資源的字首必須是 file://，才能包含為內容檔案。這些檔案會自動用於使用此代理程式的所有聊天工作階段。

新增臨時工作階段內容

您可以使用 /context add命令暫時將檔案新增至目前的聊天工作階段。這些新增項目僅適用於目前的工作階段，且不會在您啟動新的聊天工作階段時保留。

q chat
> /context add README.md
Added 1 path(s) to context.
Note: Context modifications via slash command is temporary.

您也可以使用 glob 模式一次新增多個檔案：

q chat
> /context add docs/*.md
Added 3 path(s) to context.
Note: Context modifications via slash command is temporary.

若要永久變更內容，請改為將檔案新增至代理程式的 resources 欄位。

檢視內容

若要檢視您目前的內容，請使用 /context show命令：

q chat
> /context show
👤 Agent (my-agent):
    README.md (1 match)
    .amazonq/rules/**/*.md (3 matches)
    docs/**/*.md (5 matches)

💬 Session (temporary):
    <none>

5 matched files in use:
👤 README.md (~250 tkns)
👤 .amazonq/rules/security.md (~180 tkns)
👤 .amazonq/rules/coding-standards.md (~320 tkns)
👤 docs/architecture.md (~150 tkns)
👤 docs/best-practices.md (~200 tkns)

Total: ~1100 tokens

輸出會顯示：

• 👤 客服人員：來自客服人員resources欄位的持續性內容

• 💬 工作階段：目前工作階段期間新增的暫時內容

移除內容

若要從目前的工作階段內容中移除檔案，請使用 /context rm命令：

q chat
> /context rm src/temp-file.py
Removed 1 path(s) from context.
Note: Context modifications via slash command is temporary.

若要清除所有工作階段內容，請使用 /context clear命令：

q chat
> /context clear
Cleared context
Note: Context modifications via slash command is temporary.

注意：您無法使用 /context命令移除代理程式定義的內容。若要永久移除內容，請編輯客服人員resources的欄位。

常用案例

以下是內容管理的一些常見使用案例：

使用專案規則

Amazon Q 支援可定義安全準則和限制的專案層級規則。這些規則在專案.amazonq/rules目錄中的 Markdown 檔案中定義。

例如，您可以建立規則來指定：

• Amazon Q 應該避免存取哪些目錄

• 產生程式碼的安全需求

• 編碼標準和最佳實務

包含專案規則的建議方法是透過您的代理程式組態：

{
  "name": "my-project-agent",
  "resources": [
    "file://.amazonq/rules/**/*.md",
    "file://README.md",
    "file://docs/architecture.md"
  ]
}

您也可以暫時將專案規則新增至目前的工作階段：

q chat
> /context add .amazonq/rules/*.md
Added 3 path(s) to context.
Note: Context modifications via slash command is temporary.

如需建立和使用專案規則的詳細資訊，請參閱 IDE 文件中的建立與 Amazon Q Developer 聊天搭配使用的專案規則。

從工作階段內容遷移至客服人員資源

如果您發現自己使用 /context add命令重複新增相同的內容檔案，請考慮將它們移至代理程式的 resources 欄位，以確保持久性：

1. 請注意您經常使用 新增的檔案 /context add

2. 編輯您的代理程式組態檔案

3. 使用file://字首將檔案路徑新增至resources陣列

4. 儲存代理程式組態

遷移範例：

# Instead of running these commands every session:
> /context add README.md
> /context add docs/*.md
> /context add .amazonq/rules/*.md

# Add them to your agent config once:
{
  "resources": [
    "file://README.md",
    "file://docs/**/*.md", 
    "file://.amazonq/rules/**/*.md"
  ]
}