# 盘古Bot

> 快速构建开箱即用的企业级大模型对话机器人

## 产品介绍

- [什么是盘古Bot](https://support.huaweicloud.com/productdesc-pangubot/pangubot_01_0002.md): 盘古Bot（Pangubot）是专为大模型场景全面升级的智能对话中枢，提供包括意图识别、纠错改写、知识增强问答等关键对话能力。它能够与大模型结合使用，打造端到端的开箱即用对话平台，帮助企业快速构建、发布和管理基于知识库的智能问答机器人系统。仅“西南-贵阳一”区域支持开通和使用盘古Bot服务。盘古Bot服务是受限使用阶段，如果有试用需求，请
- [产品优势](https://support.huaweicloud.com/productdesc-pangubot/pangubot_01_0003.md): 知识接入种类“全”：支持20+类型文档接入，满足用户多种知识源归一的多场景需求。广泛的文档支持：盘古Bot支持多种类型的文档接入，包括但不限于PDF、Word、Excel、PPT、TXT、HTML、Markdown等。这确保了企业内部的各种知识资源可以无缝集成到知识管理系统中。多源知识归一：无论是企业内部的政策文档、产品手册、技术文档，还
- [应用场景](https://support.huaweicloud.com/productdesc-pangubot/pangubot_01_0004.md): 提供高效自助式智能服务，可为外部用户和企业内部员工提供7*24小时实时在线的智能客服服务。支持一键部署MaaS支持一键部署各种模型、适配客户多样化场景需求和未来模型的升级迭代。MaaS支持一键部署各种模型、适配客户多样化场景需求和未来模型的升级迭代。准确率高盘古Bot内置智能客服方案，通过workflow、Agent复杂任务编排，实现复杂
- [产品功能](https://support.huaweicloud.com/productdesc-pangubot/pangubot_01_0005.md): 以下是产品主要功能：文档知识指的是以文档形式存在的知识，如pdf、doc/docx、txt、markdown格式的文档。将文档关联到助手后，助手可以根据用户提问从文档中召回相关知识，然后结合LLM给出最终答案。有关更多信息，请参见用户指南。常见问题（FAQ）是指高频率提问的问题以及它对应答案，可以维护在FAQ知识中。智能对话助手内置大模型
- [身份认证与访问控制](https://support.huaweicloud.com/productdesc-pangubot/pangubot_01_0008.md): 用户可以通过调用REST网络的API来访问盘古Bot服务，有以下两种调用方式：Token认证：通过Token认证调用请求。AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求。经过认证的请求总是需要包含一个签名值，该签名值以请求者的访问密钥（AK/SK）作为加密因子，结合请求体携带
- [数据保护技术](https://support.huaweicloud.com/productdesc-pangubot/pangubot_01_0009.md): 盘古Bot服务通过多种数据保护手段和特性，保障存储在服务中的数据安全可靠。
- [认证证书](https://support.huaweicloud.com/productdesc-pangubot/pangubot_01_0011.md): 华为云服务及平台通过了多项国内外权威机构（ISO/SOC/PCI等）的安全合规认证，用户可自行申请下载合规资质证书。合规证书下载华为云还提供以下资源来帮助用户满足合规性要求，具体请查看资源中心。资源中心华为云安全服务提供了网络安全专用产品安全检测证书、软件著作权等证书，供用户下载和参考。具体请查看合规资质证书。合规资质证书
- [约束与限制](https://support.huaweicloud.com/productdesc-pangubot/pangubot_01_0014.md): 本节介绍盘古Bot在使用过程中的约束和限制。盘古Bot的规格限制详见表1。盘古Bot的配额限制详见表2。如需单独调整配额，请联系客服。
- [与其他服务的关系](https://support.huaweicloud.com/productdesc-pangubot/pangubot_01_0016.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [基本概念](https://support.huaweicloud.com/productdesc-pangubot/pangubot_01_0017.md): 智能对话助手，也称为聊天机器人或虚拟助手，是一种基于人工智能技术的应用程序，能够通过文本或语音与用户进行自然语言交流。这种技术的核心在于理解和生成自然语言，以实现与人类的高效沟通。智能对话助手的应用范围非常广泛，包括但不限于客户服务、个人助理、教育辅导、娱乐互动等领域。技能编排是指用流程图的方式，提高智能对话系统配置的效率，提升多轮对话的

## 快速入门

- [如何创建一个助手并进行问答体验](https://support.huaweicloud.com/qs-pangubot/pangubot_02_0001.md): 本章节为您提供了一个使用盘古Bot服务的示例，您可以参考此示例来了解盘古Bot服务，包括创建助手、上传文档、创建FAQ、创建对话流等操作。仅“西南-贵阳一”区域支持开通和使用盘古Bot服务。盘古Bot服务是受限使用阶段，如果有试用需求，请提工单申请权限。在现代企业中，智能问答助手已经成为提高客户服务效率的重要工具，场景知识问答、FAQ问答

## 用户指南

- [使用流程](https://support.huaweicloud.com/usermanual-pangubot/pangubot_03_0002.md): 盘古Bot（Pangu Bot）是专为大模型场景全面升级的智能对话中枢，提供包括意图识别、纠错改写、知识增强问答等关键对话能力。它能够与大模型无缝结合，打造端到端的开箱即用对话平台。盘古Bot旨在帮助企业快速构建、发布和管理基于知识库的智能问答助手系统，提升效率和用户体验。以下为您介绍服务使用流程。
- [准备工作](https://support.huaweicloud.com/usermanual-pangubot/pangubot_03_0004.md): 盘古Bot服务不提供生成能力，因此使用本服务前需要您先购买或部署华为云相关大模型服务，为您提供生成能力。本服务支持使用两种大模型：盘古大模型和昇腾云开源大模型。盘古系列大模型围绕 “基础能力支撑 - 行业场景适配 - 专业需求落地 - 外部补充拓展” 的逻辑，构建了多层次模型矩阵，满足不同领域的应用需求，在此，我们主要使用NLP（自然语言
- [开通服务](https://support.huaweicloud.com/usermanual-pangubot/pangubot_03_0003.md): 本节内容为您介绍如何开通盘古Bot，以及购买前需要完成的注册华为账户、开通华为云以及实名认证的操作步骤。仅“西南-贵阳一”区域支持开通和使用盘古Bot服务。盘古Bot服务是受限使用阶段，如果有试用需求，请提工单申请权限。目前只支持购买一个服务。如果您已有一个华为账号，请跳到下一个步骤。如果您没有华为账号，请参考以下步骤创建。打开华为云网站
- [创建知识库](https://support.huaweicloud.com/usermanual-pangubot/pangubot_03_0009.md): 在使用盘古Bot时，您可以先新建知识库，然后将知识上传到知识库中。在后续的问答过程中，系统会根据您上传的知识进行作答。知识库中支持上传文档以及创建FAQ问答。登录盘古Bot控制台。在左侧导航栏选择“知识管理”。单击知识管理下面的按钮，创建知识库。支持创建不同语种的知识库。创建知识库
- [上传文档](https://support.huaweicloud.com/usermanual-pangubot/pangubot_03_0012.md): 文档知识指的是以文档形式存在的知识，如pdf、doc/docx、txt、markdown格式的文档。将文档关联到助手后，助手可以根据用户提问从文档中召回相关知识，然后结合LLM给出最终答案。本文介绍了文档知识的上传、删除、修改操作。支持格式为 .doc, .docx, .pdf, .pptx, .ppt, .wps, .png, .jpg
- [创建FAQ](https://support.huaweicloud.com/usermanual-pangubot/pangubot_03_0013.md): 常见问题（FAQ）是指高频率提问的问题以及它对应答案，可以维护在FAQ知识中。智能对话助手内置大模型的理解能力，可通过设置高频问答知识，对文档中难以回答的问题进行干预解决。本文介绍了FAQ知识的创建以及删除、修改操作。登录盘古Bot控制台。在左侧导航栏选择“知识管理”。单击“FAQ管理”页签，单击问答分类下边的“新增分类”按钮，填写“分类
- [助手简介](https://support.huaweicloud.com/usermanual-pangubot/pangubot_03_0006.md): 智能对话助手，是一种基于人工智能技术的应用程序，能够通过文本或语音与用户进行自然语言交流。这种技术的核心在于理解和生成自然语言，以实现与人类的高效沟通。要实现盘古Bot服务能够“智能”地回答用户问题，需要按以下步骤进行智能对话助手配置：创建助手：创建助手。“赋予”助手有关业务知识：配置助手。对具有知识的助手的问答效果进行测评，以保证助手的
- [创建助手](https://support.huaweicloud.com/usermanual-pangubot/pangubot_03_0007.md): 登录盘古Bot控制台。在左侧导航栏选择“助手管理”。单击“助手管理”页签上的“新增助手”按钮。新增助手在弹出的新增助手页面，填写“助手名称”、“助手简介”并选择“语种”。参数说明助手名称自定义助手名称。名称由大小写字母、汉字、数字、井号（#）、连字符（-）、下划线（_）组成，长度为1~63位。助手简介描述助手，不超过512个字符。语种目前
- [配置助手](https://support.huaweicloud.com/usermanual-pangubot/pangubot_03_0008.md): 配置助手主要是配置助手知识、问答参数、大模型、技能，完成助手的配置，即是赋予助手有关问答能力，使问答更加准确。已准备好大模型，详情请参考准备工作。如果需要关联知识库，请准备好相关知识，知识的创建请参考创建及管理知识库。在左侧导航栏选择“助手管理”。选择需要配置的助手，单击“设置”，进入助手管理配置页面。配置助手单击可以修改助手名称和描述。
- [查看助手对话日志](https://support.huaweicloud.com/usermanual-pangubot/pangubot_03_0015.md): 为了方便用户使用日志定位问题，盘古Bot服务提供了日志查询功能。用户可以通过日志查询进行问题分析定位。登录盘古Bot控制台。在左侧导航栏选择“助手管理”。选择需要查看日志的助手单击“设置”进入。在助手详情页面左侧导航栏单击“对话日志”进行日志查询。可在搜索框中通过搜索关键词定位日志。可单击操作列的“查看JSON”查看日志JSON详情。可在
- [体验对话助手](https://support.huaweicloud.com/usermanual-pangubot/pangubot_03_0010.md): 配置并发布好助手之后，就可以进行问答体验。有以下几个体验入口：登录盘古Bot控制台。单击左侧导航栏的“对话体验”页签，再单击右上方的小机器人标志，选择创建并配置好的助手。对话体验在输入框中输入您的问题并单击回车，查看结果。单击左侧导航栏的“助手管理”。选择配置好的助手单击“设置”进入。单击右上角的“体验”，体验对话。还可以单击对话窗口中的
- [技能编排简介](https://support.huaweicloud.com/usermanual-pangubot/pangubot_03_0031.md): 在智能对话系统中，技能是指助手在某个场景下通过多轮对话可完成的任务，例如订机票、查天气等。完成这些任务往往需要获取用户的关键信息，比如预定什么时间、目的地是哪里的机票。通过技能的形式，助手可以高效地收集这些关键信息，并最终完成用户发出的任务。然而，实际应用中，用户的需求往往更加复杂和多样化，单一的技能可能无法满足所有需求。因此，技能编排应
- [配置意图开始节点](https://support.huaweicloud.com/usermanual-pangubot/pangubot_03_0037.md): 意图开始节点是对话流程的起始节点。意图是指在问答过程中，助手对用户问题的抽象与识别，简单理解就是无论用户怎么换说法，只要核心目的一致，就属于同一个意图。通过配置意图开始节点，可以设定用户可能用于表达特定意图的输入信息，从而帮助助手更准确地收束对用户问题的解答范围。以查询天气为例，可以设置“查天气”意图及其对应的多种表达方式。当用户的输入与
- [配置信息收集节点](https://support.huaweicloud.com/usermanual-pangubot/pangubot_03_0038.md): 在助手与用户的对话过程中，当助手需要收集问题的关键信息时，可通过配置信息收集的节点，以对用户追问的方式获取到最关键的内容。在左侧基础节点列表中，拖拽收集实体节点到中间空白区域，单击“收集实体”节点界面右侧展开收集实体页签。收集实体在“收集实体”页面，填写参数。实体参数说明参数名称参数说明实体名称实体名称下拉框中选择对应的实体，系统自带常用
- [配置调用节点](https://support.huaweicloud.com/usermanual-pangubot/pangubot_03_0039.md): 在对话流程中，如果需要对接外部内容或其他业务系统，可以使用调用节点，通过调用节点为助手灵活添加多种外部能力。可以使用以下几种调用节点：大模型调用：调用大模型生成内容，并赋值到变量或者实体。API调用：调用Rest接口，解析返回结果，并赋值到变量或实体。自定义调用：调用FunctionGraph，解析返回结果，并赋值到变量或实体。在对话过程
- [配置回复节点](https://support.huaweicloud.com/usermanual-pangubot/pangubot_03_0040.md): 在助手与用户的对话流程中，完成处理节点后，需要配置回复节点，以表示助手回复用户的内容。您可以插入变量或实体，编辑回复内容。对话流程的终结节点必须以回复节点结束。可以选择以下两种方式回复：大模型回复：指的是使用大型语言模型生成的回复。这些模型经过大量数据训练，能够生成自然、流畅且上下文相关的回复。固定模板回复：是指使用预定义的模板生成的回复
- [配置逻辑节点](https://support.huaweicloud.com/usermanual-pangubot/pangubot_03_0041.md): 在多轮对话中，助手需要根据用户的不同输入进行相应的回复和逻辑处理。因此，对话流程中提供了条件判断节点，该节点可以自定义用户的不同输入作为条件分支，引导后续的对话流程。在条件判断节点中，同一个分支内可以增加多种条件，包括“或”和“且”条件。在对话过程中，需要处理多分支结果，以变量、实体的值，配置条件判断节点走到不同的分支。在左上角节点列表中
- [管理实体&变量](https://support.huaweicloud.com/usermanual-pangubot/pangubot_03_0016.md): 概念：实体是在对话过程中，需要收集的核心业务数据，如：城市、日期、颜色、品牌名称等。作用：对同一个意图加上不同的属性时，则会衍生出一个新的意图，如“查天气意图”加上“地址”属性后，则会衍生出“查询杭州天气意图”“查询北京天气意图”“查询江西天气意图”等意图，且所衍生出的各意图对应回复内容不尽相同。通过实体配置则可将此类意图归结为“查询某地

## API参考

- [使用前必读](https://support.huaweicloud.com/api-pangubot/pangubot_04_0001.md): 欢迎使用盘古Bot服务（PanguBot）。盘古Bot服务是针对大模型场景全面升级的智能对话中枢，提供包括意图识别、纠错改写、知识增强问答等关键对话能力，可与大模型结合使用，打造端到端开箱即用的对话平台。本文档提供了盘古Bot服务API的描述、语法、参数说明及样例等内容。通过配合使用这些接口，您可以轻松地使用盘古Bot服务。终端节点（En
- [API概览](https://support.huaweicloud.com/api-pangubot/pangubot_04_0002.md): 盘古Bot提供的接口为符合RESTful API设计规范的自研接口。通过盘古Bot的自研接口，您可以使用盘古Bot的如表1所示的功能。
- [构造请求](https://support.huaweicloud.com/api-pangubot/pangubot_04_0004.md): 本节介绍REST API请求的组成，并以调用IAM服务的管理员创建IAM用户接口说明如何调用API。请求URI由如下部分组成。{URI-scheme}://{Endpoint}/{resource-path}?{query-string}例如您需要创建IAM用户，由于IAM为全局服务，则使用任一区域的Endpoint（比如“西南-贵阳一”
- [认证鉴权](https://support.huaweicloud.com/api-pangubot/pangubot_04_0005.md): 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key)加密调用请求。Token认证：通过Token认证调用请求。AK/SK签名认证方式仅支持消息体大小12MB以内，12MB以上的请求请使用Token认证。AK/SK既可以使用永久访问密钥
- [返回结果](https://support.huaweicloud.com/api-pangubot/pangubot_04_0006.md): 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。对于管理员创建IAM用户接口，如果调用后返回状态码为201，则表示请求成功。对应请求消息头，响应同样也有消息头，如Content-type。对于管理员创建IAM用户接口，返回如图1所
- [问答 SSE - GenerateChatSseAnswer](https://support.huaweicloud.com/api-pangubot/GenerateChatSseAnswer.md): 问答SSE（Server-Sent Events）接口主要用于实现实时或近实时的数据推送。SSE是一种允许服务器向浏览器推送更新的技术，它使用HTTP协议，但与传统的请求-响应模式不同，SSE允许服务器主动向客户端发送数据，而不需要客户端频繁地发起请求。在问答系统中，SSE接口可以用来实现实时的问题回答更新。例如，当用户提交一个问题后，服
- [状态码](https://support.huaweicloud.com/api-pangubot/pangubot_04_0130.md): 状态码如表1所示。
- [错误码](https://support.huaweicloud.com/api-pangubot/pangubot_04_0131.md): 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。
- [获取项目ID和名称](https://support.huaweicloud.com/api-pangubot/pangubot_04_0132.md): 在调用接口的时候，部分请求中需要填入项目ID（project_id）或项目名称（project name），所以需要获取到项目ID和名称。登录盘古Bot控制台。在页面右上角单击用户名，在下拉列表中单击我的凭证，进入“API凭证”页面。在项目列表中查看项目ID和项目（项目即项目名称）。查看项目ID和名称项目ID还可通过调用查询指定条件下的项
- [获取助手ID](https://support.huaweicloud.com/api-pangubot/pangubot_04_0134.md): 在调用接口的时候，部分请求中需要填入助手ID（assistant_id），所以需要获取到助手ID。登录盘古Bot控制台。单击“助手管理”，找到想要调用的助手，单击“设置”按钮。查看助手ID字段。查看ID