Funções e testes

Uma função executa código com esquemas JSON de entrada e saída declarados. Pode devolver artefactos e propostas para o anfitrião processar. Propor uma ação não autoriza a sua execução.

Testar uma função localmente

A partir de uma cópia do código-fonte do AgentKit, crie o projeto inicial Python incluído:

make build
./dist/agentkit init --name my-agent /tmp/my-agent
./dist/agentkit test /tmp/my-agent
./dist/agentkit integration /tmp/my-agent
./dist/agentkit build /tmp/my-agent

O Python tem de estar instalado. O projeto inicial não precisa de chave de modelo, SDK nem credenciais de produção. A suite de integração verifica saídas, artefactos, regras de admissão e repetição através do contrato partilhado do anfitrião.

Após editar um ficheiro, atualize o ficheiro de bloqueio e repita as verificações:

./dist/agentkit lock /tmp/my-agent
./dist/agentkit integration /tmp/my-agent
./dist/agentkit build /tmp/my-agent

A execução nativa facilita o desenvolvimento com acesso à sua máquina. Para o perfil de contentor Python suportado, inicie o Docker e obtenha a imagem antes de executar:

docker pull python:3.12-slim
./dist/agentkit integration --executor docker /tmp/my-agent

Isto verifica um contentor sem rede e com recursos limitados. Não qualifica nem publica um kit alojado.

Adios Sandbox

Adios Sandbox é o projeto de execução local separado para aplicações num ambiente Linux próximo do alojamento Adios. A execução nativa, um contentor Docker de desenvolvimento e Adios Sandbox são ambientes de teste distintos.

O adaptador Sandbox específico do AgentKit ainda está por ligar. Até lá, adios up --local testa os manifestos de aplicações suportados; por si só não fornece um executor de funções AgentKit nem resolução de credenciais alojadas.

O modelo de execução pretendido permite escolher independentemente a localização de agentes e funções, preservando o contrato de pedidos, respostas e políticas das funções. Verifique as versões reais e os limites aplicados em cada ambiente antes de afirmar paridade.

Verificar por etapas

Etapa	Evidências a recolher
Fluxo gravado	Ordem dos passos, esquemas de saída, esperas de aprovação, retoma e conteúdo dos artefactos
Função nativa	Rejeição de entradas, validação de saídas, tempo limite, artefactos e repetição
Isolamento local	Versão do runtime, filtragem do ambiente, política de rede e limites de recursos
Teste alojado	Mesma versão do kit e dados de teste, ligações com âmbito limitado, saídas, artefactos e eventos de auditoria

Compare resultados normalizados em vez de IDs ou datas. Registe os efeitos simulados. Teste uma credencial em falta, uma aprovação recusada, uma nova tentativa e o cancelamento antes de ativar ações em serviços reais.

Para os fluxos de agentes, use o início rápido como primeira comparação entre execução local e alojada. Amplie-o com os seus dados de teste antes de adicionar efeitos reais.