Genkit 的火基地插件
Firebase插件将源基特与Firebase和Google Cloud集成. 它规定:
- 遥测/监测 - 向 Google Cloud / Firebase 出口追踪、度量和日志 基因组监测。 。 。 .
- 持久流(Beta) - 在Firestore或实时数据库中持续流出状态,以便恢复流出.
- 会话存储 (Beta) - 持续在Firestore提供代理会话快照,这种短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短篇短.
用编码代理? 先安装基因组JS技能.
npx skills add genkit-ai/skills --skill developing-genkit-js它教你的代理人 现任Genkit JS APIs 和普通的gitchas. 其他语言的来源、人工安装和技能: 技能/技能。 。 。 .
另见官方文件 部署有火地基地的玄基。 。 。 .
安装插件
npm i --save @genkit-ai/firebase
遥测/监测
打电话 enableFirebaseTelemetry() 以导出 Google Cloud / Firebase 的 Genkit 跟踪、 度量和日志 :
import { genkit } from 'genkit';
import { enableFirebaseTelemetry } from '@genkit-ai/firebase';
enableFirebaseTelemetry();
const ai = genkit({
plugins: [
// ...
],
});
见 监测文件 详细情况.
持久流(Beta)
此插件提供了两个 StreamManager 实施耐用流:
FirestoreStreamManager: Persists stream state in Google Firestore. (原始内容存档于2018-09-27).RtdbStreamManager: 火地站实时数据库中的活塞流状态.
你可以用这个 expressHandler 或者说 appRoute 让你的流流持久.
使用量
要使用流管理器,请从 @genkit-ai/firebase/beta 并把它交给你的处理器:
import { expressHandler } from '@genkit-ai/express';
import { FirestoreStreamManager } from '@genkit-ai/firebase/beta';
import express from 'express';
import { initializeApp } from 'firebase-admin/app';
import { getFirestore } from 'firebase-admin/firestore';
// ... define your flow: myFlow
const fApp = initializeApp();
const firestore = new FirestoreStreamManager({
firebaseApp: fApp,
db: getFirestore(fApp),
collection: 'streams',
});
const app = express();
app.use(express.json());
app.post('/myDurableFlow', expressHandler(myFlow, { streamManager: firestore }));
app.listen(8080);
同样,对于实时数据库:
import { RtdbStreamManager } from '@genkit-ai/firebase/beta';
const rtdb = new RtdbStreamManager({
firebaseApp: fApp,
refPrefix: 'streams',
});
app.post('/myDurableRtdbFlow', expressHandler(myFlow, { streamManager: rtdb }));
限制
- 消防车:整个溪流历史(cunks and final results)被存储在一个文档中. 消防车很严格 1MB 文件大小限制。如果您的流输出超过此限制,流会失败.
- 实时数据库:虽然RTDB没有相同的1MB限制,但存储非常大的溪流可能影响性能或打出其他配额.
会话存储 (Beta)
FirestoreSessionStore 是一个火炉支撑 SessionStore 用于持续代理会话快照。 它是一个细小的防火基地 围绕核心执行在 @genkit-ai/google-cloud,添加一个 firebaseApp 从 Firebase 应用程序中获取 Firestore 实例的选项。 与天真的单一文件店不同,它作为JSON Patch diff的增量站点,一直持续到定期的被压榨的全州检查站,所以:
- 没有任何文档接近 Firestore 1个米B限制 (状态在文档中变硬).
- 每个回合读出/写出的文件数量以下列文件为准:
checkpointInterval而不是总会话长度,因此它缩放为任意长会话(例如长寿的聊天员,编码代理). - 重建仅在只读交易中使用文档-ID查看,因此不需要二次索引,而且非常一致.
使用量
从这里导入 @genkit-ai/firebase/beta 并传递作为 store 当定义代理人时:
import { genkit } from 'genkit/beta';
import { FirestoreSessionStore } from '@genkit-ai/firebase/beta';
import { initializeApp } from 'firebase-admin/app';
const fApp = initializeApp();
const ai = genkit({
plugins: [
// ...
],
});
const myAgent = ai.defineAgent({
name: 'myAgent',
model: 'googleai/gemini-flash-latest',
system: 'You are a helpful assistant.',
store: new FirestoreSessionStore({ firebaseApp: fApp }),
});
选项
FirestoreSessionStore 接受以下选项:
firebaseApp: 一个 Firebase 应用程序从 Firestore 实例中获取 .db:一个明显的Firestore实例. 胜过firebaseApp。 。 。 .collection: 存储快照文档的集合 。 默认为"genkit-sessions"由它衍生出两个伴生集:"<collection>-pointers"(每个会话一个指针文档)和"<collection>-shards"(坚固的检查站状态).checkpointInterval:全州检查站之间的转弯次数. 默认为25. 降低(如:.10) 对于小国,读重会;提高会(例如.50- 说吧100),用于长时间留存的大回转状态.shardSize: 单个硬度/ diff 文档的最大字节大小。 默认为512 KiB。任何超过此限的分数会被提升到一个被压碎的检查站,所以没有文件接近1 MiB 的限值.
此套件的来源主要为 精灵 复发. 请提交问题 和拉请求反对的回波.
使用信息和参考详情见 Genkit 文档。 。 。 .
许可证: Apache 2.0