Document the kagent-tools example Agents and skills

オープン
#680 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
3/5
見積もり時間
1〜2日
初心者へのやさしさ
25/100
issue の種類
ドキュメント
明瞭さ
おおむね明確
活発さ
活発
技術スタック
docker, go, helm, kubernetes
領域
ai, documentation

調査の方向性

Do not start yet: the issue says to wait until kagent-dev/kagent#3417 merges and a kagent-tools release ships. Once it does, read the merged exampleAgents values in the chart and the skills under /opt/kagent-tools-skills from kagent-dev/tools#91. Edit 1.x/examples/ or 1.x/examples/skills.md, then regenerate 1.x/reference/helm.md rather than editing it by hand. Done when the seven skills and their example Agents are listed and the two stated limits are documented.

索引モデルが issue の本文から書いたものです。

説明

Do not action before kagent-dev/kagent#3417 merges and ships in a kagent release. The 1.x pages are correct against the shipped release today.

kagent 0.x shipped ready-made example agents (k8s, istio, helm, cilium, and others) as Helm charts, and the 0.x docs pointed users at them. 1.x has no equivalent yet. Two upstream changes restore one:

  • kagent-dev/tools#91 (merged 2026-10-29) ports the agents' domain guidance to seven Agent Skills in the kagent-tools image, under /opt/kagent-tools-skills. No kagent-tools release contains it yet; v0.3.0 and earlier have no skills.
  • kagent-dev/kagent#3417 (open) adds exampleAgents.enabled, off by default. It installs one Go ADK Harness, kagent-tools-example, and three Agents: kagent-tools-cluster-ops, kagent-tools-networking, and kagent-tools-security. It waits on kagent-dev/tools#98 and a kagent-tools release.

Docs work

  • Document the exampleAgents Helm values on 1.x/examples/, or add a section to 1.x/examples/skills.md. Placement is the open question below.
  • List the seven skills and which example Agent loads each one.
  • Show how to attach one of the skills to a user's own Agent, from the kagent-tools image pinned by digest.
  • State the limits the PR names: OCI skill sources only until kagent-dev/kagent#3435 merges, and a custom snapshotLocation when the Substrate chart's rustfs store is off.
  • Regenerate 1.x/reference/helm.md; do not hand-edit it.

Check before starting

  • The merged values in kagent#3417 match the PR body, and exampleAgents.skillsImage is optional in the released chart.
  • The skill names in the released kagent-tools image match tools#91.

Open question

A new example page, or a section on the existing 1.x/examples/skills.md?

主要言語
TypeScript
スター
21
フォーク
71
平均マージ
17時間 19分
マージ済み PR(30日)
87

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

kagent-dev/website のほかの issue

kagent-dev/website の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。