@agent-native/core 0.79.12 → 0.79.16
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 +29 -6
- package/corpus/core/src/deploy/build.ts +432 -42
- 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 +123 -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 +16 -6
- package/dist/client/AgentPanel.js.map +1 -1
- package/dist/collab/routes.d.ts +2 -2
- package/dist/deploy/build.d.ts +3 -1
- package/dist/deploy/build.d.ts.map +1 -1
- package/dist/deploy/build.js +372 -37
- 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/notifications/routes.d.ts +1 -1
- package/dist/observability/routes.d.ts +5 -5
- package/dist/resources/handlers.d.ts +3 -3
- package/dist/server/agent-engine-api-key-route.d.ts +2 -2
- 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/server/transcribe-voice.d.ts +1 -1
- package/dist/styles/agent-native.css +123 -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,27 +1,27 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: "大腦"
|
|
3
|
-
description: "
|
|
3
|
+
description: "由引用的機構記憶、可審查的來源程式碼攝取和可重用的工作區整合支援的幹淨的公司聊天。"
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# 大腦
|
|
7
7
|
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
連結回 Slack
|
|
11
|
-
|
|
8
|
+
大腦是幹淨的公司聊天,由引用的機構記憶支援。人們問
|
|
9
|
+
簡單的英語問題;大腦透過認可的公司知識進行回答
|
|
10
|
+
連結回 Slack 對話串、會議、紀錄、問題或 Webhook 捕獲
|
|
11
|
+
支援答案。
|
|
12
12
|
|
|
13
|
-
|
|
14
|
-
|
|
13
|
+
大腦攝取核准的 Slack 頻道、剪輯錄音、Granola Team-space
|
|
14
|
+
註解、GitHub 問題/PR 以及通用指令碼/Webhook 有效負載。它儲存原始資料
|
|
15
15
|
捕獲、提煉持久的事實/決策/流程,並路由敏感的或
|
|
16
16
|
低可信度記憶在成為公司知識之前經過審查。
|
|
17
17
|
|
|
18
18
|
產品表面有意保持簡單:**詢問**是主要聊天
|
|
19
|
-
|
|
20
|
-
|
|
19
|
+
經驗,而**來源**、**評論**和**知識**是管理/支援
|
|
20
|
+
用於連線資料、核准提案和檢查引用記憶的介面。
|
|
21
21
|
|
|
22
|
-
```an-diagram title="從來源到引用的答案" summary="
|
|
22
|
+
```an-diagram title="從來源到引用的答案" summary="大腦將經過核准的來源攝取到原始捕獲中,擷取持久記憶,透過審查對其進行門控,然後才透過引用進行回答。"
|
|
23
23
|
{
|
|
24
|
-
"html": "<div class=\"diagram-flow\"><div class=\"diagram-card\"><span class=\"diagram-pill\">Sources</span><small class=\"diagram-muted\">Slack · Granola · GitHub · Clips · webhooks</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">→</div><div class=\"diagram-box\" data-rough>原始捕獲<br><small class=\"diagram-muted\">已去重、已脫敏</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">→</div><div class=\"diagram-box\" data-rough>Distill<br><small class=\"diagram-muted\">事實 · 決策 · 流程</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">→</div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">Review</span><small class=\"diagram-muted\">sensitive / low-confidence queue</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">→</div><div class=\"diagram-box\" data-rough><span class=\"diagram-pill ok\">Knowledge</span><small class=\"diagram-muted\"
|
|
24
|
+
"html": "<div class=\"diagram-flow\"><div class=\"diagram-card\"><span class=\"diagram-pill\">Sources</span><small class=\"diagram-muted\">Slack · Granola · GitHub · Clips · webhooks</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">→</div><div class=\"diagram-box\" data-rough>原始捕獲<br><small class=\"diagram-muted\">已去重、已脫敏</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">→</div><div class=\"diagram-box\" data-rough>Distill<br><small class=\"diagram-muted\">事實 · 決策 · 流程</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">→</div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">Review</span><small class=\"diagram-muted\">sensitive / low-confidence queue</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">→</div><div class=\"diagram-box\" data-rough><span class=\"diagram-pill ok\">Knowledge</span><small class=\"diagram-muted\">已核准、原子化</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">→</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Ask</span><small class=\"diagram-muted\">cited answer</small></div></div>",
|
|
25
25
|
"css": ".diagram-flow{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.diagram-flow .diagram-card{display:flex;flex-direction:column;gap:4px;padding:10px 12px}.diagram-flow .diagram-box{display:flex;flex-direction:column;gap:4px}.diagram-flow .diagram-arrow{font-size:20px;line-height:1}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
|
|
26
26
|
}
|
|
27
27
|
```
|
|
@@ -29,90 +29,90 @@ description: "由引用的機構記憶、可審查的來源程式碼攝取和可
|
|
|
29
29
|
```an-wireframe
|
|
30
30
|
{
|
|
31
31
|
"surface": "desktop",
|
|
32
|
-
"html": "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>詢問公司記憶</h1><span class='wf-pill accent'>42 approved memories</span><span class='wf-pill'>3 sources</span><div style='flex:1'></div><button>Sources</button><button>Review</button></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span data-icon='search' aria-label='搜尋'></span><strong style='flex:1'
|
|
32
|
+
"html": "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>詢問公司記憶</h1><span class='wf-pill accent'>42 approved memories</span><span class='wf-pill'>3 sources</span><div style='flex:1'></div><button>Sources</button><button>Review</button></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span data-icon='search' aria-label='搜尋'></span><strong style='flex:1'>為什麼選取按用量定價?</strong><button class='primary'>Ask</button></div><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>Answer</strong><p style='margin:0'>試點顯示席位數低估了自動化價值後,團隊選取了按用量定價。</p><div style='display:flex;gap:8px;flex-wrap:wrap'><span class='wf-pill accent'>定價 RFC</span><span class='wf-pill'>發布複盤</span><span class='wf-pill'>銷售備註</span></div></div><div class='wf-card' style='flex:1;display:flex;flex-direction:column;gap:8px'><strong>來源時間線</strong><div class='wf-box'>5 月 3 日 · 決策已紀錄</div><div class='wf-box'>5 月 8 日 · 已新增客戶證據</div><div class='wf-box'>5 月 12 日 · 法務說明已核准</div></div></div>"
|
|
33
33
|
}
|
|
34
34
|
```
|
|
35
35
|
|
|
36
36
|
當您開啟應用程式時,**詢問**位於最前面和中心位置 - 幹淨的聊天超過審核
|
|
37
|
-
|
|
38
|
-
|
|
37
|
+
公司記憶。 **來源**、**評論**和**知識**與它並列
|
|
38
|
+
用於連線資料、核准提案和檢查引用的管理介面
|
|
39
39
|
條目。
|
|
40
40
|
|
|
41
41
|
## 何時采摘
|
|
42
42
|
|
|
43
|
-
|
|
44
|
-
|
|
43
|
+
當您的團隊希望代理回答諸如“我們為什麼這樣做”之類的問題時,請使用 Brain
|
|
44
|
+
這個產品決策?”、“這個正在開發的功能如何工作?”或“什麼
|
|
45
45
|
在這個過程中發生了變化?”包含返回來源對話、會議的連結,
|
|
46
46
|
或問題。
|
|
47
47
|
|
|
48
48
|
Brain 和 Dispatch 是互補的,但執行不同的工作:
|
|
49
49
|
|
|
50
|
-
- **Brain
|
|
50
|
+
- **Brain 擁有公司記憶。**它攝取來源、審查原始捕獲,
|
|
51
51
|
從引用的證據中提煉出持久的事實/決策/過程、答案,以及
|
|
52
52
|
向代理公開經認可的知識。
|
|
53
53
|
- **Dispatch 擁有工作區控制平面。**它集中訊息傳遞,
|
|
54
|
-
|
|
55
|
-
|
|
54
|
+
秘密、重複性作業、核准、A2A 編排和分發
|
|
55
|
+
並核准工作區範圍的資源。
|
|
56
56
|
|
|
57
|
-
在多應用工作區中,Dispatch
|
|
57
|
+
在多應用工作區中,Dispatch 可以透過 A2A 將問題傳送至 Brain,並且
|
|
58
58
|
可以授予 Brain 共用提供者憑證。大腦仍然是專家
|
|
59
|
-
|
|
60
|
-
Brain
|
|
61
|
-
因此 Dispatch
|
|
62
|
-
|
|
59
|
+
核准來源攝取、審查、檢索並引用 Company Brain 答案。
|
|
60
|
+
Brain 將唯讀、引用支援的檢索公開為其公開 A2A 功能
|
|
61
|
+
因此 Dispatch 和同級應用程式可以詢問公司記憶問題 - A2A 代理
|
|
62
|
+
卡片是公開發現中繼資料,而檢索仍然發生在 Brain 內部
|
|
63
63
|
經過驗證的操作介面。
|
|
64
64
|
|
|
65
|
-
##
|
|
65
|
+
## 你可以用它做什麼
|
|
66
66
|
|
|
67
67
|
- **詢問引用的問題。**詢問是主要的產品表面:幹淨的聊天
|
|
68
|
-
|
|
69
|
-
問題保持次要。每個答案都連結回 Slack
|
|
70
|
-
|
|
71
|
-
-
|
|
68
|
+
審查了公司記憶,包括來源健康狀況、審查計數和建議
|
|
69
|
+
問題保持次要。每個答案都連結回 Slack 對話串,
|
|
70
|
+
支援它的會議、問題或捕獲。
|
|
71
|
+
- **連線核准的來源。**設定手動、通用 Webhook、Clips、Slack,
|
|
72
72
|
格蘭諾拉麥片和 GitHub 來源。預設情況下,來源是組織共用的,因此公司
|
|
73
|
-
|
|
74
|
-
-
|
|
75
|
-
|
|
73
|
+
記憶對整個工作區很有用。
|
|
74
|
+
- **發布前進行審核。**提出的回憶將獲得一流的審核路由
|
|
75
|
+
審閱者編輯措辭、檢查證據/來源連結並核准或
|
|
76
76
|
拒絕。高可信度、非敏感條目可立即發布;
|
|
77
77
|
公司級或敏感條目作為提案排隊。
|
|
78
|
-
-
|
|
78
|
+
- **檢查引用的知識。**知識路由顯示蒸餾的、原子的
|
|
79
79
|
包含種類、主題、實體、置信度、確切證據引用的條目,以及
|
|
80
80
|
取代連結。
|
|
81
81
|
- **重用工作區整合。**腦來源可以重用共用工作區
|
|
82
82
|
連線授予而不是重新輸入提供者權杖。來源頁面
|
|
83
83
|
在可重複使用的連線授權和提供者旁邊顯示大腦來源紀錄
|
|
84
84
|
準備就緒。
|
|
85
|
-
-
|
|
85
|
+
- **將核准的記憶鏡像為環境脈絡。**規範核准的條目可以
|
|
86
86
|
鏡像到 `context/company-brain/...` 下的工作區資源,以便其他
|
|
87
|
-
|
|
87
|
+
應用程式可以將它們用作脈絡。兩個流程都在
|
|
88
88
|
資源被寫入或刪除。
|
|
89
89
|
|
|
90
90
|
## 開始使用
|
|
91
91
|
|
|
92
|
-
|
|
92
|
+
線上示範:[brain.agent-native.com](https://brain.agent-native.com)。
|
|
93
93
|
|
|
94
|
-
1.
|
|
94
|
+
1. **嘗試示範。** 開啟詢問並選取 **開始示範**。大腦種子很小
|
|
95
95
|
產品決策語料庫,執行信任檢查,並提出引用的問題
|
|
96
96
|
您可以在新增之前檢視答案、引用、評論和未找到的行為
|
|
97
97
|
真實的公司資料。
|
|
98
|
-
2.
|
|
99
|
-
提要、GitHub
|
|
98
|
+
2. **新增一個來源。**從單一 Slack 頻道、Granola Team-space 開始
|
|
99
|
+
提要、GitHub 儲存庫、剪輯匯出或通用指令碼 Webhook。保留
|
|
100
100
|
範圍很小,直到引用和評論品質看起來不錯。
|
|
101
101
|
3. **發布前進行審閱。**使用審閱來檢查證據、編輯措辭,
|
|
102
|
-
|
|
102
|
+
並僅核准持久的公司記憶。
|
|
103
103
|
4. **從來源頭詢問。**使用“詢問”來提出應基於的問題
|
|
104
104
|
經過認可的知識,而不是原始聊天記錄。
|
|
105
105
|
|
|
106
|
-
|
|
106
|
+
對於公開示範,種子語料庫示範了產品決策召回,
|
|
107
107
|
引文連結、取代行為、評論門控、編輯、個人內容
|
|
108
108
|
排除,以及在不連線真實工作空間的情況下誠實的未發現行為。
|
|
109
109
|
|
|
110
110
|
### 有用的提示
|
|
111
111
|
|
|
112
|
-
-
|
|
113
|
-
-
|
|
112
|
+
- “我們對年度定價做出了什麼決定?在哪裡討論過?”
|
|
113
|
+
- “尋找最新的入職流程變更並引用來源。”
|
|
114
114
|
- “總結一下 GitHub 討論對於發布計畫的意義。”
|
|
115
|
-
-
|
|
115
|
+
- “審查待處理的記憶提案並標記任何過於模糊而無法發布的內容。”
|
|
116
116
|
- “哪些來源已過時或同步失敗?”
|
|
117
117
|
|
|
118
118
|
## 對於開發者
|
|
@@ -128,29 +128,29 @@ pnpm install
|
|
|
128
128
|
pnpm dev
|
|
129
129
|
```
|
|
130
130
|
|
|
131
|
-
|
|
131
|
+
開啟應用程式並選取**開始示範**即可檢視引用的記憶,而無需連線真實的工作區。
|
|
132
132
|
|
|
133
133
|
### 資料模型
|
|
134
134
|
|
|
135
|
-
Brain 有意使用 SQL
|
|
135
|
+
Brain 有意使用 SQL 文字搜尋和代理查詢擴充功能 - 有
|
|
136
136
|
無需矢量資料庫,因此範本可在 SQLite 之間保持可移植性,
|
|
137
137
|
Postgres、Neon、D1、Turso 和類似主機。應用程式狀態反映
|
|
138
|
-
|
|
138
|
+
目前路由、過濾器和所選 ID,以便代理始終了解目前
|
|
139
139
|
導覽和選取。
|
|
140
140
|
|
|
141
141
|
Brain 的模式位於 `templates/brain/server/db/schema.ts` 中。八張桌子:
|
|
142
142
|
|
|
143
|
-
| 表 |
|
|
143
|
+
| 表 | 它包含什麼 |
|
|
144
144
|
| ------------------------ | --------------------------------------------------------------------------------------------------------------- |
|
|
145
|
-
| `brain_sources` | 連線器設定 -
|
|
145
|
+
| `brain_sources` | 連線器設定 - 提供者、允許列出的頻道/儲存庫、同步游標、審核狀態、`ingest_token_hash`、`status`、`last_synced_at` |
|
|
146
146
|
| `brain_source_shares` | 按來源共用授予(檢視者/編輯者/管理員) |
|
|
147
|
-
| `brain_raw_captures` | 帶有 `external_id` 重複資料刪除金鑰、`content_hash
|
|
147
|
+
| `brain_raw_captures` | 帶有 `external_id` 重複資料刪除金鑰、`content_hash`、種類和蒸餾狀態的指令碼、通道匯出、註解和 Webhook 匯入 |
|
|
148
148
|
| `brain_knowledge` | 精煉的原子條目 - 種類(決策/事實/過程/...)、主題、實體、證據引用、置信度、`publish_tier`、取代連結 |
|
|
149
149
|
| `brain_knowledge_shares` | 按知識共用授予 |
|
|
150
|
-
| `brain_proposals` | 待審專案 -
|
|
150
|
+
| `brain_proposals` | 待審專案 - 建議建立/更新/存檔並包含證據和審閱者註解 |
|
|
151
151
|
| `brain_proposal_shares` | 每項提案的股份授予 |
|
|
152
152
|
| `brain_sync_runs` | 同步審核記錄 - 提供者、狀態、統計資訊 JSON、錯誤、開始/結束時間戳 |
|
|
153
|
-
| `brain_ingest_queue` |
|
|
153
|
+
| `brain_ingest_queue` | 背景蒸餾佇列 - 操作、狀態、優先級、重試計數、`run_after` |
|
|
154
154
|
|
|
155
155
|
```an-schema title="大腦資料模型" summary="Connectors produce raw captures; distillation turns captures into reviewable knowledge; proposals gate sensitive entries. Sync runs and the ingest queue track background work."
|
|
156
156
|
{
|
|
@@ -195,7 +195,7 @@ Brain 的模式位於 `templates/brain/server/db/schema.ts` 中。八張桌子
|
|
|
195
195
|
{ "name": "status", "type": "text" },
|
|
196
196
|
{ "name": "stats", "type": "json" }
|
|
197
197
|
] },
|
|
198
|
-
{ "id": "ingest_queue", "name": "brain_ingest_queue", "note": "
|
|
198
|
+
{ "id": "ingest_queue", "name": "brain_ingest_queue", "note": "背景蒸餾佇列", "fields": [
|
|
199
199
|
{ "name": "operation", "type": "text" },
|
|
200
200
|
{ "name": "status", "type": "text" },
|
|
201
201
|
{ "name": "priority", "type": "int" },
|
|
@@ -221,43 +221,43 @@ Brain 的模式位於 `templates/brain/server/db/schema.ts` 中。八張桌子
|
|
|
221
221
|
- **知識與複習** — `write-knowledge`、`get-knowledge`、`list-knowledge`、`set-knowledge-canonical`、`preview-canonical-resource`、`list-proposals`、`review-proposal`、`approve-proposal`、`reject-proposal`、`update-proposal`
|
|
222
222
|
- **搜尋和檢索** — `ask-brain`、`search-knowledge`、`search-everything`
|
|
223
223
|
- **設定** — `get-brain-settings`、`update-brain-settings`、`set-settings`、`get-settings`
|
|
224
|
-
-
|
|
225
|
-
-
|
|
224
|
+
- **評估和示範** — `seed-demo-data`、`run-demo-eval`、`run-retrieval-eval`
|
|
225
|
+
- **脈絡和導覽** — `view-screen`、`navigate`
|
|
226
226
|
- **提供者 APIs** — `provider-api-catalog`、`provider-api-docs`、`provider-api-request`
|
|
227
227
|
|
|
228
228
|
### 連線來源
|
|
229
229
|
|
|
230
230
|
Brain 首先從授予的工作區連線解析提供者憑證,
|
|
231
|
-
|
|
232
|
-
Brain
|
|
233
|
-
|
|
231
|
+
然後來自向後相容的 Brain-local 或註冊的保管庫憑證。
|
|
232
|
+
Brain 來源憑證不會回退到部署層級環境變數。
|
|
233
|
+
如果共用提供者已存在,請授予 Brain 存取權限,而不是複製
|
|
234
234
|
在特定於大腦的設定中使用相同的秘密。
|
|
235
235
|
|
|
236
236
|
**Slack.** 建立範圍為特定通道 ID 的來源。連線器
|
|
237
|
-
驗證每個設定的對話,拒絕 DM 和 MPIM
|
|
237
|
+
驗證每個設定的對話,拒絕 DM 和 MPIM,並儲存游標
|
|
238
238
|
狀態,以便每次同步都從上次停止的位置恢復。安全的推出流程
|
|
239
|
-
每個 Slack
|
|
239
|
+
每個 Slack 來源卡都可以讓您**測試**憑證和允許清單,而無需
|
|
240
240
|
閱讀歷史紀錄,執行一個小上限的**安全試點**範例,**檢視捕獲**,
|
|
241
|
-
|
|
242
|
-
|
|
241
|
+
並在任何內容變得可查詢之前在**審核佇列**中進行核准。授予
|
|
242
|
+
機器人僅處理來源需要的範圍(憑證驗證、允許清單
|
|
243
243
|
驗證、允許列出的頻道歷史紀錄和持久的永久連結)。
|
|
244
244
|
|
|
245
|
-
**格蘭諾拉麥片。**
|
|
245
|
+
**格蘭諾拉麥片。** 建立具有輪詢視窗和頁面大小的來源。格蘭諾拉麥片
|
|
246
246
|
企業 API 金鑰公開團隊空間筆記,而不是私人筆記或資料夾。大腦
|
|
247
|
-
|
|
247
|
+
儲存筆記摘要、文字紀錄、與會者、行事曆中繼資料和來源
|
|
248
248
|
URL 作為蒸餾前的原始捕獲物。
|
|
249
249
|
|
|
250
|
-
**GitHub.**
|
|
251
|
-
使用穩定的來源 URL
|
|
252
|
-
像 Slack
|
|
250
|
+
**GitHub.** 建立範圍為已核准的儲存庫的來源。連線器
|
|
251
|
+
使用穩定的來源 URL 匯入有界問題和 pull request 脈絡,可以
|
|
252
|
+
像 Slack 或會議脈絡一樣進行提煉。這是大腦脈絡攝取,而不是
|
|
253
253
|
Analytics 風格的 GitHub 報告的替代品。
|
|
254
254
|
|
|
255
255
|
**Clips 和通用 webhooks。** Brain 公開了 Clips 的簽名 Webhook 和
|
|
256
256
|
`/api/_agent-native/brain/ingest` 的通用轉錄本/捕獲匯入。建立
|
|
257
|
-
具有 `sourceKey`
|
|
257
|
+
具有 `sourceKey` 的來源接收不記名權杖,然後傳送
|
|
258
258
|
`RawCapturePayload` 與 `Authorization: Bearer <ingestToken>`。通用來源
|
|
259
259
|
對通話紀錄、客戶研究、匯入使用相同的有效負載形狀
|
|
260
|
-
|
|
260
|
+
註解,或任何其他可以生成有界捕獲的來源。
|
|
261
261
|
|
|
262
262
|
```an-api title="簽名攝取 webhook" summary="剪輯和通用 transcript/capture 匯入會發布帶有每個來源不記名權杖的 RawCapturePayload。"
|
|
263
263
|
{
|
|
@@ -276,7 +276,7 @@ Analytics 風格的 GitHub 報告的替代品。
|
|
|
276
276
|
}
|
|
277
277
|
```
|
|
278
278
|
|
|
279
|
-
Slack、Granola 和 GitHub
|
|
279
|
+
Slack、Granola 和 GitHub 來源可以選取進入背景 `autoSync`
|
|
280
280
|
審核品質得到證實後進行投票。
|
|
281
281
|
|
|
282
282
|
### 隱私和門控
|
|
@@ -286,37 +286,37 @@ Slack、Granola 和 GitHub 來源可以選取進入後台 `autoSync`
|
|
|
286
286
|
- Slack 同步僅讀取顯式設定的通道並拒絕 DM/MPIM。
|
|
287
287
|
- Granola 同步讀取 Granola 的 API 公開的團隊空間筆記,非私人
|
|
288
288
|
筆記或私人資料夾。
|
|
289
|
-
-
|
|
289
|
+
- 預設情況下,原始捕獲是從清單/搜尋介面中編輯的;審稿人
|
|
290
290
|
並且蒸餾流程僅在需要時請求預覽或原始內容。
|
|
291
291
|
- 來源設定可能需要在提煉的知識變得持久之前進行審查
|
|
292
|
-
|
|
292
|
+
公司記憶。
|
|
293
293
|
- 設定控制預設發布層,公司層知識是否需要
|
|
294
|
-
|
|
294
|
+
核准、引用要求、電子郵件編輯和連線器錯誤
|
|
295
295
|
通知。
|
|
296
296
|
|
|
297
297
|
### 自訂它
|
|
298
298
|
|
|
299
|
-
|
|
300
|
-
|
|
299
|
+
大腦遵循 Agent-Native 四區域契約——透過編輯改變行為
|
|
300
|
+
匹配區域,代理可以為您進行以下編輯:
|
|
301
301
|
|
|
302
302
|
- `templates/brain/app/routes/` — UI 表面:提問、搜尋、知識,
|
|
303
|
-
|
|
304
|
-
- `templates/brain/actions/` —
|
|
303
|
+
檢視、來源、設定和團隊路由。
|
|
304
|
+
- `templates/brain/actions/` — 每個代理可呼叫的操作(匯入、來源
|
|
305
305
|
管理、試點報告、提煉、提案審查、引用檢索,
|
|
306
|
-
|
|
306
|
+
導覽/脈絡)。使用 `defineAction` 新增新檔案以公開新的
|
|
307
307
|
能力。
|
|
308
308
|
- `templates/brain/.agents/skills/` — 針對大腦的蒸餾指導
|
|
309
|
-
|
|
309
|
+
和檢索。當您向代理傳授新的工作流程時更新或新增技能。
|
|
310
310
|
- `templates/brain/AGENTS.md` — 頂級代理指南。新增專業時更新
|
|
311
311
|
功能。
|
|
312
312
|
- `templates/brain/server/db/schema.ts` — 資料模型。僅附加遷移;
|
|
313
313
|
路由、過濾器和選定的 ID 鏡像到代理的 `application_state`
|
|
314
|
-
|
|
314
|
+
脈絡。
|
|
315
315
|
|
|
316
316
|
要求代理為您進行更改 - 它可以編輯自己的來源。請參閱
|
|
317
317
|
[Self-Modifying Code](/docs/key-concepts#agent-modifies-code).
|
|
318
318
|
|
|
319
|
-
##
|
|
319
|
+
## 下一步是什麼
|
|
320
320
|
|
|
321
321
|
- [**Dispatch**](/docs/dispatch) — 工作區控制平面
|
|
322
322
|
- [**Dispatch template**](/docs/template-dispatch) — 腳手架協調應用
|
|
@@ -1,69 +1,69 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: "行事曆"
|
|
3
|
-
description: "
|
|
3
|
+
description: "由代理支援的行事曆,具有 Google Calendar 同步和 Calendly 風格的預訂連結。透過簡單的英語安排、尋找時段並管理可用性。"
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# 行事曆
|
|
7
7
|
|
|
8
|
-
代理驅動的行事曆應用程式。連線您的 Google Calendar
|
|
8
|
+
代理驅動的行事曆應用程式。連線您的 Google Calendar,代理就可以讀取您的日程安排、尋找空閒時段、建立活動並管理 Calendly 風格的預訂連結 - 全部采用簡單的英語。它用您擁有的一個應用程式取代了 Google Calendar + Calendly 組合。
|
|
9
9
|
|
|
10
10
|
```an-wireframe
|
|
11
11
|
{
|
|
12
12
|
"surface": "desktop",
|
|
13
|
-
"html": "<div style='display:flex;flex-direction:column;min-height:530px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px;padding:14px 18px;border-bottom:1.4px solid var(--wf-line)'><button>Week</button><button>Today</button><button>‹</button><button>›</button><div style='flex:1'></div><strong>2026 年 5 月 3-9 日</strong><div style='flex:1'></div><button class='primary'>新事件</button></div><div style='display:grid;grid-template-columns:56px repeat(7,minmax(0,1fr));grid-template-rows:36px repeat(5,72px);gap:7px;padding:14px;flex:1'><div></div><strong>週日 3</strong><strong>週一 4</strong><strong>週二 5</strong><strong>週三 6</strong><strong>週四 7</strong><strong>週五 8</strong><strong>週六 9</strong><small class='wf-muted'>7 AM</small><div class='wf-box' style='opacity:.45'></div><div></div><div></div><div></div><div></div><div></div><div></div><small class='wf-muted'>9 AM</small><div class='wf-box'>全員會</div><div class='wf-box'>工程站會</div><div class='wf-box'>工程站會</div><div class='wf-box'>工程站會</div><div></div><div class='wf-box'>Planning</div><div></div><small class='wf-muted'>11 AM</small><div class='wf-box'>設計審核</div><div></div><div class='wf-box'>設計評審</div><div class='wf-box'>Roadmap</div><div class='wf-box'
|
|
13
|
+
"html": "<div style='display:flex;flex-direction:column;min-height:530px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px;padding:14px 18px;border-bottom:1.4px solid var(--wf-line)'><button>Week</button><button>Today</button><button>‹</button><button>›</button><div style='flex:1'></div><strong>2026 年 5 月 3-9 日</strong><div style='flex:1'></div><button class='primary'>新事件</button></div><div style='display:grid;grid-template-columns:56px repeat(7,minmax(0,1fr));grid-template-rows:36px repeat(5,72px);gap:7px;padding:14px;flex:1'><div></div><strong>週日 3</strong><strong>週一 4</strong><strong>週二 5</strong><strong>週三 6</strong><strong>週四 7</strong><strong>週五 8</strong><strong>週六 9</strong><small class='wf-muted'>7 AM</small><div class='wf-box' style='opacity:.45'></div><div></div><div></div><div></div><div></div><div></div><div></div><small class='wf-muted'>9 AM</small><div class='wf-box'>全員會</div><div class='wf-box'>工程站會</div><div class='wf-box'>工程站會</div><div class='wf-box'>工程站會</div><div></div><div class='wf-box'>Planning</div><div></div><small class='wf-muted'>11 AM</small><div class='wf-box'>設計審核</div><div></div><div class='wf-box'>設計評審</div><div class='wf-box'>Roadmap</div><div class='wf-box'>週五示範</div><div></div><div></div><small class='wf-muted'>1 PM</small><div></div><div class='wf-box'>1:1</div><div class='wf-box'>專注時段</div><div></div><div></div><div class='wf-box'>全員會</div><div></div><small class='wf-muted'>3 PM</small><div></div><div></div><div></div><div class='wf-box'>越級會議</div><div></div><div></div><div></div></div></div>"
|
|
14
14
|
}
|
|
15
15
|
```
|
|
16
16
|
|
|
17
|
-
|
|
17
|
+
當您開啟應用程式時,活動行事曆檢視是主表面。代理仍然知道您正在檢視哪一天、哪一週或哪一天的活動,因此您可以說“安排在這一天與 Alex 進行 30 分鐘的通話”,而無需說明所有內容。
|
|
18
18
|
|
|
19
|
-
```an-diagram title="調度請求如何流動" summary="
|
|
19
|
+
```an-diagram title="調度請求如何流動" summary="無論您點選行事曆還是詢問代理,相同的操作都會從 Google Calendar 即時讀取並寫回同一檢視。"
|
|
20
20
|
{
|
|
21
|
-
"html": "<div class=\"diagram-flow\"><div class=\"diagram-col\"><div class=\"diagram-node\"
|
|
21
|
+
"html": "<div class=\"diagram-flow\"><div class=\"diagram-col\"><div class=\"diagram-node\">你點選<br><small class=\"diagram-muted\">拖放、工具列、快速鍵</small></div><div class=\"diagram-node\">你向代理請求<br><small class=\"diagram-muted\">\"find a 1-hour slot next week\"</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\">list-events · check-availability · create-event</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">→</div><div class=\"diagram-col\"><div class=\"diagram-box\">Google Calendar<br><small class=\"diagram-muted\">即時、多帳戶</small></div><div class=\"diagram-box\">SQL<br><small class=\"diagram-muted\">預約 · 可用時間</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">↻</div><div class=\"diagram-box\">行事曆檢視即時更新</div></div>",
|
|
22
22
|
"css": ".diagram-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-flow .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-flow .diagram-arrow{font-size:22px;line-height:1}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
|
|
23
23
|
}
|
|
24
24
|
```
|
|
25
25
|
|
|
26
|
-
##
|
|
26
|
+
## 你可以用它做什麼
|
|
27
27
|
|
|
28
|
-
-
|
|
29
|
-
- **訂閱 ICS 來源**(HR 休息時間、會議安排、團隊行事曆)-
|
|
30
|
-
-
|
|
31
|
-
- **在 `/book/{slug}` 上建立公開預訂連結**,用於“15 分鐘介紹”或“30
|
|
32
|
-
- **向工作人員詢問任何與日程相關的事情**:“週四下午我有空嗎?” “下週找一個 1 小時的時段,並在上面加上‘與 Alex 一起制定計畫’。”
|
|
28
|
+
- **在日、週或月檢視中檢視您真實的 Google Calendar**,並疊加多個帳戶。
|
|
29
|
+
- **訂閱 ICS 來源**(HR 休息時間、會議安排、團隊行事曆)- 唯讀,混合到同一檢視中。
|
|
30
|
+
- **透過時區支援設定每週可用性** - 代理在尋找空閒時段時使用此功能。
|
|
31
|
+
- **在 `/book/{slug}` 上建立公開預訂連結**,用於“15 分鐘介紹”或“30 分鐘示範”等內容。設定持續時間、自訂欄位以及要使用的會議工具。
|
|
32
|
+
- **向工作人員詢問任何與日程相關的事情**:“週四下午我有空嗎?” “下週找一個 1 小時的時段,並在上面加上‘與 Alex 一起制定計畫’。” “暫停我的示範預訂連結。”
|
|
33
33
|
- **與隊友分享預訂連結**,以便他們也可以管理它們。
|
|
34
34
|
|
|
35
35
|
## 開始使用
|
|
36
36
|
|
|
37
|
-
|
|
37
|
+
線上示範:[calendar.agent-native.com](https://calendar.agent-native.com)。
|
|
38
38
|
|
|
39
39
|
首次開啟應用程式時:
|
|
40
40
|
|
|
41
|
-
1.
|
|
42
|
-
2.
|
|
41
|
+
1. 點選“**設定**”。
|
|
42
|
+
2. 點選 **連線 Google Calendar** 並核准。
|
|
43
43
|
3. (可選)如果您想要疊加個人 + 工作,請連線更多 Google 帳戶。
|
|
44
|
-
4.
|
|
44
|
+
4. 開啟主檢視 - 將載入您的真實行事曆。
|
|
45
45
|
|
|
46
46
|
要建立您的第一個預訂連結:
|
|
47
47
|
|
|
48
|
-
1.
|
|
49
|
-
2.
|
|
48
|
+
1. 點選側邊欄中的**預訂連結**。
|
|
49
|
+
2. 點選**新預訂連結**,設定標題和持續時間。
|
|
50
50
|
3. 分享公開的 URL - 訪客從您的可用插槽中進行選取。
|
|
51
51
|
|
|
52
|
-
|
|
52
|
+
或者直接詢問代理:“建立一個帶有姓名欄位的 15 分鐘介紹預訂連結。”
|
|
53
53
|
|
|
54
54
|
### 有用的提示
|
|
55
55
|
|
|
56
|
-
-
|
|
56
|
+
- “今天我的行事曆上有什麼?”
|
|
57
57
|
- “週四下午我有空 30 分鐘嗎?”
|
|
58
58
|
- “下週找一個 1 小時的時段,並新增“與 Alex 一起制定計畫”。”
|
|
59
59
|
- “將此活動重新安排到週五下午 2 點。” (選取事件時)
|
|
60
|
-
-
|
|
61
|
-
- “在 15 分鐘時建立一個名為“15
|
|
62
|
-
- “暫停我的‘30
|
|
60
|
+
- “切換到日檢視並跳轉到下週一。”
|
|
61
|
+
- “在 15 分鐘時建立一個名為“15 分鐘介紹”的預訂連結,並帶有註解欄位。”
|
|
62
|
+
- “暫停我的‘30 分鐘示範’預訂連結。”
|
|
63
63
|
- “週五下午我有空。”
|
|
64
64
|
- “本月我有哪些關於‘發布’的會議?”
|
|
65
65
|
|
|
66
|
-
|
|
66
|
+
代理將即時查詢 Google Calendar 的任何時間表問題 - 它永遠不會猜測。
|
|
67
67
|
|
|
68
68
|
## 對於開發者
|
|
69
69
|
|
|
@@ -80,38 +80,38 @@ pnpm install
|
|
|
80
80
|
pnpm dev
|
|
81
81
|
```
|
|
82
82
|
|
|
83
|
-
開啟 `http://localhost:8082
|
|
83
|
+
開啟 `http://localhost:8082`(預設行事曆開發連接埠)。
|
|
84
84
|
|
|
85
|
-
要在開發中連線 Google Calendar
|
|
85
|
+
要在開發中連線 Google Calendar,請開啟“設定”檢視,貼上 [Google Cloud Console](https://console.cloud.google.com/) 中的 `GOOGLE_CLIENT_ID` 和 `GOOGLE_CLIENT_SECRET`,然後點選“連線 Google Calendar”。 OAuth 重新導向 URI 在開發中是 `http://localhost:8082/_agent-native/google/callback`。權杖儲存在`oauth_tokens` SQL 表中並自動重新整理。
|
|
86
86
|
|
|
87
87
|
### 主要功能
|
|
88
88
|
|
|
89
|
-
|
|
89
|
+
**即時行事曆檢視。**日、週和月檢視直接從連線的 Google 帳戶讀取,可選的唯讀 ICS Feed 分層到同一時間表中。
|
|
90
90
|
|
|
91
|
-
|
|
91
|
+
**可用性和空閒時段搜尋。**每週可用性規則、時區支援和現有事件都提供 UI 和代理使用的相同可用性操作。
|
|
92
92
|
|
|
93
93
|
**預訂連結。**公開 `/book/{slug}` 頁面收集姓名、電子郵件、自訂欄位、會議偏好設定和取消/重新安排權杖。
|
|
94
94
|
|
|
95
|
-
|
|
95
|
+
**可共用管理。**預訂連結預設是私人的,但可以透過共用actions的框架與團隊成員共用。
|
|
96
96
|
|
|
97
|
-
|
|
97
|
+
**內嵌活動預覽。**代理可以在聊天中嵌入緊湊的活動卡,其中包含標題、時間、地點、與會者和跳回按鈕。
|
|
98
98
|
|
|
99
99
|
### 與代理合作
|
|
100
100
|
|
|
101
|
-
|
|
101
|
+
代理看到您正在檢視的內容。目前行事曆檢視、所選日期和所選事件作為 `current-screen` 塊包含在每條訊息中,因此您可以說“此事件”或“今天”,它會正確解析。
|
|
102
102
|
|
|
103
|
-
|
|
103
|
+
在幕後,代理會呼叫 actions,如 `list-events`、`check-availability`、`create-event`、`navigate` 和 `update-availability`。由於事件存在於 Google Calendar 中,因此代理始終查詢 API 而不是猜測 - 如果不先執行指令碼,它不會返回空結果。
|
|
104
104
|
|
|
105
105
|
### 資料模型
|
|
106
106
|
|
|
107
|
-
在`templates/calendar/server/db/schema.ts
|
|
107
|
+
在`templates/calendar/server/db/schema.ts`中定義。僅非事件資料儲存在本機:
|
|
108
108
|
|
|
109
|
-
- `bookings` —
|
|
110
|
-
- `booking_links` — Calendly 樣式連結定義。 Slug、標題、描述、主要 `duration`、可選 `durations`
|
|
111
|
-
- `booking_slug_redirects` -
|
|
109
|
+
- `bookings` — 從公開預訂頁面確認的預約。儲存姓名、電子郵件、開始、結束、副標題、可選註解、自訂欄位回應、會議連結、用於公開管理的 `cancelToken` URL 以及 `confirmed` 或 `cancelled` 狀態。
|
|
110
|
+
- `booking_links` — Calendly 樣式連結定義。 Slug、標題、描述、主要 `duration`、可選 `durations` 清單、`customFields`、`conferencing`、`color` 和 `isActive` 標誌。使用框架的`ownableColumns`,因此適用共用系統。
|
|
111
|
+
- `booking_slug_redirects` - 重新命名連結時會記住舊的 slugs,以便現有的公開 URL 繼續工作。
|
|
112
112
|
- `booking_link_shares` — 分享預訂連結的贈款。
|
|
113
113
|
|
|
114
|
-
```an-schema title="行事曆資料模型" summary="
|
|
114
|
+
```an-schema title="行事曆資料模型" summary="僅非事件資料儲存在本機 - 事件即時儲存在 Google 行事曆中。預訂連結使用 ownableColumns,因此共用系統適用。"
|
|
115
115
|
{
|
|
116
116
|
"entities": [
|
|
117
117
|
{
|
|
@@ -152,7 +152,7 @@ pnpm dev
|
|
|
152
152
|
{
|
|
153
153
|
"id": "booking_slug_redirects",
|
|
154
154
|
"name": "booking_slug_redirects",
|
|
155
|
-
"note": "
|
|
155
|
+
"note": "連結重新命名後保持舊的公開 URLs 正常工作",
|
|
156
156
|
"fields": [
|
|
157
157
|
{ "name": "oldSlug", "type": "string", "pk": true },
|
|
158
158
|
{ "name": "linkId", "type": "id", "fk": "booking_links.id" }
|
|
@@ -178,13 +178,13 @@ pnpm dev
|
|
|
178
178
|
}
|
|
179
179
|
```
|
|
180
180
|
|
|
181
|
-
可用性規則和每使用者設定位於設定表中,由 `calendar-availability` 鍵入。 Google OAuth 代幣位於框架 `oauth_tokens` 表中。臨時 UI
|
|
181
|
+
可用性規則和每使用者設定位於設定表中,由 `calendar-availability` 鍵入。 Google OAuth 代幣位於框架 `oauth_tokens` 表中。臨時 UI 狀態(目前檢視、日期、選定事件)位於 `navigation` 鍵下的 `application_state` 中。
|
|
182
182
|
|
|
183
183
|
### 自訂
|
|
184
184
|
|
|
185
185
|
應用程式的每個部分都是可編輯的來源程式碼。從這裡開始:
|
|
186
186
|
|
|
187
|
-
- `templates/calendar/actions/` —
|
|
187
|
+
- `templates/calendar/actions/` — 每個代理可呼叫的操作。新增包含 `defineAction` 的新檔案,以向代理和前端公開新功能。關鍵檔案:`check-availability.ts`、`create-event.ts`、`list-events.ts`、`create-booking-link.ts`、`update-availability.ts`、`add-external-calendar.ts`、`navigate.ts`、`view-screen.ts`。
|
|
188
188
|
- `templates/calendar/app/routes/` — UI。 `_app._index.tsx`是行事曆,`_app.availability.tsx`是日程編輯器,`_app.booking-links._index.tsx`和`_app.booking-links.$id.tsx`管理預訂連結,`_app.bookings.tsx`列出預訂,`_app.settings.tsx`是設定,`book.$slug.tsx`加`meet.$username.$slug.tsx`是公開預訂頁面。
|
|
189
189
|
- `templates/calendar/server/db/schema.ts` — 新增帶有 Drizzle 的列或表。保持程式碼與方言無關,以便範本在 SQLite、Postgres、Turso、D1 和 Neon 上執行。
|
|
190
190
|
- `templates/calendar/AGENTS.md` — 代理指令。當您向代理教授新功能或約定時更新此內容。
|