你的助手可以用 Aggrega 做什么
你的助手连接到 Aggrega MCP 服务器后,就会使用你在终端中运行的同一个 aggrega 二进制文件工作:它读取 schema 和文档,起草并检查你的文件,构建 Release,并在你允许时进行发布。本页按类别说明这些功能涵盖的范围。服务器自身给出的答案才是完整列表,也是应当信赖的依据:不带参数调用 describe-capabilities,或让你的助手调用,它就会列出服务器为你提供的每个工具,每个工具附有一行用途说明、它服务的实体种类以及它是否会写入。兼容性说明了版本发布可以对这些工具做出哪些更改。
读取 schema 和文档
服务器提供助手在编写 YAML 之前读取的参考资料:实体的 JSON Schema(schema://<kind>)、任意语言参考页面(langref://<path>)、编写指南(authoring://<topic>)、目录实体编写的 YAML(catalog://<kind>/<name>),以及任意命令的帮助(cli://<command>)。schema 内置在二进制文件中,页面则来自服务器保存在你机器缓存中的文档副本。它的作用列出了每一类资源。
扮演角色,或遵循工作流
编写提示将助手设定为开发者、架构师或运维编写者,或使其专注于某一种实体种类,使其建议保持在该角色所编写的范围内。工作流提示为需要多次调用才能达成的目标列出调用顺序:编写新的 Aggregate 及其 Release,将现有的 chart、基础设施模块或 Compose 文件引入 Aggrega,或查明构建失败的原因。你的客户端会将它们列为服务器的提示。
了解工作区包含什么
list-entities 和 list-releases 说明你的工作区包含什么以及数量多少,然后一次一页地交付记录;describe 显示一个实体或某个 Release 所涉及的一切;config-show 报告当前生效的配置以及每项设置的来源。服务器还会报告缓存、已配置的注册表以及它解析的插件。参见了解工作区包含什么。
起草并检查你的文件
scaffold 为某个实体种类起草起始文档,包含该种类要求的字段,或者将文档中的某个可运行示例写入新目录。get-schema 返回某个种类的 JSON Schema,validate 检查草稿并指出其中仍保留的每个占位符,lint 检查目录发布约定,explain-error 将诊断展开为它所要求的修复。其他工具回答编辑过程中出现的问题:哪些 Features 可以附加到某个组件以及它可以连接到什么,新条目在文件中应放在哪里,以及对文档应用一次有界编辑,并保持它未触及的每个字节不变。参见询问可以附加什么,以及什么可以连接到什么和对文档应用一次有界编辑。
解析并构建 Release
pull 将 Release 的依赖解析到缓存中并写入其锁文件,build 将 Release 渲染为其产物,默认在内存中进行,或在助手要求写入时写入工作区根目录下的 dist/。被拒绝的构建会返回说明需要修复什么的诊断。参见解析 Release 的依赖和基于 Release 已固定的内容进行构建。
从其他工具引入项目
import 读取另一个工具生成的描述,并将 Aggrega 草稿文件写入工作区供你审阅。有关它读取的格式,参见将外部描述转换为草稿实体和 aggrega import。
发布、签名和撤回
有四个工具可以将实体或产物放入注册表、为发布在那里的内容签名,或用已签名的标记将其撤回。它们所做的更改会影响所有从该注册表解析的人,而且已经获得这些内容的人无法再被收回其中任何部分,因此在允许使用这些工具之前应当仔细考虑。参见发布、签名和撤回。
运行任意命令
对于在你自己的机器上通过标准输入和输出启动服务器的客户端,服务器还会为你可以输入的每个命令提供一个以该命令命名的工具:cli-build 运行 aggrega build,cli-validate 运行 aggrega validate,依此类推。通过 HTTPS 访问的服务器不提供这些工具。
它无需询问你即可执行的操作
通过标准输入和输出连接的助手可以调用服务器提供的每个工具而无需询问你,除非你的客户端设置为拒绝。你在客户端中按名称允许和拒绝工具。助手无需事先询问你即可执行的操作列出了超出你工作区范围的操作,而缩小服务器公布的内容可在你的客户端无法接受全部工具时缩短工具列表。