Ejecutar agentes localmente

La ejecución local mantiene el flujo del agente en tu máquina. Elige un modelo local o un endpoint remoto compatible y decide qué conexiones puede usar la ejecución.

Desarrollo independiente

La CLI independiente agentkit workflow ejecuta un directorio local sin una cuenta de Adios. Usa salidas grabadas de modelos y conectores para pruebas repetibles, o proporciona --model-url y --model para un modelo real.

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

Configura AGENT_MODEL_KEY en tu shell o gestor de secretos antes de ejecutar este ejemplo. Omite la opción si el servidor no requiere autenticación. Esta opción solo configura el cliente del modelo; no inyecta credenciales en funciones ni instrucciones.

Usar un agente Adios localmente

La CLI de Adios puede obtener un agente guardado y ejecutar su flujo con un modelo local:

adios agent run AGENT_ID --local --model YOUR_MODEL \
  --model-url http://localhost:1234/v1 --input '{"name":"Adios"}'

Este modo requiere iniciar sesión en Adios. Las operaciones de conectores pueden usar las conexiones del agente y sus aprobaciones permanecen en Adios. Usar una conexión remota no requiere copiar la credencial en el kit.

Para cambios en un directorio local, usa --local --dir ./hello-workflow. Revisa la simulación de efectos de la CLI antes de usar un directorio local con operaciones de escritura. Las grabaciones independientes, los borradores locales, las ejecuciones guardadas y las pruebas alojadas tienen políticas de efectos distintas; una simulación correcta no demuestra una escritura real.

Credenciales y funciones

Las opciones previstas son secretos locales configurados explícitamente y credenciales autorizadas resueltas desde Adios. Actualmente, las claves locales de modelos y el acceso a conectores gestionados están disponibles por las vías anteriores. La exportación general de secretos o su inyección automática en funciones arbitrarias aún no forma parte de esta interfaz.

Los ejecutores de funciones filtran su entorno. Una variable del shell no se convierte automáticamente en un secreto de función. Mantén las credenciales fuera de las entradas, grabaciones, artefactos y trazas. Usa una conexión gestionada por el host para acceder a servicios.

Reanudar e inspeccionar

Conserva el directorio de estado para reanudar una ejecución independiente con el mismo ID. Las decisiones de aprobación y las respuestas quedan guardadas. Usa --approve later para dejar las aprobaciones pendientes, o --test para simular efectos y omitir aprobaciones y esperas. --trace registra las llamadas y respuestas del modelo para depuración; esos archivos pueden contener datos de negocio proporcionados al agente.

Consulta funciones y pruebas para las pruebas nativas y el papel de Adios Sandbox.