@agent-native/core 0.79.12 → 0.79.15

package/corpus/core/docs/content/locales/zh-TW/agent-surfaces.md

@@ -1,33 +1,33 @@
 ---
-title: "特工表面"
-description: "將 Agent-Native 無頭使用，作為丰富的聊天，在現有應用程式中，或作為完整的代理本機應用程式。"
-search: "無頭代理丰富聊天完整應用程式 BYO 代理執行時 AgentChatRuntime 嵌入 actions MCP A2A HTTP CLI"
+title: "代理表面"
+description: "將 Agent-Native 無頭使用，作為豐富的聊天，在現有應用程式中，或作為完整的 Agent-Native 應用程式。"
+search: "無頭代理豐富聊天完整應用程式 BYO 代理執行時 AgentChatRuntime 嵌入 actions MCP A2A HTTP CLI"
 ---
 
-# 特工表面
+# 代理表面
 
-Agent-Native 是故意可組合的。不用太多就可以使用代理UI，
-在沒有內置代理執行時的情況下使用 UI，或者將兩者一起用作完整的
+Agent-Native 是故意可組合的。不用太多就可以使用代理 UI，
+在沒有內建代理執行時的情況下使用 UI，或者將兩者一起用作完整的
 應用程式。
 
 有用的選取方法不是先按協議。選取產品表面
 你想要，然後使用匹配的原語。
 
-| 表面                          | 什么時候使用它                                                                   | 開始於                                                                                      |
-| ----------------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
-| **無頭代理**                  | 程式碼、作業、腳本、另一個應用程式或另一個代理應直接調用該工作。                 | `agent-native create --headless`, `defineAction`, `agent-native agent`, HTTP, CLI, MCP, A2A |
-| **Agent-Native 上的丰富聊天** | 您想要由內置代理循環支持的獨立或嵌入式聊天。                                     | [Chat template](/docs/template-chat), `<AgentChatSurface>`, `<AssistantChat>`               |
-| **與您的代理進行丰富的聊天**  | 您在其他地方建置了代理，並想要 Agent-Native 的編寫器、腳本、工具卡和本機小部件。 | `AgentChatRuntime`, `<AssistantChat runtime={runtime}>`                                     |
-| **嵌入式邊車**                | 您已經有一個 SaaS 應用程式，並希望在其旁邊有一個具有頁面上下文和主機指令的代理。 | `createAgentNativeEmbeddedPlugin()`, `AgentNativeEmbedded`                                  |
-| **完整應用程式**              | 人類和代理應該共用持久的螢幕、資料、導覽和協作。                                 | 範本、actions、SQL 狀態、上下文感知                                                         |
+| 表面                          | 什麼時候使用它                                                                     | 開始於                                                                                      |
+| ----------------------------- | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
+| **無頭代理**                  | 程式碼、作業、指令碼、另一個應用程式或另一個代理應直接呼叫該工作。                 | `agent-native create --headless`, `defineAction`, `agent-native agent`, HTTP, CLI, MCP, A2A |
+| **Agent-Native 上的豐富聊天** | 您想要由內建代理迴圈支援的獨立或嵌入式聊天。                                       | [Chat template](/docs/template-chat), `<AgentChatSurface>`, `<AssistantChat>`               |
+| **與您的代理進行豐富的聊天**  | 您在其他地方建置了代理，並想要 Agent-Native 的編寫器、指令碼、工具卡和本機小工具。 | `AgentChatRuntime`, `<AssistantChat runtime={runtime}>`                                     |
+| **嵌入式邊車**                | 您已經有一個 SaaS 應用程式，並希望在其旁邊有一個具有頁面脈絡和主機指令的代理。     | `createAgentNativeEmbeddedPlugin()`, `AgentNativeEmbedded`                                  |
+| **完整應用程式**              | 人類和代理應該共用持久的螢幕、資料、導覽和協作。                                   | 範本、actions、SQL 狀態、脈絡感知                                                           |
 
 這些是階段，而不是單獨的產品。工作流程可以以無頭方式啟動
 代理只需執行一個操作，就會以表格或圖表的形式出現在聊天中，然後成為
-應用程式中的全屏，而不更改代理調用的操作。
+應用程式中的全螢幕，而不更改代理呼叫的操作。
 
 ```an-diagram title="表面光譜" summary="一個操作介面，四種產品形狀——每一種都增加了 UI，而不改變下面的操作。"
 {
-  "html": "<div class=\"diagram-spectrum\"><div class=\"diagram-card\"><strong>Headless</strong><small class=\"diagram-muted\">actions、工作、腳本、其他代理</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>丰富聊天</strong><small class=\"diagram-muted\">輸入框、轉錄、工具卡片</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>嵌入式 sidecar</strong><small class=\"diagram-muted\">agent beside an existing app</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card accent-card\"><span class=\"diagram-pill accent\">大部分 UI</span><strong>完整應用</strong><small class=\"diagram-muted\">持久螢幕、資料、協作</small></div></div><div class=\"diagram-base\" data-rough><span class=\"diagram-muted\">相同 actions · 相同 SQL · 相同代理循環</span></div>",
+  "html": "<div class=\"diagram-spectrum\"><div class=\"diagram-card\"><strong>Headless</strong><small class=\"diagram-muted\">actions、工作、指令碼、其他代理</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>豐富聊天</strong><small class=\"diagram-muted\">輸入框、轉錄、工具卡片</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>嵌入式 sidecar</strong><small class=\"diagram-muted\">agent beside an existing app</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card accent-card\"><span class=\"diagram-pill accent\">大部分 UI</span><strong>完整應用</strong><small class=\"diagram-muted\">持久螢幕、資料、協作</small></div></div><div class=\"diagram-base\" data-rough><span class=\"diagram-muted\">相同 actions · 相同 SQL · 相同代理迴圈</span></div>",
   "css": ".diagram-spectrum{display:flex;align-items:stretch;gap:10px;flex-wrap:wrap}.diagram-spectrum .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:150px;flex:1}.diagram-spectrum .diagram-arrow{align-self:center;font-size:22px;line-height:1}.diagram-base{margin-top:12px;padding:10px 14px;text-align:center}"
 }
 ```
