# @agentskit/chat 中文文档

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

版本：0\.7\.0
npm 元数据更新时间：2026-10-31T13:21:21.910Z
中文译文更新时间：2026-11-05T22:56:14.988Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：1.2 MB，66 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：6 个
- peer 依赖：ink \>=7\.1\.0，vue ^3\.4\.0，rxjs ^7\.0\.0，react \>=18，svelte ^5\.0\.0，solid-js ^1\.9\.0，drizzle-orm ^0\.45\.3，react-native \*，@angular/core \>=18\.1 \<22，@agentskit/ink ^0\.10\.1，@agentskit/vue \>=0\.4\.4 \<1，@agentskit/core ^1\.15\.0，@angular/common \>=18\.1 \<22，@agentskit/react \>=0\.7\.1 \<1，@agentskit/solid \>=0\.4\.4 \<1，@agentskit/svelte \>=0\.4\.4 \<1，@agentskit/angular ^0\.4\.6，@agentskit/react-native \>=0\.4\.4 \<1，@agentskit/observability \>=0\.13\.0 \<1
- 首次发布：2026-07-13T22:13:41.131Z
- 最新版本发布：2026-10-31T13:21:21.497Z
- 近 30 天下载量：10210（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 8 个）

## 中文简介

AgentsKit Chat的跨框架应用定义.

## 安装

```sh
npm install @agentskit/chat
```

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

## README

# @ agentskit/聊天时

**简介 :** `major-package`

框架中性应用程序定义,用于编译到 AgentsKit 配置 。 拥有键入的路由,政策组成,组件表,会话元数据,确定答案适配器,和语义回落信封,而上游控制器则保留生命周期,内存,工具执行.

协议,服务器,devtools,以及所有7个框架渲染器船作为子路径输出:

```ts
import { decodeTurnEvent } from '@agentskit/chat/protocol'
import { createChatHandler } from '@agentskit/chat/server'
import { createTraceCapture } from '@agentskit/chat/devtools'
import { AgentChat } from '@agentskit/chat/react'
```

它们仍然是孤立的私有工作空间模块,用于所有权和测试,而npm消费者只安装 `@agentskit/chat`。在单独的折旧阶段之前,原有的独立包名称仍然可用.

可操作选择的使用 `createActionConfirmation`授权验证 犬科确认 批准 拒绝 以及执行给特工Kit.

## 已核实的证据

