@ godspideai/ 编码能力
决定第一个能力选择和Cognate模式供应商合同
应用。 鉴于一项要求和一系列候选供应商,它决定——可以解释
并持久地——哪个提供者使用,它定义了平版文字 ModelProvider
用于执行模型集成的接口.
何时使用此软件包 : 在多个提供者中选择相同能力
(例如几个模型)并且需要始终适用的资格规则,排序可以
永远不要凌驾于政策之上,对每项决定都有记录的解释。 模式的实施者
供货商也需要它 ModelProvider, (中文(简体) ), ModelRequest编号 :ModelResponse,以及
ModelProviderError 类型.
安装
bun add @godspeedai/cognate-capabilities
要求数 阿宝 1.4.0. 记录选择需要任何
@godspeedai/cognate-events
存储。 SDK号飞船 Bun-native TypeScript源, 所以添加 @types/bun 财务报告和审定财务报表 @types/node 作为
输入检查您的工程时的依赖性 .
快开始
import { createMemoryStore } from "@godspeedai/cognate-store-memory";
import {
compatibilityRule,
createSelector,
recordSelection,
} from "@godspeedai/cognate-capabilities";
const store = createMemoryStore();
const selector = createSelector({
rules: [
compatibilityRule, // contract id, major version, and attributes must satisfy the requirement
{
id: "policy.no-cloud",
evaluate: (candidate) =>
candidate.contract.attributes?.hosting === "cloud"
? { eligible: false, reason: "tenant forbids cloud models" }
: { eligible: true, reason: "hosting allowed" },
},
],
// ranker: optional; without one, eligible providers are picked in provider-id order
});
const decision = await selector.select({
requirement: { capability: "model.generate", version: "1.0", attributes: { structured_output: true } },
candidates: [
{ providerId: "cloud-a", contract: { id: "model.generate", version: "1.2.0", attributes: { structured_output: true, hosting: "cloud" } } },
{ providerId: "local-b", contract: { id: "model.generate", version: "1.0.0", attributes: { structured_output: true } } },
],
principal: { id: "alice", kind: "user" },
tenant: "tenant-a",
});
decision.eligible; // ["local-b"] — cloud-a failed the policy rule
decision.selected; // "local-b"
decision.filters; // every (provider, rule) result with its reason
// Make the decision a durable fact with its full explanation:
await recordSelection(store, decision, { tenant: "tenant-a", scopeId: "root", correlationId: "corr-1", runId: "run-1" });
如何选择
- 资格第一. 每个
EligibilityRule评估每个候选人。 规则必须是 纯粹和具有决定力;候选人只有在所有规则都通过的情况下才有资格. - 排名第二——并有所遏制. 可选
Ranker只查看符合条件的套装 可以缩小范围,永远不要扩大范围。 未知、不合格、重复或 空出无穷. 丢掉或丢掉的军衔归根结底 提供方- id 命令, 记录在decision.fallback由于没有合格的候选人,selected实值null军衔是不会被调用的. - 持久的反馈.
recordSelection附录acapability.selected与 充分解释;recordOutcome附录acapability.outcome用于录制选择. 运行outcomeProjection()在您的投影跑道中获得个人能力成功 计数,然后通过createOutcomeRanker(store)作为选择者的分数 : 通过对记录结果的上层信心约束规则,提供商尝试未经试验 首先提供商,而且具有决定性——重播同样的结果产生同样的结果 排行榜. 反馈仅影响承诺和预测之后的排名.
示范供应商合同
该套件还定义了模型集成合同,每个供应商都执行:
ModelProvider—— 说id, (中文(简体) ),model,已声明features(流程、工具使用、结构化) 产出、多式联运输入、上下文限制),generate(request)财务报告和审定财务报表stream(request)。 。 。 .ModelRequest编号 :ModelResponse编号 :ModelDelta——信息,工具,responseFormat,以及 流出三角洲形状(text, (中文(简体) ),tool_call_start, (中文(简体) ),tool_call_args, (中文(简体) ),tool_call_end, (中文(简体) ),tool_call, (中文(简体) ),done) (中文(简体) ).ModelProviderError- 已打出故障类型:unauthorized, (中文(简体) ),rate_limited, (中文(简体) ),invalid_request, (中文(简体) ),unavailable, (中文(简体) ),cancelled, (中文(简体) ),malformed_response。 。 。 .modelContract(provider)- 那个CapabilityContract提供者出版物(能力 idmodel.generate,特征作为属性,从不认证).
现成供应商:
@godspeedai/cognate-provider-local
(决定因素,离线)和
@godspeedai/cognate-provider-openai-compatible
(任何OpenAI相容的HTTP端点).
限制
- 规则和军衔由你来写,这个包保证 遏制和诚实 记账,不排名质量.
- 内置结果排行榜是一个决定性的强盗 高压的你自己的记录 成果——不是训练有素的模式——和分数只在一种能力内是可比的.
recordSelection编号 :recordOutcome写给商店,没有耐用 存储,重新启动时将丢失反馈.
相关软件包
@godspeedai/cognate-kernel-api—— 说Requirement, (中文(简体) ),CapabilityContract,以及所使用的兼容性检查compatibilityRule。 。 。 .@godspeedai/cognate-events—— 说 记录选择和结果的商店合同.@godspeedai/cognate-projections—— 说 应用的投影跑道outcomeProjection()。 。 。 .@godspeedai/cognate-runtime-bun—— 说 参考运行时间,用于连接选择和提供者.@godspeedai/cognateSDK伞.
许可证
阿帕奇 - 2.0