@@ -35,42 +35,42 @@ Agent-Native 是故意可組合的。不用太多就可以使用代理UI，
 ## 無頭代理 {#headless}
 
 當沒有人需要盯著自訂應用螢幕時，請使用無頭路徑
-工作執行：計畫作業、整合、後端工作流程、CLI 循環，
-另一個代理或調用 Agent-Native 的現有產品。
+工作執行：計畫作業、整合、後端工作流程、CLI 迴圈，
+另一個代理或呼叫 Agent-Native 的現有產品。
 
 這也是當**代理*是*產品**時要達到的形狀 -
-app-agent 循環是前門，而不是儀表板。您從
+app-agent 迴圈是前門，而不是儀表板。您從
 終端、Slack、電子郵件、預定工作、其他代理或聊天 —“總結我的
-未讀電子郵件，”“將每日指標發布到 Slack，”“查找符合以下條件的候選人
-上週回複”——代理執行操作並返回結果
+未讀電子郵件，”“將每日指標發布到 Slack，”“尋找符合以下條件的候選項
+上週回覆”——代理執行操作並返回結果
 屬於。它仍然是一個真正的應用程式，而不是無狀態提示：actions，驗證工作階段，
-應用程式狀態、線程/執行歷史紀錄、設定、憑證和共用紀錄全部實時
-在SQL。
+應用程式狀態、對話串/執行歷史紀錄、設定、憑證和共用紀錄全部即時
+在 SQL。
 
 在以下情況下選取此模式：
 
