設計您的合規整合

一個正式環境的 Compliance API 整合需要做出三項設計選擇：如何取用 Activity Feed（活動摘要）、其輸出如何與您的「security information and event management」（安全資訊與事件管理）系統，即 SIEM 進行關聯，以及活動與內容的長期副本存放於何處。這些選擇與端點本身無關；本頁協助您評估其中的取捨。

本頁假設您已閱讀以下頁面：

• 查詢 Activity Feed，其中定義了本文通篇引用的參數與分頁契約。
• 擷取與刪除聊天、檔案和專案，其中定義了聊天、檔案和專案端點，以及規劃內容保留中引用的 deleted_at 語意。
• 擷取工作階段逐字稿，其中定義了本機與遠端工作階段端點。

選擇摘要取用模式

Activity Feed 支援兩種取用模式：以 created_at.gte 和 created_at.lt 為界的定期視窗輪詢（window polling），以及游標驅動的增量讀取（cursor-driven incremental reads），後者會保存某次回應中的游標並在下一次請求時傳入。兩者回傳的 Activity 物件完全相同；差異在於您的用戶端在呼叫之間所保存的狀態。

兩種模式共享以下限制：

• 活動在發生後 1 分鐘內即可查詢，並保留 6 年。記錄不具追溯性：記錄從您的組織首次啟用 Compliance API 時開始，啟用前的活動不會回填。
• 每頁的最大 limit 為 5,000。
• 游標值是不透明的字串，您不得解析它們。
• 每個父組織的請求上限為每分鐘 600 次，由所有金鑰、所有連結的組織以及所有 /v1/compliance/* 端點共用；與本機工作階段端點不同，遠端工作階段端點在此之上還有第二層請求額度。請參閱 429 Too Many Requests 以了解回應標頭與重試契約。

視窗輪詢

將 created_at.lt 設定為至少過去 1 分鐘，以確保視窗中的每個活動都已可查詢。使用 created_at.gte 作為下界、created_at.lt 作為上界，使連續的視窗能無縫銜接、不留空隙也不重疊；將前一個視窗的 lt 值重複用作下一個視窗的 gte。

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/activities" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --data-urlencode "created_at.gte=2026-04-20T07:00:00Z" \
  --data-urlencode "created_at.lt=2026-04-20T08:00:00Z" \
  --data-urlencode "limit=5000"

當回應中 has_more: true 時，表示該視窗包含超過一頁的活動。您可以在視窗內分頁，將回應的 last_id 作為下一次請求的 after_id 傳入（當 has_more 為 false 時停止），或選擇較小的時間視窗。完整契約請參閱分頁結果。

即使銜接得很乾淨，在其視窗關閉後才完成索引的活動也永遠不會出現在之後的視窗中。請依活動 id 去除重複，並且要麼將每個新視窗加寬，使其與前一個視窗重疊幾分鐘，要麼執行定期的對帳程序，重新查詢較舊的視窗。

游標驅動的增量讀取

first_id="activity_01XyDMpzjS89pFZXqSFUBDr6"  # first_id from a previous response

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/activities" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --data-urlencode "limit=5000" \
  --data-urlencode "before_id=$first_id"

逐頁讀取直到 has_more 為 false，然後保存最後一次回應中的 first_id，並在下一次執行時原封不動地將其作為 before_id 傳入，以擷取比已儲存游標更新的活動。若要反方向走訪以進行回填，請改為保存 last_id 並將其作為 after_id 傳入。完整的游標與頁面權杖對照參考及重試語意，請參閱分頁結果。

正式環境的**追趕（catch-up）**迴圈會以 has_more 和 first_id 驅動迭代，擷取自您上次輪詢以來記錄的活動：

cursor = stored_cursor
loop:
  page = GET /v1/compliance/activities?before_id={cursor}&limit=5000
  store(page.data)
  if page.first_id is not null:
    cursor = page.first_id
  if not page.has_more: break
persist(cursor)

游標在金鑰輪替後仍然有效；請參閱管理與輪替金鑰。

與您的 SIEM 進行關聯

每個 Activity 都帶有可與您 SIEM（Splunk、Datadog、Microsoft Sentinel、Cribl 或類似系統）中既有事件進行聯結的欄位：

當 actor.type 為 user_actor 時，actor.user_id 和 actor.email_address 會存在。actor.ip_address 和 actor.user_agent 在某些 actor 類型上不存在，例如 anthropic_actor 和 scim_directory_sync_actor。在讀取這些欄位之前，請先檢查鑑別器（discriminator）。user_id 是使用者帳戶的穩定、不透明識別碼：它在每個 Compliance API 端點與活動酬載中保持一致，且不會因使用者的電子郵件或顯示名稱變更而改變。請使用 user_id 而非 email_address 作為主要聯結鍵。

對 Compliance API 本身的呼叫會產生 compliance_api_accessed 活動。請將這些活動與其他活動類型一併擷取，讓您的 SIEM 記錄誰在何時查詢了合規資料。傳入 activity_types[]=compliance_api_accessed 以限定查詢範圍，然後在您的用戶端中，從每個 actor.type 為 api_actor 的活動讀取 actor.api_key_id，以將該次存取歸屬於特定的 Compliance Access Key 或 Admin API 金鑰。

規劃內容保留

五種保留期限決定了您日後可以擷取的內容：

若要了解 Claude Platform 其他部分如何處理保留，請參閱 API 與資料保留。

請依下列方式在「匯出並封存」與「隨需 API 擷取」之間做出決定：

• 如果您對活動中繼資料或工作階段逐字稿的法律保留或稽核期限超過 6 年，請在擷取時將 Activity Feed 頁面與工作階段逐字稿匯出至您自己的封存。
• 如果您的內容保留政策短於您的 eDiscovery 期限，請在保留視窗到期前匯出聊天與檔案內容；Compliance API 無法回傳已被保留政策移除的內容。本機工作階段逐字稿亦同，當設定了有限期間時，它們會遵循您組織的自訂對話保留期間，即使該期間短於 6 年。一旦設定變更，本機工作階段端點便會立即停止回傳早於您組織目前期間的訊息，且日後延長期間也不會還原已過期的逐字稿，因此請匯出任何您必須保留超過該期間的逐字稿。
• 如果您必須在使用者於 claude.ai 中刪除聊天內容後仍保留該內容（例如依法律保留要求），請在擷取時將聊天、檔案和 artifact 內容匯出至您自己的封存；Compliance API 無法回傳使用者已刪除的內容。
• 如果某個工作流程可能發出 Compliance API 硬刪除（例如 DLP 強制執行），請先擷取並封存目標內容。硬刪除後沒有復原視窗。

在其他所有情況下，請依賴直接的 API 擷取，避免維護平行副本。

傳遞保證與完整性

請將 Activity Feed 視為至少一次（at-least-once）：正確分頁的走訪會至少回傳每個活動一次，但在部分失敗後的重試可能會重新傳遞您已儲存的活動。請依活動 id 欄位去除重複。

列表端點不會回傳 total_count 欄位或校驗和。若要證明某次匯出執行是完整的，請記錄：

• 起始游標與終止的 last_id。
• 匯出的記錄數量。
• 執行時間戳記與最後一頁的 request-id。

活動數量並非完整性檢查。claude_*_viewed 活動類型（例如 claude_chat_viewed）遵循各應用程式的載入模式（請參閱了解 Activity 物件）。某段期間有聊天訊息但沒有 claude_chat_viewed 活動，本身並不表示資料遺失。請改為依賴走訪以及視窗輪詢中所述的重疊或對帳程序。

內容端點（聊天、檔案、專案、專案附件，以及本機與遠端工作階段逐字稿）僅提供 Claude Enterprise 資料。Activity Feed 則呈現全組織範圍的管理與資源事件。Compliance API 不包含：

• 來自 Claude Console 的提示文字或模型回應，或來自以 API 金鑰驗證的 Claude API 工作負載的提示文字或模型回應。
• 本機工作階段中從未傳送至 Anthropic 的裝置端活動，例如 Claude 未讀取的本機檔案。
• 以 Claude Console API 金鑰驗證、透過第三方雲端平台（Amazon Bedrock、Google Cloud 或 Microsoft Foundry）執行，或在網頁版 Claude Code 中執行的 Claude Code 使用情況。
• 來自已啟用 HIPAA 就緒之組織的本機工作階段，以及適用零資料保留的本機工作階段。
• 工作階段逐字稿中的思考區塊，以及影像或其他二進位內容（逐字稿僅包含使用者提示、助理回應與工具活動；本機工作階段逐字稿會在省略二進位內容之處顯示佔位 text 區塊）。
• claude.ai 以擷取文字形式儲存的聊天附件原始檔案，例如部分 Word、PowerPoint 和 PDF 上傳（檔案內容端點會回傳擷取的文字；請參閱擷取檔案與 artifacts）。
• 本機工作階段的系統提示（以一則標記訊息代替）。
• 工作階段逐字稿（本機或遠端）中的工具定義與 MCP 伺服器設定，以及本機工作階段逐字稿中 text 區塊上的引用中繼資料。
• 其客戶管理加密金鑰目前無法使用之組織中的本機工作階段逐字稿內容。這些請求會回傳 503 Service Unavailable，而工作階段中繼資料仍會列出。
• 被您組織的保留政策移除的內容。
• 使用者在 claude.ai 中刪除之聊天的內容（這些聊天仍會列出，並填入 deleted_at）。
• 透過 Compliance API 硬刪除的內容。

請參閱 Compliance API 常見問題，以進一步了解 Compliance API 會擷取與不會擷取的內容。

為了維護監管鏈（chain of custody），請將匯出的記錄連同來源中繼資料一併儲存：來源端點、查詢參數、執行時間戳記，以及每筆記錄的內容雜湊值。

後續步驟