| 表面 | 证据 |
| --- | --- |
| 标准组件 | [`catalog.generated.md`](https://npmcn.com/package/docs/components/catalog.generated.md) |
| 决定平面 | [ADR-0024 (英语)](https://npmcn.com/package/docs/architecture/adrs/0024-deterministic-answer-plane.md) |
| 上游收养 | [上游矩阵](https://npmcn.com/package/docs/architecture/upstream-adoption.md) |

`defineChat` 保护上游 `ChatConfig`;它不会创建另一个运行时间.

```bash
npm install @agentskit/chat @agentskit/core
```

## 快开始

```ts
import { defineChat } from '@agentskit/chat'
import type { AdapterFactory } from '@agentskit/core'

export const createSupportChat = (adapter: AdapterFactory) => defineChat({
  id: 'support',
  chat: { adapter },
})
```

使用 `resumeChatSession(definition, { sessionId, storage })` 用于交叉客户端元数据,并将返回的会话传递给任何渲染器。 自定义 UI 流经 `defineComponentManifest` 财务报告和审定财务报表 `resolveComponentFrame`。 。 。 .

![One definition fans out to protocol, server, and renderer packages](https://npmcn.com/package/docs/assets/agentschat-architecture.svg)

```mermaid
flowchart LR
  C["@agentskit/chat"] --> P["/protocol"]
  C --> S["/server"]
  C --> D["/devtools"]
  C --> R["seven renderer subpaths"]
```

## 成熟性和相容性

发表于 `0.7.0` 与 `@agentskit/core ^1.15.0`, (中文(简体) ), `@agentskit/memory ^0.12.0`, (中文(简体) ), `@agentskit/statechart ^0.3.2`,以及 `@agentskit/eval ^0.7.0`。见 [稳定](https://npmcn.com/package/docs/releases/stability.md)。 。 。 .

-   节点.js 22+
-   类型脚本严格模式

## 捐款

软件包所有权 : `packages/chat`后续 [捐款额](https://npmcn.com/package/CONTRIBUTING.md) 和编辑前查询 doc-bridge.

**标记 :** `agentskit-chat`, (中文(简体) ), `chat-definitions`, (中文(简体) ), `deterministic-answers`, (中文(简体) ), `typescript`

## 探员 Kit 生态系统

建造在 [探员Kit](https://github.com/AgentsKit-io/agentskit)组合 [书记官处](https://registry.agentskit.io/), (中文(简体) ), [游戏本](https://playbook.agentskit.io/),以及 [多克桥](https://www.npmjs.com/package/@agentskit/doc-bridge)。 。 。 .

### 可选 PostgreSQL 会话信封

安装 `drizzle-orm` 和主机中的 PostgreSQL 驱动程序,然后导入可选子路径 :

```ts
import { drizzle } from 'drizzle-orm/node-postgres'
import { chatSessionDDL, createDrizzleSessionStorage } from '@agentskit/chat/drizzle-pg'

// pool is the host-owned pg Pool (Node) or connected request Client (Workers).
// Apply chatSessionDDL once in a migration, never on every production request.
const storage = createDrizzleSessionStorage(drizzle(pool), authenticatedTenantId)
```

适配器存储应用程序信封,而不是消息. 继续使用上游 `ChatMemory` 为犬科历史; 一个 Drizzle Chat Memory 后端正在上游等待. `save` 返回丢失的光标 CAS 的虚假值; 恢复会话中的持久性将转换为 `SessionConflictError`,处理器保存 HTTP 409 `SESSION_CONFLICT`。密钥和每个读取/更新/删除都包括信任的租户身份证。 供应租户的身份来自认证, 从来没有从一个不信任的事件.

关于工人的连接 `pg.Client` 每个请求(生产中的Hyperdrive连接字符串),并调用 `client.end()` 内 `waitUntil` 在消耗/关闭聊天流后。 在节点再使用时 `pg.Pool` 并在服务器关闭时关闭 。 适配器没有导入尼昂或Cloudflare专用API. 在 SQL 发送前检查中止; 飞行中的 SQL 不取消 .

同一子路径为以后的请求中决定的确认提供耐用储存。 应用 `chatDecisionDDL` 在迁移中,把商店交给管理者 `decisions` 选项 :

```ts
import { createDrizzleDecisionStore } from '@agentskit/chat/drizzle-pg'

const decisions = createDrizzleDecisionStore(drizzle(pool), authenticatedTenantId, sessionId)
```

它执行上游 `ToolDecisionStore`: 每个确认所需的工具呼叫一行, 和一个条件 `UPDATE` 作为债权,因此同时批准的执行工具一次。 见 [服务器](https://npmcn.com/package/docs/server.mdx)。 。 。 .

可选 RLS 深度辩护( 配置租户背景- 本地交易) `set_config` 使用非所有者角色而不使用BYPASSRLS:

```sql
ALTER TABLE agentskit_chat_sessions ENABLE ROW LEVEL SECURITY;
ALTER TABLE agentskit_chat_sessions FORCE ROW LEVEL SECURITY;
CREATE POLICY chat_tenant ON agentskit_chat_sessions
  USING (tenant_id = current_setting('app.tenant_id', true))
  WITH CHECK (tenant_id = current_setting('app.tenant_id', true));
```

见 [可重复使用的本地合同](https://npmcn.com/package/tests/storage-pg/README.md) 用于Postgres 16和wrangler验证. RLS是可选的,不由该套房行使.

## 常见问题

### @agentskit/chat 是什么？

AgentsKit Chat的跨框架应用定义\.

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

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

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

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

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

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

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

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

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

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

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

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