從訊息到檔案，逐欄對照OpenAI 2.5.17 × Claude · Skills / Message / Session / Files

先對齊物件，再對齊欄位

本頁的「實際欄位」指官方公開 response 契約。未呼叫租戶 API，因此不把文件型別當作實測 payload，也不以一般模型推論 API 代替 Compliance API。

Skills · 能知道每個人用了哪些嗎？

可以做使用統計，但兩家資料面不同。OpenAI 2.5.17的訊息/agent事件可直接攜帶skill資訊；Claude另有Enterprise Analytics，並非只有transcript文字可推測。

查詢形狀（未執行）： GET /v1/organizations/analytics/skills?date=2026-09-01&group_by[]=user_id&group_by[]=product

需Claude Enterprise與Analytics API key（read:analytics，由primary owner於claude.ai建立）；不是Compliance key或一般Console Admin key。使用統計通常約次日17:00 UTC可用，需以query回報的最新可用日為準；最早2026-01-01。^[AG]

Skills清单、已啟用數與實際使用數不同。Bedrock等第三方工作負載不能自動視為此Enterprise統計涵蓋；關鍵名稱可能因隱私遮蔽。查核詳見Claude skills使用研究（本篇未附）。

01 · Message：身分、文字、時間與關聯

OpenAI 欄位起點為單筆 CONVERSATION_MESSAGE；Claude 起點為 Get chat messages 的回應。Claude session 訊息另見第三節。

02 · Conversation／Chat：容器中繼資料

先看一般聊天容器。OpenAI 的 conversation 是事件當時快照；Claude 的 chat metadata 是查詢取得的物件。

03 · Session：Codex 事件 vs Claude local／remote

這裡對照的是程式／代理工作階段。OpenAI CodexTask 是額外的 stateful task 物件；Claude local 與 remote 的欄位差異也必須保留。

04 · Tool call／result：能看到輸入、輸出到哪裡？

OpenAI 這一表主要指 CODEX_LOG。一般 ChatGPT message.author.tools_used 只是一份名稱清單，不能直接替代工具事件。

05 · 文件／附件：reference、metadata、binary 三層

比較時把 OpenAI message.files[] 與 Library 檔案分列，並把 Claude uploads、generated files、artifacts 分開；檔案ID在不同類別有不同下載路由。

06 · 圖片與原始文件：拿到的到底是什麼？

「附件出現在JSON」不等於「含原始圖片」；「hash驗證成功」也只表示所下載變體一致。

07 · 生成文件、Canvas 與 Project 文件

這些物件比一般file多出版本或文字內容語意。OpenAI Canvas與Claude artifact僅為概念近似；沒有ID或生命週期的一對一等價。

08 · 取得方式與HTTP契約

下列是路由，不是可直接執行的租戶請求。OpenAI的workspace/user ID與Claude帶型別前綴的ID須從各自來源取得。

09 · 縮減範例：相同一段文字，外層結構不同

以下全部為自行製作的合成片段，只展示本頁的結構差異；省略欄位不表示可省略的官方保證，也不是租戶實際資料。

{
  "event_id": "evt-synthetic-1",
  "type": "CONVERSATION_MESSAGE",
  "timestamp": "2026-09-08T01:00:00Z",
  "message": {
    "id": "msg-synthetic-1",
    "author": {
      "type": "assistant",
      "model": "example-model"
    },
    "content": {
      "type": "text",
      "value": "這是合成範例。"
    },
    "files": [
      {
        "id": "file-synthetic-1",
        "name": "report.pdf"
      }
    ]
  },
  "conversation": {
    "id": "conv-synthetic-1",
    "title": "合成對話"
  }
}

{
  "id": "claude_chat_synthetic",
  "model": "example-selected-model",
  "chat_messages": [
    {
      "id": "claude_chat_msg_synthetic",
      "role": "assistant",
      "created_at": "2026-09-08T01:00:00Z",
      "content": [
        {
          "type": "text",
          "text": "這是合成範例。",
          "thinking_redacted": false,
          "truncated": false
        }
      ],
      "generated_files": [
        {
          "id": "claude_gen_file_synthetic",
          "filename": "report.pdf",
          "mime_type": "application/pdf",
          "size_bytes": null,
          "md5": null
        }
      ]
    }
  ]
}

