Document the kagent-tools example Agents and skills

Ouverte
  • Quelque chose ne va pas ?
#680 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

Personne n'a encore pris cette issue.

Évaluation

Difficulté
3/5
Temps estimé
1-2 jours
Accessibilité débutants
25/100
Type d'issue
Documentation
Clarté
Plutôt claire
Activité
Active
Stack technique
docker, go, helm, kubernetes
Domaine
ai, documentation

Piste de recherche

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.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

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?

Langage dominant
TypeScript
Étoiles
21
Forks
71
Merge moyen
17 h 19 min
PR mergées (30 j)
87

Préparer son environnement

Ce projet ne fournit ni conteneur de développement, ni Dockerfile, ni guide de contribution : l'installation est à votre charge. Commencez par son README, et consultez notre guide de la première contribution pour les étapes générales.

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de kagent-dev/website

Toutes les issues de kagent-dev/website

Issues similaires

Plus d'issues TypeScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.