@ agent- intative/ creative- context

共享创意-图书馆摄取,管理可重复使用的背景,不可改变 证据、混合检索、品牌背景和生成来源 原生创意应用.

创意背景是一个工具包能力模块,应请求安装。 它活着 在它自己的 npm 软件包中,所以应用程序只接收被管理的实体,检索,UI,以及 他们需要生命周期元数据.

软件包将 Google 幻灯片、图片、图片、网站和上传 PPTX/DOCX/PDF/PNG/JPEG/WebP/GIF/safe-SVG文件被改编为版本的SQLector. 二进制原作, 局部视觉 倒计时, 并绑定的 UI 缩略图生活在私人 blob 存储; 完全滑行 和全帧源是临时的质量保证投入,被丢弃。 文本仍可直接调取到 SQL; PostgreSQL 部署添加全文候选人和 pgvector 视觉 类似 DATABASE_URL 数据库.

安装

pnpm add @agent-native/creative-context

每个应用程序添加服务器插件一次 :

// server/plugins/creative-context.ts
import { setupCreativeContext } from "@agent-native/creative-context/server";

export default setupCreativeContext({ appId: "slides" });

在应用程序的现有代理页面上挂载共享库标签 :

import { AgentTabsPage } from "@agent-native/toolkit/app/agent-page";
import { createCreativeContextAgentTab } from "@agent-native/creative-context/client";

export default function AgentPage() {
  return <AgentTabsPage extraTabFactories={[createCreativeContextAgentTab]} />;
}

导入 ./server 通过框架登记一揽子行动 成套行动登记册、适用添加剂转移、登记册 共享来源/简介/文稿/包装,开始可回收的进口加工, 并有条件地为代理提示提供已公布的品牌上下文. 每个 拥有应用程序也会注册服务器侧本地捕获适配器, 所以它的共享 popover 可以通过资源 id 提交甲板、 设计、 文档、 资产或仪表板 而不通过一般操作发送本地有效载荷。 及时 当应用程序状态包含时,会从结构上省略贡献 { contextMode: "off" }。 。 。 .

管理上下文

品牌简介包含批准的身份和DNA. 创意背景是: 长期、可分享的募捐者(例如默认、营销、, 产品,或销售)。 上下文包是不可更改的准确版本收件 一辈人.

• 每个个人或组织的范围都有一个不可存档的默认上下文.
• 请求使用默认加最多一个特殊上下文 。 明确选择 胜出; 应用程序绑定或语义匹配提供自动特长.
• open 上下文立即发布编辑稿. review 财务报告和审定财务报表 admins-only 上下文对其提交者保密 上下文管理员直到批准.
• 目前核准的快照仍在使用,而更新版本是 待定。 删除会立即影响新检索而无需重写旧文件 包装.
• 更广义的出版需要源管理许可 明确确认。 接受书写不可改变的上下文自有副本; 它永远不会改变原始资源共享.

标准 UI 是框架的上下文标签 上下文第一库。 图书馆铁路选择默认或专业及其 项目、来源、批准和设置视图仅显示安全、有界限的预览 : 幻灯片胶片、设计框架、 文档结构、访问范围 和包含合成预览数据的仪表板.

精确的app-native数据是一个单独的私人blob能力. 通用列表, 物品、包装、状况、媒体和搜索回复从未暴露这种能力. 只有拥有的应用程序的已打入的克隆动作才能解决它,验证存储的散列 并创建新的可编辑资源 常规持久路径。 继续导入 Google 幻灯片和相片 使用更严格的可信编译器和本地重装路径.

检索行为

• 语法搜索使用规范化的 grep 模式 (allTerms, (中文(简体) ), anyTerm, (中文(简体) ), phrase, (中文(简体) ), regex)和加权头衔/摘要/身体评分.
• PostgreSQL 添加一个 tsvector/GIN 候选车道和一个已配置的多式车道 在同一数据库中嵌入由 pgvector 支撑的家庭 .
• PGlite只保留词汇和词典/标题搜索。 视觉查询失败 明确的 PostgreSQL+pgvector 要求; 软件包从不创建另一个 PGlite或矢量数据库.
• 每个上下文支持的生成 解决默认加零或一个特长, 应用特长排名助推,快照精确 (itemId, itemVersionId) 证据、分数、选择理由和上下文 身份标识为不可改变的上下文包.

背景包是有意拥有的,可以独立分享,而不是 继承广泛的源可见度。 一包记录一代人的要求, 选定的证据,以及影响分数,可以揭示私人工作意图 即使每个来源都是组织可见的 只有创造者才能 见一新包;合作者通过一明确包份额获得. 普通来源证据仍受当前来源访问和 撤销。 背景自有的已出版的快照仍可重放于被封存的快照上 用于取消会员资格后授权的包式取景器的版本.

孤立部署

一个工作空间中的 Apps 默认使用共享数据库进行中. 如果一个应用 在一个单独的数据库中部署 CREATIVE_CONTEXT_A2A_URL 页:1 拥有程序并配置共享的应用程序 A2A_SECRET 两者 部署或匹配的曲线范围d CREATIVE_CONTEXT_A2A_KEY倒计时 仅转发有界限的解析、验证、生成记录读取,以及 通过认证的 A2A 协议生成记录写入操作. 呼叫者身份由接收者签名并重新解决,所有请求和 反应形状得到严格验证,且反应格式不当或超时 明显失败,而不是回到未跟踪的背景。 可选 CREATIVE_CONTEXT_A2A_TIMEOUT_MS 被夹到1-60秒,默认值为30秒 秒数。 不要将这些值放在客户端代码或应用程序状态中 .

CREATIVE_CONTEXT_A2A_URL 是选择入:没有它,就不会发生A2A请求。 A 类 保存或一代 contextMode: "off" 结构抑制 远程路径 .

信任和生命周期

被导入的文字是证据,不是指示. 只有人类出版,验证 结构化品牌字段可以输入已键入 <brand-context> 快速块. 限制上游项目默认审查和排除。 组织印本 要求一个组织管理或经核实的集装箱所有人加上确认 准确的容器和物品数量。 断开或删除源 墓碑同步取出 所以立即停止取出 私人墓穴是 同步清理 本地上下文文件使用相同的已关闭 私人小块规则 永远不要回到 SQL 有效载荷存储.

出口