{
  "session": {
    "id": "clls_synthetic",
    "user": {
      "id": "user_synthetic",
      "email_address": null
    }
  },
  "data": [
    {
      "id": "clsm_synthetic",
      "role": "assistant",
      "model": "example-serving-model",
      "created_at": "2026-09-08T01:00:00Z",
      "provenance": null,
      "content": [
        {
          "type": "tool_use",
          "id": "toolu_synthetic",
          "name": "Read",
          "input": "{\"file_path\":\"example.txt\"}",
          "truncated": false
        }
      ]
    }
  ],
  "next_page": null
}

{
  "event_id": "evt-synthetic-2",
  "type": "CODEX_LOG",
  "event_type": "TOOL_CALL_COMPLETED",
  "event_details": {
    "detail_type": "TOOL_CALL_COMPLETED",
    "session_id": "session-synthetic",
    "tool_call_id": "call-synthetic",
    "tool_name": "Read",
    "tool_type": "example",
    "tool_input": "{\"file_path\":\"example.txt\"}"
  }
}

10 · 欄位比對後，最值得保留的結論

以下是從已核對契約導出的整合判讀，不新增本專案資料契約或變更程式。

查核範圍：ChatGPT／claude.ai一般訊息、Codex／Claude local與remote session、附件與圖片、生成文件、Canvas／artifact、Project檔案。未延伸為所有供應商API的全量目錄；未執行live API或生產操作。

欄位來源與查核資料

每張表的引用代碼連到以下精確reference；O是使用者提供OpenAPI快照，Claude是查核日的線上文件。

• [O] OpenAI OpenAPI 2.5.17（2026-09-04）（本篇未附）使用者提供契約：Conversation Messages／Codex tags，Library inline schema，BaseFile、CanvasContent、CodexTask 等。事件 tag 是文字契約，不是完整 required JSON Schema。
• [CM] Claude · Get chat messageschat_messages、content block union、檔案／artifact 欄位、型別、nullable 與 query。
• [CC] Claude · Chats / content guide聊天增量、刪除、文件下載與檔案種類。
• [CS] Claude · Session transcripts guidelocal／remote 的語意、provenance、圖片 placeholder、截斷與時間順序。
• [SA] Claude · Skill Usage AnalyticsEnterprise Analytics；per-user/group/product維度、skill識別與使用指標。
• [SD] Claude · Skill Usage完整Markdown schemaSkillUsageRow欄位與private名稱遮蔽、invocation reporting、explicit activation定義。
• [AF] Claude · Compliance activitiesSkills建立/啟用/停用/替換/刪除等生命週期；本次未找到skill使用/啟動事件。
• [AG] Claude · Analytics APIs guideAnalytics key與read:analytics、資料時效與coverage。
• [CL] Claude · List chatschat metadata 與分頁。
• [LS] Claude · List local sessionslocal session metadata。
• [LM] Claude · Local session messageslocal message、model、provenance、區塊與bytes參數。
• [RS] Claude · List remote sessionsremote owner、agent、啟動人、status及project。
• [RM] Claude · Remote session messagesremote message、sent_by_user_id、content_unavailable。
• [FM] Claude · Uploaded file metadata檔案metadata與反向message/chat關聯。
• [FD] Claude · Download uploaded file檔案bytes、headers及下載變體。
• [GM] Claude · Generated-file metadata生成檔案metadata。
• [GD] Claude · Download generated file生成檔案binary下載。
• [AM] Claude · Artifact version metadataartifact/version identity、type、hash、size。
• [AD] Claude · Download artifact version版本內容下載；沒有可據以聲稱的JSON envelope schema。
• [PA] Claude · Project attachmentsproject_file / project_doc union。
• [PD] Claude · Project document content文字document的JSON內容。
• [PM] Claude · Project document metadataUTF-8內容hash/size及project/user關聯。

可追溯盤點：OpenAI欄位筆記（本篇未附） · OpenAI契約擷取JSON（本篇未附） · Claude欄位筆記（本篇未附）。