Grok WorldGrok Build CLI field station

回顧期號 / FILES

替 uploaded file 建立 lifecycle

追蹤 owner、purpose、content type、processing state、retention、expiry、derived index 與 deletion。

01 / DECIDE

架構決策

Document 或 media 需要被後續 API operation 引用時採用。

追蹤 owner、purpose、content type、processing state、retention、expiry、derived index 與 deletion。 先把 input、output、state、tool 與 side effect 畫成一條可觀察路徑,再決定 替 uploaded file 建立 lifecycle 的 owner。

02 / OPERATE

三步野戰程序

  1. 01

    鎖定合約

    寫下 caller、資料分類、成功條件、timeout、取消與 ownership。Document 或 media 需要被後續 API operation 引用時採用。

  2. 02

    執行有界路徑

    只建立一條 end-to-end path,保留 correlation、typed state 與 reversible failure。追蹤 owner、purpose、content type、processing state、retention、expiry、derived index 與 deletion。

  3. 03

    驗證訊號

    把驗收變成可重跑的 fixture、contract test 或 browser test。Lifecycle test 涵蓋 upload、processing、reject、expire、delete、unauthorized access 與 orphan cleanup。

03 / BOUND

Operation 邊界

驗證 type/size、避免公開暴露,並讓 deletion 傳遞到所有 dependent resource。

04 / PROVE

驗收證據

Lifecycle test 涵蓋 upload、processing、reject、expire、delete、unauthorized access 與 orphan cleanup。

SOURCE / HTTP

可重現來源探針

curl -fsSI 'https://docs.x.ai/developers/advanced-api-usage/files' | sed -n '1,5p'

PRIMARY / OFFICIAL

xAI 官方來源

來源核對 · 2026-08-10

  1. 01Files API