-- **工作在後台進行。**大部分價值是在使用者不注意的時候創造的 - 分類代理、每日報告代理、待命回應人員。
-- **輸出離開應用程式。**代理發布到 Slack、發送電子郵件或更新第三方系統；應用內沒有任何內容可供瀏覽。
-- **該域是一次性的。**研究機器人、摘要生成器、報告編寫器 - 沒有需要列表視圖的持久物件。
-- **您正在制作原型。**立即發送代理；如果使用者想要的話，稍後新增更丰富的 UI。
+- **工作在背景進行。**大部分價值是在使用者不注意的時候創造的 - 分類代理、每日報告代理、待命回應人員。
+- **輸出離開應用程式。**代理發布到 Slack、傳送電子郵件或更新第三方系統；應用內沒有任何內容可供瀏覽。
+- **該域是一次性的。**研究機器人、摘要生成器、報告編寫器 - 沒有需要清單檢視的持久物件。
+- **您正在製作原型。**立即傳送代理；如果使用者想要的話，稍後新增更豐富的 UI。
 
 如果您的產品是圍繞持久物件建置的，使用者會瀏覽、透視和
 分享 — 電子郵件、事件、檔案、圖表 — 選取 [full application](#full-application)
 或 [template](/docs/cloneable-saas) 代替；這些新增了完整的 UI _plus_ 代理。
 
-### 盒子裡裝的是什么 {#in-the-box}
+### 盒子裡裝的是什麼 {#in-the-box}
 
-無頭應用程式會跳過數週的儀表板工作，並且從一天開始就與渠道無關
+無頭應用程式會跳過數週的儀表板工作，並且從一天開始就與管道無關
 一個 - 同一代理從網路、Slack、Telegram、電子郵件和其他代理執行
-因為一切都通過代理，而不是 UI。權衡是有的
-沒有“一目了然地瀏覽所有內容”視圖；如果使用者需要，請混合模式和
-新增小型狀態頁面或列表視圖。
+因為一切都透過代理，而不是 UI。權衡是有的
+沒有“一目了然地瀏覽所有內容”檢視；如果使用者需要，請混合模式和
+新增小型狀態頁面或清單檢視。
 
-當新增內置的Chat shell時，框架提供了五種管理
+當新增內建的Chat shell時，框架提供了五種管理
 您不必建置的介面：**聊天**（主要輸入）、**工作區**
-（skills、內存、指令、子代理、連線的 MCP 伺服器、已調度
-jobs）、**作業歷史紀錄**、**線程歷史紀錄**和**設定**。這些通常是
-足夠了——與它交談，看看它做了什么，設定它的行為方式。伸手去拿
+（skills、記憶、指令、子代理、連線的 MCP 伺服器、已調度
+jobs）、**作業歷史紀錄**、**對話串歷史紀錄**和**設定**。這些通常是
+足夠了——與它交談，看看它做了什麼，設定它的行為方式。伸手去拿
 [Chat](/docs/template-chat) 當您準備好新增瀏覽器 UI 時，或
 [Dispatch template](/docs/template-dispatch) 工作空間式啟動
 使用 Slack/Telegram、計畫作業和開箱即用的共用機密。
@@ -100,21 +100,21 @@ export default defineAction({
 });
 ```
 
-然後可以調用一個操作：
+然後可以呼叫一個操作：
 
 - **HTTP** — `POST /_agent-native/actions/summarize-week`
 - **CLI** — `pnpm action summarize-week --formId form_123`
 - **應用程式代理 CLI** — `pnpm agent "Summarize form_123"`
 - **MCP** — 來自 Claude、ChatGPT、Codex、Cursor、OpenCode、Copilot 和其他 MCP 主機
-- **A2A** - 來自另一個代理本機應用程式或代理對等點
-- **UI** — 通過 `useActionQuery`、`useActionMutation` 或 `callAction`
-- **代理工具** - 來自內置聊天循環
+- **A2A** - 來自另一個 Agent-Native 應用程式或代理對等點
+- **UI** — 透過 `useActionQuery`、`useActionMutation` 或 `callAction`
+- **代理工具** - 來自內建聊天迴圈
 
-```an-api title="通過 HTTP 調用操作"
+```an-api title="透過 HTTP 呼叫操作"
 {
   "method": "POST",
   "path": "/_agent-native/actions/summarize-week",
-  "summary": "通過 HTTP 按名稱調用任何操作",
+  "summary": "透過 HTTP 按名稱呼叫任何操作",
   "description": "Every `defineAction` is auto-mounted at `/_agent-native/actions/<name>`. The JSON body is validated against the action's zod schema before `run` executes.",
   "request": {
     "contentType": "application/json",
@@ -127,23 +127,23 @@ export default defineAction({
 }
 ```
 
-這不是無資料庫或無狀態模式。應用程式代理循環存儲工作階段，
-線程、執行、設定、憑證、應用程式狀態和共用紀錄
-SQL。本機開發預設為SQLite；託管無頭應用程式應使用
+這不是無資料庫或無狀態模式。應用程式代理迴圈儲存工作階段，
+對話串、執行、設定、憑證、應用程式狀態和共用紀錄
+SQL。本機開發預設為 SQLite；託管無頭應用程式應使用
 持久 SQL 資料庫。
 
-如果您需要從專案資料夾中無頭地執行整個代理循環，請使用：
+如果您需要從專案資料夾中無頭地執行整個代理迴圈，請使用：
 
 ```bash
 pnpm agent "Summarize this week's forms."
 ```
 
-如果另一個應用程式或腳本需要調用整個代理，請使用
+如果另一個應用程式或指令碼需要呼叫整個代理，請使用
 `agentNative.invoke("analytics", "...")` 或 `agent-native invoke` CLI。那
 將跨應用工作保留在 A2A 路徑上，而本機工作保留在 actions 上。
 
-工作人員、作業、整合 webhooks 和自訂主機可以驅動代理循環
-直接通過伺服器API。這比 actions 級別低 - 您提供
+工作人員、作業、整合 webhooks 和自訂主機可以驅動代理迴圈
+直接透過伺服器 API。這比 actions 層級低 - 您提供
 您自己的引擎、模型、訊息、actions 和事件接收器：
 
 ```ts
@@ -152,28 +152,28 @@ import { runAgentLoop } from "@agent-native/core/server";
 await runAgentLoop({ engine, model, systemPrompt, actions, messages, send });
 ```
 
-對於大多數應用程式，計畫的提示和整合 webhooks 已經調用此循環
-給你。僅在建置自訂無頭主機時直接獲取它，eval
-執行程序，或伺服器端編排表面 - 請參閱[伺服器 - 正式環境代理
-handler](/docs/server#agent-handler) 獲取完整簽名。
+對於大多數應用程式，計畫的提示和整合 webhooks 已經呼叫此迴圈
+給你。僅在建置自訂無頭主機時直接取得它，eval
+執行程式，或伺服器端編排表面 - 請參閱[伺服器 - 正式環境代理
+handler](/docs/server#agent-handler) 取得完整簽名。
 
 ### 針對資料夾執行 {#folder-loop}
 
 如果您的目標是“針對此資料夾執行代理”，請從應用程式代理開始
-在該資料夾中循環：建置無頭應用程式，新增 actions/指令，執行
+在該資料夾中迴圈：建置無頭應用程式，新增 actions/指令，執行
 `pnpm agent "..."`。這使工作保持在相同的操作/執行時/狀態內
 應用程式將在正式環境中使用的合同。
 
 外部編碼線束是用於嵌入 Claude 的獨立產品表面
 Agent-Native 應用內的程式碼、Codex、Pi、Cursor、Mastra 或類似執行時。
 在建置編碼代理產品時使用它們，而不是作為預設方式
-啟動本機代理本機工作流程。
+啟動本機 Agent-Native 工作流程。
 
 ### 雲端儲存庫存取 {#cloud-repo-access}
 
 對於需要儲存庫存取的雲端無頭應用程式，請使用 GitHub 連線器
 加上代幣CRUD模型：列出儲存庫、搜尋檔案、讀取檔案、建立或
-通過提供者範圍編輯檔案、刪除檔案和撤銷存取權限
+透過提供者範圍編輯檔案、刪除檔案和撤銷存取權限
 憑證。在本機開發中，明確設定目標儲存庫：
 
 ```bash
@@ -183,20 +183,20 @@ GITHUB_REPOSITORY=owner/repo pnpm agent "Read README.md and suggest the next act
 不要將虛擬機克隆或長期沙箱簽出視為主要雲端
 儲存庫存取模型。沙箱對於隔離程式碼執行仍然很重要，但是
 儲存庫存取應該是明確的、經過授權的、可審核的和可撤銷的
-通過連線器層。
+透過連線器層。
 
 ### 共用工作階段和執行 {#sharing-runs}
 
 無頭工作階段和執行是持久物件。共用性應該分階段進行：
 首先閱讀/共用連結，以便隊友可以檢查經過清理的提示、輸出
 和執行狀態；稍後授予可寫協作權限，因此繼續執行，
-批準 actions、編輯計畫或更改設定已完成
+核准 actions、編輯計畫或更改設定已完成
 顯式存取檢查。
 
-## Agent-Native 上的丰富聊天 {#rich-chat}
+## Agent-Native 上的豐富聊天 {#rich-chat}
 
-當使用者應該與代理交談時使用內置聊天，檢視工具調用，
-批準工作、檢查本機結果並保留持久的線程歷史紀錄。
+當使用者應該與代理交談時使用內建聊天，檢視工具呼叫，
+核准工作、檢查本機結果並保留持久的對話串歷史紀錄。
 
 要獲得完整的應用程式起點，請使用 [Chat template](/docs/template-chat)：
 
@@ -218,7 +218,7 @@ export default function ChatRoute() {
 在兩個表面上安裝`storageKey`，啟用`chatViewTransition`，並安裝
 布局中的聊天主頁面切換助手。聊天之外的普通應用內連結
 頁面可以將完整的聊天內容轉變為側邊欄，同時保持活動狀態
-線程：
+對話串：
 
 ```tsx
 import {
@@ -266,16 +266,16 @@ export function ProjectChat({ threadId }: { threadId: string }) {
 }
 ```
 
-Actions 可以返回顯式的本機小部件結果，因此聊天輸出不僅僅是
-文本。表格、圖表和鍵入的產品卡呈現為第一方 React
+Actions 可以返回顯式的本機小工具結果，因此聊天輸出不僅僅是
+文字。表格、圖表和鍵入的產品卡呈現為第一方 React
 聊天中的元件，沒有 iframe。參見[Native 聊天介面](/docs/native-chat-ui)。
 
-## 與您的代理進行丰富的聊天 {#byo-agent}
+## 與您的代理進行豐富的聊天 {#byo-agent}
 
 當您的代理已使用其他框架建置時，請使用此路徑
 執行時，你想要 Agent-Native 的聊天 UI 圍繞它。 `AgentChatRuntime` 是
 邊界：您的執行時流規範化事件，Agent-Native 呈現
-作曲家、腳本、工具調用、批準、本機小部件和應用布局。
+撰寫器、指令碼、工具呼叫、核准、本機小工具和應用布局。
 
 ```tsx
 import {
@@ -296,13 +296,13 @@ export function SupportAgentChat() {
 Agent SDK、Vercel AI SDK 和 AG-UI，以及上面的標準化 HTTP 執行時
 對於任何其他代理（Mastra、Flue、Eve、LangGraph 或自訂服務）。 ACP 是
 不是最終使用者應用聊天或 A2A 傳輸，並且 Agent-Native 目前沒有
-要求 A2UI 支持。 ACP 在一個特定位置受支持 - 駕駛本機
-編碼代理（Gemini CLI，Claude程式碼，...）通過
+要求 A2UI 支援。 ACP 在一個特定位置受支援 - 駕駛本機
+編碼代理（Gemini CLI，Claude 程式碼，...）透過
 [harness layer](/docs/harness-agents#acp)，這裡不作為聊天執行時。
 
 [Native 聊天介面 — BYO agent runtimes](/docs/native-chat-ui#byo-agent-runtimes)
 是事件形狀、執行時助手和 `chatUI` 的規範主頁面
-工具結果元資料。將外部代理連線到聊天中時從這裡開始。
+工具結果中繼資料。將外部代理連線到聊天中時從這裡開始。
 
 ## 嵌入式邊車 {#embedded-sidecar}
 
@@ -322,7 +322,7 @@ export default createAgentNativeEmbeddedPlugin({
 });
 ```
 
-React sidecar 傳遞頁面上下文和主機指令：
+React sidecar 傳遞頁面脈絡和主機指令：
 
 ```tsx
 import { AgentNativeEmbedded } from "@agent-native/core/client";
@@ -345,15 +345,15 @@ export function AppShell({ children }) {
 }
 ```
 
-```an-diagram title="Sidecar 如何橋接到主機應用程式" summary="該外掛在伺服器端掛載 Agent-Native 路由； React sidecar 流輸入頁面上下文並輸出主機指令。"
+```an-diagram title="Sidecar 如何橋接到主機應用程式" summary="該外掛在伺服器端掛載 Agent-Native 路由； React sidecar 流輸入頁面脈絡並輸出主機指令。"
 {
-  "html": "<div class=\"diagram-sidecar\"><div class=\"diagram-panel\"><strong>宿主應用</strong><small class=\"diagram-muted\">你現有的 SaaS</small><div class=\"diagram-node\">getContext()<br><small class=\"diagram-muted\">路由 · 選取</small></div><div class=\"diagram-node\">onNavigate / onRefresh<br><small class=\"diagram-muted\">宿主指令</small></div></div><div class=\"diagram-col-arrows\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&larr;</div></div><div class=\"diagram-panel accent-panel\"><span class=\"diagram-pill accent\">AgentNativeEmbedded</span><small class=\"diagram-muted\">agent + workspace</small><div class=\"diagram-box\" data-rough>Agent-Native 路由<br><small class=\"diagram-muted\">mounted by the server plugin</small></div></div></div>",
+  "html": "<div class=\"diagram-sidecar\"><div class=\"diagram-panel\"><strong>主機應用</strong><small class=\"diagram-muted\">你現有的 SaaS</small><div class=\"diagram-node\">getContext()<br><small class=\"diagram-muted\">路由 · 選取</small></div><div class=\"diagram-node\">onNavigate / onRefresh<br><small class=\"diagram-muted\">主機指令</small></div></div><div class=\"diagram-col-arrows\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&larr;</div></div><div class=\"diagram-panel accent-panel\"><span class=\"diagram-pill accent\">AgentNativeEmbedded</span><small class=\"diagram-muted\">agent + workspace</small><div class=\"diagram-box\" data-rough>Agent-Native 路由<br><small class=\"diagram-muted\">mounted by the server plugin</small></div></div></div>",
   "css": ".diagram-sidecar{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-sidecar .diagram-panel{display:flex;flex-direction:column;gap:8px;padding:14px 16px;min-width:200px}.diagram-sidecar .diagram-col-arrows{display:flex;flex-direction:column;gap:6px}.diagram-sidecar .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
 
 請參閱 [Embedding SDK](/docs/embedding-sdk) 以了解主機驗證、資料庫隔離，
-iframe/picker 模式，以及較低級別的橋 APIs。
+iframe/picker 模式，以及較低階別的橋 APIs。
 
 ## 完整應用程式 {#full-application}
 
@@ -363,10 +363,10 @@ iframe/picker 模式，以及較低級別的橋 APIs。
 完整應用程式圍繞相同的操作和代理合同新增產品 UI：
 
 - **SQL 狀態** — 應用資料、導覽、設定和聊天歷史紀錄是持久的。
-- **上下文感知** - 代理知道目前路線、選取和聚焦物件。
-- **實時同步** - 代理更改會更新 UI，UI 更改會更新代理的上下文。
-- **深層連結** — 操作結果可以開啟正確的應用視圖。
-- **本機聊天小部件** — 表格、圖表、卡片、批準和鍵入的結果內聯顯示。
+- **脈絡感知** - 代理知道目前路由、選取和聚焦物件。
+- **即時同步** - 代理更改會更新 UI，UI 更改會更新代理的脈絡。
+- **深層連結** — 操作結果可以開啟正確的應用檢視。
+- **本機聊天小工具** — 表格、圖表、卡片、核准和鍵入的結果行內顯示。
 
 當您想要一個最小的應用程式時，請從 [Chat template](/docs/template-chat) 開始
 您的 actions 週圍，或來自域 [template](/docs/cloneable-saas)，當您
@@ -376,14 +376,14 @@ iframe/picker 模式，以及較低級別的橋 APIs。
 
 | 如果您在想...                                        | 選取                      |
 | ---------------------------------------------------- | ------------------------- |
-| “我只需要一個可調用的工具或工作流程。”               | 無頭代理                  |
-| “我想要框架的代理，但是聊天應該是主要的UI。”         | Agent-Native 上的丰富聊天 |
-| “我已經有一個代理；我需要一個完美的聊天 UI。”        | 與您的代理進行丰富的聊天  |
+| “我只需要一個可呼叫的工具或工作流程。”               | 無頭代理                  |
+| “我想要框架的代理，但是聊天應該是主要的 UI。”        | Agent-Native 上的豐富聊天 |
+| “我已經有一個代理；我需要一個完美的聊天 UI。”        | 與您的代理進行豐富的聊天  |
 | “我已經有一個 SaaS 應用程式；在它旁邊新增一個代理。” | 嵌入式邊車                |
 | “代理和 UI 應該作為產品一起進化。”                   | 完整應用程式              |
 
 保持合約較小：將持久操作定義為 actions，顯式返回
-聊天需要丰富UI時的小部件結果，並且僅在使用者時新增全屏
+聊天需要豐富 UI 時的小工具結果，並且僅在使用者時新增全螢幕
 需要瀏覽、比較、設定或協作持久物件。
 
 ## 相關檔案 {#related-docs}
@@ -391,7 +391,7 @@ iframe/picker 模式，以及較低級別的橋 APIs。
 - [Actions](/docs/actions) — 定義一次無頭操作。
 - [Native 聊天介面](/docs/native-chat-ui) — 在聊天中呈現鍵入的操作結果。
 - [Drop-in Agent](/docs/drop-in-agent) — 安裝聊天、側邊欄或面板表面。
-- [Component API](/docs/components) — 較低級別的 React 聊天/作曲片段。
+- [Component API](/docs/components) — 較低階別的 React 聊天/合成片段。
 - [Embedding SDK](/docs/embedding-sdk) — 將 Agent-Native 新增到現有應用。
-- [External Agents](/docs/external-agents) — 將 MCP 兼容主機連線到應用。
+- [External Agents](/docs/external-agents) — 將 MCP 相容主機連線到應用。
 - [A2A Protocol](/docs/a2a-protocol) — 從其他座席呼叫座席。

package/corpus/core/docs/content/locales/zh-TW/agent-teams.md

@@ -1,26 +1,26 @@
 ---
 title: "代理團隊"
-description: "主代理代表向在自己的線程中執行的子代理工作，並在聊天中顯示為內嵌的實時預覽芯片。"
+description: "主代理代表向在自己的對話串中執行的子代理工作，並在聊天中顯示為內嵌的即時預覽標籤。"
 ---
 
 # 代理團隊
 
-代理聊天是一個**協調器**，而不是一個整體。當主代理完成一項更適合由專家負責的工作時——“用我的聲音寫這封電子郵件”、“執行 BigQuery 分析”、“檢視此 PR”——它會在自己的線程、工具和上下文中生成一個子代理。子代理在主聊天中顯示為實時預覽**芯片**；點選它以分頁形式開啟完整對話。
+代理聊天是一個**協調器**，而不是一個整體。當主代理完成一項更適合由專家負責的工作時——“用我的聲音寫這封電子郵件”、“執行 BigQuery 分析”、“檢視此 PR”——它會在自己的對話串、工具和脈絡中產生一個子代理。子代理在主聊天中顯示為即時預覽**標籤**；點選它以分頁形式開啟完整對話。
 
-這可以保持主線程集中，讓子代理並行執行，並為您提供任何委派工作的清晰審計跟蹤。
+這可以保持主對話串集中，讓子代理並行執行，並為您提供任何委派工作的清晰審計跟蹤。
 
-Agent Teams 在核心執行管理器上執行：事件流並持續，中止通過 SQL 傳播，工作在無伺服器冷啟動中幸存。
+Agent Teams 在核心執行管理器上執行：事件流並持續，中止透過 SQL 傳播，工作在無伺服器冷啟動中幸存。
 
 ## 心智模型 {#mental-model}
 
 - **主聊天** — 協調器。代表們，請閱讀您的請求。繁重的工作本身很少。
-- **子代理** — 使用自己的線程、自己的系統提示符、自己的工具集執行。每個對應到 [workspace](/docs/workspace) 中的“自訂代理”設定檔案。
-- **Chips** — 主聊天中內聯顯示的丰富預覽卡，顯示子代理的目前步驟、流輸出和最終摘要。預設折疊；點擊即可展開完整對話。
-- **雙向訊息傳遞** - 主代理可以向正在執行的子代理發送後續訊息；當子代理遇到模糊點時可以回複訊息。
+- **子代理** — 使用自己的對話串、自己的系統提示符、自己的工具集執行。每個對應到 [workspace](/docs/workspace) 中的“自訂代理”設定檔案。
+- **Chips** — 主聊天中行內顯示的豐富預覽卡，顯示子代理的目前步驟、流輸出和最終摘要。預設折疊；點選即可展開完整對話。
+- **雙向訊息傳遞** - 主代理可以向正在執行的子代理傳送後續訊息；當子代理遇到模糊點時可以回覆訊息。
 
-子代理狀態保留在 `application_state` SQL 表（在 `agent-task:<taskId>` 下）中，因此工作可以在無伺服器冷啟動中幸存並跨多個進程工作。
+子代理狀態保留在 `application_state` SQL 表（在 `agent-task:<taskId>` 下）中，因此工作可以在無伺服器冷啟動中幸存並跨多個行程工作。
 
-```an-diagram title="協調員和專家" summary="主聊天委托給在自己的線程中執行並作為內聯芯片報告的子代理。"
+```an-diagram title="協調員和專家" summary="主聊天委托給在自己的對話串中執行並作為行內標籤報告的子代理。"
 {
   "html": "<div class=\"at-orc\"><div class=\"diagram-card main\"><span class=\"diagram-pill accent\">主聊天</span><small class=\"diagram-muted\">orchestrator &mdash; reads your request, delegates</small></div><div class=\"at-fan\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"at-subs\"><div class=\"diagram-box\">程式碼評審<br><small class=\"diagram-muted\">own thread &amp; prompt</small></div><div class=\"diagram-box\">BigQuery 分析<br><small class=\"diagram-muted\">own tools</small></div><div class=\"diagram-box\">語音郵件<br><small class=\"diagram-muted\">own context</small></div></div></div><div class=\"diagram-pill\">each appears inline as a live chip &#8635;</div></div>",
   "css": ".at-orc{display:flex;flex-direction:column;align-items:center;gap:12px}.at-orc .diagram-card{padding:14px 18px;display:flex;flex-direction:column;gap:4px;align-items:center}.at-orc .at-fan{display:flex;flex-direction:column;align-items:center;gap:8px}.at-orc .diagram-arrow{font-size:22px}.at-orc .at-subs{display:flex;gap:12px;flex-wrap:wrap;justify-content:center}.at-orc .diagram-box{text-align:center}"
@@ -32,25 +32,25 @@ Agent Teams 在核心執行管理器上執行：事件流並持續，中止通
 工作出現時：
 
 - 需要不同的**系統提示**（專業的聲音或語氣，例如“程式碼審查”）。
-- 擁有一個**長時間執行**的工具鏈，會污染主要上下文。
+- 擁有一個**長時間執行**的工具鏈，會污染主要脈絡。
 - 可以與主代理正在執行的其他工作**並行**執行。
 - 由一個**不同的團隊**擁有，該團隊已經擁有自訂代理設定檔案。
 
-不要為了瑣碎的一次性工作而生成 - 直接調用操作。
+不要為了瑣碎的一次性工作而生成 - 直接呼叫操作。
 
-## 調用子代理 {#invoking}
+## 呼叫子代理 {#invoking}
 
 啟動子代理的三種方法，從最簡單到最明確：
 
 ### 1。 `@mention` 自訂代理 {#mention}
 
-使用者在聊天編輯器中鍵入 `@agent-name`。將出現工作區子代理的下拉列表。選取其中一個插入芯片；提交後，主代理將訊息委托給該子代理。
+使用者在聊天編輯器中鍵入 `@agent-name`。將出現工作區子代理的下拉清單。選取其中一個插入標籤；提交後，主代理將訊息委托給該子代理。
 
 自訂代理位於 `agents/<slug>.md` 的工作區中 — 一個帶有 YAML frontmatter 的 Markdown 檔案。格式請參見[Custom Agents](/docs/workspace#custom-agents)。
 
 ### 2。主代理自動委托 {#auto-delegate}
 
-該框架為主代理提供了一個 `agent-teams` 工具。當模型確定工作適合已註冊的子代理設定檔案時，它會使用 `action: "spawn"` 和可選的 `agent` 參數調用該工具，該參數從 `agents/*.md` 命名設定檔案。出現一個芯片；子代理執行。主代理等待（或並行行動）並在子代理完成時合並結果。
+此框架為主代理提供了一個 `agent-teams` 工具。當模型確定工作適合已註冊的子代理設定檔案時，它會使用 `action: "spawn"` 和可選的 `agent` 參數呼叫該工具，該參數從 `agents/*.md` 命名設定檔案。出現一個標籤；子代理執行。主代理等待（或並行行動）並在子代理完成時合併結果。
 
 完整的 `agent-teams` 操作集是：
 
@@ -58,11 +58,11 @@ Agent Teams 在核心執行管理器上執行：事件流並持續，中止通
 | ------------- | -------------------------- |
 | `spawn`       | 啟動新的子代理工作         |
 | `status`      | 檢查正在執行的子代理的進度 |
-| `read-result` | 獲取完成的子代理的輸出     |
-| `send`        | 向正在執行的子代理發送訊息 |
+| `read-result` | 取得完成的子代理的輸出     |
+| `send`        | 向正在執行的子代理傳送訊息 |
 | `list`        | 檢視目前使用者的所有工作   |
 
-### 3。程序化生成 {#programmatic-spawn}
+### 3。程式化生成 {#programmatic-spawn}
 
 對於框架級整合，請使用 `@agent-native/core/server` 中的 `spawnTask()`：
 
@@ -81,23 +81,23 @@ const task = await spawnTask({
 });
 ```
 
-大多數應用程式程式碼不會直接調用它 - 框架在 `@mentions` 和 `agent-teams` 工具的後台執行此操作。僅當您連線新的入口點（例如，啟動作為子代理執行的後台作業的按鈕）時，才需要使用 `spawnTask()`。
+大多數應用程式的程式碼不會直接呼叫它 - 框架在 `@mentions` 和 `agent-teams` 工具的背景執行此操作。僅當您連線新的入口點（例如，啟動作為子代理執行的背景作業的按鈕）時，才需要使用 `spawnTask()`。
 
 ## 工作生命週期 {#lifecycle}
 
-```an-diagram title="spawnTask() 的作用" summary="每個spawn都會建立一個線程，將狀態儲存到SQL，並將芯片事件流式傳輸直至完成。"
+```an-diagram title="spawnTask() 的作用" summary="每個spawn都會建立一個對話串，將狀態儲存到 SQL，並將標籤事件流式傳輸直至完成。"
 {
   "html": "<div class=\"at-life\"><div class=\"diagram-box\"><code>spawnTask()</code></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">create thread</span><small class=\"diagram-muted\">new row in <code>chat_threads</code>, description as first message</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">persist state</span><small class=\"diagram-muted\"><code>agent-task:&lt;id&gt;</code> &rarr; <code>application_state</code>, status=running</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">stream</span><small class=\"diagram-muted\"><code>agent_task_started</code> &rarr; chip appears; <code>agent_task_step</code> &rarr; chip updates live</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card ok\"><span class=\"diagram-pill ok\">complete</span><small class=\"diagram-muted\">status=completed, write summary + preview, emit <code>agent_task_done</code></small></div></div>",
   "css": ".at-life{display:flex;flex-direction:column;align-items:stretch;gap:6px;max-width:560px}.at-life .diagram-card{display:flex;flex-direction:column;gap:3px;padding:10px 14px}.at-life .diagram-box{align-self:flex-start}.at-life .diagram-arrow{font-size:18px;align-self:center}"
 }
 ```
 
-父代理可以隨時通過 `sendToTask(taskId, message)` 恢復子代理並進行後續操作。如果子代理發生錯誤，`markTaskErrored(taskId, reason)` 會紀錄失敗並將其呈現給使用者。
+父代理可以隨時透過 `sendToTask(taskId, message)` 恢復子代理並進行後續操作。如果子代理發生錯誤，`markTaskErrored(taskId, reason)` 會紀錄失敗並將其呈現給使用者。
 
 雙向訊息傳遞是持久的。執行子代理的父級後續操作是
-通過工作生命週期交付；如果子代理無法在
+透過工作生命週期交付；如果子代理無法在
 目前步驟，它們應該保持排隊並在安全的地方應用
-延續點。子代理也可以在需要澄清時回複訊息
+延續點。子代理也可以在需要澄清時回覆訊息
 而不是無形地阻塞。
 
 ## 讀取工作狀態 {#reading-state}
@@ -130,13 +130,13 @@ interface AgentTask {
 
 ## 自訂代理設定檔案 {#profiles}
 
-子代理對應到自訂代理設定檔案 - 工作區中 `agents/<slug>.md` 處的 Markdown 檔案，這些檔案顯示在 `@mention` 下拉列表中並用作委派目標。 [Workspace — Custom Agents](/docs/workspace#custom-agents) 擁有完整格式（frontmatter、`tools`、`delegate-default`、模型覆蓋）。
+子代理對應到自訂代理設定檔案 - 工作區中 `agents/<slug>.md` 處的 Markdown 檔案，這些檔案顯示在 `@mention` 下拉清單中並用作委派目標。 [Workspace — Custom Agents](/docs/workspace#custom-agents) 擁有完整格式（frontmatter、`tools`、`delegate-default`、模型覆蓋）。
 
 ## 委托深度防護 {#depth-guard}
 
-子代理可以產生子代理，這是一種失控/成本風險：無限的委托鏈可能會無限期地散開。該框架在伺服器端強制執行**委托深度**的硬上限，獨立於任何工具級防護。
+子代理可以產生子代理，這是一種失控/成本風險：無限的委托鏈可能會無限期地散開。此框架在伺服器端強制執行**委托深度**的硬上限，獨立於任何工具級防護。
 
-頂級聊天深度為`0`。它生成的子代理深度為 `1`；該子代理可能會再次生成（深度 `2`）；會建立深度 `3` 子代理的生成被 **拒絕**。預設上限為 **2**。
+頂級聊天深度為`0`。它產生的子代理深度為 `1`；該子代理可能會再次生成（深度 `2`）；會建立深度 `3` 子代理的生成被 **拒絕**。預設上限為 **2**。
 
 ```an-diagram title="委派深度保護（預設上限 2）" summary="每一層都可能產生更深的一層，直到達到上限；超過它的生成將被伺服器端拒絕。"
 {
@@ -155,17 +155,17 @@ interface AgentTask {
 | ------------ | --------------------------------------------------------------------------------------------------- |
 | _（未設定）_ | `2`的預設上限。                                                                                     |
 | `0`          | **不能生成任何子代理** - 頂級代理完成所有工作。                                                     |
-| `1`…`16`     | 這么多級別的委派。                                                                                  |
+| `1`…`16`     | 這么多層級的委派。                                                                                  |
 | 無效/`>16`   | 非整數/負/NaN值回退到`2`； `16` 以上的任何內容都會被固定到 `16`，因此拼寫錯誤永遠不會停用防護裝置。 |
 
 ```bash
 AGENT_NATIVE_MAX_SUBAGENT_DEPTH=1   # 允許分代理，但不能分代理
 ```
 
-當子代理達到或低於上限時，框架會在其執行時上下文中注入一行，告訴它它的位置有多深以及是否可以進一步委托，以便模型適當地花費其預算。
+當子代理達到或低於上限時，框架會在其執行時脈絡中注入一行，告訴它它的位置有多深以及是否可以進一步委托，以便模型適本機花費其預算。
 
-## 下一步是什么
+## 下一步是什麼
 
 - [**Workspace — Custom Agents**](/docs/workspace#custom-agents) — 設定檔案格式
 - [**A2A Protocol**](/docs/a2a-protocol) - 當“子代理”完全位於不同的應用程式中時
-- [**Actions**](/docs/actions) — 子代理調用的工具
+- [**Actions**](/docs/actions) — 子代理呼叫的工具

package/corpus/core/docs/content/locales/zh-TW/agent-web-surfaces.md

@@ -1,11 +1,11 @@
 ---
 title: "公開代理網路"
-description: "使公開路線可爬行、可讀、可引用，並可選取由代理調用 - robots.txt、llms.txt、markdown 鏡像、JSON-LD 和公開 MCP 表面。"
+description: "使公開路由可爬行、可讀、可引用，並可選取由代理呼叫 - robots.txt、llms.txt、markdown 鏡像、JSON-LD 和公開 MCP 表面。"
 ---
 
 # 公開代理網路
 
-公開代理網路使公開 Agent-Native 路由易於代理抓取、閱讀、引用和調用。目標不是公開每個應用程式端點。目標是為已經公開的頁面發布一個幹淨的公開介面，同時將私人資料和工具存取保留在顯式控制之下。
+公開代理網路使公開 Agent-Native 路由易於代理抓取、閱讀、引用和呼叫。目標不是公開每個應用程式端點。目標是為已經公開的頁面發布一個幹淨的公開介面，同時將私人資料和工具存取保留在顯式控制之下。
 
 檔案站點是參考實現。今天發貨：
 
@@ -14,12 +14,12 @@ description: "使公開路線可爬行、可讀、可引用，並可選取由代
 - `/llms.txt` 和 `/llms-full.txt` 用於代理友好的內容發現。
 - Markdown 鏡像，例如 `/docs/getting-started.md`。
 - 正式環境建置後公開檔案頁面的 `Accept: text/markdown` 回應。
-- JSON-LD 用於基礎組織、網站和頁面元資料。
+- JSON-LD 用於基礎組織、網站和頁面中繼資料。
 - 審核 CLI (`npx @agent-native/core@latest audit-agent-web`)，檢查上述所有內容。
 
-設定 `publicMcp: true` 還會將選取加入的 actions 公開為公開 MCP 端點，允許外部代理直接調用它們（請參閱 [MCP Protocol](/docs/mcp-protocol)）。
+設定 `publicMcp: true` 還會將選取加入的 actions 公開為公開 MCP 端點，允許外部代理直接呼叫它們（請參閱 [MCP Protocol](/docs/mcp-protocol)）。
 
-```an-diagram title="公開路由發布什么" summary="一條公開路線呈扇形展開，形成對代理人友好的代表。讀取路線與調用工具是分開的——工具存取保持選取加入。"
+```an-diagram title="公開路由發布什麼" summary="一條公開路由呈扇形展開，形成對代理友好的代表。讀取路由與呼叫工具是分開的——工具存取保持選取加入。"
 {
   "html": "<div class=\"diagram-web\"><div class=\"diagram-box\" data-rough>公開路由<br><small class=\"diagram-muted\">derived from route access settings</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-grid\"><span class=\"diagram-pill\">robots.txt</span><span class=\"diagram-pill\">sitemap.xml</span><span class=\"diagram-pill\">llms.txt</span><span class=\"diagram-pill\">.md mirror</span><span class=\"diagram-pill\">JSON-LD</span><span class=\"diagram-pill\">text/markdown</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col gate\"><span class=\"diagram-pill warn\">工具保持私人</span><small class=\"diagram-muted\">publicMcp + publicAgent.expose required</small></div></div>",
   "css": ".diagram-web{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-web .diagram-arrow{font-size:22px;line-height:1}.diagram-web .diagram-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:8px}.diagram-web .gate{display:flex;flex-direction:column;gap:4px;align-items:flex-start}"
@@ -28,7 +28,7 @@ description: "使公開路線可爬行、可讀、可引用，並可選取由代
 
 ## 設定 {#config}
 
-在現有工作區應用設定下新增 `agentWeb`（在應用的 `package.json` 中的 `agent-native` 鍵下 — 或等效的 `workspace.agentWeb`、`agentWeb` 或 `root.agentWeb`）。公開路由列表仍然來源於應用程式的路由存取設定； `agentWeb` 控制公開表面如何呈現給代理。
+在現有工作區應用設定下新增 `agentWeb`（在應用的 `package.json` 中的 `agent-native` 鍵下 — 或等效的 `workspace.agentWeb`、`agentWeb` 或 `root.agentWeb`）。公開路由清單仍然來源於應用程式的路由存取設定； `agentWeb` 控制公開表面如何呈現給代理。
 
 ```json
 {
@@ -63,7 +63,7 @@ description: "使公開路線可爬行、可讀、可引用，並可選取由代
 
 代理 Web 發現遵循路由存取模型：
 
-- 公開應用程式公開除 `protectedPaths` 之外的所有路線。
+- 公開應用程式公開除 `protectedPaths` 之外的所有路由。
 - 內部應用僅公開 `publicPaths`。
 - 代理可以讀取公開共用和表單頁面。
 - 提交的私人資料、經過驗證的儀表板和使用者/組織狀態永遠不會僅僅因為附近的頁面是公開的而包含在內。
@@ -72,7 +72,7 @@ description: "使公開路線可爬行、可讀、可引用，並可選取由代
 
 ## 公開頁面不是公開工具 {#public-tools}
 
-公開頁面存取和公開工具存取是分開的。路線僅公開意味著代理可以將該路線讀取為 HTML、Markdown、站點地圖條目、llms 條目和結構化資料。
+公開頁面存取和公開工具存取是分開的。路由僅公開意味著代理可以將該路由讀取為 HTML、Markdown、站點地圖條目、llms 條目和結構化資料。
 
 ```an-callout
 {
@@ -81,7 +81,7 @@ description: "使公開路線可爬行、可讀、可引用，並可選取由代
 }
 ```
 
-要通過公開代理協議公開操作，該操作必須選取加入：
+要透過公開代理協議公開操作，該操作必須選取加入：
 
 ```an-annotated-code title="在公開表面上選取一項安全行動"
 {
@@ -99,7 +99,7 @@ description: "使公開路線可爬行、可讀、可引用，並可選取由代
 
 ## 建置時檔案 {#build-time}
 
-`@agent-native/core/agent-web` 中的框架實用程序從一頁面列表生成通用檔案：
+`@agent-native/core/agent-web` 中的框架實用程式從一頁面清單生成通用檔案：
 
 ```ts
 import {
@@ -154,7 +154,7 @@ npx @agent-native/core@latest audit-agent-web --url https://www.agent-native.com
 
 如果缺少所需的公開表面，審核將以非零值退出。
 
-## 下一步是什么
+## 下一步是什麼
 
 - [**Actions**](/docs/actions) — 如何選取 actions 加入公開代理協議
 - [**MCP Protocol**](/docs/mcp-protocol) — `publicMcp: true` 啟用的 MCP 表面