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

# Vue d’ensemble

## Qu’est-ce que Novita Agent Runtime ?

Novita Agent Runtime est un framework léger pour déployer des Agents IA, qui vous permet de **déployer des Agents IA rapidement et à moindre coût**.

Plus besoin de vous soucier de la configuration de l’infrastructure, de l’orchestration de conteneurs, de l’exposition de services ou d’autres détails complexes : concentrez-vous simplement sur le développement de la logique métier de votre Agent.

***

## Composants principaux

Novita Agent Runtime est inclus dans le SDK Novita Sandbox et les outils CLI :

| Composant              | Description                                                                                                                                         |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Novita Sandbox SDK** | Fournit des API basées sur des décorateurs pour exposer votre Agent comme un service HTTP standard, ainsi que des méthodes pour invoquer des Agents |
| **Novita Sandbox CLI** | Configuration et déploiement en un clic des Agents vers l’écosystème Novita Agent Sandbox                                                           |

***

## Flux de déploiement

Le flux complet de déploiement et d’utilisation comprend trois étapes :

### Étape 1 : Développer et intégrer votre Agent

Intégrez le SDK dans le code de votre Agent en ajoutant des décorateurs :

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

app = AgentRuntimeApp()

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

### Étape 2 : Configurer et déployer

Utilisez l’outil CLI pour configurer et déployer dans le cloud :

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

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

* Génère les fichiers de configuration `Dockerfile` et `.novita-agent.yaml`
* Construit le modèle de sandbox et le téléverse
* Génère l’ID de l’Agent (format : `agent_<name>_v<version>`)

### Étape 3 : Invoquer l’Agent

Après un déploiement réussi, vous pouvez invoquer votre Agent via la CLI ou le SDK :

**Option 1 : Test rapide avec la CLI**

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

**Option 2 : Invocation via le SDK dans votre application**

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

**Flux d’exécution de l’invocation de l’Agent** :

* Crée une instance de sandbox isolée à partir du modèle de sandbox
* Exécute l’Agent dans un environnement isolé
* Renvoie le résultat traité

***

## Principaux avantages

SDK :

* ✅ **Modifications minimales** : Modifiez seulement quelques lignes de code avec des décorateurs
* ✅ **Indépendant du framework** : Prend en charge LangChain, LangGraph, CrewAI et d’autres frameworks IA populaires
* ✅ **Prise en charge du streaming** : Réponses en streaming natives pour les scénarios de génération LLM en temps réel
* ✅ **Contrôles de santé** : Point de terminaison de contrôle de santé intégré avec état de santé personnalisable

CLI :

* ✅ **Détection intelligente** : Détecte automatiquement la structure du projet, les fichiers d’entrée et les fichiers de gestion des dépendances
* ✅ **Build automatique** : Génère automatiquement Dockerfile et la configuration du projet
* ✅ **Gestion des versions** : Prend en charge la coexistence de plusieurs versions avec des déploiements indépendants
* ✅ **Tests rapides** : Commande invoke intégrée pour une vérification rapide du déploiement

Runtime :

* ✅ **Isolation de l’environnement** : Chaque instance de sandbox s’exécute indépendamment, sans interférence
* ✅ **Persistance de session** : Plusieurs invocations vers la même instance de sandbox, avec prise en charge des Agents interactifs multi-tours
* ✅ **Sandbox sécurisé** : Environnement de sandbox isolé de manière sécurisée avec accès restreint au système de fichiers