@finalai/agents

中文文档
0.6.2发布于 2026/11/01Apache-2.0TypeScriptES Module

代理编写、客户端api和CLI。

中文使用文档

@finalai /代理

用于定义、发布和使用代理的SDK。中实现了创作帮助程序 @finalai/agent-definition;特定于最终的绑定来自 @finalai/final-agent-provider.

import { defineAgent } from '@finalai/agents';
import { serverlessPi } from '@finalai/agents/harnesses';

export default defineAgent({
  name: 'Assistant',
  harness: serverlessPi({
    credentials: { payer: 'agent-owner', tryInOrder: [{ kind: 'platform' }] },
  }),
});

使用 @finalai/agents/client 对于定义、会议、对话、批准, 附件,时间表,沙箱访问和实时。使用 final-agents --help 命令行。编译需要Node 26,并通过Node 26交付其资产 agent-definition.

凭据链声明选择代理可以使用哪些凭据 它们的顺序。在线束配置中显式地设置付款人策略。

对于自定义提供程序实现,从 @finalai/agent-provider, 来自 @finalai/agent-provider/sandbox,以及一致性工具 @finalai/agent-provider/conformance。做一个安全带检查 final-agents conformance ./harness.ts.

使用 FINAL_API_HOST 与 FINAL_API_KEY 为构建和选择一次部署 发布;一个显式的 --host 覆盖它。使用 defineHostedConnection 对于一个命名的 在会话开始时由主机解析的连接。 defineFinalConnection() 使用 相同的路径 final 绑定。显式URL声明保持静态。 请参阅存储库的 托管指南 对于提供者上下文, 资源查找,以及所需的托管集成。

版本与发布记录

@finalai/agents 共发布 21 个版本,首次发布于 2026/10/15;过去 12 个月发布了 21 个版本。

版本发布日期距今
0.6.2latest2026/11/012 天前
0.6.12026/11/012 天前
0.6.02026/10/313 天前
0.5.02026/10/286 天前
0.4.42026/10/277 天前
0.4.32026/10/2311 天前

关于 @finalai/agents 的常见问题

@finalai/agents 是什么?

代理编写、客户端api和CLI。

如何安装 @finalai/agents?

在项目目录运行 npm install @finalai/agents,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 final-agents,可以用 npx final-agents 直接运行。

@finalai/agents 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@finalai/agents 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@finalai/agents 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=26。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@finalai/agents 可以商用吗?

@finalai/agents 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@finalai/agents 还在维护吗?

最新版本 0.6.2 发布于 2026/11/01(2 天前);至今共发布 21 个版本,其中过去 12 个月发布了 21 个;首次发布于 2026/10/15。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。