@aws-sdk/client-qconnect

中文文档
3.1164.0发布于 2026/11/07Apache-2.0TypeScriptESM + CJS近 30 天下载 6.1万

JavaScript QConnect 客户端的 AWS SDK 为 Node.js , 浏览器和 React Independent

中文使用文档
文档目录10 节
  1. 说明
  2. 安装
  3. 开始
  4. 导入
  5. 使用量
  6. 解决问题
  7. 获取帮助
  8. 捐款
  9. 许可证
  10. 客户端命令( 操作列表)

@aws-sdk/客户端-q连接

说明

JavaScript QConnect客户端的 AWS SDK 为Node.js, 浏览器和React Industrial 的客户端.

由亚马逊·贝德洛克提供动力: 亚马逊网络服务工具 自动发现虐待由于"连接"中的亚马逊Q是建立在亚马逊·贝德罗克上,用户可以充分利用亚马逊·贝德罗克实施的控制,强制执行安全,安保,以及负责任地使用人工智能(AI).

Amazon Q in Connect是一个基因化的AI客户服务助理. 它是Connect Client Wisdom的LLM强化演化,提供实时建议来帮助联系中心代理人快速准确地解决客户问题.

Connect中的Amazon Q在通话和聊天时会使用对话分析以及自然语言理解(NLU)自动检测客户意向. 然后,它向代理人提供即时、实时的基因反应和建议的行动,以及与相关文件和文章的联系。 代理商还可以直接使用自然语言或关键词查询连接中的亚马逊Q来回答客户请求.

例如使用连接API中的Amazon Q来创建助手和知识库,或者通过上传自定义文件来管理内容.

更多信息见 实时使用 Amazon Q in Connect 用于基因化 AI 动力代理协助 输入 连接客户管理员指南。 。 。 .

安装

要安装此软件包, 请使用您最喜欢的软件包管理器的 CLI :

  • npm install @aws-sdk/client-qconnect
  • yarn add @aws-sdk/client-qconnect
  • pnpm add @aws-sdk/client-qconnect

开始

导入

AWS SDK由客户端和命令进行调制. 要发送请求,只需导入 QConnectClient 财务报告和审定财务报表 例如,您需要的命令 ListAssistantsCommand数字 :

// ES5 example
const { QConnectClient, ListAssistantsCommand } = require("@aws-sdk/client-qconnect");
// ES6+ example
import { QConnectClient, ListAssistantsCommand } from "@aws-sdk/client-qconnect";

使用量

发出请求:

  • 以配置(如证书,区域)为客户端提供证据.
  • 以输入参数证明命令 .
  • 打电话 send 操作客户端,以输入方式提供命令对象.
const client = new QConnectClient({ region: "REGION" });

const params = { /** input parameters */ };
const command = new ListAssistantsCommand(params);

自动/等待

我们建议使用 等待时 运算符等待通过发送操作返回的承诺如下:

// async/await.
try {
  const data = await client.send(command);
  // process data.
} catch (error) {
  // error handling.
} finally {
  // finally.
}

承诺

您还可以使用 承诺连锁。 。 。 .

client
  .send(command)
  .then((data) => {
    // process data.
  })
  .catch((error) => {
    // error handling.
  })
  .finally(() => {
    // finally.
  });

合并客户端

归集客户端类别从同套件中导出,但没有"Client"后缀.

QConnect 扩展 QConnectClient 并额外支持所有操作,服务员, 和活人作为方法. 这种风格可能从JavaScript v2的AWS SDK中为您所熟悉.

如果你正在捆绑 AWS SDK, 我们建议只使用赤骨客户端(QConnectClient) (中文(简体) ). 更多详情见博客文章: javaScript 的 AWS SDK 模块包。 。 。 .

import { QConnect } from "@aws-sdk/client-qconnect";

const client = new QConnect({ region: "REGION" });

// async/await.
try {
  const data = await client.listAssistants(params);
  // process data.
} catch (error) {
  // error handling.
}

// Promises.
client
  .listAssistants(params)
  .then((data) => {
    // process data.
  })
  .catch((error) => {
    // error handling.
  });

// callbacks (not recommended).
client.listAssistants(params, (err, data) => {
  // process err and data.
});

解决问题

当服务返回例外时,错误将包括例外信息, 以及响应元数据(如请求编号).

try {
  const data = await client.send(command);
  // process data.
} catch (error) {
  const { requestId, cfId, extendedRequestId } = error.$metadata;
  console.log({ requestId, cfId, extendedRequestId });
  /**
   * The keys within exceptions are also parsed.
   * You can access them by specifying exception names:
   * if (error.name === 'SomeServiceException') {
   *     const value = error.specialKeyInException;
   * }
   */
}

另见 文档/错误。 。 。 .

获取帮助

