> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Descripción general

## ¿Qué es Novita Agent Runtime?

Novita Agent Runtime es un framework ligero para desplegar agentes de IA que te permite **desplegar agentes de IA de forma rápida y rentable**.

No tienes que preocuparte por la configuración de infraestructura, la orquestación de contenedores, la exposición de servicios u otros detalles complejos: simplemente céntrate en desarrollar la lógica de negocio de tu agente.

***

## Componentes principales

Novita Agent Runtime está incluido en el SDK y las herramientas CLI de Novita Sandbox:

| Componente             | Descripción                                                                                                                  |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **Novita Sandbox SDK** | Proporciona API basadas en decoradores para exponer tu agente como un servicio HTTP estándar, y métodos para invocar agentes |
| **Novita Sandbox CLI** | Configuración y despliegue de agentes con un solo clic en el ecosistema Novita Agent Sandbox                                 |

***

## Flujo de trabajo de despliegue

El flujo completo de despliegue y uso consta de tres pasos:

### Paso 1: Desarrolla e integra tu agente

Integra el SDK en el código de tu agente añadiendo decoradores:

```python theme={"system"}
from novita_sandbox.agent_runtime import AgentRuntimeApp

app = AgentRuntimeApp()

@app.entrypoint
def my_agent(request: dict):
    # Agent business logic
    return {"result": "..."}
```

### Paso 2: Configura y despliega

Usa la herramienta CLI para configurar y desplegar en la nube:

```bash theme={"system"}
# Configure Agent
novita-sandbox-cli agent configure

# Deploy to cloud
novita-sandbox-cli agent launch
```

* Genera los archivos de configuración `Dockerfile` y `.novita-agent.yaml`
* Construye la plantilla de sandbox y la sube
* Genera el ID del agente (formato: `agent_<name>_v<version>`)

### Paso 3: Invoca el agente

Tras un despliegue correcto, puedes invocar tu agente mediante CLI o SDK:

**Opción 1: Prueba rápida con CLI**

```bash theme={"system"}
novita-sandbox-cli agent invoke "Hello, Agent!"
```

**Opción 2: Invocar mediante SDK en tu aplicación**

```python theme={"system"}
import json
from novita_sandbox.agent_runtime import AgentRuntimeClient

client = AgentRuntimeClient(api_key="your-api-key")

# Prepare request data (converted to a JSON string and encoded as bytes)
payload = json.dumps({"prompt": "Hello, Agent!"}).encode()

response = await client.invoke_agent_runtime(
    agentId="agent-xxxxx",
    payload=payload
)
```

**Flujo de ejecución de la invocación del agente**:

* Crea una instancia de sandbox aislada a partir de la plantilla de sandbox
* Ejecuta el agente en un entorno aislado
* Devuelve el resultado procesado

***

## Beneficios clave

SDK:

* ✅ **Cambios mínimos**: Solo modifica unas pocas líneas de código con decoradores
* ✅ **Agnóstico del framework**: Compatible con LangChain, LangGraph, CrewAI y otros frameworks de IA populares
* ✅ **Compatibilidad con streaming**: Respuestas de streaming nativas para escenarios de generación LLM en tiempo real
* ✅ **Comprobaciones de estado**: Endpoint de comprobación de estado integrado con estado de salud personalizable

CLI:

* ✅ **Detección inteligente**: Detecta automáticamente la estructura del proyecto, los archivos de entrada y los archivos de gestión de dependencias
* ✅ **Compilación automática**: Genera automáticamente Dockerfile y la configuración del proyecto
* ✅ **Gestión de versiones**: Admite la coexistencia de múltiples versiones con despliegues independientes
* ✅ **Pruebas rápidas**: Comando de invocación integrado para una verificación rápida del despliegue

Runtime:

* ✅ **Aislamiento del entorno**: Cada instancia de sandbox se ejecuta de forma independiente sin interferencias
* ✅ **Persistencia de sesión**: Múltiples invocaciones a la misma instancia de sandbox, compatible con agentes interactivos de múltiples turnos
* ✅ **Sandbox seguro**: Entorno de sandbox aislado de forma segura con acceso restringido al sistema de archivos