@ agent- native/ 发送
调度是代理 - Native工作空间控制平面和单独的产品. 这不是工具包能力模块.
代理本地应用程序的工作空间控制平面——金库,集成, 目的地 交叉应用工作空间资源 反复出现的"梦想"报告工作, 和跨应用程序代表团, 以单一的快递包运.
权力 dispatch 模板。 规定:
- Drizzle 计划 - 目的地、身份链接、链接标志、批准 请求、审计活动、梦想报告/建议、金库秘密/赠款/ 请求/审计、工作空间资源/赠款
- 服务器层 —— 说
setupDispatch(config)+ 认证的硝基插件, 集成、代理聊天、数据库和核心路由 - 行动 - ~90岁
defineAction模块(故障赠款/请求、工作空间) 资源赠款、目的地、梦想工作、提供者-api目录/文件/ 请求, 黑线上下文, 连接代理发现, 审计/批准, 作为代理工具+ HTTP 端点消耗的平台消息,以及更多 - 路线 完全回放路由器 7
RouteConfig[](聊天,综述,应用, 保险库 整合 代理 工作空间 通讯 目的地, 身份、批准、自动化、审计、设置、梦想、扩展、, .) 被挤入消费者的app/routes.ts - 反应组件 —— 说
DispatchShell, (中文(简体) ),Layout编号 :NavContent, (中文(简体) ),CreateAppPopover编号 :CreateAppFlow, (中文(简体) ),AppKeysPopover,加满分 阴影/ 依地components/ui/*原始设定.SimpleAgentsPanel实值 也导出将共享代理管理器嵌入到另一个工作空间 UI 中 . - 样式 —— 说
dispatch.css尾风层
安装
pnpm add @agent-native/dispatch
对等依赖 @agent-native/core (单位:千美元)>=0.8.0, (中文(简体) ), react编号 :react-dom
(单位:千美元)>=19.2.7),以及 react-router (单位:千美元)>=8) (中文(简体) ).
编曲
模板 app/routes.ts数字 :
import { type RouteConfig } from "@react-router/dev/routes";
import { dispatchRoutes } from "@agent-native/dispatch/routes";
export default [
...localRoutes, // consumer's own routes win on collision
...dispatchRoutes, // dispatch fills in everything else
] satisfies RouteConfig;
模板 server/plugins/*.ts (每个导出都保存在自己的文件中 所以Nitro
自动加载:
// server/plugins/setup-dispatch.ts
import { setupDispatch } from "@agent-native/dispatch/server";
export default setupDispatch({ auth: { googleOnly: true } });
// server/plugins/auth.ts
export { dispatchAuthPlugin as default } from "@agent-native/dispatch/server";
// server/plugins/integrations.ts
export { dispatchIntegrationsPlugin as default } from "@agent-native/dispatch/server";
// server/plugins/agent-chat.ts
export { dispatchAgentChatPlugin as default } from "@agent-native/dispatch/server";
// server/plugins/db.ts
export { dispatchDbPlugin as default } from "@agent-native/dispatch/server";
// server/plugins/core-routes.ts
export { dispatchCoreRoutesPlugin as default } from "@agent-native/dispatch/server";
模板 server/db/schema.ts数字 :
export * from "@agent-native/dispatch/db";
@agent-native/dispatch/actions 大部分不需要手动导入
消费者: import "@agent-native/dispatch/server" (由插件驱动)
副作用登记员通过
registerPackageActions,框架的 autoDiscoverActions 合并
在消费者在当地之后 actions/ 目录。 丢出同名词
消费者自己的文件 actions/ 以覆盖任何单一动作.
出口
| 子路径 | 这是什么 |
|---|---|
. | 仅共享配置类型 —— DispatchConfig, (中文(简体) ), DispatchAuthConfig, (中文(简体) ), DispatchIntegrationsConfig。当需要类型时,不绘制服务器/客户端代码. |
./routes | dispatchRoutes 方案 RouteConfig[] 覆盖每个调度页面(聊天、概览、度量衡、操作、应用、金库、集成、代理、工作空间、通讯、目的地、身份、批准、自动化、审计、设置、梦想、扩展、线程调试、团队、以及工作空间-应用全面路线). |
./routes/pages/* | 单个编译的页面模块上方的路径(例如:. ./routes/pages/vault.js) (中文(简体) ). 通常不直接进口. |
./server | setupDispatch(config) 加硝基插件集 : dispatchAuthPlugin, (中文(简体) ), dispatchIntegrationsPlugin, (中文(简体) ), dispatchAgentChatPlugin, (中文(简体) ), dispatchDbPlugin, (中文(简体) ), dispatchCoreRoutesPlugin。导入此模块还输入所有调度动作. |
./shared/feature-flags | 违约 DISPATCH_WORKSPACE_SSO_FLAG 定义用于安全瞄准浏览器工作空间的签名. |
./shared/workspace-sso | 精确的第一当事方工作空间SSO起源和由调度和身份中心共享的添加剂自定义注册解析器. |
./server/lib/thread-link-preview | loadThreadLinkPreview(threadId) ——只用于服务器的帮助器(阅读请求上下文并检查线程所有权),用于构建共享线程URL的链接-预览元数据. |
./actions | dispatchActions 平起平起的名称 ActionEntry 每个调度行动的地图(故障、工作空间资源、目的地、梦想工作、提供者-api目录/文件/请求、连接代理人、审计、批准、平台信息等等). |
./db | getDb() 编号 : db()滴水龙头 schema 名称空间, 调度表导出( N)dispatchDestinations, (中文(简体) ), dispatchIdentityLinks, (中文(简体) ), dispatchLinkTokens, (中文(简体) ), dispatchApprovalRequests, (中文(简体) ), dispatchAuditEvents, (中文(简体) ), dispatchDreams, (中文(简体) ), dispatchDreamProposals, (中文(简体) ), vaultSecrets, (中文(简体) ), vaultGrants, (中文(简体) ), vaultRequests, (中文(简体) ), vaultAuditLog, (中文(简体) ), workspaceResources, (中文(简体) ), workspaceResourceGrants),和迁移. |
./lib/thread-link-preview | 服务器后面的异形助手 上面一个.. extractThreadPreviewImageUrl, (中文(简体) ), buildThreadLinkPreviewMeta,则 ThreadLinkPreview 类型。 从客户端代码导入安全 . |
./components | 用于自定义布局的 Escape-hatch UI 部件 : DispatchShell, (中文(简体) ), Layout编号 :NavContent (单位:千美元) DispatchExtensionConfig编号 :DispatchNavIcon编号 :DispatchNavItem编号 :DispatchNavSection 类型), CreateAppPopover编号 :CreateAppFlow, (中文(简体) ), AppKeysPopover。大多数消费者只需要 dispatchRoutes 绝不直接从这里进口. |
./components/ui/* | Shadcn/ui原始设定 调度局自己的UI是建立在(button, (中文(简体) ), dialog, (中文(简体) ), dropdown-menu, (中文(简体) ), card, (中文(简体) ), command, (中文(简体) ), calendar, (中文(简体) ), chart,...),每个文件都输出,这样消费者就可以再用一个原始的而不用拉入其他的. |
./styles/dispatch.css | 有调度专用风格的尾风层. 在消费者的全球CSS条目中导入一次. |
构成导出布局的主机可以标出其桌面和移动 一起导航而无需执行调度 :
import { Layout } from "@agent-native/dispatch/components";
<Layout brandName="Acme Workspace" brandIcon={<AcmeMark />}>
{children}
</Layout>;
校验社区模板分支
当分支核查失败时,组织所有人或管理人员可以拨打
inspect-community-builder-backup 仅限 branchName。其内容为:
来自组织保存的构建器项目的备份和分支状态元数据
以显示备份是否为部分、有效、完整和当前,是否为
分支活动、存档、被删除或未知,以及它是否闲置
未倾斜变化. 它只读取现有的状态元数据;它不要求
备份、下载捆绑或验证应用程序文件.
backupPartial 返回时 missing 或者说 invalid 当供应商旗没有时
它从来不强迫那些案件 false。 。 。 .
明确提供者 invalid编号 :no-backup 没有备份对象的状态为 a
类型 status_no_backup 失败; 其他缺失的备份对象仍然不正确
状态失败.
verificationPerformed 总是 false启用
verify-curated-community-app 对于单独的散列核查步骤.
核查者请求捆绑下载的 URL 并可能刷新提供者备份
状态;此状态动作没有。 状态元数据仅为诊断
从未授权安装或重试 .
组织业主和管理人员可以打电话 verify-curated-community-app 与
sourceId, (中文(简体) ), appId,以及 branchName 以选中已有的构建器分支
组织配置的构建器项目。 项目选择和审查
文件指针来自调度;呼叫者无法提供另一个工程或散列.
动作使用保存的构建器连接到项目读取访问. 这个
需要一个完整的备份, 其消化和永恒的承诺 匹配闲置,
读取其"Git"捆绑前后的清洁分枝. 每一个普通文件下
apps/<appId> 必须与审查过的模板的确切路径和 Git blob 散列匹配;
缺少、额外、更改或链接文件无法校验。 结果包含
承诺并存档散列, 不包含文件内容或签名下载 URL .
服务器需要一个可写入的临时目录 。 核查界限包 在 JavaScript Git 读取器打开一个孤立的对象商店前解压, 从不检查或执行应用程序代码,并删除其临时文件. 或部分备份, 无法验证的身份、访问错误和大小限制都无法关闭 .
核查不安装应用程序、准许访问、更改社区实验室或 标记一个应用程序准备。 尚未安装的建构器- 模组群落仍为已禁用 已核实生成分支接受.
是为了什么
调度是位于单个模板之上的工作空间控制平面 应用程序 :
- 默认 - 与请求分享工作空间秘密, 每个应用程序都有范围.
- 工作空间资源 • 交叉应用资源(例如共用指示或 (d) 提供明确的赠款和有效文本解析.
- 简单的代理和代理包 ——可重复使用的代理保持克洛德兼容性
Markdown/JSON 简介 at
agents/<slug>.md并可以在agents/<slug>/context/, (中文(简体) ),references/,以及skills/<name>/SKILL.md编辑import-agent-pack财务报告和审定财务报表list-agent-pack动作创建/读取整个包;import-agent仍然是快速的单文件路径。 不安全的能力,例如: 证书、钩子、 shell 命令和本地环境设置 剥去或报告为警告。 Pack 文件是文本资源, 而不是一个 执行补助. - 整合和目的地 - 外出消息频道设置(Slack, 团队、Discord、Telegram、WhatsApp、电子邮件等)和目的地 队列用于发送代理输出.
- 梦想工作 - 经常性的背景工作(
ensure-dream-job扫描 代理线程调试历史跨连接源并生成待处理, (b) 证据支持的建议create-dream-report, (中文(简体) ),list-dream-candidates, (中文(简体) ),apply-dream-proposal编号 :reject-dream-proposal没有额外的LLM呼叫. - 连接的代理和提供者 API 发现其他工作空间应用软件
(单位:千美元)
list-connected-agents, (中文(简体) ),open_app, (中文(简体) ),ask_app)和一个通用提供者-api 目录/文件/请求通过存储的第三方API 证书. - 核准和审计 - 采用共同核准请求/审计活动模式 横跨上述表面.
弹出
没有 agent-native.package.json / CLI 包生命周期接线
此软件包至今( 不同于 @agent-native/scheduling) (中文(简体) ). 超越自定义
setupDispatch 配置表面, 复制您想要拥有的文件
node_modules/@agent-native/dispatch/src 转换到您的软件包中
手动依赖.