> ## 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.

# Overzicht

## Wat is Novita Agent Runtime?

Novita Agent Runtime is een lichtgewicht framework voor het implementeren van AI-agents waarmee je **AI-agents snel en kosteneffectief kunt implementeren**.

Je hoeft je geen zorgen te maken over infrastructuurconfiguratie, containerorchestratie, het beschikbaar maken van services of andere complexe details—richt je gewoon op het ontwikkelen van de bedrijfslogica van je Agent.

***

## Kerncomponenten

Novita Agent Runtime is opgenomen in de Novita Sandbox SDK en CLI-tools:

| Component              | Beschrijving                                                                                                                          |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **Novita Sandbox SDK** | Biedt decorator-gebaseerde API's om je Agent als een standaard HTTP-service beschikbaar te maken, en methoden om Agents aan te roepen |
| **Novita Sandbox CLI** | Configuratie en implementatie van Agents naar het Novita Agent Sandbox-ecosysteem met één klik                                        |

***

## Implementatieworkflow

De volledige workflow voor implementatie en gebruik bestaat uit drie stappen:

### Stap 1: Ontwikkel en integreer je Agent

Integreer de SDK in je Agent-code door decorators toe te voegen:

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

app = AgentRuntimeApp()

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

### Stap 2: Configureer en implementeer

Gebruik de CLI-tool om te configureren en naar de cloud te implementeren:

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

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

* Genereert de configuratiebestanden `Dockerfile` en `.novita-agent.yaml`
* Bouwt de sandboxtemplate en uploadt deze
* Genereert Agent-ID (indeling: `agent_<name>_v<version>`)

### Stap 3: Roep de Agent aan

Na succesvolle implementatie kun je je Agent aanroepen via CLI of SDK:

**Optie 1: Snelle test met CLI**

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

**Optie 2: Aanroepen via SDK in je applicatie**

```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
)
```

**Uitvoeringsstroom voor Agent-aanroep**:

* Maakt een geïsoleerde sandboxinstantie aan op basis van de sandboxtemplate
* Voert de Agent uit in een geïsoleerde omgeving
* Retourneert het verwerkte resultaat

***

## Belangrijkste voordelen

SDK:

* ✅ **Minimale wijzigingen**: Pas slechts een paar regels code aan met decorators
* ✅ **Framework-agnostisch**: Ondersteunt LangChain, LangGraph, CrewAI en andere populaire AI-frameworks
* ✅ **Streaming-ondersteuning**: Native streamingresponses voor realtime LLM-generatiescenario's
* ✅ **Healthchecks**: Ingebouwde healthcheck-endpoint met aanpasbare gezondheidsstatus

CLI:

* ✅ **Slimme detectie**: Detecteert automatisch projectstructuur, invoerbestanden en bestanden voor afhankelijkheidsbeheer
* ✅ **Automatische build**: Genereert automatisch Dockerfile en projectconfiguratie
* ✅ **Versiebeheer**: Ondersteunt meerdere naast elkaar bestaande versies met onafhankelijke implementaties
* ✅ **Snel testen**: Ingebouwde invoke-opdracht voor snelle verificatie van implementaties

Runtime:

* ✅ **Omgevingsisolatie**: Elke sandboxinstantie draait onafhankelijk zonder interferentie
* ✅ **Sessiepersistentie**: Meerdere aanroepen naar dezelfde sandboxinstantie, met ondersteuning voor interactieve Agents met meerdere beurten
* ✅ **Veilige sandbox**: Veilig geïsoleerde sandboxomgeving met beperkte toegang tot het bestandssysteem