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

# Visão geral

## O que é o Novita Agent Runtime?

O Novita Agent Runtime é um framework leve para implantar Agentes de IA que permite **implantar Agentes de IA de forma rápida e econômica**.

Não é necessário se preocupar com configuração de infraestrutura, orquestração de contêineres, exposição de serviços ou outros detalhes complexos — basta focar no desenvolvimento da lógica de negócios do seu Agente.

***

## Componentes principais

O Novita Agent Runtime está incluído no Novita Sandbox SDK e nas ferramentas CLI:

| Componente             | Descrição                                                                                                                   |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Novita Sandbox SDK** | Fornece APIs baseadas em decorators para expor seu Agente como um serviço HTTP padrão, além de métodos para invocar Agentes |
| **Novita Sandbox CLI** | Configuração e implantação de Agentes com um clique no ecossistema Novita Agent Sandbox                                     |

***

## Fluxo de trabalho de implantação

O fluxo completo de implantação e uso consiste em três etapas:

### Etapa 1: Desenvolva e integre seu Agente

Integre o SDK ao código do seu Agente adicionando decorators:

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

app = AgentRuntimeApp()

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

### Etapa 2: Configure e implante

Use a ferramenta CLI para configurar e implantar na nuvem:

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

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

* Gera os arquivos de configuração `Dockerfile` e `.novita-agent.yaml`
* Cria o template de sandbox e faz o upload
* Gera o ID do Agente (formato: `agent_<name>_v<version>`)

### Etapa 3: Invoque o Agente

Após a implantação bem-sucedida, você pode invocar seu Agente via CLI ou SDK:

**Opção 1: Teste rápido com CLI**

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

**Opção 2: Invoque via SDK na sua aplicação**

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

**Fluxo de execução da invocação do Agente**:

* Cria uma instância de sandbox isolada a partir do template de sandbox
* Executa o Agente em um ambiente isolado
* Retorna o resultado processado

***

## Principais benefícios

SDK:

* ✅ **Alterações mínimas**: Basta modificar algumas linhas de código com decorators
* ✅ **Agnóstico a framework**: Suporta LangChain, LangGraph, CrewAI e outros frameworks populares de IA
* ✅ **Suporte a streaming**: Respostas em streaming nativas para cenários de geração de LLM em tempo real
* ✅ **Health Checks**: Endpoint de health check integrado com status de integridade personalizável

CLI:

* ✅ **Detecção inteligente**: Detecta automaticamente a estrutura do projeto, arquivos de entrada e arquivos de gerenciamento de dependências
* ✅ **Build automático**: Gera automaticamente Dockerfile e configuração do projeto
* ✅ **Gerenciamento de versões**: Suporta múltiplas versões coexistindo com implantações independentes
* ✅ **Teste rápido**: Comando invoke integrado para verificação rápida da implantação

Runtime:

* ✅ **Isolamento de ambiente**: Cada instância de sandbox é executada de forma independente, sem interferência
* ✅ **Persistência de sessão**: Múltiplas invocações para a mesma instância de sandbox, com suporte a Agentes interativos de múltiplos turnos
* ✅ **Sandbox seguro**: Ambiente de sandbox isolado com segurança e acesso restrito ao sistema de arquivos