请利用这些社区资源获得帮助. 我们使用 GitHub 问题来跟踪错误和特性请求,但处理它们的带宽有限.

为了测试您在Node.js中通用的JavaScript代码,浏览器和反应本地环境, 拜访我们 代码样本 repo。 。 。 .

捐款

此客户端代码是自动生成的. 任何修改在下次修改时都会被覆盖 @aws-sdk/client-qconnect 软件包正在更新. 为了帮助客户,你可以检查我们 生成客户端脚本。 。 。 .

许可证

此 SDK 分布于 Apache 许可证,2.0版本, (中文(简体) ), 更多信息见LICENSE.

客户端命令( 操作列表)

激活Message 模板

命令 API 引用 编号 : 投入 编号 : 产出

创建AIA 代理

命令 API 引用 编号 : 投入 编号 : 产出

创建AIAgentVersion

命令 API 引用 编号 : 投入 编号 : 产出

创建AI 守护

命令 API 引用 编号 : 投入 编号 : 产出

创建AI 守护轨道

命令 API 引用 编号 : 投入 编号 : 产出

创建AIPrompt

命令 API 引用 编号 : 投入 编号 : 产出

创建AI PromptVersion

命令 API 引用 编号 : 投入 编号 : 产出

创建助手

命令 API 引用 编号 : 投入 编号 : 产出

创建助理协会

命令 API 引用 编号 : 投入 编号 : 产出

创建内容

命令 API 引用 编号 : 投入 编号 : 产出

创建关联

命令 API 引用 编号 : 投入 编号 : 产出

创建知识库

命令 API 引用 编号 : 投入 编号 : 产出

创建Message 模板

命令 API 引用 编号 : 投入 编号 : 产出

创建 Message 模板标签

命令 API 引用 编号 : 投入 编号 : 产出

创建 Message 模板版本

命令 API 引用 编号 : 投入 编号 : 产出

创建快速响应

命令 API 引用 编号 : 投入 编号 : 产出

创建会话

命令 API 引用 编号 : 投入 编号 : 产出

解除Message 调试

命令 API 引用 编号 : 投入 编号 : 产出

删除插件

命令 API 引用 编号 : 投入 编号 : 产出

删除AIAgentVersion

命令 API 引用 编号 : 投入 编号 : 产出

删除AI 守护

命令 API 引用 编号 : 投入 编号 : 产出

删除AI 守护轨道

命令 API 引用 编号 : 投入 编号 : 产出

删除AI Prompt

命令 API 引用 编号 : 投入 编号 : 产出

删除AI PromptVersion

命令 API 引用 编号 : 投入 编号 : 产出

删除助理

命令 API 引用 编号 : 投入 编号 : 产出

删除助理协会

命令 API 引用 编号 : 投入 编号 : 产出

删除内容

命令 API 引用 编号 : 投入 编号 : 产出

删除关联

命令 API 引用 编号 : 投入 编号 : 产出

删除导入工作

命令 API 引用 编号 : 投入 编号 : 产出

删除知识库

命令 API 引用 编号 : 投入 编号 : 产出

删除Message 模板

命令 API 引用 编号 : 投入 编号 : 产出

删除Message Template 选项

命令 API 引用 编号 : 投入 编号 : 产出

删除快速回复

命令 API 引用 编号 : 投入 编号 : 产出

获取助手

命令 API 引用 编号 : 投入 编号 : 产出

GetAI 守护者

命令 API 引用 编号 : 投入 编号 : 产出

获取AI Prompt

命令 API 引用 编号 : 投入 编号 : 产出

获取助理

命令 API 引用 编号 : 投入 编号 : 产出

获取助理协会

命令 API 引用 编号 : 投入 编号 : 产出

获取关联

命令 API 引用 编号 : 投入 编号 : 产出

获取关联

命令 API 引用 编号 : 投入 编号 : 产出

获取内容摘要

命令 API 引用 编号 : 投入 编号 : 产出

获取导入工作

命令 API 引用 编号 : 投入 编号 : 产出

获取知识库

命令 API 引用 编号 : 投入 编号 : 产出

获取Message 模板

命令 API 引用 编号 : 投入 编号 : 产出

获取下一个消息

命令 API 引用 编号 : 投入 编号 : 产出

获取快速响应

命令 API 引用 编号 : 投入 编号 : 产出

获取建议

命令 API 引用 编号 : 投入 编号 : 产出

获取会议

命令 API 引用 编号 : 投入 编号 : 产出

列表AIA代理人

命令 API 引用 编号 : 投入 编号 : 产出

列表AIAgents 参数

命令 API 引用 编号 : 投入 编号 : 产出

ListAI 守护栏

命令 API 引用 编号 : 投入 编号 : 产出

ListAI 守护轨道

命令 API 引用 编号 : 投入 编号 : 产出

ListAI 程序

