Visão geral

​

O que é o Novita Agent Runtime?

​

Componentes principais

​

Fluxo de trabalho de implantação

​

Etapa 1: Desenvolva e integre seu Agente

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

# 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

novita-sandbox-cli agent invoke "Hello, Agent!"

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
)

• 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

• ✅ 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

• ✅ 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

• ✅ 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