Guida rapida ad AgentKit

Esegui un piccolo flusso di saluto localmente, poi usa gli stessi file su Adios. Produce un saluto strutturato e un artefatto greeting.txt senza accedere a servizi esterni.

Ottenere l’esempio

Scarica hello-workflow.zip ed estrailo. L’archivio include istruzioni, schemi JSON, un flusso di lavoro e dati di test registrati.

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

Installa la CLI Adios per validare o caricare l’esempio:

adios agent validate ./hello-workflow

La CLI autonoma agentkit di sviluppo si compila da una copia del codice sorgente di AgentKit:

make build
./dist/agentkit help

Esegui il comando seguente da quella copia del codice, sostituendo il percorso dell’esempio con la directory estratta. Questa esecuzione registrata non richiede accesso né chiave del modello.

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

Il risultato deve avere lo stato completed, con greet come output del passaggio:

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

Il greeting salva greeting.txt contenente il messaggio. Riutilizzare la directory di stato e l’ID riprende l’esecuzione salvata. Scegli un nuovo ID per provare input o istruzioni modificati.

Usare un modello reale

Sostituisci --recording con l’URL del server e il nome del modello:

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

Il server deve implementare l’interfaccia chat completions compatibile con OpenAI. Per un endpoint autenticato, aggiungi --model-key-env AGENT_MODEL_KEY dopo aver impostato la variabile localmente. L’opzione indica il nome della variabile, non il suo valore.

Eseguire lo stesso kit su Adios

Autenticati e seleziona il team di test con la guida alla configurazione della CLI.

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

Usa l’ID dell’agente restituito alla creazione. Confronta saluto e artefatto con il risultato locale nella vista Attività. I test ospitati possono chiamare modelli reali e consumare utilizzo. Continua con la guida all’hosting per versioni, connessioni, approvazioni ed esecuzioni normali.