Inicio rápido de AgentKit

Ejecuta un pequeño flujo de saludo localmente y después usa los mismos archivos en Adios. Produce un saludo estructurado y un artefacto greeting.txt sin acceder a un servicio externo.

Obtener el ejemplo

Descarga hello-workflow.zip y extráelo. El archivo incluye instrucciones, esquemas JSON, un flujo de trabajo y datos de prueba grabados.

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

Instala la Adios CLI para validar o subir el ejemplo:

adios agent validate ./hello-workflow

La CLI independiente agentkit de desarrollo se compila desde una copia del código fuente de AgentKit:

make build
./dist/agentkit help

Ejecuta el siguiente comando desde esa copia del código, sustituyendo la ruta del ejemplo por el directorio extraído. Esta ejecución grabada no necesita inicio de sesión ni clave de modelo.

./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

El resultado debe tener el estado completed, con greet como salida del paso:

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

El greeting guarda greeting.txt con ese mensaje. Reutilizar el directorio de estado y el ID de ejecución reanuda la ejecución guardada. Elige un nuevo ID para probar cambios en los datos de entrada o las instrucciones.

Usar un modelo real

Reemplaza los marcadores --recording por la URL de tu servidor de modelos y el nombre del modelo:

./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

El servidor debe implementar la interfaz de chat completions compatible con OpenAI. Para un endpoint autenticado, añade --model-key-env AGENT_MODEL_KEY después de configurar esa variable localmente. La opción indica el nombre de la variable, no su valor.

Ejecutar el mismo kit en Adios

Autentícate y selecciona tu equipo de prueba con la guía de configuración de la CLI.

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

Usa el ID de agente devuelto al crearlo. Compara el saludo y el artefacto con el resultado local en la vista Actividad. Las pruebas alojadas pueden llamar a modelos reales y consumir uso. Continúa con la guía de alojamiento para versiones, conexiones, aprobaciones y ejecuciones normales.