Document the kagent-tools example Agents and skills

Offen
  • Stimmt etwas nicht?
#680 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
3/5
Geschätzter Aufwand
1-2 Tage
Anfängerfreundlichkeit
25/100
Issue-Typ
Dokumentation
Klarheit
Größtenteils klar
Aktivitätsstatus
Aktiv
Tech-Stack
docker, go, helm, kubernetes
Bereich
ai, documentation

Rechercherichtung

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.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

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?

Vorherrschende Sprache
TypeScript
Sterne
21
Forks
71
Ø Merge
17 Std. 19 Min.
Gemergte PRs (30 T.)
87

Entwicklungsumgebung

Dieses Projekt bietet weder Dev-Container noch Dockerfile noch Beitragsleitfaden – die Einrichtung liegt bei Ihnen. Beginnen Sie mit der README; die allgemeinen Schritte stehen in unserem Leitfaden für den ersten Beitrag.

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus kagent-dev/website

Alle Issues in kagent-dev/website

Ähnliche Issues

Weitere Issues zu TypeScript

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.