處理 Compliance API 錯誤
依 HTTP 狀態碼整理的每一則 Compliance API 錯誤訊息,包含原因與修正方式。
本頁列出每個已記載的 Compliance API 端點所回傳的回應訊息、其原因,以及修正方式。
Compliance API 以標準的 Anthropic 錯誤格式回傳錯誤:一個非 2xx 的狀態碼、一個 request-id 回應標頭,以及一個 JSON 主體,其中的 error 物件包含 type 與 message。當您向支援團隊提報問題時,請附上 request-id 標頭的值。
{
"error": {
"type": "authentication_error",
"message": "The API key provided is invalid or has been revoked."
}
}在本頁中,本機工作階段(local sessions)在使用者的機器上執行,遠端工作階段(remote sessions)則在雲端執行;請參閱擷取工作階段逐字稿。
請比對 error.type,而非訊息字串。訊息的穩定程度足以複製到操作手冊(runbook)中,但可能會隨時間改寫措辭;type 值則是 API 合約的一部分。本機工作階段端點有少數已記載的例外情況,其中共用同一 type 的回應需透過訊息來區分;每一處適用的地方都會特別註明。
下表讓您一眼就能判斷是否應重試。後續各節會顯示逐字的錯誤主體與修正方式。
| 狀態 | 是否重試? | 時機 |
|---|---|---|
| 400 Bad Request | 否 | 修正請求後重新送出。 |
| 401 Unauthorized | 否 | 修正或輪替金鑰,然後重新送出。 |
| 403 Forbidden | 否 | 加入缺少的 scope 或使用正確的金鑰類型,然後重新送出。 |
| 404 Not Found | 通常否 | 資源已被刪除或從未存在;請將其從您的佇列中移除。例外:在本機工作階段端點上,訊息 Local sessions are not available.(每次呼叫都會回傳,包括列表)表示這些端點目前對您的上層組織不可用,而非某個工作階段已消失;請保留您佇列中的 ID,並參閱找不到本機工作階段。仍處於 pending 狀態的遠端工作階段,在啟動之前其 messages 端點會回傳 404;請參閱找不到遠端工作階段。 |
| 409 Conflict | 否 | 請求與資源的目前狀態衝突;請解決衝突(例如分離子資源),然後重試。 |
| 429 Too Many Requests | 是,在 retry-after 之後 | 等待 retry-after 中的秒數後重試;不要推進您的游標。 |
| 500 Internal Server Error | 取決於 x-should-retry | 重試前請檢查 x-should-retry 回應標頭。 |
| 502、503、504、529 | 是,搭配退避 | 暫時性;請以指數退避重試。例外:部分本機工作階段的 503 並非暫時性。請參閱本機工作階段暫時不可用。 |
400 Bad Request
請求在語法上有效,但包含伺服器拒絕的參數。請修正該參數後重試。
無效的時間戳記格式
Type: invalid_request_error
The `created_at.gte` parameter contains an invalid timestamp format. Timestamps must be provided in RFC 3339 format e.g., "2024-03-01T00:00:00Z". Got "2024-01-01".原因: 某個 created_at.* 或 updated_at.* 值(.gte、.gt、.lte、.lt)無法解析為日期時間。訊息會指出失敗的參數名稱,並回顯所送出的值。
修正: 送出完整的 RFC 3339 時間戳記,包含時間與時區,例如 2024-03-01T00:00:00Z 或 2024-03-01T00:00:00+00:00。
本機工作階段列表(GET /v1/compliance/apps/sessions/local)在同時提供兩個時間界限且 created_at.lt 並未嚴格晚於 created_at.gte 時,也會回傳 400 invalid_request_error。主體內容為:
created_at.lt must be strictly after created_at.gte.請送出晚於 created_at.gte 的 created_at.lt,或省略其中一個界限。
無效的 limit
Type: invalid_request_error
The limit parameter must be between 1 and 1000, inclusive. Got 1500.原因: limit 查詢參數超出可接受的範圍。訊息中指出的界限反映了所呼叫之特定端點的最大值。
修正: 送出端點可接受範圍內的 limit。每個列表端點都有自己的 limit 範圍;請參閱對應 Compliance API 參考頁面上的參數限制。
工作階段逐字稿端點(GET /v1/compliance/apps/sessions/local/{session_id}/messages 與 GET /v1/compliance/apps/sessions/remote/{session_id}/messages)以相同方式驗證其截斷參數:tool_use_input_max_bytes 與 tool_result_max_bytes 各自接受正的位元組數或 -1(伺服器最大值),因此像 0 這樣的值會回傳相同的 400 invalid_request_error。
無效的分頁 ID
Type: invalid_request_error
Invalid `after_id`. No activity found for `after_id` "activity_invalid123"原因: after_id 或 before_id 游標無法解碼為不透明游標,也無法解析為活動 ID。
修正: 將分頁游標視為不透明字串。請一律複製上一頁回傳的 first_id 或 last_id 值;當 has_more 為 false 時停止。不要從物件 ID 自行建構游標。
目錄、專案與工作階段端點(組織、使用者、角色、角色權限、群組、群組成員、專案、專案附件、本機與遠端工作階段,以及工作階段訊息)使用不透明的 page 權杖進行分頁,而非 after_id 與 before_id。同樣的建議也適用:原封不動地傳入上一個回應中的 next_page 值,並在 has_more 為 false 時停止(或者,在不回傳 has_more 的工作階段端點上,當 next_page 為 null 時停止)。格式錯誤的 page 權杖會回傳與格式錯誤的 after_id 或 before_id 相同的 400 invalid_request_error。
兩個分頁式的本機工作階段端點(列表與 messages 端點)對於任何無法解碼的 page 值都會回傳下列 400 invalid_request_error,例如在您儲存後遭截斷或竄改的權杖,或由不同端點或在不同上層組織下核發的權杖。在本機工作階段 messages 端點(GET /v1/compliance/apps/sessions/local/{session_id}/messages)上,每個 page 游標也綁定於其核發時所對應的工作階段與 order,因此為不同工作階段或排序順序核發的游標會回傳相同的主體:
The page parameter is not a valid cursor for this request.messages 端點上的游標也會在走訪(walk,即完整翻過所有頁面一次)開始後 24 小時過期。過期的游標會回傳:
The page cursor has expired. Restart the walk without a page parameter; results will reflect the current retention boundary.對於第一個主體,請將上一個回應中未經修改的 next_page 值重新送至核發它的端點與工作階段。對於過期的游標,請在不帶 page 參數的情況下重新開始;新的走訪會反映其開始時生效的保留界限,因此在此期間已超出保留期限的訊息將不再回傳(請參閱擷取本機工作階段逐字稿)。
401 Unauthorized
x-api-key 標頭缺少或與已知金鑰不符。具有錯誤 scope 的有效金鑰則會回傳 403 Forbidden。
無效的 API 金鑰
Type: authentication_error
The API key provided is invalid or has been revoked.原因: x-api-key 中的金鑰不存在、已被刪除,或已被停用。缺少或空白的 x-api-key 標頭會回傳相同的主體,因此請同時檢查您的機密儲存庫與金鑰的撤銷狀態。
修正: 確認金鑰值,檢查它是否未在 claude.ai(Compliance Access Keys)或 Claude Console(Admin API 金鑰)中被刪除,並確認它已啟用。請參閱設定 Compliance API。
403 Forbidden
x-api-key 中的金鑰有效,但不具備端點所需的 scope。逐字訊息會列出金鑰所具備的 scope(Got:)以及端點所需的 scope(Needed:),因此您無需重新查看 Claude Console 或 claude.ai 即可確認金鑰具備哪些 scope。Compliance Access Key 的 scope 在建立後不可變更,因此每個 scope 不足的修正方式都會引導您建立新金鑰,而非編輯現有金鑰。獨立的 Claude Console 組織(沒有上層組織者)無法建立 Compliance Access Key,因此需要該金鑰的修正方式不適用於它;它只能查詢 Activity Feed。
Scope 不足:Activity Feed
Type: permission_error
Missing required scopes. Got: ['read:compliance_user_data'] Needed: ['read:compliance_activities']原因: 使用了不具 read:compliance_activities 的金鑰呼叫 GET /v1/compliance/activities。導致此錯誤的常見途徑有兩種:
- Compliance Access Key(
sk-ant-api01-...)在建立時未包含read:compliance_activitiesscope。 - Claude Console Admin API 金鑰(
sk-ant-admin01-...)是在組織尚未啟用 Compliance API 時建立的。在 Compliance API 未啟用時建立的金鑰不具備該 scope;請參閱設定 Compliance API。
修正: Compliance Access Key 的 scope 在建立後不可變更。請建立包含 read:compliance_activities 的新金鑰,或使用 Claude Console Admin API 金鑰。請參閱您需要哪種金鑰?以了解 Admin API 金鑰在何種條件下具備此 scope。
Scope 不足:組織資料
Type: permission_error
Missing required scopes. Got: ['read:compliance_user_data'] Needed: ['read:compliance_org_data']原因: 使用了不具 read:compliance_org_data 的金鑰呼叫組織、角色、群組或有效設定端點。導致此錯誤的常見途徑有兩種:
- Compliance Access Key(
sk-ant-api01-...)在建立時未包含read:compliance_org_datascope。 - 使用了 Claude Console Admin API 金鑰(
sk-ant-admin01-...)。Admin API 金鑰僅具備read:compliance_activities,無法讀取組織中繼資料。
修正: 建立新的 Compliance Access Key,並勾選 read:compliance_org_data。Admin API 金鑰無法讀取組織中繼資料;必須使用 Compliance Access Key。
已淘汰的 scope:組織設定
Type: permission_error
Missing required scopes. Got: ['read:compliance_org_settings'] Needed: ['read:compliance_org_data']原因: read:compliance_org_settings scope 已於 2026 年 6 月 30 日淘汰。GET /v1/compliance/organizations/{organization_id}/settings 現在需要 read:compliance_org_data,與其他組織端點相同的 scope,而已淘汰的 scope 不再授權任何操作。僅具備 read:compliance_org_settings 的 Compliance Access Key 在每次呼叫設定端點時都會回傳此錯誤,即使該金鑰在淘汰前可正常運作。建立金鑰時已無法再選取或授予已淘汰的 scope。
修正: Compliance Access Key 的 scope 在建立後不可變更。請建立新的 Compliance Access Key 並勾選 read:compliance_org_data,更新您的整合以使用它,然後刪除舊金鑰。已具備 read:compliance_org_data 的金鑰不受此淘汰影響。
Scope 不足:使用者資料
Type: permission_error
Missing required scopes. Got: ['read:compliance_activities'] Needed: ['read:compliance_user_data']原因: 使用了不具 read:compliance_user_data 的金鑰呼叫聊天、訊息、檔案、專案、工作階段、組織使用者或群組成員端點。導致此錯誤的常見途徑有兩種:
- Compliance Access Key(
sk-ant-api01-...)在建立時未包含read:compliance_user_datascope。 - 使用了 Claude Console Admin API 金鑰(
sk-ant-admin01-...)。Admin API 金鑰僅具備read:compliance_activities,且無法被授予read:compliance_user_data,因此無法呼叫聊天、檔案、專案、專案附件、工作階段、使用者或群組成員端點。
修正: 使用在 claude.ai 中建立並勾選 read:compliance_user_data 的 Compliance Access Key。如果該請求確實應僅限於 Activity Feed,請改將 Admin API 金鑰指向 GET /v1/compliance/activities。
Scope 不足:刪除
Type: permission_error
Missing required scopes. Got: ['read:compliance_user_data'] Needed: ['delete:compliance_user_data']原因: 使用了不具 delete:compliance_user_data 的 Compliance Access Key 呼叫聊天、檔案或專案的 DELETE 端點。
修正: 建立新的 Compliance Access Key 並勾選 delete:compliance_user_data。刪除 scope 與 read:compliance_user_data 分開,以確保唯讀稽核金鑰無法刪除內容。
404 Not Found
端點已解析,但資源 ID 不存在或已被刪除。Compliance API 的刪除是立即且永久的,因此對先前已知 ID 回傳 404 通常表示內容已透過 Compliance API 刪除呼叫被硬刪除,或已被保留政策移除。工作階段端點另外增加了兩種情況。在本機工作階段端點上,當這些端點對您的上層組織不可用時,每次呼叫(包括列表)都會回傳另一則 404 訊息 Local sessions are not available.;它與工作階段 ID 無關,且可能是暫時性的。請參閱找不到本機工作階段。在遠端工作階段端點上,仍在佈建中的工作階段(status 為 pending)尚無逐字稿,因此其 messages 端點在工作階段啟動前會回傳 404。請參閱找不到遠端工作階段。每個修正中引用的活動類型字串(例如 claude_chat_created)是您可以傳入 Activity Feed activity_types[] 篩選器的值;請參閱查詢合規活動以了解所有支援的值。
找不到聊天
Type: not_found_error
Chat claude_chat_01H5CWunD7RpVJ5bHa8RCkja not found.原因: 路徑中的聊天 ID 與可透過 Compliance API 讀取的聊天不符。該聊天可能已透過先前的 Compliance API 呼叫被硬刪除,或被您組織的保留政策移除,或者它可能屬於呼叫金鑰無法讀取的組織。使用者在 claude.ai 中刪除的聊天不會回傳 404;它們仍可讀取,deleted_at 會被填入,但不含其訊息內容。
修正: 對照最近的 claude_chat_created 或 claude_chat_viewed 活動確認聊天 ID。如果活動是最近的而讀取仍然失敗,則該聊天已被硬刪除(透過此 API 或因保留政策到期),或屬於您金鑰範圍之外的組織。
找不到檔案
Type: not_found_error
No file found with provided id, or it has already been deleted.原因: 檔案 ID 不存在或已被刪除。此錯誤同時適用於聊天附加檔案(claude_file_...)與專案檔案。
修正: 對照最近的 claude_file_uploaded 或 claude_file_deleted 活動進行核對。如果檔案已被刪除,二進位內容即已消失;活動記錄會在 6 年的保留期間內保留於 feed 中。
找不到專案
Type: not_found_error
No project is found with the provided id.原因: 專案 ID 不存在或已被刪除。
修正: 對照最近的 claude_project_created 或 claude_project_deleted 活動進行核對。即使專案本身已消失,Activity Feed 仍會持續公開該專案的生命週期事件。
找不到專案文件
Type: not_found_error
No project document found with provided id, or it has already been deleted.原因: 專案文件 ID 不存在或已被刪除。此錯誤適用於文字專案文件(claude_proj_doc_...),不適用於專案檔案。
修正: 使用 GET /v1/compliance/apps/projects/{project_id}/attachments 列出目前的附件。如果文件不在其中,表示它已被刪除;若您只需要中繼資料,可透過 claude_project_document_uploaded 活動記錄擷取。
找不到本機工作階段
Type: not_found_error
Local session not found.原因: 傳入 GET /v1/compliance/apps/sessions/local/{session_id} 或 GET /v1/compliance/apps/sessions/local/{session_id}/messages 的工作階段 ID 與可透過 Compliance API 讀取的本機工作階段不符。在下列情況下,兩個端點都會回傳這同一則訊息而不區分原因:該 ID 不是您金鑰可讀取之組織中的工作階段(包括屬於另一個上層組織的 ID)、該工作階段從未存在、該工作階段適用零資料保留,或該工作階段的所有活動皆已超過適用於執行它之組織的保留期限。Local session not found. 回應沒有暫時性形式,因為本機工作階段沒有佈建(pending)狀態;請對照找不到遠端工作階段,其中 pending 工作階段在啟動前會回傳 404。格式不正確的 clls_ 識別碼工作階段 ID 則會回傳 400 Bad Request。
當本機工作階段端點本身對您的上層組織不可用時,這些端點(包括列表端點)會回傳另一則 404 訊息 Local sessions are not available.。該回應與工作階段 ID 無關;客戶端的任何金鑰、scope 或設定都無法改變它,且它可能是暫時性的。兩種回應都帶有 not_found_error type;區分它們的是訊息文字。
修正: 對照 GET /v1/compliance/apps/sessions/local 確認工作階段 ID;請參閱使用者機器上的工作階段。如果該工作階段不再出現在列表中,表示其內容已超過保留期限(或該工作階段因其他原因不再位於您金鑰可讀取的組織中),其逐字稿無法擷取;請將該 ID 從您的佇列中移除。如果每次呼叫(包括列表)都回傳 Local sessions are not available.,請保留您佇列中的工作階段 ID,並在下一次排程執行時重試;如果該回應持續出現,請聯絡您的 Anthropic 代表並附上 request-id 回應標頭。
找不到遠端工作階段
Type: not_found_error
Remote session not found.原因: 傳入 GET /v1/compliance/apps/sessions/remote/{session_id}/messages 的工作階段 ID 與可透過 Compliance API 讀取的工作階段逐字稿不符。這會發生在工作階段 ID(cse_...)不存在或工作階段已被刪除時、工作階段屬於您金鑰無法讀取的組織時,或工作階段的 status 仍為 pending 時:pending 工作階段尚無逐字稿,因此 messages 端點在工作階段啟動前會回傳 404。格式不正確的 cse_ 識別碼工作階段 ID 則會回傳 400 Bad Request。
修正: 對照 GET /v1/compliance/apps/sessions/remote 確認工作階段 ID 及其 status;請參閱雲端中的工作階段。如果工作階段為 pending,請在它離開該狀態後重試。如果該工作階段不再出現在列表中,表示它已被刪除,其逐字稿無法擷取。
找不到組織、角色或群組
Type: not_found_error
The "ce86b5f3-7c16-48b3-a9f3-e1d2c4b8a0f1" organization does not exist or the requester is not authorized to access it.組織、角色與群組端點以標準錯誤格式回傳 404 not_found_error。組織訊息會指出 org_uuid;角色與群組訊息則為通用訊息(Role not found.、Group not found.)。這會發生在路徑 ID(org_uuid、role_id 或 group_id)不存在,或不再屬於呼叫金鑰可讀取的樹狀結構時。
原因: 路徑中的 ID 與可透過 Compliance API 讀取的記錄不符。角色與群組可以被刪除,組織也可以從上層樹狀結構中取消連結。
修正: 對照對應的列表端點驗證 ID,並對照 Activity Feed 中最近的組織、角色或群組活動進行核對。
組織設定不可用
Type: not_found_error
organization `91012d09-e48b-438e-a489-1bebfd8fa6f9` not found in this organization's hierarchy原因: GET /v1/compliance/organizations/{organization_id}/settings 在三種情況下回傳此 404,這三種情況刻意共用相同的主體,使回應不會揭露組織是否存在:organization_id 不是您上層組織的已連結組織之一、該值不是有效的 UUID,或設定端點尚未為您的上層組織啟用。
修正: 對照列出組織驗證 ID。如果已知正確的組織 ID 仍回傳 404,表示設定端點尚未為您的上層組織啟用;請聯絡您的 Anthropic 代表。
409 Conflict
請求格式正確且已獲授權,但與資源的目前狀態衝突。
專案有附加的聊天
Type: conflict_error
The "claude_proj_01KGp4eZNug9ri4kE35RSppq" project cannot be deleted as it has chats attached to it. Delete or detach all chats, and try deleting the project again.原因: 對仍有聊天附加的專案呼叫了 DELETE /v1/compliance/apps/projects/{project_id}。
修正: 使用 GET /v1/compliance/apps/chats?user_ids[]={user_id}&project_ids[]={project_id} 列出專案的聊天(project_ids[] 篩選器需要至少一個 user_ids[] 值;請透過列出組織使用者列舉 ID),使用 DELETE /v1/compliance/apps/chats/{claude_chat_id} 逐一刪除,然後重試專案刪除。
429 Too Many Requests
對 Compliance API 的請求限制為每個上層組織每分鐘 600 個請求。此限制是上層組織下所有金鑰(Compliance Access Keys 以及所有已連結組織的 Admin API 金鑰)與所有 /v1/compliance/* 端點共用的單一額度;遠端工作階段端點在此之上另有第二個請求額度。對於沒有上層組織的獨立 Claude Console 組織,相同的額度適用於該組織本身,並由其 Admin API 金鑰共用。如果您的整合需要更高的限制,請聯絡您的 Anthropic 代表。
一旦您的 API 金鑰通過驗證,Compliance API 回應會透過標準的速率限制回應標頭回報共用額度,讓您的用戶端可以主動節流,而非等待 429:
anthropic-ratelimit-requests-limit是每分鐘的請求額度。anthropic-ratelimit-requests-remaining是目前視窗中剩餘的額度。anthropic-ratelimit-requests-reset是視窗重設並恢復完整額度時的 RFC 3339 時間戳記。
429 回應也帶有 retry-after 標頭,其中包含送出下一個請求前應等待的秒數。此值可能包含超出 anthropic-ratelimit-requests-reset 的少量安全餘裕;請遵循 retry-after。
HTTP/1.1 429 Too Many Requests
date: Tue, 21 Apr 2026 14:38:02 GMT
retry-after: 25
anthropic-ratelimit-requests-limit: 600
anthropic-ratelimit-requests-remaining: 0
anthropic-ratelimit-requests-reset: 2026-04-21T14:38:25Z{
"error": {
"type": "rate_limit_error",
"message": "Compliance API rate limit of 600 requests per minute per parent organization has been exceeded. Retry after the time indicated by the retry-after header. Quote the request-id response header when contacting Anthropic support."
}
}原因: 您的上層組織(或獨立 Claude Console 組織)在 1 分鐘視窗內,跨所有共用其額度的金鑰,向 /v1/compliance/* 送出了超過 600 個請求,或者耗盡了遠端工作階段端點的第二個請求額度(本節稍後說明)。
修正: 等待 retry-after 標頭中的秒數後重試。如果該標頭不存在(例如被中介移除),請退回使用指數退避(從 1 秒開始,加倍至最多 60 秒)。遇到 429 時不要推進您的分頁游標:失敗的請求未回傳任何資料,因此上一個成功頁面的游標仍然正確。
驗證失敗的請求(缺少或無法辨識的金鑰,或使用 Claude API 金鑰而非 Compliance Access Key 或 Admin API 金鑰)會在速率限制器之前被拒絕,不會消耗配額。缺少端點所需 scope 的有效金鑰會在回傳 403 之前消耗一個配額單位。
本機工作階段端點僅計入共用限制。遠端工作階段端點在此之上另有第二個請求額度,與共用限制一樣以您的上層組織為鍵。來自該額度的 429 帶有永遠為 1 的 retry-after 標頭(最小等待時間,而非實際重設時間);該回應上的任何 anthropic-ratelimit-* 標頭描述的是共用限制而非此額度,因此若 429 重複出現,請以指數方式退避。
如果您依排程輪詢 Activity Feed,請將您的總請求速率(跨所有金鑰、已連結組織與並行工作者)控制在共用限制以下。請觀察 anthropic-ratelimit-requests-remaining,在達到限制前放慢速度。請參閱設計您的合規整合,以了解如何在視窗輪詢與游標驅動擷取之間做選擇。
500 Internal Server Error
當失敗是確定性的時,來自 Compliance API 的 500 會帶有 x-should-retry: false 回應標頭。Anthropic SDK 會自動遵循此標頭。如果您使用對每個 5xx 都重試的通用 HTTP 重試函式庫,請在 x-should-retry 為 false 時抑制重試;重試此錯誤在每次嘗試時都會以相同方式失敗。
不帶 x-should-retry: false 標頭的 500 是暫時性的:請以指數退避重試(從 1 秒開始,加倍至最多 60 秒)。502、503、504 與 529 回應也適用相同做法。例外是接下來說明的一小組本機工作階段 503,它們取決於組織的設定或加密金鑰,而非負載。請參閱錯誤以了解全平台的重試語意。
本機工作階段暫時不可用
Type: overloaded_error
The local-sessions index is temporarily unavailable. Try again shortly.Captured content is temporarily unavailable. Try again shortly.The local-sessions index cannot currently evaluate retention overrides for this page. Try again later.原因: 本機工作階段端點會以這些主體之一回傳 503。三者共用 overloaded_error type,因此這是本頁少數需要依訊息文字而非 error.type 來區分情況的錯誤之一:
index is temporarily unavailable主體表示工作階段列表因負載或後端狀況而短暫不可用。這是暫時性的。Captured content主體表示某個工作階段的逐字稿內容目前無法回傳。這通常也是暫時性的。在使用客戶管理加密金鑰的組織中,messages 端點也會對每個包含您的金鑰無法解密之內容的頁面回傳此主體,例如因為您停用、撤銷或銷毀了該金鑰,或因為無法連線至該金鑰。在這種情況下,只要金鑰無法使用,錯誤就會持續存在。兩種情況的訊息文字相同,因此金鑰是原因的唯一訊號是該錯誤在該組織持續重複出現。無法使用的金鑰永遠不會被回報為not_captured。retention overrides主體表示適用於所請求範圍內一個或多個工作階段的保留或資料處理設定尚無法評估。在擷取與 messages 端點上,它會顯示for this session而非for this page。它取決於執行該工作階段之組織的資料與設定,而非負載,且可能持續較長時間。
修正: 請依下列方式處理各主體:
- 對於兩個
Try again shortly.主體,請以指數退避重試,且不要推進您的page游標,因為失敗的請求未回傳任何資料。 - 如果
Captured content主體在使用客戶管理金鑰之組織的 messages 端點上持續重複出現,請將其視為持續性的:停止走訪該組織的逐字稿,並在您的金鑰管理服務中檢查金鑰狀態。其他已連結組織中的逐字稿,以及所有地方的工作階段中繼資料,皆不受影響。如果您在之後的執行中重試,請在不帶page的情況下重新開始每個工作階段的走訪,因為 messages 頁面游標會在走訪第一頁後 24 小時過期。 - 對於
Try again later.主體,不要讓走訪保持開啟以等待它清除。在列表端點上,您可以稍後透過不帶page參數重新開始來重試(超過 24 小時的列表頁面權杖仍會被接受,但會依目前的保留界限重新評估,因此擱置的走訪可能會跳過工作階段),或縮小created_at.gte與created_at.lt視窗直到請求成功,並在之後的執行中另行匯出被跳過的範圍。在擷取與 messages 端點上,請跳過該工作階段 ID,繼續進行其餘的匯出,並在之後的執行中重試該工作階段。messages 頁面游標會在走訪第一頁後 24 小時過期,因此當您回到該工作階段時,請在不帶page的情況下重新開始其走訪。
如果上述任何情況跨多次執行重複出現,請聯絡您的 Anthropic 代表並附上 request-id 回應標頭。對於客戶管理金鑰的情況,僅在您的金鑰可用而錯誤仍持續時才這麼做。
如遇全服務範圍的事件,請查看 status.anthropic.com。
後續步驟
關於存取、scope、保留與整合的常見問題。
全平台的錯誤目錄與重試語意。
Was this page helpful?