命令 API 引用 编号 : 投入 编号 : 产出

ListAI 进展

命令 API 引用 编号 : 投入 编号 : 产出

列表助理协会

命令 API 引用 编号 : 投入 编号 : 产出

列表助手

命令 API 引用 编号 : 投入 编号 : 产出

列表关联

命令 API 引用 编号 : 投入 编号 : 产出

列表内容

命令 API 引用 编号 : 投入 编号 : 产出

列表导入工作

命令 API 引用 编号 : 投入 编号 : 产出

列表知识库

命令 API 引用 编号 : 投入 编号 : 产出

列表

命令 API 引用 编号 : 投入 编号 : 产出

列表模板

命令 API 引用 编号 : 投入 编号 : 产出

ListMessage 模板参数

命令 API 引用 编号 : 投入 编号 : 产出

列表模式

命令 API 引用 编号 : 投入 编号 : 产出

列表快速响应

命令 API 引用 编号 : 投入 编号 : 产出

列表扩展

命令 API 引用 编号 : 投入 编号 : 产出

列表标签格式资源

命令 API 引用 编号 : 投入 编号 : 产出

通知收到的建议

命令 API 引用 编号 : 投入 编号 : 产出

倒车

命令 API 引用 编号 : 投入 编号 : 产出

查询助理

命令 API 引用 编号 : 投入 编号 : 产出

注册助理

命令 API 引用 编号 : 投入 编号 : 产出

注册知识库ReplicaKey

命令 API 引用 编号 : 投入 编号 : 产出

删除助手

命令 API 引用 编号 : 投入 编号 : 产出

删除知识库TemplateUri

命令 API 引用 编号 : 投入 编号 : 产出

渲染介质

命令 API 引用 编号 : 投入 编号 : 产出

获取

命令 API 引用 编号 : 投入 编号 : 产出

搜索内容

命令 API 引用 编号 : 投入 编号 : 产出

搜索磁盘

命令 API 引用 编号 : 投入 编号 : 产出

搜索快速响应

命令 API 引用 编号 : 投入 编号 : 产出

搜索会议

命令 API 引用 编号 : 投入 编号 : 产出

发送消息

命令 API 引用 编号 : 投入 编号 : 产出

开始装入

命令 API 引用 编号 : 投入 编号 : 产出

开始导入工作

命令 API 引用 编号 : 投入 编号 : 产出

标签资源

命令 API 引用 编号 : 投入 编号 : 产出

调和资源

命令 API 引用 编号 : 投入 编号 : 产出

更新AIA 代理

命令 API 引用 编号 : 投入 编号 : 产出

更新AI 守护者

命令 API 引用 编号 : 投入 编号 : 产出

更新AI Prompt

命令 API 引用 编号 : 投入 编号 : 产出

更新助手

命令 API 引用 编号 : 投入 编号 : 产出

更新内容

命令 API 引用 编号 : 投入 编号 : 产出

更新“ 知识” 数据库

命令 API 引用 编号 : 投入 编号 : 产出

更新Message 模板

命令 API 引用 编号 : 投入 编号 : 产出

更新Message Template气象数据

命令 API 引用 编号 : 投入 编号 : 产出

更新快速响应

命令 API 引用 编号 : 投入 编号 : 产出

更新会议

命令 API 引用 编号 : 投入 编号 : 产出

更新会议数据

命令 API 引用 编号 : 投入 编号 : 产出

版本与发布记录

@aws-sdk/client-qconnect 共发布 428 个版本,首次发布于 2023/11/29;过去 12 个月发布了 223 个版本。

版本发布日期距今
3.1164.0latest2026/11/07今天
3.1163.02026/11/061 天前
3.1162.02026/11/052 天前
3.1161.02026/10/318 天前
3.1160.02026/10/309 天前
3.1159.02026/10/2910 天前

关于 @aws-sdk/client-qconnect 的常见问题

@aws-sdk/client-qconnect 是什么?

JavaScript QConnect 客户端的 AWS SDK 为 Node.js , 浏览器和 React Independent

如何安装 @aws-sdk/client-qconnect?

在项目目录运行 npm install @aws-sdk/client-qconnect,或使用 pnpm add / yarn add / bun add。

@aws-sdk/client-qconnect 支持 TypeScript 吗?

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

@aws-sdk/client-qconnect 支持 ESM 还是 CommonJS?

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

@aws-sdk/client-qconnect 需要什么版本的 Node.js?

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

@aws-sdk/client-qconnect 可以商用吗?

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

@aws-sdk/client-qconnect 的下载量有多少?

根据 npm 官方下载统计,@aws-sdk/client-qconnect 在 2026/10/08 – 2026/11/06 这 30 天内被下载 60,675 次,日均约 2,023 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@aws-sdk/client-qconnect 还在维护吗?

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