Skip to main content
このドキュメントでは、Novita Agent Runtime の高度な機能とベストプラクティスについて説明します。

目次


設定ファイルリファレンス

.novita-agent.yaml の構造

.novita-agent.yaml 設定ファイルは、Kubernetes スタイルの YAML 形式を使用します。

設定の変更

CPU とメモリ設定の変更

.novita-agent.yamlspec.runtime 配下にあるリソース設定を変更します。

環境変数の変更

.novita-agent.yamlspec.envVars は、CLI の agent invoke コマンドでのみ使用され、デプロイされたサンドボックステンプレートには渡されません。 .novita-agent.yamlspec.envVars 配下にある環境変数を変更します。
:
  • ⚠️ .novita-agent.yaml に API Keys などの機密情報を保存しないでください
  • agent invoke コマンドを実行する際に、--env パラメーター経由で環境変数を渡すこともできます

設定変更を適用するための再デプロイ

.novita-agent.yaml のリソース仕様を変更した後は、再デプロイが必要です。

環境変数の管理

サンドボックスインスタンスで実行されている Agents に環境変数を渡す方法はいくつかあります。

方法 1: 設定ファイルで定義する(CLI 呼び出しのみ)

.novita-agent.yamlspec.envVars 配下に環境変数を定義します。

方法 2: SDK 経由で動的に渡す

SDK の invoke_agent_runtime メソッドを使用して Agent を呼び出す場合、envVars パラメーター経由で動的に渡します。

ストリーミングレスポンス

同期ジェネレーターによるストリーミングの実装

Python ジェネレーターを使用してストリーミングレスポンスを実装します。

非同期ジェネレーターによるストリーミングの実装

Python 非同期ジェネレーターを使用します。

LangChain ストリーミングレスポンスの例

LangChain を使用したストリーミングレスポンスの完全な例です。

ストリーミング Agent の呼び出し

SDK を使用してストリーミング Agent を呼び出します。

バージョン管理

新しい Agent バージョンのデプロイ

バージョン番号を変更し、新しいバージョンをデプロイします。
デプロイが成功すると、新しい agent_id が生成されます。各デプロイでは、特定のバージョンに対応する一意の agent_id が生成されます。

ヘルスチェック

デフォルトのヘルスチェックエンドポイント

AgentRuntimeApp は、/ping ヘルスチェックエンドポイントを自動的に提供します。

カスタムヘルスチェック

@app.ping デコレーターを使用して、ヘルスチェックロジックをカスタマイズします。

サポートされるヘルスチェックステータス

Agents は次のヘルスステータスを返すことができます。

マルチターン会話

マルチターン会話での Session ID の使用

runtimeSessionId パラメーターを使用して、複数のリクエストを同じサンドボックスインスタンスにルーティングします。

サンプルプロジェクト

LangGraph をベースにした完全なサンプルプロジェクトを提供しており、Novita Agent Runtime で実際の AI アプリケーションを構築する方法を示しています。

プロジェクトリポジトリ

🔗 https://github.com/novitalabs/Novita-CollabHub/tree/main/examples/agent-runtime/agentic-frameworks/langgraph
最終更新日 2026年5月15日