agently-model-setup

Agently モデル設定

リクエストロジックを検討する前に、プロバイダーの接続とトランスポートの設定にこのスキルを使用してください。

ネイティブ優先のルール

• 設定されたモデルをサービス、ストリーミング経路、または並行ワークフローから使用する場合は、デフォルトで async 優先のガイダンスに従ってください
• 設定をファイルに置く場合は、Agently.load_settings("yaml_file", path, auto_load_env=True) を優先してください
• インラインのマッピングやホスト側のオーバーライドには、Agently.set_settings(...) または agent.set_settings(...) を使用してください
• ベース URL、モデル、認証には ${ENV.xxx} プレースホルダーを含む設定ファイルを優先してください
• プロバイダー設定は、所有するプラグインが読み取る名前空間の下に配置してください。OpenAICompatible の場合は plugins.ModelRequester.OpenAICompatible.* を優先してください
• ペイロードが .env に依存する可能性がある場合は、対応する設定ローダーを auto_load_env=True で呼び出してください
• アプリをフェイルファストさせる必要がある場合は、Agently を呼び出す前に統合レイヤーで必須の環境変数名を検証してください
• 読み込み後は、ファイルの形式が正しかったと仮定せず、有効なプロバイダーのアクティベーション、ベース URL、モデル、認証の存在を確認してください
• プロバイダーの設定は、ビジネスワークフローのロジックやプロンプトファイルの外に保ってください

アンチパターン

• プロバイダー固有のパース処理をリクエストコードにハードコードしないでください
• 設定と環境変数プレースホルダーで対応できる場合は、シークレットや環境固有のエンドポイントをコミットされた Python コードに埋め込まないでください
• プロバイダー設定を、有効なプラグインが読み取らないルートレベルの名前空間に置いたままにしないでください
• 同期専用のサンプルに、async 対応サービス のアーキテクチャを決定させないでください
• モデル設定を出力のパースやワークフロー設計と混在させないでください

次に読む

• references/overview.md