# @agentskit/integrations 中文文档

规范地址：https://npmcn.com/package/%40agentskit/integrations/

版本：0\.8\.3
npm 元数据更新时间：2026-10-24T15:09:17.459Z
中文译文更新时间：2026-11-06T03:13:19.431Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40agentskit/integrations
原文对照：https://npmcn.com/package/%40agentskit/integrations/?lang=original
项目主页：https://www.agentskit.io/docs/for-agents/integrations
源码仓库：https://github.com/AgentsKit-io/agentskit

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

- 包体积（解压后）：1.2 MB，16 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.19
- 运行依赖：2 个
- 首次发布：2026-06-10T13:16:29.399Z
- 最新版本发布：2026-10-24T15:09:16.683Z
- 近 30 天下载量：5865（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：31（近 12 个月 31 个）

## 中文简介

AgentsKit代理的统一,插件和游戏服务集成——每个服务一个描述器投射到工具,连接器,触发器和认证.

## 安装

```sh
npm install @agentskit/integrations
```

也可以使用：`pnpm add @agentskit/integrations`、`yarn add @agentskit/integrations`、`bun add @agentskit/integrations`

## README

# @ agentskit/ 合并

简介 : `major-package`

![AgentsKit](https://raw.githubusercontent.com/AgentsKit-io/agentskit/main/apps/docs-next/public/brand/logo-wordmark.svg)

**标记 :** `agentskit` • 妇女 `typescript` • 妇女 `ai-agents`

[![stability](https://img.shields.io/badge/stability-beta-yellow)](https://npmcn.com/package/docs/STABILITY.md)

AgentsKit代理的统一、插件和游戏服务集成——一个描述符 每个服务,投放到工具,连接器,触发器,以及认证. 每个 集成为 HTTP/`fetch`\- 只:没有捆绑或要求销售商SDK (见 [ADR-0012 (英语)](https://npmcn.com/package/docs/architecture/adrs/0012-vendor-adapter-scope.md)HTTP (韩语) 重试、 超时- 信号、 校对行为使用 `@agentskit/net` 运行时间依赖.

## 已核实的证据

-   软件包元数据和测试在 `packages/integrations/`。 。 。 .
-   软件包指南 : [https://www.agentskit.io/docs/for-agents/合并](https://www.agentskit.io/docs/for-agents/integrations)
-   稳定地图: [文件/服务.md](https://npmcn.com/package/docs/STABILITY.md)

## 如何适应生态系统

@agentskit/集成将SaaS API变为代理准备工具,连接器,触发器,以及来自一个服务描述符的auth.

-   **探员Kit**:与本回购中的其他包一起作曲,从可互换的小零件来构建代理.
-   **书记官处**: 查找已使用此图层的即时代理和模板 [登记. agentskit.io](https://registry.agentskit.io/)。 。 。 .
-   **游戏本**: 学习本层背后的生产模式 [游戏本. agentskit.io](https://playbook.agentskit.io/)。 。 。 .

文档 : [软件包指南](https://www.agentskit.io/docs/for-agents/integrations) • 妇女 [代理交接](https://github.com/AgentsKit-io/agentskit/blob/main/llms.txt)

## 安装

```bash
npm install @agentskit/integrations
```

## 快开始

```ts
// Most consumers don't author integrations directly — they pull ready-made
// service descriptors from the registry and project them into tools:
import { integrationTools } from '@agentskit/integrations'

export const tools = integrationTools('slack', {
  credential: process.env.SLACK_BOT_TOKEN,
})
```

服务说明人居住在 `src/services/`。描述者宣布 服务的动作、触发器、认证和 `CONFIG_FIELDS`; 投影帮助器 将每个消费者需要的描述文字变成表面(a) `ToolDefinition` 用于运行时间,用于应用程序的连接-形式,一个webhook触发器等).

目录是 **捆绑, 只获取** 一套~50服务(ADR-0012). `@agentskit/tools` 使用此软件包,而不是重新发送集成.

## 授权新的整合

```ts
import { defineIntegration, defineAction } from '@agentskit/integrations'

export const myService = defineIntegration({
  name: 'my-service',
  http: { baseUrl: 'https://api.example.com' },
  actions: [
    defineAction({
      name: 'send',
      schema: { type: 'object', properties: { to: { type: 'string' } }, required: ['to'] },
      execute: (args, { http }) => http({ method: 'POST', path: '/send', body: args }),
    }),
  ],
})
```

## 执行边界(复原力和安全性)

预测和HTTP共用一套安全合同 (单位:千美元)[ADR-0026 (英语)](https://npmcn.com/package/docs/architecture/adrs/0026-integration-execution-boundaries.md):

-   **`HttpToolOptions.signal` 编号 : `ProjectionConfig.signal`** 取消打电话者,包括按要求暂停.
-   **`HttpToolOptions.retry`** ——只选入一能方法的复试:默认一次完全尝试,使用 `GET` 编号 : `PUT` 编号 : `DELETE` 正在重试 `408`, (中文(简体) ), `425`, (中文(简体) ), `429`, (中文(简体) ), `500`, (中文(简体) ), `502`, (中文(简体) ), `503`,以及 `504` 当配置为更多尝试时。 后退以100ms起跑,2秒后起跑,没有焦急. `Retry-After` 以该上限为界;三角洲秒由共享剖析器四舍五入到最接近的毫秒。 网络错误没有重试 .
-   **重试接缝** —— 说 `sleep(delayMs)` 仍为一证回召; `now()` 提供 HTTP 日期的时钟 `Retry-After` 数值。 总体超时也结束了一个待定的自定义睡眠等.
-   **超时兼容性** —— 说 `composeTimeoutSignal` 仍按版本折旧 `0.10.0` 和至少90天的时间。 内容 `cleanup()` 解析相容中继; 本地超时信号在自己的时钟上过期.
-   **来源自定义的 HTTP** 何时 `baseUrl` 已经设定, `httpJson` 拒绝跨源路径并禁用自动重定向,因此绑定的证书不能离开该源.
-   **衍生确认** ——投影部队 `requiresConfirmation` 用于与 `sideEffect` 联 合 国 `write`, (中文(简体) ), `external`,或 `destructive` (描述符不能选择退出).
-   **`ProjectionConfig.fetchUntrusted`** ——对模型控制的URL进行政策强制获取. 直接耳语(和类似)消费者 **必须注入** 一个 egrees- policy 获取; 已贬值 `@agentskit/tools` 静音外观注射 `safeFetch` 独立于提供者 `fetch`。 。 。 .

## 稳定

`beta` 可用于生产;说明、登记和投影合同 被运出, 仅获取目录被填入, 执行边界是 明确(ADR-0026)。 还没有 `stable`: 公众表面仍可轻微移动 随同变换组的笔记发布. 偏爱 `~x.y.z` 如果你需要更紧的针.

## 成熟性和相容性

-   稳定性: **β 语录** 看到了吗 [文件/服务.md](https://npmcn.com/package/docs/STABILITY.md)
-   **节点.js 20+** 财务报告和审定财务报表 **类型脚本** 严格模式
-   发表于 `@agentskit/integrations`

## 捐款

见 [捐款额](https://npmcn.com/package/CONTRIBUTING.md) 单曲 [自由主义](https://npmcn.com/package/LICENSE)。 。 。 .

## 常见问题

### @agentskit/integrations 是什么？

AgentsKit代理的统一,插件和游戏服务集成——每个服务一个描述器投射到工具,连接器,触发器和认证\.

### 如何安装 @agentskit/integrations？

在项目目录运行 npm install @agentskit/integrations，或使用 pnpm add / yarn add / bun add。

### @agentskit/integrations 支持 TypeScript 吗？

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

### @agentskit/integrations 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @agentskit/integrations 需要什么版本的 Node\.js？

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

### @agentskit/integrations 可以商用吗？

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

### @agentskit/integrations 的下载量有多少？

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

### @agentskit/integrations 还在维护吗？

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