AngusAI 是什么：企业私有智能体开发平台-育师

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<安装包>.zipcdAngusAI-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。