Funciones y pruebas
Una función ejecuta código con esquemas JSON de entrada y salida declarados. Puede devolver artefactos y propuestas para que el host los procese. Devolver una acción propuesta no autoriza su ejecución.
Probar una función localmente
Desde una copia del código fuente de AgentKit, crea el proyecto inicial de Python incluido:
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 debe estar instalado. El proyecto inicial no necesita clave de modelo, SDK ni credenciales de producción. Su suite de integración comprueba salidas, artefactos, reglas de admisión y reproducción mediante el contrato compartido del host.
Después de editar un archivo, actualiza el archivo de bloqueo y repite las comprobaciones:
./dist/agentkit lock /tmp/my-agent
./dist/agentkit integration /tmp/my-agent
./dist/agentkit build /tmp/my-agent
La ejecución nativa facilita el desarrollo con acceso a tu máquina. Para el perfil compatible de contenedor Python, inicia Docker y obtén la imagen antes de ejecutar:
docker pull python:3.12-slim
./dist/agentkit integration --executor docker /tmp/my-agent
Esto comprueba un contenedor sin red y con recursos limitados. No cualifica ni publica un kit alojado.
Adios Sandbox
Adios Sandbox es el proyecto de ejecución local independiente para aplicaciones en un entorno Linux más cercano al alojamiento en Adios. La ejecución nativa, un contenedor Docker de desarrollo y Adios Sandbox son entornos de prueba distintos.
El adaptador Sandbox específico de AgentKit aún está pendiente de conexión. Hasta entonces, adios up --local prueba los manifiestos de aplicaciones compatibles; por sí solo no proporciona un ejecutor de funciones AgentKit ni resolución de credenciales alojadas.
El modelo de ejecución deseado permite elegir independientemente la ubicación de agentes y funciones, conservando el contrato de solicitudes, respuestas y políticas de funciones. Comprueba las versiones reales y los límites aplicados en cada entorno antes de afirmar que existe paridad.
Verificar por etapas
| Etapa | Evidencias que recopilar |
|---|---|
| Flujo grabado | Orden de pasos, esquemas de salida, esperas de aprobación, reanudación y contenido de artefactos |
| Función nativa | Rechazo de entradas, validación de salidas, tiempo límite, artefactos y reproducción |
| Aislamiento local | Versión del runtime, filtrado del entorno, política de red y límites de recursos |
| Prueba alojada | Misma versión del kit y datos de prueba, conexiones con alcance limitado, salidas, artefactos y eventos de auditoría |
Compara resultados normalizados, no IDs ni marcas de tiempo. Registra qué efectos se simularon. Prueba una credencial ausente, una aprobación denegada, un reintento y la cancelación antes de habilitar acciones sobre servicios reales.
Para los flujos de agentes, usa el inicio rápido como primera comparación entre ejecución local y alojada. Amplíala con tus propios datos de prueba antes de añadir efectos reales.