@agent-native/core 0.79.11 → 0.79.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/corpus/README.md +2 -2
- package/corpus/core/CHANGELOG.md +25 -0
- package/corpus/core/docs/content/locales/zh-TW/a2a-protocol.md +68 -68
- package/corpus/core/docs/content/locales/zh-TW/actions.md +82 -82
- package/corpus/core/docs/content/locales/zh-TW/agent-mentions.md +22 -22
- package/corpus/core/docs/content/locales/zh-TW/agent-surfaces.md +82 -82
- package/corpus/core/docs/content/locales/zh-TW/agent-teams.md +29 -29
- package/corpus/core/docs/content/locales/zh-TW/agent-web-surfaces.md +11 -11
- package/corpus/core/docs/content/locales/zh-TW/audit-log.md +16 -16
- package/corpus/core/docs/content/locales/zh-TW/authentication.md +32 -32
- package/corpus/core/docs/content/locales/zh-TW/automations.md +32 -32
- package/corpus/core/docs/content/locales/zh-TW/blueprint-installer.md +19 -19
- package/corpus/core/docs/content/locales/zh-TW/cli-adapters.md +17 -17
- package/corpus/core/docs/content/locales/zh-TW/client.md +62 -62
- package/corpus/core/docs/content/locales/zh-TW/cloneable-saas.md +32 -32
- package/corpus/core/docs/content/locales/zh-TW/code-agents-ui.md +91 -91
- package/corpus/core/docs/content/locales/zh-TW/components.md +51 -51
- package/corpus/core/docs/content/locales/zh-TW/context-awareness.md +66 -66
- package/corpus/core/docs/content/locales/zh-TW/creating-templates.md +39 -39
- package/corpus/core/docs/content/locales/zh-TW/cross-app-sso.md +29 -29
- package/corpus/core/docs/content/locales/zh-TW/database.md +21 -21
- package/corpus/core/docs/content/locales/zh-TW/deployment.md +37 -37
- package/corpus/core/docs/content/locales/zh-TW/dispatch.md +43 -43
- package/corpus/core/docs/content/locales/zh-TW/drop-in-agent.md +34 -34
- package/corpus/core/docs/content/locales/zh-TW/durable-resume.md +18 -18
- package/corpus/core/docs/content/locales/zh-TW/embedding-sdk.md +73 -73
- package/corpus/core/docs/content/locales/zh-TW/evals.md +16 -16
- package/corpus/core/docs/content/locales/zh-TW/extensions.md +81 -81
- package/corpus/core/docs/content/locales/zh-TW/external-agents.md +146 -146
- package/corpus/core/docs/content/locales/zh-TW/faq.md +43 -43
- package/corpus/core/docs/content/locales/zh-TW/file-uploads.md +11 -11
- package/corpus/core/docs/content/locales/zh-TW/frames.md +33 -33
- package/corpus/core/docs/content/locales/zh-TW/getting-started.md +28 -28
- package/corpus/core/docs/content/locales/zh-TW/harness-agents.md +78 -78
- package/corpus/core/docs/content/locales/zh-TW/human-approval.md +27 -27
- package/corpus/core/docs/content/locales/zh-TW/internationalization.md +19 -19
- package/corpus/core/docs/content/locales/zh-TW/key-concepts.md +68 -68
- package/corpus/core/docs/content/locales/zh-TW/local-file-mode.md +50 -50
- package/corpus/core/docs/content/locales/zh-TW/mcp-apps.md +38 -38
- package/corpus/core/docs/content/locales/zh-TW/mcp-clients.md +67 -67
- package/corpus/core/docs/content/locales/zh-TW/mcp-protocol.md +50 -50
- package/corpus/core/docs/content/locales/zh-TW/messaging.md +99 -99
- package/corpus/core/docs/content/locales/zh-TW/migration-workbench.md +6 -6
- package/corpus/core/docs/content/locales/zh-TW/multi-app-workspace.md +39 -39
- package/corpus/core/docs/content/locales/zh-TW/multi-tenancy.md +7 -7
- package/corpus/core/docs/content/locales/zh-TW/native-chat-ui.md +38 -38
- package/corpus/core/docs/content/locales/zh-TW/notifications.md +23 -23
- package/corpus/core/docs/content/locales/zh-TW/observability.md +49 -49
- package/corpus/core/docs/content/locales/zh-TW/observational-memory.md +23 -23
- package/corpus/core/docs/content/locales/zh-TW/onboarding.md +40 -40
- package/corpus/core/docs/content/locales/zh-TW/plan-plugin.md +37 -37
- package/corpus/core/docs/content/locales/zh-TW/pr-visual-recap.md +72 -72
- package/corpus/core/docs/content/locales/zh-TW/processors.md +17 -17
- package/corpus/core/docs/content/locales/zh-TW/progress.md +15 -15
- package/corpus/core/docs/content/locales/zh-TW/pure-agent-apps.md +10 -10
- package/corpus/core/docs/content/locales/zh-TW/real-time-collaboration.md +103 -103
- package/corpus/core/docs/content/locales/zh-TW/recurring-jobs.md +19 -19
- package/corpus/core/docs/content/locales/zh-TW/routing.md +9 -9
- package/corpus/core/docs/content/locales/zh-TW/sandbox-adapters.md +48 -48
- package/corpus/core/docs/content/locales/zh-TW/security.md +49 -49
- package/corpus/core/docs/content/locales/zh-TW/server.md +47 -47
- package/corpus/core/docs/content/locales/zh-TW/sharing.md +22 -22
- package/corpus/core/docs/content/locales/zh-TW/skills-guide.md +46 -46
- package/corpus/core/docs/content/locales/zh-TW/template-analytics.md +40 -40
- package/corpus/core/docs/content/locales/zh-TW/template-assets.md +69 -69
- package/corpus/core/docs/content/locales/zh-TW/template-brain.md +81 -81
- package/corpus/core/docs/content/locales/zh-TW/template-calendar.md +40 -40
- package/corpus/core/docs/content/locales/zh-TW/template-chat.md +27 -27
- package/corpus/core/docs/content/locales/zh-TW/template-clips.md +85 -85
- package/corpus/core/docs/content/locales/zh-TW/template-content.md +65 -66
- package/corpus/core/docs/content/locales/zh-TW/template-design.md +29 -29
- package/corpus/core/docs/content/locales/zh-TW/template-dispatch.md +51 -51
- package/corpus/core/docs/content/locales/zh-TW/template-forms.md +25 -25
- package/corpus/core/docs/content/locales/zh-TW/template-mail.md +71 -71
- package/corpus/core/docs/content/locales/zh-TW/template-plan.md +92 -92
- package/corpus/core/docs/content/locales/zh-TW/template-slides.md +52 -52
- package/corpus/core/docs/content/locales/zh-TW/template-videos.md +30 -30
- package/corpus/core/docs/content/locales/zh-TW/tracking.md +29 -29
- package/corpus/core/docs/content/locales/zh-TW/using-your-agent.md +18 -18
- package/corpus/core/docs/content/locales/zh-TW/voice-input.md +19 -19
- package/corpus/core/docs/content/locales/zh-TW/what-is-agent-native.md +61 -61
- package/corpus/core/docs/content/locales/zh-TW/workspace-connections.md +41 -41
- package/corpus/core/docs/content/locales/zh-TW/workspace-management.md +27 -27
- package/corpus/core/docs/content/locales/zh-TW/workspace.md +58 -58
- package/corpus/core/docs/content/locales/zh-TW/writing-agent-instructions.md +41 -41
- package/corpus/core/docs/content/template-clips.md +48 -2
- package/corpus/core/package.json +2 -1
- package/corpus/core/src/client/AgentPanel.tsx +27 -3
- package/corpus/core/src/deploy/build.ts +738 -57
- package/corpus/core/src/deploy/route-discovery.ts +1 -1
- package/corpus/core/src/server/edge.ts +50 -0
- package/corpus/core/src/styles/agent-native.css +93 -0
- package/corpus/core/src/templates/default/app/i18n/zh-TW.ts +44 -44
- package/corpus/core/src/vite/client.ts +1 -0
- package/corpus/templates/analytics/app/components/layout/Layout.tsx +5 -3
- package/corpus/templates/analytics/app/i18n/zh-TW.ts +69 -70
- package/corpus/templates/analytics/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
- package/corpus/templates/assets/app/components/layout/Layout.tsx +3 -3
- package/corpus/templates/assets/app/i18n/zh-TW.ts +82 -82
- package/corpus/templates/assets/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
- package/corpus/templates/brain/app/components/layout/Layout.tsx +6 -4
- package/corpus/templates/brain/app/i18n/zh-TW.ts +90 -90
- package/corpus/templates/brain/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
- package/corpus/templates/calendar/app/components/layout/AppLayout.tsx +1 -1
- package/corpus/templates/calendar/app/components/layout/Sidebar.tsx +1 -1
- package/corpus/templates/calendar/app/i18n/zh-TW.ts +57 -57
- package/corpus/templates/calendar/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
- package/corpus/templates/calendar/server/lib/booking-og-fonts.ts +20 -6
- package/corpus/templates/calendar/server/lib/booking-og-image.ts +17 -9
- package/corpus/templates/chat/app/components/layout/Layout.tsx +5 -3
- package/corpus/templates/chat/app/i18n/zh-TW.ts +3 -3
- package/corpus/templates/chat/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
- package/corpus/templates/clips/AGENTS.md +6 -0
- package/corpus/templates/clips/actions/delete-recording-permanent.ts +7 -1
- package/corpus/templates/clips/actions/get-recording-player-data.ts +44 -2
- package/corpus/templates/clips/actions/navigate.ts +2 -0
- package/corpus/templates/clips/actions/save-bug-report-context.ts +173 -0
- package/corpus/templates/clips/actions/view-screen.ts +58 -7
- package/corpus/templates/clips/app/components/recorder/storage-setup-card.tsx +9 -3
- package/corpus/templates/clips/app/hooks/use-navigation-state.ts +17 -0
- package/corpus/templates/clips/app/i18n/ar-SA.ts +31 -0
- package/corpus/templates/clips/app/i18n/de-DE.ts +32 -0
- package/corpus/templates/clips/app/i18n/en-US.ts +32 -0
- package/corpus/templates/clips/app/i18n/es-ES.ts +32 -0
- package/corpus/templates/clips/app/i18n/fr-FR.ts +32 -0
- package/corpus/templates/clips/app/i18n/hi-IN.ts +32 -0
- package/corpus/templates/clips/app/i18n/ja-JP.ts +31 -0
- package/corpus/templates/clips/app/i18n/ko-KR.ts +32 -0
- package/corpus/templates/clips/app/i18n/pt-BR.ts +32 -0
- package/corpus/templates/clips/app/i18n/zh-CN.ts +30 -0
- package/corpus/templates/clips/app/i18n/zh-TW.ts +461 -451
- package/corpus/templates/clips/app/routes/bug-report.done.tsx +126 -0
- package/corpus/templates/clips/app/routes/bug-report.tsx +222 -0
- package/corpus/templates/clips/app/routes/record.tsx +104 -12
- package/corpus/templates/clips/changelog/2026-06-26-brief-network-blips-no-longer-block-recording-or-wrongly-pro.md +6 -0
- package/corpus/templates/clips/changelog/2026-06-26-bug-report-recordings-can-keep-redacted-host-app-context-wit.md +6 -0
- package/corpus/templates/clips/changelog/2026-06-26-bug-report-widgets-can-launch-clips-recordings-from-embedded.md +6 -0
- package/corpus/templates/clips/changelog/2026-06-26-desktop-recording-keeps-connected-users-out-of-the-storage-s.md +6 -0
- package/corpus/templates/clips/changelog/2026-06-26-if-a-recording-can-t-be-uploaded-the-chrome-extension-now-sa.md +6 -0
- package/corpus/templates/clips/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
- package/corpus/templates/clips/chrome-extension/public/manifest.json +9 -2
- package/corpus/templates/clips/chrome-extension/src/background.ts +43 -0
- package/corpus/templates/clips/chrome-extension/src/offscreen.ts +111 -6
- package/corpus/templates/clips/chrome-extension/src/popup.ts +18 -7
- package/corpus/templates/clips/desktop/src/app.tsx +53 -19
- package/corpus/templates/clips/server/db/schema.ts +26 -0
- package/corpus/templates/clips/server/lib/public-agent-context.ts +51 -0
- package/corpus/templates/clips/server/plugins/auth.ts +1 -0
- package/corpus/templates/clips/server/plugins/db.ts +28 -0
- package/corpus/templates/clips/server/routes/api/agent-context.json.get.ts +4 -1
- package/corpus/templates/clips/shared/bug-report.ts +161 -0
- package/corpus/templates/content/app/components/layout/Layout.tsx +10 -8
- package/corpus/templates/content/app/components/sidebar/DocumentSidebar.tsx +1 -1
- package/corpus/templates/content/app/i18n/zh-TW.ts +67 -66
- package/corpus/templates/content/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
- package/corpus/templates/design/app/components/layout/Layout.tsx +3 -3
- package/corpus/templates/design/app/i18n/zh-TW.ts +44 -44
- package/corpus/templates/design/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
- package/corpus/templates/dispatch/app/i18n/zh-TW.ts +5 -4
- package/corpus/templates/dispatch/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
- package/corpus/templates/forms/app/components/layout/Layout.tsx +4 -2
- package/corpus/templates/forms/app/components/layout/Sidebar.tsx +1 -1
- package/corpus/templates/forms/app/i18n/zh-TW.ts +48 -48
- package/corpus/templates/forms/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
- package/corpus/templates/macros/app/components/layout/AppLayout.tsx +3 -3
- package/corpus/templates/macros/app/i18n/zh-TW.ts +5 -5
- package/corpus/templates/macros/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
- package/corpus/templates/mail/app/i18n/zh-TW.ts +83 -83
- package/corpus/templates/mail/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
- package/corpus/templates/plan/app/components/layout/Layout.tsx +5 -3
- package/corpus/templates/plan/app/i18n/zh-TW.ts +69 -69
- package/corpus/templates/plan/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
- package/corpus/templates/slides/app/components/layout/Layout.tsx +3 -3
- package/corpus/templates/slides/app/i18n/zh-TW.ts +64 -64
- package/corpus/templates/slides/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
- package/corpus/templates/videos/app/components/layout/Layout.tsx +2 -2
- package/corpus/templates/videos/app/i18n/zh-TW.ts +54 -54
- package/corpus/templates/videos/changelog/2026-06-27-traditional-chinese-copy-uses-taiwan-terminology.md +6 -0
- package/dist/client/AgentPanel.d.ts.map +1 -1
- package/dist/client/AgentPanel.js +14 -4
- package/dist/client/AgentPanel.js.map +1 -1
- package/dist/collab/routes.d.ts +1 -1
- package/dist/deploy/build.d.ts +29 -2
- package/dist/deploy/build.d.ts.map +1 -1
- package/dist/deploy/build.js +587 -51
- package/dist/deploy/build.js.map +1 -1
- package/dist/deploy/route-discovery.d.ts +1 -1
- package/dist/deploy/route-discovery.js +1 -1
- package/dist/deploy/route-discovery.js.map +1 -1
- package/dist/file-upload/actions/upload-image.d.ts +2 -2
- package/dist/notifications/routes.d.ts +2 -2
- package/dist/observability/routes.d.ts +7 -7
- package/dist/resources/handlers.d.ts +2 -2
- package/dist/server/agent-engine-api-key-route.d.ts +1 -1
- package/dist/server/edge.d.ts +11 -0
- package/dist/server/edge.d.ts.map +1 -0
- package/dist/server/edge.js +11 -0
- package/dist/server/edge.js.map +1 -0
- package/dist/styles/agent-native.css +93 -0
- package/dist/templates/default/app/i18n/zh-TW.ts +44 -44
- package/dist/vite/client.d.ts.map +1 -1
- package/dist/vite/client.js +1 -0
- package/dist/vite/client.js.map +1 -1
- package/docs/content/locales/zh-TW/a2a-protocol.md +68 -68
- package/docs/content/locales/zh-TW/actions.md +82 -82
- package/docs/content/locales/zh-TW/agent-mentions.md +22 -22
- package/docs/content/locales/zh-TW/agent-surfaces.md +82 -82
- package/docs/content/locales/zh-TW/agent-teams.md +29 -29
- package/docs/content/locales/zh-TW/agent-web-surfaces.md +11 -11
- package/docs/content/locales/zh-TW/audit-log.md +16 -16
- package/docs/content/locales/zh-TW/authentication.md +32 -32
- package/docs/content/locales/zh-TW/automations.md +32 -32
- package/docs/content/locales/zh-TW/blueprint-installer.md +19 -19
- package/docs/content/locales/zh-TW/cli-adapters.md +17 -17
- package/docs/content/locales/zh-TW/client.md +62 -62
- package/docs/content/locales/zh-TW/cloneable-saas.md +32 -32
- package/docs/content/locales/zh-TW/code-agents-ui.md +91 -91
- package/docs/content/locales/zh-TW/components.md +51 -51
- package/docs/content/locales/zh-TW/context-awareness.md +66 -66
- package/docs/content/locales/zh-TW/creating-templates.md +39 -39
- package/docs/content/locales/zh-TW/cross-app-sso.md +29 -29
- package/docs/content/locales/zh-TW/database.md +21 -21
- package/docs/content/locales/zh-TW/deployment.md +37 -37
- package/docs/content/locales/zh-TW/dispatch.md +43 -43
- package/docs/content/locales/zh-TW/drop-in-agent.md +34 -34
- package/docs/content/locales/zh-TW/durable-resume.md +18 -18
- package/docs/content/locales/zh-TW/embedding-sdk.md +73 -73
- package/docs/content/locales/zh-TW/evals.md +16 -16
- package/docs/content/locales/zh-TW/extensions.md +81 -81
- package/docs/content/locales/zh-TW/external-agents.md +146 -146
- package/docs/content/locales/zh-TW/faq.md +43 -43
- package/docs/content/locales/zh-TW/file-uploads.md +11 -11
- package/docs/content/locales/zh-TW/frames.md +33 -33
- package/docs/content/locales/zh-TW/getting-started.md +28 -28
- package/docs/content/locales/zh-TW/harness-agents.md +78 -78
- package/docs/content/locales/zh-TW/human-approval.md +27 -27
- package/docs/content/locales/zh-TW/internationalization.md +19 -19
- package/docs/content/locales/zh-TW/key-concepts.md +68 -68
- package/docs/content/locales/zh-TW/local-file-mode.md +50 -50
- package/docs/content/locales/zh-TW/mcp-apps.md +38 -38
- package/docs/content/locales/zh-TW/mcp-clients.md +67 -67
- package/docs/content/locales/zh-TW/mcp-protocol.md +50 -50
- package/docs/content/locales/zh-TW/messaging.md +99 -99
- package/docs/content/locales/zh-TW/migration-workbench.md +6 -6
- package/docs/content/locales/zh-TW/multi-app-workspace.md +39 -39
- package/docs/content/locales/zh-TW/multi-tenancy.md +7 -7
- package/docs/content/locales/zh-TW/native-chat-ui.md +38 -38
- package/docs/content/locales/zh-TW/notifications.md +23 -23
- package/docs/content/locales/zh-TW/observability.md +49 -49
- package/docs/content/locales/zh-TW/observational-memory.md +23 -23
- package/docs/content/locales/zh-TW/onboarding.md +40 -40
- package/docs/content/locales/zh-TW/plan-plugin.md +37 -37
- package/docs/content/locales/zh-TW/pr-visual-recap.md +72 -72
- package/docs/content/locales/zh-TW/processors.md +17 -17
- package/docs/content/locales/zh-TW/progress.md +15 -15
- package/docs/content/locales/zh-TW/pure-agent-apps.md +10 -10
- package/docs/content/locales/zh-TW/real-time-collaboration.md +103 -103
- package/docs/content/locales/zh-TW/recurring-jobs.md +19 -19
- package/docs/content/locales/zh-TW/routing.md +9 -9
- package/docs/content/locales/zh-TW/sandbox-adapters.md +48 -48
- package/docs/content/locales/zh-TW/security.md +49 -49
- package/docs/content/locales/zh-TW/server.md +47 -47
- package/docs/content/locales/zh-TW/sharing.md +22 -22
- package/docs/content/locales/zh-TW/skills-guide.md +46 -46
- package/docs/content/locales/zh-TW/template-analytics.md +40 -40
- package/docs/content/locales/zh-TW/template-assets.md +69 -69
- package/docs/content/locales/zh-TW/template-brain.md +81 -81
- package/docs/content/locales/zh-TW/template-calendar.md +40 -40
- package/docs/content/locales/zh-TW/template-chat.md +27 -27
- package/docs/content/locales/zh-TW/template-clips.md +85 -85
- package/docs/content/locales/zh-TW/template-content.md +65 -66
- package/docs/content/locales/zh-TW/template-design.md +29 -29
- package/docs/content/locales/zh-TW/template-dispatch.md +51 -51
- package/docs/content/locales/zh-TW/template-forms.md +25 -25
- package/docs/content/locales/zh-TW/template-mail.md +71 -71
- package/docs/content/locales/zh-TW/template-plan.md +92 -92
- package/docs/content/locales/zh-TW/template-slides.md +52 -52
- package/docs/content/locales/zh-TW/template-videos.md +30 -30
- package/docs/content/locales/zh-TW/tracking.md +29 -29
- package/docs/content/locales/zh-TW/using-your-agent.md +18 -18
- package/docs/content/locales/zh-TW/voice-input.md +19 -19
- package/docs/content/locales/zh-TW/what-is-agent-native.md +61 -61
- package/docs/content/locales/zh-TW/workspace-connections.md +41 -41
- package/docs/content/locales/zh-TW/workspace-management.md +27 -27
- package/docs/content/locales/zh-TW/workspace.md +58 -58
- package/docs/content/locales/zh-TW/writing-agent-instructions.md +41 -41
- package/docs/content/template-clips.md +48 -2
- package/package.json +2 -1
- package/src/templates/default/app/i18n/zh-TW.ts +44 -44
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: "使用您的代理"
|
|
3
|
-
description: "
|
|
3
|
+
description: "與代理合作的日常迴圈:它看到您正在檢視的內容,您指導它,嵌入它,使用 輕 UI,並與它一起共同編輯。"
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# 使用您的代理
|
|
@@ -9,18 +9,18 @@ agent-native 背後的定義思想是,agent 和 UI 是**平等的伙伴** -
|
|
|
9
9
|
|
|
10
10
|
有一條簡單的直通線。代理**看到**您正在檢視的內容,您**將其引導**到您想要的內容,您可以**嵌入**它在任何地方,您可以在更合適的情況下完全**輕 UI**,並且您可以同時**共同編輯**相同的檔案。其中每一個都是本節中的一個頁面。
|
|
11
11
|
|
|
12
|
-
```an-diagram title="
|
|
12
|
+
```an-diagram title="日複一日的迴圈" summary="使用對接代理的五種方式 - 每種方式都是本節中的一個頁面。"
|
|
13
13
|
{
|
|
14
|
-
"html": "<div class=\"diagram-loop\"><div class=\"diagram-card\"><strong>Sees</strong><small class=\"diagram-muted\">your view & selection</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">→</div><div class=\"diagram-card\"><strong>Direct</strong><small class=\"diagram-muted\">@-mentions & voice</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">→</div><div class=\"diagram-card\"><strong>Embed</strong><small class=\"diagram-muted\">drop into any app</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">→</div><div class=\"diagram-card\"><strong>輕 UI</strong><small class=\"diagram-muted\">chat is the product</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">→</div><div class=\"diagram-card accent-card\"><span class=\"diagram-pill accent\">協同編輯</span><small class=\"diagram-muted\"
|
|
14
|
+
"html": "<div class=\"diagram-loop\"><div class=\"diagram-card\"><strong>Sees</strong><small class=\"diagram-muted\">your view & selection</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">→</div><div class=\"diagram-card\"><strong>Direct</strong><small class=\"diagram-muted\">@-mentions & voice</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">→</div><div class=\"diagram-card\"><strong>Embed</strong><small class=\"diagram-muted\">drop into any app</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">→</div><div class=\"diagram-card\"><strong>輕 UI</strong><small class=\"diagram-muted\">chat is the product</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">→</div><div class=\"diagram-card accent-card\"><span class=\"diagram-pill accent\">協同編輯</span><small class=\"diagram-muted\">即時,並排</small></div></div>",
|
|
15
15
|
"css": ".diagram-loop{display:flex;align-items:stretch;gap:10px;flex-wrap:wrap}.diagram-loop .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:130px;flex:1}.diagram-loop .diagram-arrow{align-self:center;font-size:22px;line-height:1}"
|
|
16
16
|
}
|
|
17
17
|
```
|
|
18
18
|
|
|
19
|
-
##
|
|
19
|
+
## 它能看到你在看什麼 {#it-sees}
|
|
20
20
|
|
|
21
|
-
|
|
21
|
+
代理不會對您的螢幕視而不見。開啟一封電子郵件,它就知道是哪個對話串。選取一個圖表,它就知道是哪個圖表。突出顯示一個段落,它可以只作用於該範圍。這種共同的意識讓您可以說“回覆此內容”或“總結選取”,而無需每次都拼寫出脈絡。
|
|
22
22
|
|
|
23
|
-
這是有效的,因為目前的導覽和選取位於 `application_state` SQL
|
|
23
|
+
這是有效的,因為目前的導覽和選取位於 `application_state` SQL 中,代理將其作為其脈絡的一部分讀取。代理還可以驅動相同的狀態 - 開啟檢視,選取一行 - 這樣你就可以看到它在真實的 UI 中而不是在指令碼中工作。
|
|
24
24
|
|
|
25
25
|
```an-callout
|
|
26
26
|
{
|
|
@@ -29,43 +29,43 @@ agent-native 背後的定義思想是,agent 和 UI 是**平等的伙伴** -
|
|
|
29
29
|
}
|
|
30
30
|
```
|
|
31
31
|
|
|
32
|
-
→ [**Context Awareness**](/docs/context-awareness) —
|
|
32
|
+
→ [**Context Awareness**](/docs/context-awareness) — 導覽狀態、檢視螢幕、導覽指令以及代理如何與您的螢幕保持同步。
|
|
33
33
|
|
|
34
34
|
## 你指揮 {#you-direct-it}
|
|
35
35
|
|
|
36
|
-
|
|
36
|
+
大多數時候,您透過在聊天中輸入內容來引導代理。有兩件事可以讓速度更快。
|
|
37
37
|
|
|
38
|
-
**提及。** 使用 `@` 標記自訂代理、連線的代理或檔案,將其拉入對話中 — “讓 `@analytics`
|
|
38
|
+
**提及。** 使用 `@` 標記自訂代理、連線的代理或檔案,將其拉入對話中 — “讓 `@analytics` 拉取上週的資料,然後起草摘要。”提及是您如何在不離開撰寫器的情況下找到合適的專家或附加正確的脈絡。
|
|
39
39
|
|
|
40
|
-
|
|
40
|
+
**聲音。**撰寫器有麥克風。口述請求而不是鍵入請求,提供者選項範圍從 Builder 的託管轉錄到自帶金鑰到瀏覽器後備。
|
|
41
41
|
|
|
42
42
|
→ [**Agent Mentions**](/docs/agent-mentions) - `@` - 在聊天中提及自訂代理、連線的代理和檔案。
|
|
43
|
-
→ [**Voice Input**](/docs/voice-input) —
|
|
43
|
+
→ [**Voice Input**](/docs/voice-input) — 聊天編輯器中的聽寫以及轉錄的路由方式。
|
|
44
44
|
|
|
45
45
|
## 您嵌入它 {#you-embed-it}
|
|
46
46
|
|
|
47
|
-
|
|
47
|
+
代理不是您透過 Tab 鍵切換到的單獨應用程式。它以幾個 React 元件的形式提供——一個側邊欄、一個原始面板和一個 `sendToAgentChat()` 呼叫——您可以將它們放入任何應用程式中。渲染 `<AgentSidebar>` 為每個螢幕提供一個可切換代理,或連線一個按鈕將特定工作交給聊天,而不是執行一次性 LLM 呼叫。
|
|
48
48
|
|
|
49
49
|
→ [**Drop-in Agent**](/docs/drop-in-agent) — 將 `<AgentPanel>`、`<AgentSidebar>` 和 `sendToAgentChat()` 安裝到任何 React 應用程式中。
|
|
50
50
|
→ [**Agent Surfaces**](/docs/agent-surfaces) — 選取工作流程是否應為無頭、聊天優先、嵌入式或完整應用程式。
|
|
51
51
|
|
|
52
52
|
## 你可以去輕 UI {#ui-light}
|
|
53
53
|
|
|
54
|
-
並非每個應用程式都需要完整的儀表板。當代理*是*產品時,您可以跳過大部分自訂UI
|
|
54
|
+
並非每個應用程式都需要完整的儀表板。當代理*是*產品時,您可以跳過大部分自訂 UI:開啟應用程式,詢問您想要的內容,然後讓代理完成其餘的工作。代理仍然有其管理介面——歷史紀錄、工作區、設定——但主要互動是對話而不是點選。
|
|
55
55
|
|
|
56
56
|
→ [**Pure-Agent Apps**](/docs/pure-agent-apps) — 代理是整個產品的應用。
|
|
57
57
|
|
|
58
58
|
## 您與它共同編輯 {#you-co-edit}
|
|
59
59
|
|
|
60
|
-
|
|
60
|
+
當您和代理處理同一份檔案時,你們不會輪流處理。透過即時協作,代理的編輯可以與您的編輯一起傳輸 - 即時游標,不會覆蓋 - 與隊友的編輯方式相同。您可以在它工作時繼續輸入,並且它會在發生更改時看到您的更改。
|
|
61
61
|
|
|
62
|
-
→ [**Real-Time Collaboration**](/docs/real-time-collaboration) —
|
|
62
|
+
→ [**Real-Time Collaboration**](/docs/real-time-collaboration) — 在同一檔案中使用即時游標和代理編輯進行多使用者協作編輯。
|
|
63
63
|
|
|
64
|
-
##
|
|
64
|
+
## 下一步是什麼 {#whats-next}
|
|
65
65
|
|
|
66
|
-
- [**Context Awareness**](/docs/context-awareness) —
|
|
66
|
+
- [**Context Awareness**](/docs/context-awareness) — 代理知道您在看什麼
|
|
67
67
|
- [**Agent Mentions**](/docs/agent-mentions) — 使用 `@` 提及來引導
|
|
68
|
-
- [**Voice Input**](/docs/voice-input) —
|
|
68
|
+
- [**Voice Input**](/docs/voice-input) — 透過說話進行指導
|
|
69
69
|
- [**Drop-in Agent**](/docs/drop-in-agent) — 將其嵌入任何 React 應用
|
|
70
70
|
- [**Pure-Agent Apps**](/docs/pure-agent-apps) — 當代理是產品時,采用 輕 UI
|
|
71
71
|
- [**Real-Time Collaboration**](/docs/real-time-collaboration) — 共同編輯同一檔案
|
|
@@ -1,25 +1,25 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: "語音輸入"
|
|
3
|
-
description: "
|
|
3
|
+
description: "代理聊天編輯器中的語音聽寫 - Builder Gemini、BYOK 提供者和瀏覽器 Web 語音後備。"
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# 語音輸入
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
每個 Agent-Native 應用程式的聊天編輯器中都有一個麥克風。點選它,說話,您的話就會被轉錄到提示中。在行動設備上很有用,對於長提示很有用,當您的手放在其他東西上時很有用。
|
|
9
9
|
|
|
10
|
-
框架會自動處理所有這些。 Builder連線的使用者預設獲得Builder託管的Gemini Flash-Lite;否則,使用者可以攜帶自己的提供者金鑰或退回到瀏覽器語音識別。
|
|
10
|
+
框架會自動處理所有這些。 Builder 連線的使用者預設獲得 Builder 託管的 Gemini Flash-Lite;否則,使用者可以攜帶自己的提供者金鑰或退回到瀏覽器語音識別。
|
|
11
11
|
|
|
12
12
|
## 它是如何工作的 {#how-it-works}
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
撰寫器的語音按鈕在瀏覽器中錄製音訊,然後選取提供者:
|
|
15
15
|
|
|
16
|
-
1. **Builder Gemini Flash-Lite(連線 Builder 時預設)。**瀏覽器將音訊 POST 到 `/_agent-native/transcribe-voice`,`/_agent-native/transcribe-voice` 使用 Gemini Flash-Lite
|
|
16
|
+
1. **Builder Gemini Flash-Lite(連線 Builder 時預設)。**瀏覽器將音訊 POST 到 `/_agent-native/transcribe-voice`,`/_agent-native/transcribe-voice` 使用 Gemini Flash-Lite 透過 Builder.io 進行代理。無需 Google API 金鑰。
|
|
17
17
|
2. **BYOK 雲端提供者。** 使用者可以從“設定”中選取 Google Gemini、Groq Whisper 或 OpenAI Whisper。該路由在共用部署憑證之前解析使用者範圍的加密機密。
|
|
18
|
-
3. **瀏覽器網路語音 API(後備)。**
|
|
18
|
+
3. **瀏覽器網路語音 API(後備)。** 如果沒有可用的伺服器提供者,撰寫器可以使用瀏覽器的內建語音識別。適用於基於 Chromium 的瀏覽器(Chrome、Edge、Arc)和 Safari。不太準確;即時串流。
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
提供者選取儲存在 `voice-transcription-prefs` 下的應用程式狀態中,因此使用者可以在側邊欄設定中強制使用 `"auto"`(預設 — 選取最佳的可用提供者)、`"builder-gemini"`、`"builder"`、`"gemini"`、`"groq"`、`"openai"` 或 `"browser"`。
|
|
21
21
|
|
|
22
|
-
```an-diagram title="語音轉錄提供者後備方案" summary="
|
|
22
|
+
```an-diagram title="語音轉錄提供者後備方案" summary="撰寫器錄製音訊,然後按順序遍歷伺服器提供者,僅當沒有可用的伺服器提供者時才轉到瀏覽器 Web Speech API。"
|
|
23
23
|
{
|
|
24
24
|
"html": "<div class=\"diagram-voice\"><div class=\"diagram-node\">麥克風按鈕<br><small class=\"diagram-muted\">錄製 webm/opus</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">→</div><div class=\"diagram-card col\"><div class=\"diagram-pill accent\">1 · Builder Gemini</div><small class=\"diagram-muted\">連線 Builder 後預設使用</small><div class=\"diagram-pill\">2 · BYOK cloud</div><small class=\"diagram-muted\">Gemini · Groq · OpenAI Whisper</small></div><div class=\"diagram-arrow diagram-warn\" aria-hidden=\"true\">↓</div><div class=\"diagram-box diagram-warn\" data-rough>3 · Browser Web Speech<br><small class=\"diagram-muted\">fallback on 400 · streams live</small></div></div>",
|
|
25
25
|
"css": ".diagram-voice{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-voice .col{display:flex;flex-direction:column;gap:6px;padding:14px}.diagram-voice .diagram-arrow{font-size:22px;line-height:1}"
|
|
@@ -34,7 +34,7 @@ Builder 是最簡單的路徑:從“設定”連線 Builder.io,預設提供
|
|
|
34
34
|
|
|
35
35
|
### 每使用者(推薦用於 SaaS)
|
|
36
36
|
|
|
37
|
-
|
|
37
|
+
使用者透過代理側邊欄設定 UI 設定自己的金鑰。它儲存為使用者範圍的加密秘密(透過 `readAppSecret`)。每個使用者為自己的轉錄付費;主機零成本。
|
|
38
38
|
|
|
39
39
|
### 共用(用於內部工具)
|
|
40
40
|
|
|
@@ -43,17 +43,17 @@ Builder 是最簡單的路徑:從“設定”連線 Builder.io,預設提供
|
|
|
43
43
|
```an-callout
|
|
44
44
|
{
|
|
45
45
|
"tone": "info",
|
|
46
|
-
"body": "
|
|
46
|
+
"body": "**憑證解析順序:**路由首先檢查使用者自己的加密金鑰,然後檢查共用部署金鑰。擁有自己金鑰的進階使用者始終會覆蓋共用金鑰。如果兩者都不存在,則路由將返回撰寫器識別的 400,並默默地退回到瀏覽器 Web 語音。"
|
|
47
47
|
}
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
-
##
|
|
50
|
+
## 路由 {#route}
|
|
51
51
|
|
|
52
|
-
```an-api title="
|
|
52
|
+
```an-api title="語音轉錄路由"
|
|
53
53
|
{
|
|
54
54
|
"method": "POST",
|
|
55
55
|
"path": "/_agent-native/transcribe-voice",
|
|
56
|
-
"summary": "
|
|
56
|
+
"summary": "將錄製的音訊片段轉錄為提示文字",
|
|
57
57
|
"auth": "Active session (Better Auth cookie). Same-origin only.",
|
|
58
58
|
"description": "The composer POSTs the recorded clip here; the route resolves a provider and returns the transcribed text. You should not call this directly.",
|
|
59
59
|
"params": [
|
|
@@ -68,14 +68,14 @@ Builder 是最簡單的路徑:從“設定”連線 Builder.io,預設提供
|
|
|
68
68
|
}
|
|
69
69
|
```
|
|
70
70
|
|
|
71
|
-
|
|
71
|
+
您不需要直接呼叫它——撰寫器會這樣做。如果您正在建置自訂輸入介面,請首先重用 `@agent-native/core/client` 中的共用撰寫器/語音用戶端片段。將此路由視為需要傳送多部分音訊的自訂助手的低階傳輸邊界。
|
|
72
72
|
|
|
73
|
-
##
|
|
73
|
+
## 自訂提供者 {#customizing}
|
|
74
74
|
|
|
75
|
-
提供者欄位是一個普通的應用程式狀態金鑰,因此代理可以根據請求更改它(`"use the browser speech recognizer instead"`)。如果您正在建置具有不同要求的範本(例如,本機 Whisper
|
|
75
|
+
提供者欄位是一個普通的應用程式狀態金鑰,因此代理可以根據請求更改它(`"use the browser speech recognizer instead"`)。如果您正在建置具有不同要求的範本(例如,本機 Whisper 部署),請在框架安裝預設路由之前透過註冊您自己的 `transcribe-voice` 路由來交換路由處理常式。
|
|
76
76
|
|
|
77
|
-
##
|
|
77
|
+
## 下一步是什麼
|
|
78
78
|
|
|
79
|
-
- [**Drop-in Agent**](/docs/drop-in-agent) —
|
|
79
|
+
- [**Drop-in Agent**](/docs/drop-in-agent) — 公開語音按鈕的撰寫器
|
|
80
80
|
- [**Onboarding**](/docs/onboarding) — 註冊提供者金鑰作為設定步驟
|
|
81
|
-
- [**Security & Data Scoping**](/docs/security) —
|
|
81
|
+
- [**Security & Data Scoping**](/docs/security) — 每個使用者如何儲存加密秘密
|
|
@@ -1,83 +1,83 @@
|
|
|
1
1
|
---
|
|
2
|
-
title: "Agent-Native
|
|
3
|
-
description: "
|
|
2
|
+
title: "Agent-Native 是什麼?"
|
|
3
|
+
description: "為什麼大多數人工智慧應用感覺是半成品,是什麼讓應用真正成為 Agent-Native 的,以及最終的結果是你的日常體驗。"
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# Agent-Native
|
|
6
|
+
# Agent-Native 是什麼?
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
原生代理是一種建置軟體的方式,其中人工智慧代理及其週圍的產品表面是**平等的合作伙伴**。該表面可以是具有一個自訂操作的無頭代理、豐富的聊天或完整的 UI。重要的是代理和人類共用相同的 actions、資料庫和狀態。
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
如果您只記得本頁面中的一件事,請記住這一點:當今大多數人工智慧應用程式都離實用性差一步,而這一差距是目前該領域最大的錯誤。
|
|
11
11
|
|
|
12
|
-
##
|
|
12
|
+
## 作為一個使用者是什麼樣的 {#what-it-looks-like}
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
想象一個背景工作人員、收件箱、行事曆、表單生成器或分析儀表板。有時還沒有自訂螢幕:您執行一項操作或一項無頭應用程式代理提示。有時,第一個螢幕是聊天:您詢問您想要什麼,代理指導設定,顯示表格或圖表,並開啟正確的應用程式檢視。有時聊天會停靠在完整應用程式的右側。透過這些形狀,您可以:
|
|
15
15
|
|
|
16
|
-
- **從實際操作開始。**一個持久操作可以從 CLI、HTTP、MCP、A2A
|
|
17
|
-
- **點選存在 UI
|
|
18
|
-
- **或者只是詢問。**
|
|
16
|
+
- **從實際操作開始。**一個持久操作可以從 CLI、HTTP、MCP、A2A、應用程式代理迴圈以及稍後的 UI 執行。
|
|
17
|
+
- **點選存在 UI 時通常點選的任何內容。**所有按鈕、清單、儀表板、鍵盤快速鍵 - 它們都呼叫代理可以呼叫的相同操作。
|
|
18
|
+
- **或者只是詢問。** 在代理中輸入“回覆 Sara 的電子郵件,說我會在 3 點前到達”。它會開啟正確的對話串,起草回覆,然後將其顯示給您以供核准 - 就像您手動完成的一樣。
|
|
19
19
|
- **檢視它看到的內容。** 開啟一封電子郵件,代理就知道是哪一封。選取一個圖表,代理就知道是哪個圖表。突出顯示一個段落並按 Cmd+I,代理將僅對該段落執行操作。
|
|
20
|
-
- **觀察它的工作。**
|
|
21
|
-
-
|
|
20
|
+
- **觀察它的工作。** 當代理執行操作(開啟檢視、編輯草稿、執行報告)時,UI 會即時更新。您可以隨時停止它、重新導向它或用滑鼠接管。
|
|
21
|
+
- **像隊友一樣引導它。**提供意見回饋、排隊另一個工作、編輯其指令、審核它昨天做了什麼。它會記住,並且隨著時間的推移,它會更好地適應您的工作流程。
|
|
22
22
|
|
|
23
23
|
這就是 agent-native 的設計初衷。這就是大多數產品無法實現這一目標的原因。
|
|
24
24
|
|
|
25
|
-
##
|
|
25
|
+
## 為什麼大多數“人工智慧應用程式”都達不到要求(階梯原理) {#the-ladder}
|
|
26
26
|
|
|
27
27
|
大多數團隊都在攀登,就像梯子一樣,而且大多數人過早地停止了一級。
|
|
28
28
|
|
|
29
|
-
### 第 1 階 —
|
|
29
|
+
### 第 1 階 — 單一 LLM 呼叫(反模式) {#rung-one}
|
|
30
30
|
|
|
31
|
-
|
|
31
|
+
文字框傳送提示,AI 返回字串,然後您顯示它。也許用旋轉器。使用者無法糾正路由,人工智慧無法採取行動,無法了解發生了什麼或為什麼。
|
|
32
32
|
|
|
33
|
-
您隨處可見:“AI 功能”基本上是固定在 SaaS
|
|
33
|
+
您隨處可見:“AI 功能”基本上是固定在 SaaS 產品上的“總結”按鈕。它們在示範中看起來令人印象深刻,並在現實變得混亂時打破了這一點。那不是一個產品;而是一個產品。那是一個玩具。
|
|
34
34
|
|
|
35
35
|
### 梯級 2 — 使用工具聊天 {#rung-two}
|
|
36
36
|
|
|
37
|
-
|
|
37
|
+
現在人工智慧可以*做事*。它有工具——“電子郵件草稿”、“搜尋聯絡人”、“執行查詢”——以及一個聊天介面,它在你面前工作,顯示工具呼叫和結果。這就是 Claude、ChatGPT 和 Cursor 在底層的樣子。
|
|
38
38
|
|
|
39
|
-
|
|
39
|
+
這是真正的進步。但就其本身而言,它仍然是一個聊天視窗。沒有正確的 UI。沒有儀表板、沒有清單、沒有表單、沒有鍵盤快速鍵、沒有團隊協作。如果人工智慧感到困惑,你就會陷入重新輸入的困境,而不僅僅是點選正確的按鈕。非開發人員很難以這種格式完成真正的工作。
|
|
40
40
|
|
|
41
|
-
### 第 3 級 —
|
|
41
|
+
### 第 3 級 — 代理 + UI 作為平等合伙人 {#rung-three}
|
|
42
42
|
|
|
43
|
-
|
|
43
|
+
這是 Agent-Native 的。您可以在代理週圍新增一個真實的、功能齊全的應用程式 - 至關重要的是,代理可以執行的每個操作也是 UI 中的一個按鈕,並且使用者點選的每個按鈕都執行代理使用的相同邏輯。一種實現,兩種方式。
|
|
44
44
|
|
|
45
45
|
當您到達第 3 級時,三件事會發生變化:
|
|
46
46
|
|
|
47
47
|
- **您停止向聊天機器人新增按鈕。您向應用程式新增了代理。** 這對雙方來說都是品質更高的產品。
|
|
48
|
-
-
|
|
49
|
-
-
|
|
48
|
+
- **代理具有真實的脈絡。**它可以看到您正在檢視的內容、您選取的內容以及您剛剛執行的操作。它寫入 UI 讀取的同一個資料庫,因此它的工作會立即顯示。
|
|
49
|
+
- **外部代理也可以使用它。**其他 Agent-Native 應用程式可以透過 [A2A protocol](/docs/a2a-protocol) 呼叫此 actions。 Claude 程式碼、Codex、ChatGPT 自訂 MCP 應用程式、游標和其他 MCP 主機可以將其作為[MCP server](/docs/mcp-protocol)驅動。一個應用程式,多個入口點。
|
|
50
50
|
|
|
51
|
-
這是第 3
|
|
51
|
+
這是第 3 級。這是 Agent-Native 的。
|
|
52
52
|
|
|
53
53
|
```an-diagram title="階梯原理" summary="大多數團隊停在第 1 級或第 2 級。原生代理是第 3 級——一個真實的應用程式和一個共用操作介面上的真實代理。"
|
|
54
54
|
{
|
|
55
|
-
"html": "<div class=\"diagram-ladder\"><div class=\"diagram-card rung rung-3\"><span class=\"diagram-pill accent\">第 3 階 · agent-native</span><strong>代理 + UI 作為平等伙伴</strong><small class=\"diagram-muted\">One action surface. Every agent tool is also a button; every button runs the same logic the agent uses.</small></div><div class=\"diagram-card rung rung-2\"><span class=\"diagram-pill\">第 2 階</span><strong>帶工具的聊天</strong><small class=\"diagram-muted\"
|
|
55
|
+
"html": "<div class=\"diagram-ladder\"><div class=\"diagram-card rung rung-3\"><span class=\"diagram-pill accent\">第 3 階 · agent-native</span><strong>代理 + UI 作為平等伙伴</strong><small class=\"diagram-muted\">One action surface. Every agent tool is also a button; every button runs the same logic the agent uses.</small></div><div class=\"diagram-card rung rung-2\"><span class=\"diagram-pill\">第 2 階</span><strong>帶工具的聊天</strong><small class=\"diagram-muted\">代理可以行動,但它仍只是聊天視窗。沒有儀表板、清單或快速鍵。</small></div><div class=\"diagram-card rung rung-1\"><span class=\"diagram-pill warn\">第 1 階</span><strong>一次 LLM 呼叫</strong><small class=\"diagram-muted\">Prompt in, string out. Impressive in a demo; breaks the moment reality gets messy.</small></div></div>",
|
|
56
56
|
"css": ".diagram-ladder{display:flex;flex-direction:column;gap:14px}.diagram-ladder .rung{display:flex;flex-direction:column;gap:6px;padding:16px 18px}.diagram-ladder .rung-2{margin-inline-end:48px}.diagram-ladder .rung-1{margin-inline-end:96px}"
|
|
57
57
|
}
|
|
58
58
|
```
|
|
59
59
|
|
|
60
60
|
請參閱 [Key Concepts — Protocols](/docs/key-concepts#protocols),了解所有這些如何掛在同一操作定義上。
|
|
61
61
|
|
|
62
|
-
##
|
|
62
|
+
## 為什麼每個代理都需要 UI {#why-every-agent-needs-a-ui}
|
|
63
63
|
|
|
64
64
|
即使代理完成了所有繁重的工作,人類仍然需要:
|
|
65
65
|
|
|
66
|
-
-
|
|
66
|
+
- **看看它在做什麼** - 進度、中間輸出、它觸及了什麼
|
|
67
67
|
- **引導它** — 提供意見回饋、中斷、對下一個工作進行排隊
|
|
68
|
-
- **管理它** - 編輯其指令、skills
|
|
68
|
+
- **管理它** - 編輯其指令、skills、記憶、計畫作業、連線的帳戶
|
|
69
69
|
- **檢查其工作**——審查草稿、審核歷史紀錄、回滾錯誤
|
|
70
|
-
- **分享其輸出** -
|
|
70
|
+
- **分享其輸出** - 儀表板、報告、表單、傳送給隊友的連結
|
|
71
71
|
|
|
72
72
|
至少,“代理的 UI”是一個可觀察性和管理儀表板。最多,它是一個完整的 SaaS 應用程式,其中嵌入了代理作為副駕駛。兩端都算作原生代理,並且表面可以從一端增長而無需重寫。
|
|
73
73
|
|
|
74
|
-
|
|
74
|
+
您不必預先選取形狀。代理可以無頭執行,坐在豐富的聊天後面,或者住在圍繞同一操作介面的完整應用程式中 - 請參閱 [Agent Surfaces](/docs/agent-surfaces) 了解具體形狀和 API。
|
|
75
75
|
|
|
76
|
-
##
|
|
76
|
+
## 為什麼每個應用都受益於代理 {#why-every-app-benefits-from-an-agent}
|
|
77
77
|
|
|
78
78
|
另一面也同樣重要。現有的 SaaS 產品總是遇到同樣的問題:80% 的產品你需要的效果很好,而 20% 的產品你就是無法改變。新增聊天側邊欄很少能解決這個問題——聊天通常無法真正\_做\_UI 可以做的事情。
|
|
79
79
|
|
|
80
|
-
|
|
80
|
+
Agent-Native 翻轉了這一點。由於應用程式中的每個操作都定義一次,並作為按鈕和代理工具公開,因此代理可以執行按鈕可以執行的所有操作(甚至更多),而無需維護單獨的“AI 世界”。自然語言與點選一起成為一流的輸入。
|
|
81
81
|
|
|
82
82
|
這個論點不是“代理取代 UI”。它是“**代理屬於應用程式內部,頂部有 UI,作為平等的合作伙伴**。”即使代理是產品的應用程式仍然需要 UI 供人類監督、設定和引導 - 請參閱 [Agent Surfaces — Headless](/docs/agent-surfaces#headless)。
|
|
83
83
|
|
|
@@ -85,33 +85,33 @@ description: "為什么大多數人工智能應用感覺是半成品,是什么
|
|
|
85
85
|
|
|
86
86
|
這是定義原則。
|
|
87
87
|
|
|
88
|
-
> **來自 UI** —
|
|
88
|
+
> **來自 UI** — 點選按鈕、填寫表格、導覽檢視。 UI 寫入資料庫;代理看到結果。
|
|
89
89
|
>
|
|
90
|
-
> **來自代理** —
|
|
90
|
+
> **來自代理** — 自然語言,其他代理透過 A2A、Slack、Telegram。代理寫入資料庫; UI 自動更新。
|
|
91
91
|
|
|
92
|
-
```an-diagram title="一套系統,兩種方式" summary="代理和 UI
|
|
92
|
+
```an-diagram title="一套系統,兩種方式" summary="代理和 UI 寫入相同的操作和相同的資料庫。無論一個人做什麼,另一個人都會看到。"
|
|
93
93
|
{
|
|
94
|
-
"html": "<div class=\"diagram-parity\"><div class=\"diagram-col\"><div class=\"diagram-node\">Human<br><small class=\"diagram-muted\"
|
|
94
|
+
"html": "<div class=\"diagram-parity\"><div class=\"diagram-col\"><div class=\"diagram-node\">Human<br><small class=\"diagram-muted\">點選、表單、快速鍵</small></div><div class=\"diagram-node\">Agent<br><small class=\"diagram-muted\">自然語言 · A2A · Slack</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">→</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Actions</span><small class=\"diagram-muted\">defined once</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">→</div><div class=\"diagram-box\">SQL 資料庫</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">↻</div><div class=\"diagram-box\">介面即時更新</div></div>",
|
|
95
95
|
"css": ".diagram-parity{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-parity .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-parity .diagram-arrow{font-size:22px;line-height:1}.diagram-parity .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
|
|
96
96
|
}
|
|
97
97
|
```
|
|
98
98
|
|
|
99
|
-
當代理建立電子郵件草稿時,它會顯示在 UI
|
|
99
|
+
當代理建立電子郵件草稿時,它會顯示在 UI 中。當您點選“傳送”時,代理就知道它已傳送。沒有單獨的“代理世界”和“UI 世界”——它是一個系統。請參閱 [Key Concepts](/docs/key-concepts) 了解實現此功能的架構。
|
|
100
100
|
|
|
101
101
|
## 通常為電動工具保留定制 {#workspace-customization}
|
|
102
102
|
|
|
103
|
-
像 Claude Code 這樣的工具之所以如此強大,並不是因為模型,而是**定制層**:每個專案的指令、skills
|
|
103
|
+
像 Claude Code 這樣的工具之所以如此強大,並不是因為模型,而是**定制層**:每個專案的指令、skills、記憶、子代理、連線的服務。您可以根據您的程式碼庫、您的偏好、您的團隊來塑造代理。
|
|
104
104
|
|
|
105
|
-
Agent-
|
|
105
|
+
Agent-Native 為每個使用者提供相同的自訂層 - 無需離開應用程式。每個應用程式都附帶一個個人**工作區**,您(或團隊中的任何人)可以:
|
|
106
106
|
|
|
107
107
|
- 編輯每個代理都會讀取的團隊範圍規則
|
|
108
108
|
- 讓代理在您更正時自動記住偏好
|
|
109
109
|
- 將可重用的操作指南編寫為 `/slash` 指令
|
|
110
|
-
- 為特定工作保留自訂子代理(使用 `@mentions`
|
|
110
|
+
- 為特定工作保留自訂子代理(使用 `@mentions` 呼叫)
|
|
111
111
|
- 安排作業在 cron 上執行(例如“每週一早上,總結上週”)
|
|
112
|
-
-
|
|
112
|
+
- 透過每使用者 MCP 伺服器連線外部服務(Gmail、Stripe、Slack、內部 API)
|
|
113
113
|
|
|
114
|
-
|
|
114
|
+
不同之處:它全部儲存在資料庫中,而不是檔案系統中。沒有需要啟動的開發環境,每個使用者沒有容器。每個使用者都可以獲得自己的完整工作空間 - 個人記憶、個人聯絡、個人 skills - 基本上免費,因為它是表中的所有行。這就是 Claude 程式碼級靈活性在真正的多租戶 SaaS 產品中可行的原因。
|
|
115
115
|
|
|
116
116
|
請參閱 [Workspace](/docs/workspace) 了解完整概念。
|
|
117
117
|
|
|
@@ -119,25 +119,25 @@ Agent-native 為每個使用者提供相同的自訂層 - 無需離開應用程
|
|
|
119
119
|
|
|
120
120
|
| 方法 | 描述 |
|
|
121
121
|
| ----------------------------------- | ------------------------------------------------------------------------------------------------------ |
|
|
122
|
-
|
|
|
122
|
+
| **搭載人工智慧的傳統應用** | 人工智慧是事後的想法。僅限於自動完成、摘要或聊天側邊欄,實際上無法在應用程式中執行任何操作。 |
|
|
123
123
|
| **純聊天/代理介面** | 強大但難以接近。沒有儀表板,沒有工作流程,沒有持久性。非開發人員無法有效使用它們。 |
|
|
124
124
|
| **Claude 程式碼 / Codex 用於 SaaS** | 非常適合開發者在自己的機器上使用。不會轉化為多租戶 SaaS — 開發盒上每個使用者一個程式碼庫無法擴充功能。 |
|
|
125
|
-
|
|
|
125
|
+
| **Agent-Native 應用** | 代理是一等公民。它共用相同的資料庫、相同的狀態,並且可以執行 UI 可以執行的所有操作 - 反之亦然。 |
|
|
126
126
|
|
|
127
127
|
## 整個團隊的發展 {#whole-team-development}
|
|
128
128
|
|
|
129
|
-
Agent-
|
|
129
|
+
Agent-Native 不僅僅適合開發人員。由於代理可以編輯應用程式自己的程式碼,因此開發應用程式不再是僅限開發人員的活動:
|
|
130
130
|
|
|
131
|
-
-
|
|
132
|
-
-
|
|
133
|
-
- **QA**
|
|
134
|
-
-
|
|
131
|
+
- **設計師**透過代理直接在執行的應用程式中更新設計
|
|
132
|
+
- **產品經理**透過描述來新增功能和更新流程
|
|
133
|
+
- **QA** 測試應用並要求代理修復損壞的內容
|
|
134
|
+
- **團隊中的任何人**透過自然語言做出貢獻
|
|
135
135
|
|
|
136
136
|
願景:減少交接,一個人完成小團隊的工作。
|
|
137
137
|
|
|
138
138
|
## 分叉並自訂 {#fork-and-customize}
|
|
139
139
|
|
|
140
|
-
|
|
140
|
+
Agent-Native 應用程式遵循分叉和自訂模型。您從**範本**開始 - 行事曆、內容、幻燈片、分析、郵件、剪輯、設計、表單、調度 - 並將其變成您的。每一個都是一個完整的、可工作的 SaaS 產品,您可以批量分叉,而不是一個空白的腳手架:
|
|
141
141
|
|
|
142
142
|
1. 在[agent-native.com/templates](/templates)上選取範本
|
|
143
143
|
2. 立即將其用作託管應用程式(例如 mail.agent-native.com)
|
|
@@ -145,19 +145,19 @@ Agent-native 不僅僅適合開發人員。由於代理可以編輯應用程式
|
|
|
145
145
|
4. 代理修改程式碼以滿足您的需求
|
|
146
146
|
5. 將您的分叉部署到您自己的域 - 或留在agent-native.com
|
|
147
147
|
|
|
148
|
-
|
|
148
|
+
因為它是*您的*應用程式,而不是共用基礎設施,所以代理可以安全地改行程式碼。您的應用程式會隨著您的使用而不斷改進。完整故事請參見 [Templates](/docs/cloneable-saas)。
|
|
149
149
|
|
|
150
|
-
|
|
150
|
+
尚未準備好分叉整個範本?您還可以透過向已使用的編碼代理新增**技能**來嘗試 Agent-Native - 使用 `npx @agent-native/core@latest skills add visual-plan` 安裝計畫技能。請參閱 [Skills Guide](/docs/skills-guide#app-backed-skills)。
|
|
151
151
|
|
|
152
152
|
## 可組合代理 {#composable-agents}
|
|
153
153
|
|
|
154
|
-
|
|
154
|
+
Agent-Native 應用程式可以相互通信。在郵件應用程式內部,您可以標記分析代理以查詢資料並將結果包含在草稿電子郵件中。代理會發現其他可用代理,在彼此之間移交工作,並在您已經所在的 UI 中顯示結果。
|
|
155
155
|
|
|
156
|
-
這由 [A2A](/docs/a2a-protocol) 和 [MCP](/docs/mcp-protocol)
|
|
156
|
+
這由 [A2A](/docs/a2a-protocol) 和 [MCP](/docs/mcp-protocol) 提供支援 - 相同的定義,多個表面 - 但作為使用者,您所需要知道的是“我可以向我的任何應用程式尋求任何他們可以做的事情的幫助。”
|
|
157
157
|
|
|
158
|
-
##
|
|
158
|
+
## 這在程式碼中是什麼樣的? {#what-does-it-look-like-in-code}
|
|
159
159
|
|
|
160
|
-
|
|
160
|
+
如果您正在建置或擴充功能 Agent-Native 應用程式,那麼中心模式如下:應用程式中的每個操作都是一個**操作** - 定義一次,可供代理和 UI 使用。
|
|
161
161
|
|
|
162
162
|
```an-annotated-code title="一個動作,定義一次"
|
|
163
163
|
{
|
|
@@ -165,7 +165,7 @@ Agent-native 不僅僅適合開發人員。由於代理可以編輯應用程式
|
|
|
165
165
|
"language": "ts",
|
|
166
166
|
"code": "import { defineAction } from \"@agent-native/core/action\";\nimport { z } from \"zod\";\n\nexport default defineAction({\n description: \"Reply to an email thread\",\n schema: z.object({ emailId: z.string(), body: z.string() }),\n run: async ({ emailId, body }) => {\n // db and schema come from your app's server/db setup\n await db.insert(schema.replies).values({ emailId, body });\n },\n});",
|
|
167
167
|
"annotations": [
|
|
168
|
-
{ "lines": "5", "label": "工具表面", "note": "`description`
|
|
168
|
+
{ "lines": "5", "label": "工具表面", "note": "`description` 是代理讀取的內容,以決定何時將其呼叫為工具。" },
|
|
169
169
|
{ "lines": "6", "label": "型別化契約", "note": "一個 zod `schema` 會驗證來自**每個**介面的輸入:代理、UI、HTTP、MCP 和 A2A。" },
|
|
170
170
|
{ "lines": "7-10", "label": "一次實施", "note": "`run` 主體是唯一的事實來源。 UI 按鈕和代理工具都執行此操作。" }
|
|
171
171
|
]
|
|
@@ -188,15 +188,15 @@ import { AgentSidebar } from "@agent-native/core/client";
|
|
|
188
188
|
<AgentSidebar />;
|
|
189
189
|
```
|
|
190
190
|
|
|
191
|
-
一個操作,多個表面:代理將其稱為工具,UI 將其稱為型別安全突變,[native chat](/docs/native-chat-ui)
|
|
191
|
+
一個操作,多個表面:代理將其稱為工具,UI 將其稱為型別安全突變,[native chat](/docs/native-chat-ui) 可以呈現顯式小工具結果,外部代理透過 [A2A](/docs/a2a-protocol) 存取它,MCP 主機透過應用程式的 [MCP server](/docs/mcp-protocol) 呼叫它,可選地使用 MCP 應用程式 UI 資源和標準遠端 MCP OAuth 由框架處理。完整參考請參見 [Actions](/docs/actions)。
|
|
192
192
|
|
|
193
|
-
##
|
|
193
|
+
## 下一步是什麼 {#whats-next}
|
|
194
194
|
|
|
195
195
|
- [**Getting Started**](/docs/getting-started) — 從一個操作開始,選取一個範本,或安裝一項技能
|
|
196
|
-
- [**Agent Surfaces**](/docs/agent-surfaces) —
|
|
197
|
-
- [**Key Concepts**](/docs/key-concepts) — 架構:SQL、actions
|
|
196
|
+
- [**Agent Surfaces**](/docs/agent-surfaces) — 選取無頭、豐富的聊天、嵌入式邊車或完整應用
|
|
197
|
+
- [**Key Concepts**](/docs/key-concepts) — 架構:SQL、actions、輪詢同步、脈絡感知、可移植性
|
|
198
198
|
- [**Templates**](/docs/cloneable-saas) — 範本作為您擁有的完整產品
|
|
199
|
-
- [**Workspace**](/docs/workspace) - 由 SQL
|
|
199
|
+
- [**Workspace**](/docs/workspace) - 由 SQL 支援的每使用者自訂層(skills、記憶、指令、MCP),而不是檔案
|
|
200
200
|
- [**Dispatch**](/docs/dispatch) — 工作區控制平面:秘密庫、Slack/電子郵件收件箱、跨應用委派
|
|
201
201
|
- [**Extensions**](/docs/extensions) - 代理立即建立的沙盒迷你應用程式,無需更改程式碼
|
|
202
202
|
- [**Drop-in Agent**](/docs/drop-in-agent) — 將 `<AgentPanel>` 安裝到任何 React 應用中
|