Manifest reference

Chaque agent est décrit par un fichier agent.yaml. Cette page documente chaque champ.

Champs au premier niveau

Champ	Type	Requis	Description
`name`	string	Oui	Nom visible, 3–50 caractères.
`slug`	string	Non	Slug URL. Auto-généré depuis `name` sinon.
`description`	string (markdown)	Oui	Description longue (visible sur la fiche agent). Min 10, max 5000.
`short_description`	string	Oui	Tagline (cartes du catalog). Max 80 caractères.
`category`	enum	Oui	productivity, finance, creativity, personal, dev, fun.
`orb_color`	hex color	Oui	Format `#RRGGBB`. Couleur de l'Orb de l'agent.
`tags`	string[]	Non	Max 5, chacun 2–20 caractères.
`version`	semver	Oui	Format `x.y.z`.

pricing

pricing:
  model: ONE_SHOT  # FREE | ONE_SHOT | SUBSCRIPTION
  amount: 299      # centimes EUR, requis si payant
  currency: EUR
  interval: MONTHLY # si SUBSCRIPTION

system_prompt

Le cerveau de ton agent. Supporte les variables {{key}} qui seront résolues avec les valeurs des input blocks.

Longueur recommandée500–5000 caractères. Trop court → score qualité pénalisé. Trop long → coût tokens et latence.

input_blocks

Liste ordonnée des widgets du formulaire utilisateur. Minimum 1, max 15. Voir la page Input Blocks pour la référence complète.

output

output:
  mode: structured   # structured | narrative | text
  blocks:
    - type: markdown
    - type: table
    - type: checklist

Voir Output Blocks pour les 24 types supportés.

runtime

runtime:
  model: claude-sonnet-4-6   # haiku | sonnet
  temperature: 0.7
  max_tokens: 4000
  timeout_seconds: 30

tools (optionnel)

tools:
  - name: web_search
    config: { max_results: 5 }
  - name: file_output
    config: { file_type: pdf }

test_fixtures

Min 1 fixture, max 10. Exécutés au push.

test_fixtures:
  - name: "basic"
    input:
      recipient: "mon manager"
      goal: "demander 3 jours de congé"
      tone: "cordial"
    expected_output_contains:
      - "Objet"
      - "Bonjour"

Exemple complet

Consulte Ton premier agent pour un manifest complet annoté.

← Getting started Input Blocks →