Démarrage rapide d’AgentKit

Exécutez un petit workflow de salutation localement, puis utilisez les mêmes fichiers sur Adios. Il produit une salutation structurée et un artefact greeting.txt sans accéder à un service externe.

Obtenir l’exemple

Téléchargez hello-workflow.zip et décompressez-le. L’archive contient des instructions, des schémas JSON, un workflow et des données de test enregistrées.

hello-workflow/
  agentkit.yaml
  instructions/greeter.md
  schemas/input.json
  schemas/output.json
  tests/input.json
  tests/recording.json

Installez la CLI Adios pour valider ou importer l’exemple :

adios agent validate ./hello-workflow

La CLI autonome agentkit de développement se compile depuis une copie du code source d’AgentKit :

make build
./dist/agentkit help

Exécutez la commande suivante depuis cette copie du code, en remplaçant le chemin d’exemple par le répertoire extrait. Cette exécution enregistrée ne nécessite ni connexion ni clé de modèle.

./dist/agentkit workflow --workflow hello \
  --input ./hello-workflow/tests/input.json \
  --recording ./hello-workflow/tests/recording.json \
  --state ./.agentkit/hello-recorded --run-id hello-recorded \
  ./hello-workflow

Le résultat doit avoir le statut completed, avec greet comme sortie de l’étape :

{"message":"Hello, Adios!"}

Le greeting enregistre greeting.txt contenant ce message. Réutiliser le répertoire d’état et l’identifiant reprend l’exécution sauvegardée. Choisissez un nouvel identifiant pour tester des entrées ou des instructions modifiées.

Utiliser un modèle réel

Remplacez --recording par l’URL de votre serveur et le nom du modèle :

./dist/agentkit workflow --workflow hello \
  --model-url http://localhost:1234/v1 --model YOUR_MODEL \
  --input ./hello-workflow/tests/input.json \
  --state ./.agentkit/hello-model --run-id hello-model \
  ./hello-workflow

Le serveur doit implémenter l’interface chat completions compatible avec OpenAI. Pour un endpoint authentifié, ajoutez --model-key-env AGENT_MODEL_KEY après avoir défini cette variable localement. L’option indique le nom de la variable, pas sa valeur.

Exécuter le même kit sur Adios

Authentifiez-vous et sélectionnez votre équipe de test avec le guide de configuration de la CLI.

adios agent create --dir ./hello-workflow --name "Hello workflow"
adios agent run AGENT_ID --test --workflow hello --input '{"name":"Adios"}'

Utilisez l’identifiant d’agent renvoyé à la création. Comparez la salutation et l’artefact au résultat local dans la vue Activité. Les tests hébergés peuvent appeler de vrais modèles et consommer de l’usage. Continuez avec le guide d’hébergement pour les versions, connexions, approbations et exécutions normales.