# 有信 AIP 交付与使用指南

以自然语言为入口，以业务本体为核心，将企业业务需求转化为企业级应用与智能体。

## 了解与开始

### 认识有信 AIP

有信 AIP 是以自然语言为入口、以业务本体为核心的 AI 原生智能平台，将业务需求转化为企业级应用与智能体。您提需求、确认成果。

#### 从目标到业务理解

先说谁遇到什么问题、要交付什么及完成标准。AI 分析客户、订单、员工是什么、如何关联、须遵守哪些规则；请确认符合业务。权限沿用企业已有组织、部门和成员体系，无需重复建组织。了解[业务目标](#描述业务目标)与[业务本体](#确认业务本体)。

> 请梳理售后订单问题，建议跟进方案；通知须负责人确认。

#### 创建、验证并完善成果

确认理解后，可单独创建应用、智能体或组合使用，不必先建应用。用真实样例检查结果、权限、人工审核与失败处理，核对执行记录。用自然语言指出问题和更改范围，修改后重测。参考[企业应用](#创建企业应用)、[企业智能体](#创建企业级智能体)、[验证](#核对业务规则和结果)与[迭代](#用自然语言调整成果)。

#### 发布后持续使用

通过验证后，选私有、有信云或云上 SaaS。支持 PC、H5、小程序、iOS、安卓、企微、钉钉、飞书；智能设备按能力适配。可按需导出应用及智能体完整前后端源码，独立运行或二次开发，不依赖有信平台；不含 AIP 源码，非每项目默认包含。上线后检查结果、权限和异常，按需调整复测。了解[部署](#选择部署方式与源码交付)与[持续保障](#组织与权限)。

---

### 提交需求与费用预估

项目开始前，准备需求文档和相关业务资料，并确定由谁确认需求与交付结果。不必先写成技术方案，先说明业务问题和预期即可。

#### 描述要解决的问题

说明谁在什么场景遇到什么问题、当前如何处理、希望交付什么，以及怎样判断完成。写清首期范围、使用对象、数据限制和重要操作需谁审核。应用与智能体可按需单独创建或组合，不必先建应用。

> 例如：客服每天要整理未回复的客户咨询，希望先归类并给出回复建议；涉及承诺或退款的内容交负责人审核。以分类准确、建议可用且审核范围符合要求作为验收依据。

#### 提交并确认预估

将需求文档交有信 AIP 评估，了解大致积分消耗和部署平台用量费。费用包括 Token 消耗以积分体现，以及部署平台用量费：私有按年，有信云平台和云上 SaaS 按年按使用量。评估不是最终账单，也不代表固定金额。

收到预估后，核对需求范围和部署方式是否符合计划；如需求或方案变化，重新确认预估，再安排项目。

---

## 让 AI 理解业务

### 描述业务目标

#### 准备需求

先说明要解决的工作问题、谁负责确认需求与成果，以及谁实际使用。准备已有需求文档、样例资料和必要的业务背景，注明可用于项目的内容。

#### 描述预期成果

用日常语言说明谁在什么场景遇到什么困难、现在如何处理、希望有信 AIP 交付什么，以及成果要帮助谁完成哪项工作。交付可以是企业应用、智能体，或两者组合。审批、报表和客户管理都可以作为需求例子，具体交付内容按您的业务目标确定。

> 请帮助客服团队缩短订单问题的处理时间，整理查询信息并提出处理建议；信息不足或需要例外处理时，交由负责人确认。

#### 确认完成标准

写清哪些任务需要完成、结果应包含什么、哪些角色参与，以及何时转交人工。选真实业务例子作为检查依据，并约定由谁确认成果是否可用。若需说明客户、订单、员工等信息的含义、关联和规则，请继续查看[业务本体](#确认业务本体)，再据此创建和验证交付成果。

---

### 确认业务本体

#### 先选清楚业务对象

从一项具体工作开始，列出会涉及什么对象，例如客户、订单和员工。说明每个对象在业务中的含义，以及需要记录或处理的内容。业务本体就是这些业务对象、它们之间的关系和适用规则，让 AI 与团队按同一套业务理解开展工作。

#### 描述关联与规则

用自然语言说明对象如何关联、状态如何变化、谁可以查看或处理，以及哪些操作需要负责人确认。可以先描述一个常见场景，不必一次覆盖全部业务。

> 客户可以有多张订单；订单要对应客户和跟进员工。订单发货后更新状态，修改客户归属需负责人确认。

#### 确认 AI 的理解

有信 AIP 会分析描述并形成业务理解。检查对象含义、关联、状态和规则是否符合实际；发现遗漏或理解有误，就补充说明并再次核对。确认后，再按需要创建应用、智能体或组合使用，不必先创建应用。

---

### 系统集成与业务工具

#### 是什么
系统集成是让AIP在获授权的边界内连接企业已有系统与数据来源；API和Webhook是常见集成方式。AIP以业务本体组织业务：定义实体及其属性、关系、状态、动作和规则，让自然语言需求落到业务对象与受约束的操作上。连接方式、可读数据和可执行动作需按项目确认。让外部系统调用AIP的数据与操作，参见[开放平台](#开放平台与-api-对接)。

#### 可以做什么
在确认接口、权限及业务规则后，可设计查询、通知或更新类业务工具（Tool），例如查询订单、发送通知、修改工单。工具应仅使用必要数据，并保留现有组织、权限与审批约束；写入后核对实际记录或回执。集成不等于替换已有系统，也不要求全部重建。

#### 这样向AIP提需求
请说明要连接的系统、业务对象、使用人、要完成的目标、允许读取或变更的内容，以及审批和核验要求。比如：

> 请连接现有订单系统，按客户和日期查询订单；如需更新订单状态，先展示拟变更内容并提交负责人确认，再执行并核对结果。

#### 完成后确认
确认连接对象与授权数据来源、身份范围、字段和动作边界、审批要求、异常处理及验收方式。敏感变量值不得进入对话、日志或公开响应；写入、删除、付款、发布须按授权并复核。以查询结果、实际状态或有效回执验收，不以“请求已发出”代替完成。

---

### 开放平台与 API 对接

#### 是什么
开放平台是AIP向外提供授权访问的接口通道。外部系统通过API（程序之间交互的接口）读取业务数据或调用获批操作；[系统集成](#系统集成与业务工具)侧重AIP连接外部系统，两者可以配合使用。

#### 可以做什么
通过标准接口读取授权应用、业务字段和记录，按权限新增或更新数据；通过已配置的自定义接口调用业务操作。业务本体中的属性、关系和规则帮助明确接口传什么、允许做什么，具体接口与可用范围按项目确认。

#### 这样向AIP提需求
说明调用方、目标应用、数据范围、允许操作和验收要求。例如：

> 请让现有订单系统查询指定客户的订单状态；只开放必要的查询接口。需要更新状态时，校验身份和业务规则，经负责人确认后执行，再读取结果核验。

#### 接入后确认
由授权人员配置调用凭据、应用与接口权限及来源IP白名单，使用访问令牌验证身份。令牌不等于全部数据权限；密钥和令牌留在受控服务端，不进入前端、对话或日志。先验证读取范围，再验证写入和异常处理，不默认关闭规则或审批。独立部署的接口地址与鉴权按项目交付确认，不要求使用有信托管地址。

---

## 创建交付成果

### 创建企业应用

#### 明确目标与准备

先说清谁遇到什么问题、要交付什么、怎样算完成。整理需求文档，列出使用者、业务数据、关键步骤和规则。沿用已有组织、部门及成员体系，无需重复创建。可看[项目估算](#提交需求与费用预估)和[业务目标](#描述业务目标)。

#### 说明需要的业务能力

确认客户、订单等业务本体的关系与规则，再说明需要的能力：用[仪表盘](#仪表盘与业务看板)看趋势，用[报表](#报表与指标分析)核对指标，用[审批](#审批与业务流程)控制流转，用[自动化](#自动化与智能体协同)处理符合条件的工作。明确指标、角色和异常处理；并非所有应用都必须包含这些能力。应用与智能体可独立交付或协同。

> 请创建订单应用，关联客户与订单，展示销售趋势和订单明细；大额订单由负责人审批，审批通过后通知销售，各区域只看自己的数据。

#### 验证、调整与交付

用真实样例测试统计口径、流程、权限和异常处理。用自然语言反馈修改范围，再复测。确认后选择私有、有信云或云上 SaaS 发布；支持导出交付应用和智能体的完整前后端源码，独立运行或二次开发，不含平台源码。见[验证](#核对业务规则和结果)、[迭代](#用自然语言调整成果)和[部署](#选择部署方式与源码交付)。

---

### 创建企业级智能体

#### 明确目标并确认业务理解

先明确谁遇到什么问题、要交付什么、怎样算完成，并准备真实业务例子和数据范围。用自然语言说明客户、订单、员工是什么、如何关联及遵守哪些规则。例如，一位客户可有多个订单；取消订单前核对状态并由负责人确认。检查并修正AI对对象、关系和规则的理解，再确认。需用外部数据时参见[数据连接](#系统集成与业务工具)。

#### 创建并验证交付成果

说明任务目标、[业务工具](#系统集成与业务工具)、[权限](#组织与权限)、[审批](#审批与业务流程)和异常处理。智能体可独立创建或与应用组合；[自动化](#自动化与智能体协同)按规则执行，智能体处理需要判断与规划的工作。用真实样例验证资料不足、审核未过与执行失败时的处理，核验重要动作的实际结果。按自然语言反馈更新并复测。

#### 发布并持续使用

确认后选择私有、有信云或云上 SaaS 发布，按目标设备验证适配。支持电脑、手机、协作平台，以及按能力适配的智能眼镜和具身机器人。可导出交付应用和智能体完整前后端源码，独立运行或二次开发，不含平台源码。核对[环境配置](#环境变量与环境配置)，持续收集反馈并复测。见[部署交付](#选择部署方式与源码交付)。

---

### 仪表盘与业务看板

#### 是什么
仪表盘与业务看板把企业数据组织成图表和组件；数据大屏是集中展示形态。图表呈现结果，维度用于分组比较，指标是待计算的业务数值。看板不等同于报表，也不代表AI推理。业务本体中的定义、属性、关系、状态、动作和规则说明数据含义与边界。

#### 可以做什么
看板可按维度汇总指标、比较趋势和分布，并通过筛选聚焦问题。报表侧重筛选、分组、计算及明细展示，也可作为仪表盘数据源；数据集可整合并汇总数据。AIP保留企业数据与组织，权限及审批约束行动；图表不能替代指标口径、授权和业务判断。

#### 这样向AIP提需求
说明业务问题、数据范围、指标、维度、时间口径、筛选条件和查看权限；不确定处先请AIP提问确认。例如：

> 请按月份展示近12个月各地区销售额和订单数，比较同比趋势。先确认取消订单是否排除、销售额的统计口径，以及我有权查看的数据范围，再提出看板方案。

#### 完成后确认
核对指标、范围、时间边界、筛选和汇总口径；抽查明细与代表性数据，并确认访问权限。发布或变更业务数据须经授权、复核，并验证真实结果。

---

### 报表与指标分析

#### 是什么
报表与指标分析，是把业务问题转成有依据的数据观察：明确看什么指标、按什么范围统计、如何分组比较。AIP以业务本体理解企业中的定义、属性、关系、状态、动作与规则，保留既有企业数据和组织，并让权限与审批约束后续行动；分析结果不替代业务授权。

#### 可以做什么
可梳理指标口径、汇总或明细、分析维度、筛选条件、时间范围、公式及数据来源；报表用于筛选、分组、计算和呈现，仪表盘侧重图表与控件的整体展示。数据集、数据流或公式可在适用范围内支持数据整合与计算。导出等能力取决于实际数据源和交付配置，不预设格式或默认具备。

#### 这样向AIP提需求
请说明业务问题、指标含义与计算口径、统计对象、时间范围、筛选条件、分组维度、需要汇总还是明细，以及数据来源或字段；不确定之处可以先请AIP澄清。

> 请按月份和区域统计已完成订单的销售额与订单数，说明销售额口径，排除取消订单，并提供可核对的订单明细。

#### 完成后确认
确认统计范围、关系与粒度、公式、时间边界和数据来源是否符合预期，再用代表性样本核对结果。若数据不足、口径未定或来源不支持，应明确说明；结果需导出或用于后续动作时，另行确认能力、权限与审批要求。

---

### 审批与业务流程

#### 是什么

审批与业务流程把申请、审核、批准或拒绝以及结果流转组织起来，明确责任人、适用条件和状态变化。它把业务本体中的规则落实到办理过程；审批结论不等于后续操作已经执行。

#### 可以做什么

说明发起人、审批角色、适用条件、通过或拒绝后的流转、状态变化及人工确认点。AIP据此梳理流程、规则与待确认事项。具体能力以确认后的需求、权限和交付范围为准，建议不等于授权。

#### 这样向AIP提需求

> 请帮我设计报销流程：员工提交报销单和明细后，由部门负责人、会计、总经理按已确认职责审核；批准后进入待付款，由出纳核对并按授权付款，核实实际结果后再记为已付款。请先与我确认角色、条件、驳回处理和状态规则；未确认前不要执行付款。

#### 完成后确认

核对角色、审批条件、结果流向、状态变化、数据权限、异常处理和人工复核点。审批通过不代表资金已划转；付款须经授权执行并核验真实回执，不能只把状态改为“已付款”。

---

### 自动化与智能体协同

#### 是什么

自动化把触发条件、业务规则和动作连成流程，在符合条件时按授权执行。智能体处理需要理解、判断和规划的任务；两者可以协同，但规则自动化不等于智能体自主决策。

#### 可以做什么

例如，订单确认后通知负责人、状态变化后处理关联事项，或在约定时间执行业务检查。说明何时触发、处理哪些数据、需要什么权限，以及哪些动作必须审批。遇到条件不明、权限不足或执行失败时，交由指定人员处理。

#### 这样向AIP提需求

> 订单确认后核对库存，库存不足时通知负责人；满足发货条件时准备出库，出库前由负责人审批。请说明触发条件、可操作的数据范围和异常处理，完成后核验订单状态。

将重复步骤与需要判断的步骤分开，再决定使用自动化、智能体或两者协同。

#### 完成后确认

用正常、条件不匹配和审批未通过的例子测试。核对触发是否正确、动作是否在授权范围内、通知对象是否正确，并检查实际业务结果；不能把发起操作当成已经成功。

---

## 验证与完善

### 核对业务规则和结果

#### 准备样例

先明确目标、判断标准与参与角色，参照[业务目标](#描述业务目标)。选客户、订单、员工等真实且已处理敏感信息的样例，覆盖正常、信息缺失和规则冲突。核实对象关系及业务条件；有疑问先请业务负责人确认，并参照[业务本体](#确认业务本体)核对关系。

#### 按场景核对

以实际使用者身份检查可见信息、可执行动作和结果是否符合授权。说明预期，要求重要变更未经确认不执行：

> 请核对这笔订单是否符合约定条件；如信息不全，请指出缺项，不要直接执行重要变更。

对照结果、统计口径、状态和关联记录；确认重要步骤的授权、人工复核或审批，并检查执行记录。失败时记录条件、提示和影响，确认没有非预期变更。权限要求见[安全与治理](#组织与权限)。

#### 确认与完善

逐项标记符合或待处理，勿只凭提示判断完成。发现差异，说明样例、期望及调整范围，用自然语言反馈；修改后重测受影响场景与权限，再确认结果。调整方法见[迭代完善](#用自然语言调整成果)。

---

### 用自然语言调整成果

#### 整理调整目标

说明当前成果、遇到的问题、使用者和受影响的业务环节。明确希望改变什么、哪些内容应保留，以及如何判断调整完成。先核对相关业务关系与规则，必要时参照[业务目标](#描述业务目标)和[业务本体](#确认业务本体)。

#### 用自然语言说明变更

描述具体场景、期望行为、适用角色及变更边界；可只调整应用、智能体，也可说明两者如何配合。不必把无关部分一并重做。

> 请调整订单处理：销售提交后由负责人审核，保留已有订单记录；运营只查看进度。请列出改动并让我确认后再应用。

检查AI对需求的理解，补充遗漏后确认调整方案。涉及重要业务操作时，确保授权并安排必要的人审或审批。

#### 重新验证并完善

使用真实或脱敏样例走查关键流程、角色权限、异常输入和失败情形，确认结果符合预期。若不符，用自然语言指出具体样例、实际结果和期望结果，并限定再次修改范围；每轮修改后重新测试。参考[验证成果](#核对业务规则和结果)完成检查。

---

## 发布与交付

### 选择部署方式与源码交付

#### 选择部署方式

准备时，梳理使用者、业务数据管理方、运维责任及所需终端。描述业务目标、数据边界和运维安排，再选择私有、有信云平台或云上 SaaS。终端包括 PC、H5、小程序、iOS、安卓、企微、钉钉、飞书及智能设备；智能眼镜和具身机器人按设备能力适配。确认方案符合企业的数据管理和运维安排。

#### 确认源码交付

如需自主管理或二次开发，请在项目交付范围中明确提出导出企业应用与智能体完整前后端源码。源码可独立运行，不依赖有信平台；它是企业成果，不是有信 AIP 平台源码。支持导出不代表每个项目默认包含源码包，交付前确认是否纳入本项目。

#### 评估项目费用

费用分两类：Token 消耗以积分体现；部署平台用量费。私有部署按年计费；有信云平台和云上 SaaS 按年、按使用量计费。项目开始前可提交需求文档，评估大致积分消耗和部署费；预估不是最终账单。

---

### 环境变量与环境配置

#### 是什么

环境变量用于保存运行时的可变配置，例如服务地址、连接参数和业务开关。测试与生产可以使用不同的配置，而不必在每次修改地址时改写业务规则。它不是业务数据，也不能代替权限与审批。

#### 可以做什么

说明哪些参数会变化、各自的用途和类型，以及未填写时如何处理。区分测试与生产的连接地址，核对相关系统的访问权限。敏感密钥由有权限的人员按部署方案配置，不写进对话、公开页面或日志。

#### 这样向AIP提需求

> 请将订单系统的服务地址与校验规则分开管理，分别设置测试和生产配置；检查参数缺失时的处理，测试连接结果，不在回复或日志中展示密钥。

同时说明谁负责配置、需要连接哪些系统，以及怎样判断连接正确。普通业务参数与敏感凭据分别管理。

#### 完成后确认

核对参数、类型、缺失处理与目标环境，确认连接和业务规则都正常。修改生产配置前确认授权与影响，完成后验证结果；不要只凭“配置已保存”判断系统已经可用。

---

### 发布到不同终端

#### 发布前准备

明确谁遇到什么问题、希望交付什么、如何判断完成，参见[梳理业务目标](#描述业务目标)。说明客户、订单、员工分别是什么、如何关联、须遵守哪些规则，并确认AI理解正确，参见[业务本体](#确认业务本体)。例如：

> 销售用手机查询客户和订单；折扣申请由主管审核并留记录。

应用、智能体可单独创建或组合，无需先创建应用。沿用已有组织、部门、成员体系，明确角色权限。

#### 选择发布方式与终端

按数据管理和运维责任选择私有、有信云或云上SaaS。选用PC、H5、小程序、iOS、安卓、企微、钉钉或飞书；智能眼镜、具身机器人按设备能力适配。已有系统满足需求可保留，明确新增交付范围。支持按需导出企业应用及智能体完整前后端源码，可独立运行、二次开发；不是平台源码，也不代表每个项目默认交付源码包。

#### 验证后交付

用真实样例走查各终端，检查结果、权限及失败处理。重要动作设置授权、人审或审批，并核对执行记录。用自然语言指出问题和修改范围，再测试相关流程与终端，参见[验证与完善](#核对业务规则和结果)和[治理与保障](#组织与权限)。

---

## 持续使用与保障

### 组织与权限

#### 是什么

有信AIP以自然语言分析业务本体，经用户确认后交付企业级应用和智能体。业务本体包含定义、属性、关系、状态、动作和规则；组织与权限明确谁能对什么数据做什么。优先沿用企业已有组织、部门和成员，不另建目录。

#### 可以做什么

围绕角色、数据范围和操作权限梳理授权，并把审批、人工确认纳入行动约束。智能体不得越权，也不能自行授予权限；角色权限不等于租户隔离，行级权限全链路仍须实际验证。

#### 这样向AIP提需求

说明组织、人员、数据范围、允许操作和审批人；请AIP先列授权草案与待确认问题，再按确认结果实施。

> 沿用现有部门和成员，规划销售人员的客户数据范围与操作权限；先列角色、审批建议和待确认项，经我确认后再实施并记录验证结果。

#### 完成后确认

用真实业务样例检查不同成员能否访问和处理职责范围内的信息，并确认无关人员不可见。操作完成后核对业务结果、处理状态和执行记录，确保与授权及人工决定一致。发现异常或结果不符时，停止后续操作，交由负责人查明并修正。

---

### 积分与平台用量费用

#### 费用由哪两部分组成

有信 AIP 只有两类费用：AI 使用产生的 Token 消耗以积分体现；部署平台用量费按发布方式计算。私有部署按年计费；有信云平台和云上 SaaS 按年并按使用量计费。两部分分别核算，具体计费标准与积分规则可在费用评估时确认。

#### 开始前怎样预估

准备现有需求文档，写清谁遇到什么业务问题、希望交付什么、预计使用范围，并说明计划采用的部署方式。项目开始前，可将文档交由有信 AIP 评估大致积分消耗和部署平台用量费。收到预估后，确认需求范围及部署方式是否准确；有调整时先补充说明再评估，以便按一致范围讨论费用。预估用于预算参考，不是最终账单。实际费用依项目使用情况及约定核算。

#### 常见问题

**创建应用或智能体会增加第三类费用吗？**不会，费用仍为积分消耗和部署平台用量费。

---

### 常见问题

#### 怎样开始并确认成果？

先说明要解决的问题、希望交付什么，以及由谁确认结果。准备业务资料与真实样例，用自然语言提出需求；确认 AI 的业务理解后再创建，用样例验证成果。需要调整时说明问题并复测。参阅[业务目标](#描述业务目标)和[验证与完善](#核对业务规则和结果)。

#### 业务本体是什么？

它描述客户、订单、员工等业务对象是什么、彼此怎样关联、要遵守哪些规则。例如一个客户可以有多个订单，每个订单属于一个客户，状态变化遵循企业规则；员工负责客户时，也要明确谁能查看或修改。请确认AI对这些关系和规则的理解，必要时补充修正。了解[业务本体](#确认业务本体)。

#### 应用、智能体和已有系统如何安排？

应用与智能体可以分别创建，也可组合交付，不必先创建应用。已有系统不必全部重建，可从一个需求开始，按需连接现有数据和流程。成员权限沿用企业已有组织、部门和成员体系，不必重复新建组织。

#### 费用和发布有哪些选择？

费用只有 Token 消耗（以积分体现）和部署平台用量费：私有按年；有信云平台、云上 SaaS 按年按使用量。项目开始前可提交需求文档评估大致费用，预估不是最终账单。可选私有、有信云或云上 SaaS 发布。支持导出交付应用与智能体的完整前后端源码，可独立运行、二次开发；不含平台源码。
