Document the kagent-tools example Agents and skills

Aperta
  • Qualcosa non va?
#680 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
3/5
Tempo stimato
1-2 giorni
Idoneità per principianti
25/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
docker, go, helm, kubernetes
Ambito
ai, documentation

Direzione di ricerca

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.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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?

Lingua principale
TypeScript
Stelle
21
Fork
71
Merge medio
17h 19m
PR unite (30g)
87

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di kagent-dev/website

Tutte le issue di kagent-dev/website

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.