Funzioni e test
Una funzione esegue codice con schemi JSON di input e output dichiarati. Può restituire artefatti e proposte da elaborare sull’host. Proporre un’azione non ne autorizza l’esecuzione.
Testare una funzione localmente
Da una copia del codice sorgente di AgentKit, crea il progetto iniziale Python incluso:
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
Python deve essere installato. Il progetto iniziale non richiede chiavi del modello, SDK o credenziali di produzione. La suite di integrazione verifica output, artefatti, regole di ammissione e riproduzione tramite il contratto condiviso dell’host.
Dopo aver modificato un file, aggiorna il file di blocco e ripeti le verifiche:
./dist/agentkit lock /tmp/my-agent
./dist/agentkit integration /tmp/my-agent
./dist/agentkit build /tmp/my-agent
L’esecuzione nativa facilita lo sviluppo con accesso alla tua macchina. Per il profilo container Python supportato, avvia Docker e ottieni l’immagine prima di eseguire:
docker pull python:3.12-slim
./dist/agentkit integration --executor docker /tmp/my-agent
Questo verifica un container senza rete e con risorse limitate. Non qualifica né pubblica un kit ospitato.
Adios Sandbox
Adios Sandbox è il progetto separato per eseguire applicazioni localmente in un ambiente Linux vicino all’hosting Adios. Esecuzione nativa, container Docker di sviluppo e Adios Sandbox sono ambienti di test distinti.
L’adattatore Sandbox specifico di AgentKit deve ancora essere collegato. Fino ad allora, adios up --local verifica i manifest supportati delle applicazioni; da solo non fornisce un esecutore di funzioni AgentKit né la risoluzione di credenziali ospitate.
Il modello di esecuzione previsto consente di scegliere indipendentemente la posizione di agenti e funzioni, preservando il contratto di richiesta, risposta e politica delle funzioni. Verifica versioni reali e limiti applicati in ogni ambiente prima di dichiarare la parità.
Verificare per fasi
| Fase | Evidenze da raccogliere |
|---|---|
| Flusso registrato | Ordine dei passaggi, schemi di output, attese di approvazione, ripresa e contenuto degli artefatti |
| Funzione nativa | Rifiuto degli input, validazione degli output, timeout, artefatti e riproduzione |
| Isolamento locale | Versione del runtime, filtro dell’ambiente, politica di rete e limiti di risorse |
| Test ospitato | Stessa versione del kit e dati di test, connessioni con ambito limitato, output, artefatti ed eventi di audit |
Confronta risultati normalizzati anziché ID o timestamp. Registra gli effetti simulati. Prova credenziali mancanti, approvazione negata, nuovo tentativo e annullamento prima di abilitare azioni su servizi reali.
Per i flussi degli agenti, usa la guida rapida come primo confronto tra esecuzione locale e ospitata. Aggiungi i tuoi dati di test prima di attivare effetti reali.