kagent 网站与文档站
kagent 与 kMCP 的官方网站和文档源码，用来发布、维护并展示 Kubernetes 原生 Agent 框架的说明与采用者名单。
- Star 数
- ★ 21
- 最近更新
- 2 天前
- License
- Apache-2.0
- 主语言
- TypeScript
- FA 评分
- 30/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台
- 费用
- 免费，无需付费服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 想了解 kagent 是什么、如何用 Kubernetes 构建 AI Agent 的开发者，通过本仓库的站点与文档获得说明。
- 不适合
- 想直接部署 kagent 框架本体的读者，本仓库只是网站与文档
- 没有 kagent 或 kmcp 实际使用经验、只想看演示的团队
这个 Agent 能做什么，适合哪些场景？
这个仓库是 kagent-dev 组织下的 website 项目，定位是 kagent 和 kMCP 的官方网站与文档载体，而不是 kagent 框架本身。仓库以网站形式呈现内容，README 中的图标与 Discord 徽章直接引用了 kagent 主仓库的图片资源和 Discord 服务器链接。仓库提供三条明确的协作路径：本地开发说明写在 DEVELOPMENT.md，贡献流程写在 CONTRIBUTION.md，采用者则通过向 src/data/adopters.yaml 提交 PR 来加入名单。README 明确说明可将公司名称和 logo 加入 adopters 文件，因此站点承担了 kagent / kMCP 生态的采用情况展示职责。内容结构上以站点页面与数据文件为主，文档与站点内容都在此仓库维护。
该仓库承载 kagent 与 kMCP 的网站和文档：它读取并渲染站点内容，通过 src/data/adopters.yaml 维护采用者清单，接受来自社区的 PR 来追加公司名称与 logo。README 引用 kagent 主仓库的图标资源（icon-dark.svg 与 icon-light.svg）作为站点头图，并嵌入 Discord 邀请徽章链接到 bit.ly/kagentdiscord。文档说明分散在 DEVELOPMENT.md（本地运行方法）与 CONTRIBUTION.md（贡献方法）两个文件中；README 只给出指向这两个文件的入口，不包含具体命令。站点输出的结果是可浏览的官网与文档页面，以及公开的 kagent / kMCP 采用者列表。
- 想了解 kagent 是什么、如何用 Kubernetes 构建 AI Agent 的开发者，通过本仓库的站点与文档获得说明。
- 已经在 dev/test 或生产环境使用 kagent 或 kmcp 的公司，想被列入官网 adopters 名单，通过修改 src/data/adopters.yaml 提交 PR。
- 希望为 kagent 官网或文档做贡献的社区成员，按 CONTRIBUTION.md 的流程提交改动。
- 想在本地跑起网站做预览或调试的贡献者，按 DEVELOPMENT.md 的说明进行本地开发。
- 想进入 kagent 社区沟通渠道的人，通过 README 中的 Discord 徽章链接加入服务器。
- 需要把 kMCP 相关内容与 kagent 一并对外说明的维护者，在同一站点内维护两类文档。
如何安装或部署这个 Agent？
本仓库未在 README 中给出可复制的安装或构建命令。README 只说明本地运行方法见 DEVELOPMENT.md，贡献方法见 CONTRIBUTION.md，而这两个文件的内容未在本次源码中提供。因此，具体的包管理器、依赖安装命令、Node.js 或其他运行时版本要求、构建与预览命令，均属于缺失信息，需要打开 DEVELOPMENT.md 才能确定。可以确认的是：仓库以 Apache-2.0 许可发布，进一步的信息请查看仓库中的 DEVELOPMENT.md 与 CONTRIBUTION.md。
如何使用这个 Agent？
作为采用者加入 kagent / kMCP 名单的流程在 README 中有明确说明：向采用者数据文件提交 PR，附上公司名称与 logo。
文件路径: src/data/adopters.yaml
操作: 提交 PR，加入公司名称与 logo除上述采用者流程外，README 未提供站点运行、预览或部署的具体命令；这些步骤在 DEVELOPMENT.md 与 CONTRIBUTION.md 中描述，本次未提供其内容。README 还提供了 Discord 社区入口链接，指向 https://bit.ly/kagentdiscord。
这个 Agent 有哪些优点和局限？
- 职责清晰：仓库专门承载 kagent 与 kMCP 的官网与文档，不会与主框架代码混淆。
- 采用者路径开放且低门槛：只需向 src/data/adopters.yaml 提交带公司名与 logo 的 PR 即可加入名单。
- 社区入口直接：README 内嵌 Discord 邀请徽章，指向 bit.ly/kagentdiscord。
- 采用 Apache-2.0 许可，站点内容与文档可自由使用和再分发。
- 本仓库不是 kagent 框架本体，README 未包含任何框架安装或运行命令，想部署 Agent 的读者需转往主仓库。
- README 把本地运行与贡献说明分别委托给 DEVELOPMENT.md、CONTRIBUTION.md，未提供技术栈、运行时版本或构建命令。
- 缺少环境依赖的明确说明：未列出 Node.js 或包管理器版本，本地启动能否成功无法从 README 判断。
- 采用者名单依赖人工 PR，仓库未说明审核标准或 logo 的格式与尺寸要求。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| kagent 网站与文档站 当前 | 30 · 缺口较多 | 网页应用免费 | ★ 21 | 2 天前 | TypeScript | — |
| Cordum Agent Control Plane | 64 · 存在缺口 | 自托管服务免费 | ★ 511 | 1 天前 | Go | Claude Code |
| HolmesGPT SRE Agent | 57 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 3.6k | 1 天前 | Python | OpenAI API |
| SandBase Harness | 52 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 639 | 7 天前 | TypeScript | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据仅包含 README、LICENSE、package.json 与两个 CI 工作流及两个 Playwright 规格文件。仓库是 kagent 的网站/文档站，不是可安装的 Agent 产品，因此权限最小化、用户确认、敏感数据处理等运行时信任属性在源码中基本无从体现：least_privilege 仅因 CI 中显式声明 permissions: contents: read / issues: write 而给 1 分，未展示任何 Agent 侧权限模型；user_confirmation 无任何确认/审批机制证据，记 0；data_flow_transparency 仅 README 一句框架定位，未说明数据流向，记 1；sensitive_data_handling 无密钥、PII、日志脱敏相关说明，记 0；external_effects 因 CI 会创建 issue、发 Slack、部署 Cloudflare worker 而给 1 分，但无回滚或影响范围说明；rollback 无任何回滚/恢复流程，记 0；dependency_security 有 overrides 固定 postcss/sharp 且 CI action 均按 SHA 固定，属薄证据，记 1；source_attribution 有 Apache-2.0 与上游 kagent 图标引用，但无 NOTICE/来源清单，记 1。
self_consistency 方面，README 描述与 package.json 脚本、CI 注释基本一致，但 README 完全未提及 docs-site/ Hugo 子站与 Next.js 双栈结构，存在文档与仓库实际结构脱节，记 1；dependency_availability 依赖均为公开 npm 包且 CI 固定版本，但无锁文件证据、无离线/镜像说明，记 1；failure_messages 方面 CI 注释详细说明了超时、apt 镜像失败、pipefail 掩盖失败等失败模式并给出处理，属较好证据，但仅限 CI 层面，产品侧无错误信息设计，记 1。
audience_and_scenarios 仅 README 面向贡献者与采用者，未区分 Agent 使用者/运维/开发者场景，记 1；capability_boundaries 未说明该 Agent 能做什么、不能做什么，仅一句框架定位，记 1；trigger_precision 无触发条件、调用契约或输入输出定义，记 1；environment_fit 有本地开发、Cloudflare worker、Hugo 文档站多环境线索，但无环境要求矩阵，记 1。
information_architecture 有 README/LICENSE/package.json/CI/测试目录的基本结构，但无目录说明或导航，记 1；install_notes 仅指向 DEVELOPMENT.md 与 CONTRIBUTION.md，文件未在证据中，无法核实，记 1；naming_stability 包名 kagent-website、脚本命名一致，但无版本化命名策略，记 1；examples_and_faq 无示例与 FAQ，仅 Playwright 规格可视为测试示例，记 1；known_limitations 无已知限制章节，CI 注释中的临时措施（preview overlay、continue-on-error）属内部说明而非用户可见限制，记 1；license 有完整 Apache-2.0 文本，记 2；versioning_changelog 无 CHANGELOG、无版本发布说明，记 0；maintenance_responsibility 有 Discord、贡献指引与 adopters 流程，但发布者身份未验证、无维护者/安全联系渠道，记 1。
output_usability 该仓库产出的是网站与文档，对 Agent 使用者而言无直接可运行产物，记 1；marginal_value 作为 kagent 的文档站有信息价值，但相对 kagent 主仓库属附属，边际价值有限，记 1；cost_benefit 维护双栈（Next.js + Hugo）与多套 CI 成本不低，收益主要是文档呈现，记 1。
claim_traceability README 的框架定位无法在本仓库源码中追溯验证，记 1；cross_source_corroboration README、package.json、CI 之间对仓库结构描述不一致（README 未提 docs-site），交叉印证薄弱，记 1；fact_inference_separation CI 注释明确区分了观察到的现象与推断原因（如 apt 镜像问题），这一点较好，但整体仍以叙述为主，记 1。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 该仓库是 kagent 的网站/文档站，不是可安装的 Agent 产品；不要将其文档内容当作 Agent 运行时安全或可靠性的证据。
- 发布者身份未经验证，README 中的 Discord 与 adopters 流程不构成维护责任或安全响应渠道的证明。
- CI 工作流会创建 issue、向 Slack 频道发送结果并部署 Cloudflare worker，存在外部副作用，但仓库未说明影响范围或回滚方式。
- framework-tests 工作流标记 continue-on-error，测试失败不会阻断合并，不能据此认为测试通过即代表质量达标。
- README 未提及 docs-site/ Hugo 子站，文档与仓库实际结构不一致，按 README 操作可能无法覆盖全部内容。
- 无 CHANGELOG、无版本发布说明、无已知限制章节，版本与兼容性信息缺失。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
What's Changed * Update kagent 1.x reference docs at v1.0.0-alpha13 (version conrefs changed) by @github-actions[bot] in https://github.com/kagent-dev/website/pull/603 * Derive runtime metrics from invocation spans by @Rachael-Graham in https://github.com/kagent-dev/website/pull/602 * Clarify ModelConfig rejection behavior by @Rachael-Graham in https://github.com/kagent-dev/website/pull/604 * Revert npm-minor-patch group bump (#599) to restore kagent.dev by @Rachael-Graham in https://github.com/kagent-dev/website/pull/605 …在 GitHub 查看 ↗ -
v0.10.3 Docs for v0.10.3
发布说明摘录
Point-in-time snapshot of the kagent documentation at the kagent v0.10.3 release. Publishing this release runs Update Reference Documentation against the kagent v0.10.3 tag and opens a pull request regenerating the 0.x API, Helm, and CLI references along with the 0.x version conrefs. See https://github.com/kagent-dev/website/pull/525 for the trigger. First docs release cut from this repository, so there is no earlier tag to generate a changelog from. Later releases carry the usual What's Changed list. Full Changelog: https://github.com/kagent-dev/website/compare/v0.10.2...v0.10.3在 GitHub 查看 ↗ -
v0.10.2 Docs for v0.10.2