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

# 概要

## Novita Agent Runtime とは？

Novita Agent Runtime は、AIエージェントをデプロイするための軽量フレームワークで、**AIエージェントを迅速かつ費用対効果高くデプロイ**できます。

インフラ構成、コンテナオーケストレーション、サービス公開、その他の複雑な詳細を気にする必要はありません。エージェントのビジネスロジック開発に集中できます。

***

## コアコンポーネント

Novita Agent Runtime は、Novita Sandbox SDK および CLI ツールに含まれています。

| コンポーネント                | 説明                                                                     |
| ---------------------- | ---------------------------------------------------------------------- |
| **Novita Sandbox SDK** | エージェントを標準の HTTP サービスとして公開するためのデコレータベースの API と、エージェントを呼び出すためのメソッドを提供します |
| **Novita Sandbox CLI** | Novita Agent Sandbox エコシステムへのエージェントのワンクリック設定とデプロイを提供します                |

***

## デプロイワークフロー

完全なデプロイと利用のワークフローは、3つのステップで構成されます。

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

デコレータを追加して、SDK をエージェントコードに統合します。

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

app = AgentRuntimeApp()

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

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

CLI ツールを使用して、クラウドへの設定とデプロイを行います。

```bash theme={"system"}
# 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: エージェントを呼び出す

デプロイが成功したら、CLI または SDK 経由でエージェントを呼び出せます。

**オプション 1: CLI でクイックテスト**

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

**オプション 2: アプリケーション内で SDK 経由で呼び出す**

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

**エージェント呼び出しの実行フロー**:

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

***

## 主なメリット

SDK:

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

CLI:

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

Runtime:

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