Secrets - Weights & Biases Documentation

wandb.sandbox は非推奨です。 W&B Python SDK の将来のリリースで削除されます。代わりに cwsandbox パッケージを使用してください。詳細は CoreWeave サンドボックスのドキュメントを参照してください。移行にあたっては、次の 2 点が変わります。

import: W&B の extra を指定して cwsandbox をインストールし (pip install "cwsandbox[wandb]")、wandb.sandbox ではなく cwsandbox から import します。
認証情報: cwsandbox はデフォルトで CWSANDBOX_API_KEY に設定された CoreWeave API アクセストークンで認証します。引き続き W&B APIキーを使用する場合は、auth=AuthStrategy.WANDB を渡してください。認証情報の選択を参照してください。

このページの例では引き続き wandb.sandbox を使用しています。同等の cwsandbox のコードについては、cwsandbox への移行を参照してください。

Serverless Sandboxes はパブリックプレビューです。アクセスは組織ごとに有効化されます。組織でアクセスを利用するには、サポートにお問い合わせください。

サンドボックス内で APIキーやトークンなどの機密情報にアクセスするには、W&B Python SDK で W&B Secrets Manager を使用します。サンドボックスでシークレットを使用するには、まずチームの Secrets Manager に追加します。次に、サンドボックスの作成時にそのシークレットを名前で参照します。

シークレットの値をコードやサンドボックスの設定に直接含めないでください。シークレットは名前でのみ参照してください。

W&B は、要求された各シークレットを環境変数としてサンドボックスに注入します。デフォルトでは、環境変数名はシークレット名と一致します。env_var パラメーターを使用すると、環境変数名をカスタマイズできます。

W&B アカウントでシークレットを作成および管理する方法については、Manage secrets を参照してください。

サンドボックスでシークレットにアクセスする

サンドボックスに含めるシークレットを指定するには、Secret クラスを使用します。1 つ以上の Secret オブジェクトを Sandbox.run() の secrets パラメーターに渡します。各 Secret オブジェクトでは、シークレットを名で指定します。W&B はシークレット値を環境変数としてサンドボックスに設定します。

シークレット値ではなく、シークレット名を渡してください。サンドボックス内では、対応する環境変数からシークレットを読み取ってください。

次の例では、既存の 2 つのシークレット HF_TOKEN と OPENAI_API_KEY をサンドボックスで使用可能にします。

from wandb.sandbox import Sandbox, Secret

with Sandbox.run(
    secrets=[
        Secret(name="HF_TOKEN"),
        Secret(name="OPENAI_API_KEY"),
    ],
) as sandbox:
    result = sandbox.exec([
        "python",
        "-c",
        """
import os
if "HF_TOKEN" in os.environ:
    print(f"Hugging Face token found.")
if "OPENAI_API_KEY" in os.environ:
    print(f"OpenAI key token found.")
""",
    ]).result()
    print(result.stdout)

サンドボックス内では、各シークレットに対応する環境変数を通じてアクセスします。この例では、HF_TOKEN は os.environ["HF_TOKEN"] として利用でき、OPENAI_API_KEY は os.environ["OPENAI_API_KEY"] として利用できます。シークレットの環境変数名をカスタマイズするには、カスタム環境変数名を使用するを参照してください。

カスタムの環境変数名を使用する

デフォルトでは、シークレットの環境変数名はシークレット名と同じです。特定のシークレットについてサンドボックスで使用する環境変数名を変更するには、Secret の env_var パラメーターを設定します (Secret(env_var="CUSTOM_NAME")) 。次の例では、HF_TOKEN シークレットがサンドボックス内で利用可能であることを確認します。

from wandb.sandbox import Sandbox, Secret

with Sandbox.run(
    secrets=[
        Secret(name="HF_TOKEN", env_var="HUGGINGFACE_TOKEN")
    ],
) as sandbox:
    result = sandbox.exec([
        "python",
        "-c",
        """
import os
if "HUGGINGFACE_TOKEN" in os.environ:
    print(f"Hugging Face token found!")
""",
    ]).result()
    print(result.stdout)

​サンドボックスでシークレットにアクセスする

​カスタムの環境変数名を使用する

サンドボックスでシークレットにアクセスする

カスタムの環境変数名を使用する