概要

​

Novita Agent Runtime とは？

​

コアコンポーネント

​

デプロイワークフロー

​

ステップ 1: エージェントを開発して統合する

from novita_sandbox.agent_runtime import AgentRuntimeApp

app = AgentRuntimeApp()

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

​

ステップ 2: 設定してデプロイする

# Configure Agent
novita-sandbox-cli agent configure

# Deploy to cloud
novita-sandbox-cli agent launch

• Dockerfile および .novita-agent.yaml 設定ファイルを生成します
• サンドボックステンプレートをビルドしてアップロードします
• Agent ID を生成します（形式: agent_<name>_v<version>）

​

ステップ 3: エージェントを呼び出す

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
)

• サンドボックステンプレートから分離されたサンドボックスインスタンスを作成します
• 分離された環境でエージェントを実行します
• 処理済みの結果を返します

​

主なメリット

• ✅ 最小限の変更: デコレータを使って数行のコードを変更するだけです
• ✅ フレームワーク非依存: LangChain、LangGraph、CrewAI などの一般的な AI フレームワークをサポートします
• ✅ ストリーミング対応: リアルタイムの LLM 生成シナリオ向けに、ネイティブなストリーミングレスポンスを提供します
• ✅ ヘルスチェック: カスタマイズ可能なヘルスステータスを備えた組み込みのヘルスチェックエンドポイント

• ✅ スマート検出: プロジェクト構造、エントリファイル、依存関係管理ファイルを自動検出します
• ✅ 自動ビルド: Dockerfile とプロジェクト設定を自動生成します
• ✅ バージョン管理: 独立したデプロイで複数バージョンの共存をサポートします
• ✅ クイックテスト: 迅速なデプロイ検証のための組み込み invoke コマンド

• ✅ 環境分離: 各サンドボックスインスタンスは干渉することなく独立して実行されます
• ✅ セッション永続化: 同じサンドボックスインスタンスへの複数回の呼び出しにより、マルチターンの対話型エージェントをサポートします
• ✅ セキュアサンドボックス: ファイルシステムアクセスが制限された、安全に分離されたサンドボックス環境