Início rápido do AgentKit

Execute um pequeno fluxo de saudação localmente e depois use os mesmos ficheiros no Adios. Produz uma saudação estruturada e um artefacto greeting.txt sem aceder a um serviço externo.

Obter o exemplo

Transfira hello-workflow.zip e extraia-o. O arquivo inclui instruções, esquemas JSON, um fluxo de trabalho e dados de teste gravados.

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

Instale a CLI Adios para validar ou carregar o exemplo:

adios agent validate ./hello-workflow

A CLI autónoma agentkit de desenvolvimento é compilada a partir de uma cópia do código-fonte do AgentKit:

make build
./dist/agentkit help

Execute o seguinte comando a partir dessa cópia do código, substituindo o caminho do exemplo pelo diretório extraído. Esta execução gravada não precisa de início de sessão nem chave 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

O resultado deve ter o estado completed, com greet como saída do passo:

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

O greeting guarda greeting.txt com essa mensagem. Reutilizar o diretório de estado e o ID retoma a execução guardada. Escolha um novo ID para testar alterações nas entradas ou instruções.

Usar um modelo real

Substitua --recording pelo URL do seu servidor e pelo nome do 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

O servidor deve implementar a interface chat completions compatível com OpenAI. Para um endpoint autenticado, adicione --model-key-env AGENT_MODEL_KEY depois de definir essa variável localmente. A opção indica o nome da variável, não o seu valor.

Executar o mesmo kit no Adios

Autentique-se e selecione a equipa de teste com o guia de configuração da CLI.

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

Use o ID do agente devolvido na criação. Compare a saudação e o artefacto com o resultado local na vista Atividade. Os testes alojados podem chamar modelos reais e consumir utilização. Continue com o guia de alojamento para versões, ligações, aprovações e execuções normais.