AngusAI 是一个智能体开发平台，接上已有模型，发布后再进对话。公司文档、工具和固定流程挂到同一个智能体上，先发布，再从「AI对话」或「进入对话」试。已有客户端走 Web、嵌入或 OpenAI 兼容 API，认的是同一个已发布编码。模型用已经买好或自己部署的。文档、会话和出站凭证留在这次安装里。平台不训练模型。
解决的主要问题
- 搭一个智能体，往往要改配置文件或写代码，页面上配不完，非技术人员用起来费劲。向导在页面上依次填完基本信息、对话配置、关联资源和 MCP 集成。
- 挂到智能体上的模型、知识库、工具、数据集和工作流散在各处，没有一处集中管理。这些资源先在各自页面维护，再在「关联资源」里挂到这个智能体上。
- 密钥写在提示词里，输入和输出也没有按这个智能体限制。出站凭证放进秘钥中心，智能体只留引用。输入护栏和输出护栏挂在这个智能体上。推理模式决定它只回答，还是会调工具、先规划再执行。
- 排障步骤、常用接口和固定顺序留在个人脚本里，换一个智能体就重写。文档收成知识库，接口收成接口集，顺序固定的步骤收成工作流或编排，操作说明收成技能。编排和技能带版本，下一次挂的是这一版。
注意: 检索、编排和鉴权不会合成一套已经替你选好的默认值。知识库运行时做的是向量语义检索。创建页上可以看见混合检索、Reranker 和 Query 改写，这些开关在当前运行时并不生效。管理里的「API密钥」还没有接到对话鉴权上，调对话用的是用户令牌或个人访问令牌。不要把「API密钥」当成已经能调通对话的凭证。扫描件和截图不会自动变成文字，平台不内置 OCR。实时音视频、纯图像识别、以及拿掉中间这层编排之后的毫秒级推理，都不在这个产品里做。
主要功能
「概览」是登录后的第一屏。这一屏用来看应用用量和最近动态，并进入常用功能。
模型。 对话和向量化都指向这里接进来的端点。侧栏「模型」按类型添加，并做连接测试。对话用 CHAT 模型，知识库向量化用嵌入模型。提供商是 OpenAI、Anthropic、通义千问、智谱 AI、DeepSeek、Google Gemini、Ollama、月之暗面 Kimi、百川智能、xAI Grok、OpenRouter、AWS Bedrock、Google Vertex AI、Cohere，以及「其他」。没有单独的 Mistral 项。「其他」用来填 OpenAI 兼容端点，例如你自己的 vLLM。某一类任务没在智能体上指定模型时，就用这一类的默认模型。连接测试没过，后面的发布只是把一个还没接通的名字挂上去。
知识库和向量源。 创建知识库时要先选向量存储源。上传的是文本：TXT、PDF、DOCX、Markdown、HTML、JSON、XML、YAML。扫描件要先在外面做成文本再传。文档还在处理时就去问，回答会像没读过。运行时召回的是向量语义检索，不是创建页上勾了、当前却并不执行的那几项。
智能体。 侧栏「智能体」，地址是 /agents。向导四步：基本信息、对话配置、关联资源、MCP 集成。点完成之后徽章是「离线」。列表上点「发布」才变成「已发布」。应用向导、OpenAI 兼容口和对话运行都要求已发布。列表没有页内试聊，也没有克隆。要试，先发布，做成应用，再从应用的「进入对话」或侧栏「AI对话」进去。
类型在对话配置里选，默认是通用。换类型不会自动带上提示词或资源。
| 类型 | 控制台名称 | 这一步在决定什么 |
|---|---|---|
general |
通用 | 问答、工具、检索都可能用到 |
chat |
对话 | 少挂外部资源 |
rag |
检索增强 | 下一步应挂知识库。没挂，对话时报错 |
coding |
编码 | 配合工具看代码 |
workflow |
工作流 | 应挂一条已发布的工作流。没挂，对话时报错 |
编码在租户内唯一。字母开头，只含字母、数字、下划线和连字符。OpenAI 兼容口的 model 按这个编码精确匹配，不按显示名。编码以后还能改，已经写进客户端里的 model 会因此 404。
推理模式至少要留一种，默认落在受支持列表里。没配时按问答。
| 值 | 控制台名称 | 什么时候用 |
|---|---|---|
ASK |
问答 | 默认。单轮问答，不主动调工具 |
TOOL_CALL |
工具调用 | 要调工具、接口集、数据集、编排时必须勾上 |
REACT |
ReAct(推理→行动→观察) | 多步想、做、看 |
PLAN |
规划执行 | 先规划再执行 |
REFLECT |
反思重构 | 生成后再自检 |
挂了工具却只留问答，对话里往往不会调工具。需要工具时，受支持列表勾上工具调用，并把默认设成它，或让人在对话页切换。
系统提示词可以写 Markdown。建议问题出现在空会话上，点一下就发出。知识库问答可以写成：只根据检索到的内容回答；没有依据就说明找不到。
高级参数留空则沿用模型或引擎默认。页面上的生效顺序是：请求，然后会话，然后智能体高级参数，然后模型默认，最后系统默认。
记忆默认开情景和语义，还可以开工作和程序。历史滑窗决定带进模型的最近消息条数。长对话变差时先看这个滑窗，再改提示词。详情页不展示记忆，要改得回到编辑向导的第二步。
关联资源。 这一步没有必填项。工作流只列出已发布的。工具、编排、技能只列出已启用的。输入护栏和输出护栏要方向匹配，并且已经启用。rag 至少挂一个知识库。数据集是受控 SQL，不是把整库交给模型随便生成语句。同一页下半区可以给已选工具或编排配启用、秘钥引用和审批。审批渠道可以选网页、Slack、飞书、钉钉或邮件。不需要这些就留空。
工作流、编排、技能。 工作流在画布上把模型调用、知识检索、工具、条件和循环串起来，用定时或 Webhook 触发。智能体只挂已发布的工作流。编排带版本，引擎按这一版写下的步骤执行，顺序是确定的。技能是一份 SKILL.md，前面是名称和说明，后面是正文，模型在需要时读。步骤要画在画布上，用工作流。步骤必须按写下的顺序跑完，用编排。只希望模型在需要时翻一份操作说明，用技能。
工具和接口集。 单条 HTTP、一段脚本或一个 JavaBean，建在「工具」。脚本可以是 Groovy 或 JavaScript。OpenAPI、Swagger 或 Postman 的整包，导入「接口集」。内置工具是一组固定目录，例如检索、格式化、评审和 diff、设计、时间、文本、产物、Schema。工具没启用，关联资源里就选不到。
应用和对话。 人从「应用」进来：控制台对话、分享页或嵌入。公开分享走 /app/share/...。新建应用时勾选的必须是已发布智能体。应用自己也要发布，侧栏「AI对话」里才选得到。Web、嵌入和兼容 API 用的是同一个编码。挂了工具时，对话页的推理方式要选工具调用。对话页可以在受支持列表里改这一次用的模式。
活动和记录。 侧栏「活动」记录谁改了挂载和配置。「消息」是站内收件箱。「分析」看用量和性能趋势，「监控」看会话、消息和反馈。概览上的最近动态，点进去就是这些记录。
应用场景
值班要按仓库里的排障步骤回答，步骤却进不了对话。 先接对话模型和嵌入模型，连接测试通过后再建向量源。知识库选这个向量源，上传 Markdown 和已经是文本的 PDF，等处理完。类型选检索增强，关联这个库，系统提示词写明没有检索依据就说找不到。发布智能体，做成应用再发布，从「AI对话」提问。文档还在处理时去问，会像没读过。没有依据时停在「找不到」，不补一段操作。
发布窗口要确认某个实例的当前状态，对话却答不出系统里的值。 把已有的 OpenAPI 整包放进「接口集」。类型保持通用，受支持推理里勾上工具调用并设为默认，关联这个接口集，然后发布。在「AI对话」里问一个该接口能回答的问题，应能看到一次调用。只有一条 HTTP、没有整包规范时，建在「工具」，不要塞进接口集。没勾工具调用就发布，对话里往往不会发出这次调用。
一次回滚要先确认值班人，再写入回滚记录，顺序不能让模型临场对调。 在「工作流」里把这两步画完并发布。类型选工作流，关联资源里只能挂这条已发布的工作流。智能体发布，应用再发布，对话里走的就是这条流程。工作流没发布，关联列表里不会出现它。
失败栈在流水线日志里，函数说明在仓库里，两边对不上。 类型选编码，挂上已启用的工具，推理模式包含工具调用。发布之后把这段栈贴进「AI对话」。列表上没有试聊按钮。要看它怎么对说明，从这次对话进，或从应用卡片的「进入对话」进。
云上的模型接口不能用，会话也不能离开这台机器。 在「模型」里添加已经部署好的端点，Ollama 或「其他」里的 OpenAI 兼容地址都可以，连接测试通过后再指定给智能体。测试没过就发布，只是把一个还没接通的名字挂上去。文档、会话和出站凭证留在这次安装里。
现有客户端已经按 OpenAI 的地址在调，配完的智能体仍接不进去。 在智能体列表上点发布。兼容口的
model填编码。Web、嵌入和这个兼容口认的是同一个已发布编码。要看回答，从发布后的「AI对话」或应用卡片的「进入对话」进。智能体还是离线时，按这个编码调用会 404。
核心亮点
在页面上把智能体配完。 向导里选类型，挂知识库和工具。通用、对话、检索增强、编码、工作流共用这一套页面。换类型之后，提示词和资源要重新挂。非技术人员在这一套向导里配完。
这个智能体能做什么，打开页面就能审。 知识库、工具、护栏和提示词挂在这一个智能体上。接手的人看的是这份挂载。输入护栏和输出护栏跟着这个智能体。
发布之后，对话和已有客户端才认它。 离线时，应用向导和兼容口都不认它。点发布之后，从「AI对话」或「进入对话」试。Web、嵌入和兼容 API 用的是同一个编码。
经验收成可以再挂一次的资产。 排障文档进知识库，常用接口进接口集。顺序不能改的步骤进工作流或编排，给模型看的说明进技能。编排和技能带版本，下一个智能体挂的是这一版。
推理方式划定它能走多远。 只留问答时，它不主动调工具。要调工具或先规划再执行，把对应模式放进受支持列表，并设成默认。知识库问答没有检索依据，就说明找不到。
模型和数据留在这次安装能碰到的地方。 多家供应商、Ollama 或自己的兼容地址，在「模型」里加一条并做连接测试。密钥放秘钥中心，智能体只留引用。文档和会话留在这次安装里。
部署方式
本包安装 AngusAI，并带上门户。浏览器先打开门户，再打开本产品。有 Docker 时走安装向导，默认是 Docker Compose。没有 Docker，走主机 ZIP。安装机不能访问公网，走离线安装。Kubernetes 的 Helm 目前是预览，不要当成生产安装。
生产用 Linux x86_64。试用可以用 macOS。docker compose version 要能打出版本号。macOS 用当前登录用户跑向导，不要加 sudo，否则 Docker Desktop 挂不上 root 建出来的目录。Linux 要装到 /opt/angus，先把目录所有者改成当前用户。
80 端口空闲。要 HTTPS 时 443 也空闲。8801 和 8802 是应用自己的端口，反向代理会转发，不必对公网开放，但本机上不能被别的程序占用。gm.<你的域名> 和 ai.<你的域名> 解析到这台机器。机器要能访问 https://repo.anguskit.com。安装包从该站的 raw-public 下载，解压目录是 AngusAI-1.0.0。
unzip <安装包>.zip
cd AngusAI-1.0.0
./install.sh
Windows 在 Docker Desktop 里进同一目录，执行 .\install.bat。向导提示是英文。
| 向导提示 | 你输入什么 | 它决定什么 |
|---|---|---|
Install mode |
回车 | Docker Compose。没有 Docker 时不要改这里的选项，改用主机 ZIP |
Access |
输入 2 |
自带反向代理和子域名。回车留在选项 1，那是按端口访问 |
| 反向代理 | 回车 | Caddy。Let's Encrypt 只能配 Caddy。改成 Nginx 时，HTTP 选项是 3，没有 4 |
| 证书 | 必须输入数字，没有默认 | 1 已有 PEM，2 安装包自签，3 Let's Encrypt，4 只用 HTTP |
| 数据库 | 回车 | Compose 在本机起 MySQL 8。已有数据库时再选外部地址 |
| 安装目录 | 回车 | 当前解压目录，即 $ANGUS_HOME |
| 根域名 | example.com 这种根域 |
拼出子域名。填 gm.example.com 会变成 gm.gm.example.com。IP 或 localhost 会停下 |
管理员密码至少 8 位，记在向导外面。不要沿用向导给出的公开默认数据库口令。数据目录只在第一次创建时采用这个口令。之后只改 angus.env 或 docker/.env、不改库里已经存下的口令，应用会连不上。无人值守且没另设管理员密码时，装完到门户个人设置里立刻改掉。默认字符串不写在这里。
证书选 1、2 或 3，打开 https://gm.<你的域名>/，再打开 https://ai.<你的域名>/。选 4，两边都是 http://，走 80，不要写成 :443。自签时浏览器会警告，那是证书类型，不是门户没起来。当前安装包在选 Let's Encrypt 时，仍会为七个产品子域申请证书，即使这台机器只装了本产品和门户。那七个名字都要解析到本机，或者改用通配符证书。只想先用 HTTP 时，证书选 4，不受这条限制。
成功是日志末尾两行：doctor: OK 和 Install finished. 日志在 $ANGUS_HOME/logs/install.log。之后在安装目录执行 ./bin/angusctl.sh doctor 复查。
MCP 接入
没有单独的 MCP 文档页。入口在创建智能体的第四步「MCP 集成」，不需要就点完成。
stdio 要填名称和启动命令。http 或 sse 要填名称和 URL。鉴权引用秘钥中心，不把密钥写进提示词。stdio 注入环境变量 MCP_CREDENTIAL。http 和 sse 注入 Authorization。
服务端默认关。打开后至少选一种传输，http 或 sse。鉴权里 none 和 api-key 会生效。表单上有 oauth2 和 mtls，页面写明暂未支持，不要当成已经能用。
这一步是把智能体接到外部 MCP，或把本智能体暴露成 MCP Server。它不代替发布。服务端开了，智能体仍要是已发布，应用才选得到。
SDK 接入
官方 REST SDK 从 AngusRepo 公开仓安装，版本 1.0.0。Java 构件 angus-ai-sdk，包名 cloud.xcan.angus.sdk.ai。npm 是 @anguskit/angus-ai-sdk。PyPI 是 angus-ai-sdk。Go 模块是 github.com/anguskit/angus-sdk-ai。没有官方 NuGet 包。
认证头是 Authorization: Bearer <access_token>。令牌在个人设置的访问令牌里创建，并选中本应用。示例读取环境变量 ANGUS_ACCESS_TOKEN。不要把管理菜单里的「API密钥」填进这个头，那个密钥还没接入对话鉴权。对话和兼容口用用户令牌或个人访问令牌，并具备相应权限。公开分享不传令牌。
网关 Base URL 是 https://bj-c1-prod-apis.anguskit.com/ai。路径前缀 /api/v1/**，可选 /pubapi/v1/**。/innerapi 不在官方 SDK 里。冒烟请求是 GET /api/v1/agents/type-presets。列工作流是 GET /api/v1/workflows。字段以 API 参考里的 OpenAPI 为准。
SDK 不代替发布。智能体仍是离线时，兼容口按编码调用会 404。工具仍挂在智能体上，不在 SDK 请求里声明 tools。
FAQ
它会训练模型吗？
不会。对话和嵌入都调用你接进来的模型。平台不做训练，也不做微调。
应用向导里找不到刚建的智能体？
还是离线。在智能体列表上点发布，变成已发布之后，应用才勾得到。OpenAI 兼容口的 model 填编码，不是显示名。
对话里不调工具？
受支持推理里没有工具调用，或默认仍是问答。工具未启用，或没挂到关联资源，也会这样。接口集和单条 HTTP 工具是两套对象，挂错入口等于没挂。
从哪登录？
先开 gm.<你的域名>，再开 ai.<你的域名>。HTTP 还是 HTTPS，跟安装时证书那一项一致。不要把 8802 当成对外入口。
扫描版 PDF 能直接做知识库吗？
不能。平台不内置 OCR。先在外面变成文本，再上传。
SDK 能代替控制台发布吗？
不能。SDK 调的是 /api/v1。发布是列表上的一次操作。没发布的智能体，应用和兼容口都不会把它当成可用的 model。
