目次
設定ファイルリファレンス
.novita-agent.yaml の構造
.novita-agent.yaml 設定ファイルは、Kubernetes スタイルの YAML 形式を使用します。
設定の変更
CPU とメモリ設定の変更
.novita-agent.yaml の spec.runtime 配下にあるリソース設定を変更します。
環境変数の変更
.novita-agent.yaml の spec.envVars は、CLI の agent invoke コマンドでのみ使用され、デプロイされたサンドボックステンプレートには渡されません。
.novita-agent.yaml の spec.envVars 配下にある環境変数を変更します。
- ⚠️
.novita-agent.yamlに API Keys などの機密情報を保存しないでください agent invokeコマンドを実行する際に、--envパラメーター経由で環境変数を渡すこともできます
設定変更を適用するための再デプロイ
.novita-agent.yaml のリソース仕様を変更した後は、再デプロイが必要です。
環境変数の管理
サンドボックスインスタンスで実行されている Agents に環境変数を渡す方法はいくつかあります。方法 1: 設定ファイルで定義する(CLI 呼び出しのみ)
.novita-agent.yaml の spec.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 パラメーターを使用して、複数のリクエストを同じサンドボックスインスタンスにルーティングします。