# @agenticprimitives/tool-policy 中文文档

规范地址：https://npmcn.com/package/%40agenticprimitives/tool-policy/

版本：1\.0\.0-alpha\.46
npm 元数据更新时间：2026-10-26T11:50:29.926Z
中文译文更新时间：2026-11-06T03:27:35.329Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40agenticprimitives/tool-policy
原文对照：https://npmcn.com/package/%40agenticprimitives/tool-policy/?lang=original
项目主页：https://agenticprimitives.dev/
源码仓库：https://github.com/agentictrustlabs/agenticprimitives

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：61.7 kB，40 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：@agenticprimitives/types ^1\.0\.0-alpha\.46
- 首次发布：2026-05-31T17:12:59.799Z
- 最新版本发布：2026-10-26T11:50:29.756Z
- 近 30 天下载量：5600（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：45（近 12 个月 45 个）

## 中文简介

协议不可知的分类、风险等级和精确计费政策。 由MCP,A2A,LangGraph,和Vercel AI工具运行时间所消耗.

## 安装

```sh
npm install @agenticprimitives/tool-policy
```

也可以使用：`pnpm add @agenticprimitives/tool-policy`、`yarn add @agenticprimitives/tool-policy`、`bun add @agenticprimitives/tool-policy`

## README

# @ agenticprimitives/tool-policy (原始内容存档于2018-09-30) (英语)

> 部分 **[代理先导](https://agenticprimitives.dev/)** ——代理应用程序的开源信任底板:可以签名的身份,行为时间检查权限,所有者携带的证据. [开发者工具包](https://github.com/agentictrustlabs/agentic-primitives) • 妇女 [所有软件包](https://agenticprimitives.dev/developers)

**每一个代表团都有一个模式——这就是决定的层次.**

特工们比任何人都快获得工具访问权 决定这些工具应该允许做什么 通常的答案是OAuth瞄准镜字符串或API密钥并附有祷告——粗糙,有运输载体,对风险保持沉默. 此套件是缺少的决断层:分类分类( C) :`@sa-tool`, (中文(简体) ), `@sa-auth`, (中文(简体) ), `@sa-validation`, (中文(简体) ), `@sa-risk-tier` 使用TTL夹子的风险等级和需要的外观,精确的DSL用于字节精确的链上通话,以及决定性的决策引擎 `evaluatePolicy(ctx)` 返回时 `allow`, (中文(简体) ), `deny`,或 `requires-consent`,同样的答案 对于相同的输入,每次。 未知的分类域已关闭 .

没错 **故意免费运输**:没有MCP SDK,没有LangChain,没有Vercel AI进口([ADR-0003 (韩语)](https://npmcn.com/package/docs/architecture/decisions/0003-tool-policy-protocol-agnostic.md)) (中文(简体) ). 一个 LangGraph 用户可以 `pnpm add` 它不购买到MCP中间软件 `@agenticprimitives/mcp-runtime` 消费它而不是唯一的消费者。 此软件包决定; 您的运行时间执行 .

> 部分 [代理原始产品](https://npmcn.com/package/README.md) ——代理经济的信托基底:一个有监护,授权,命名,证书,审计证据的犬类智能代理身份,设计成一个系统.

见 [`spec.md`](https://npmcn.com/package/%40agenticprimitives/tool-policy/spec.md) → [`specs/204-tool-policy.md`](https://npmcn.com/package/specs/204-tool-policy.md)。 。 。 .

## 快开始

```ts
import { declareTool, evaluatePolicy } from '@agenticprimitives/tool-policy';

const getProfileTool = declareTool(
  { name: 'get_profile', inputSchema: { /* ... */ }, handler: /* ... */ },
  {
    '@sa-tool': 'delegation-verified',
    '@sa-auth': 'session-token',
    '@sa-validation': 'shape-check',
    '@sa-risk-tier': 'low',
  },
);

const decision = evaluatePolicy({
  toolName: 'get_profile',
  classification: getProfileTool._classification,
  delegation,             // from @agenticprimitives/delegation
  callerKind: 'user-session',
});

if (decision.decision === 'deny') throw new Error(decision.reason);
if (decision.decision === 'requires-consent') /* prompt user */;
```

## 准确通知政策

当"大概是这种呼叫"不够好时,就把确切的一次:

```ts
import { exactCall, matchesExactCall } from '@agenticprimitives/tool-policy';

const policy = exactCall(safeAddress, '0xa9059cbb', {
  calldataHash: '0xdeadbeef...',
  valueLimit: 0n,
});

const ok = matchesExactCall({ to, data, value }, policy);
```

何时 `calldataHash` 设置,匹配为字节-等同——没有部分匹配快捷键.

## 怎么不一样

OAuth瞄准镜和通用政策引擎(OPA-style)是这里的现任者,两者都有这一一揽子目标的差距. 范围是在同意时间给予的静态串;它们不知道风险等级、价值限制,也不知道代表团是否实际拥有一个呼叫者。 政策引擎是强大的但通用的——你带来自己的身份模型,你自己的风险分类,以及你自己的整合胶水每一次运输. 这个软件包将预建的代理工具特定层 : 用于工具调用的风险分类, 由 making complex `Delegation` 来自 `@agenticprimitives/delegation` (只消耗类型——无运行时间接合),以及一个定型的,无副作用的引擎,你可以黄金测试. MCP服务器执行的决定是 LangGraph 或 A2A 运行时间会得到的相同决定,因为政策层从未得知它所生活的运输方式.

## 校验

```bash
pnpm --filter @agenticprimitives/tool-policy typecheck
pnpm --filter @agenticprimitives/tool-policy test
```

## 状态

**阿尔法轨道-只试网.** Spec + API 稳定; 在根上列出的门之前不要部署到生产中 [`README.md` 状况科](https://npmcn.com/package/README.md#status) 包括第三方合同审计和治理关键轮换。 追踪所有安全发现 [`docs/audits/findings.yaml`](https://npmcn.com/package/docs/audits/findings.yaml)。 。 。 .

## 常见问题

### @agenticprimitives/tool-policy 是什么？

协议不可知的分类、风险等级和精确计费政策。 由MCP,A2A,LangGraph,和Vercel AI工具运行时间所消耗\.

### 如何安装 @agenticprimitives/tool-policy？

在项目目录运行 npm install @agenticprimitives/tool-policy，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@agenticprimitives/types（^1\.0\.0-alpha\.46）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @agenticprimitives/tool-policy 支持 TypeScript 吗？

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

### @agenticprimitives/tool-policy 支持 ESM 还是 CommonJS？

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

### @agenticprimitives/tool-policy 可以商用吗？

@agenticprimitives/tool-policy 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @agenticprimitives/tool-policy 的下载量有多少？

根据 npm 官方下载统计，@agenticprimitives/tool-policy 在 2026/10/05 – 2026/11/03 这 30 天内被下载 5,600 次，日均约 187 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @agenticprimitives/tool-policy 还在维护吗？

最新版本 1\.0\.0-alpha\.46 发布于 2026/10/26（10 天前）；至今共发布 45 个版本，其中过去 12 个月发布了 45 个；首次发布于 2026/06/01。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。