@ ai- matrx/ api
每个应用程序对每个 AI Matrx 服务器说话的方法。 从服务器合同中生成并按区域分割,因此一个应用程序只加载它所呼叫的请求. 它从不持有屏幕,应用程序状态或数据库代码.
import { createApi } from "@ai-matrx/api";
import { listAssets } from "@ai-matrx/api/files";
const api = createApi({ credentials: { kind: "api_key", apiKey: process.env.MATRX_API_KEY! }, organizationId });
const page = await listAssets(api, { query: { limit: 50 } });
- 全权证书 - 一种设定:证书、获得者或
CredentialsPort(单位:千美元)user, (中文(简体) ),guest, (中文(简体) ),api_key, (中文(简体) ),service, (中文(简体) ),scoped) (中文(简体) ). - 组织 ——捆绑一次;按每个业务的合同规则发送(要求/可选/免责).
- 路线 ——每个行动知道哪些部署答案;使用
baseUrls或者说resolveBaseUrl。 。 。 . - 流线 NDJSON/SSE操作返回可同步操作;
*_or_json业务返回{ kind: "json" } | { kind: "stream" }。 。 。 . - 节 —— 说
@ai-matrx/api/<domain>每个域,/schemas, (中文(简体) ),/types(仅类型)components编号 :paths视图),/stream, (中文(简体) ),/net, (中文(简体) ),/credentials。导入一个域不会加载其他域的代码.
服务器合同变更后再生 : node scripts/generate.mjs (输入:助药) api-contract/) (中文(简体) ). --check 在漂移时失败.
盖茨
pnpm check:package 运行生成器 --check、建设、出口协议、publint和部门探测器(scripts/section-probe.mjs:没有域段加载了另一个域的代码;一个导入的操作捆绑了完全一个操作描述符.