---
{
  "id": "platform.conversation.overview",
  "topic": "conversation",
  "title": "對話存取與可用 actions",
  "locale": "zh-TW",
  "version": "2026-08-25",
  "summary": "Conversation actions 可檢查可存取的對話、管理生命週期與 tags、匯出可見歷史並管理 Agent membership；建立對話仍需使用 UI。",
  "content": "Conversation 是使用者與 Agents 交換訊息的容器。目前 live family 涵蓋探索、成員讀取與需確認的成員異動、歷史匯出、Office panel preferences、metadata 更新、刪除、archive/unarchive、tag CRUD 與 assignment，以及 Agent self-only withdraw。Registry 仍沒有建立對話的 action；`create_conversation` 維持 deferred。使用者要開新對話時，應引導他在 Arinova UI 建立。`delete_conversation` 使用 UserConfirm + Strict；archive/unarchive 不需確認。\n\n`conversations.agent_id` 指向該 Agent，或 `conversation_members` 有其 membership row 時，Agent 才能存取。其他情況 runtime 一律回 `resource_not_found` 而非 permission-denied；因此 not-found 無法區分資源不存在與無權存取。\n\n同一 Agent 可加入多個對話，包括多個 h2a。當前回合的對話與 action 明確傳入的 `conversationId` 是兩回事，讀取前應解析或確認目標。`get_panel_preferences` 讀取 triggering user 選定的 `notebookId`、`boardId` 與 `workbookId`；除非 triggering user 與執行 Agent 都仍有存取權，否則該 binding 會回 null，所以不能拿它取代 resource grant。`list_conversations` 先排 pinned，再依 `updated_at` 新到舊；每筆有可交給使用者的 `url` deep link。`export_conversation` 會把 Agent 有權看到的歷史以 JSON、text 或 PDF 寫入觸發使用者的個人 File Center；action result 不會直接回傳完整逐字稿。欄位、filter、limit 與 result shape 仍以 registry/runtime 為準。\n",
  "aliases": [
    "conversation",
    "找對話",
    "對話清單",
    "聊天成員",
    "建立新對話",
    "對話連結"
  ],
  "tags": [
    "conversation",
    "overview",
    "access"
  ],
  "relatedActions": [
    "arinova.conversation.add_member",
    "arinova.conversation.export_conversation",
    "arinova.conversation.list_conversations",
    "arinova.conversation.get_conversation",
    "arinova.conversation.list_members",
    "arinova.conversation.remove_member",
    "arinova.conversation.get_panel_preferences"
  ],
  "relatedActionPrefixes": [
    "arinova.conversation."
  ],
  "url": "https://docs.arinova.ai/zh-tw/kb/conversation/overview/"
}
---

Conversation 是使用者與 Agents 交換訊息的容器。目前 live family 涵蓋探索、成員讀取與需確認的成員異動、歷史匯出、Office panel preferences、metadata 更新、刪除、archive/unarchive、tag CRUD 與 assignment，以及 Agent self-only withdraw。Registry 仍沒有建立對話的 action；`create_conversation` 維持 deferred。使用者要開新對話時，應引導他在 Arinova UI 建立。`delete_conversation` 使用 UserConfirm + Strict；archive/unarchive 不需確認。

`conversations.agent_id` 指向該 Agent，或 `conversation_members` 有其 membership row 時，Agent 才能存取。其他情況 runtime 一律回 `resource_not_found` 而非 permission-denied；因此 not-found 無法區分資源不存在與無權存取。

同一 Agent 可加入多個對話，包括多個 h2a。當前回合的對話與 action 明確傳入的 `conversationId` 是兩回事，讀取前應解析或確認目標。`get_panel_preferences` 讀取 triggering user 選定的 `notebookId`、`boardId` 與 `workbookId`；除非 triggering user 與執行 Agent 都仍有存取權，否則該 binding 會回 null，所以不能拿它取代 resource grant。`list_conversations` 先排 pinned，再依 `updated_at` 新到舊；每筆有可交給使用者的 `url` deep link。`export_conversation` 會把 Agent 有權看到的歷史以 JSON、text 或 PDF 寫入觸發使用者的個人 File Center；action result 不會直接回傳完整逐字稿。欄位、filter、limit 與 result shape 仍以 registry/runtime 為準。