Movatterモバイル変換


[0]ホーム

URL:


コンテンツにスキップ

SDK の設定

API キーとクライアント

デフォルトでは、 SDK はインポートされるとすぐに、 LLM リクエストとトレーシングのためにOPENAI_API_KEY 環境変数を探します。アプリの起動前にその環境変数を設定できない場合は、set_default_openai_key() 関数を使ってキーを設定できます。

fromagentsimportset_default_openai_keyset_default_openai_key("sk-...")

また、使用する OpenAI クライアントを設定することもできます。デフォルトでは、 SDK は環境変数または上で設定したデフォルトキーから API キーを使用してAsyncOpenAI インスタンスを作成します。これを変更するには、set_default_openai_client() 関数を使用します。

fromopenaiimportAsyncOpenAIfromagentsimportset_default_openai_clientcustom_client=AsyncOpenAI(base_url="...",api_key="...")set_default_openai_client(custom_client)

最後に、使用する OpenAI API をカスタマイズすることもできます。デフォルトでは OpenAI Responses API を使用します。set_default_openai_api() 関数を使って、 Chat Completions API を使用するように上書きできます。

fromagentsimportset_default_openai_apiset_default_openai_api("chat_completions")

トレーシング

トレーシングはデフォルトで有効です。デフォルトでは上記の OpenAI API キー(つまり、環境変数または設定したデフォルトキー)を使用します。トレーシングに使用する API キーを個別に設定するには、set_tracing_export_api_key 関数を使用します。

fromagentsimportset_tracing_export_api_keyset_tracing_export_api_key("sk-...")

set_tracing_disabled() 関数を使用して、トレーシングを完全に無効化することもできます。

fromagentsimportset_tracing_disabledset_tracing_disabled(True)

デバッグ ログ

SDK にはハンドラーが設定されていない 2 つの Python ロガーがあります。デフォルトでは、これは警告とエラーがstdout に送信され、その他のログは抑制されることを意味します。

詳細なログを有効にするには、enable_verbose_stdout_logging() 関数を使用します。

fromagentsimportenable_verbose_stdout_loggingenable_verbose_stdout_logging()

また、ハンドラー、フィルター、フォーマッターなどを追加してログをカスタマイズできます。詳細はPython logging guide を参照してください。

importlogginglogger=logging.getLogger("openai.agents")# or openai.agents.tracing for the Tracing logger# To make all logs show uplogger.setLevel(logging.DEBUG)# To make info and above show uplogger.setLevel(logging.INFO)# To make warning and above show uplogger.setLevel(logging.WARNING)# etc# You can customize this as needed, but this will output to `stderr` by defaultlogger.addHandler(logging.StreamHandler())

ログ内の機微なデータ

一部のログには機微なデータ(たとえば、ユーザー データ)が含まれる場合があります。このデータがログに出力されないようにするには、次の環境変数を設定してください。

LLM の入力と出力のログを無効化するには:

exportOPENAI_AGENTS_DONT_LOG_MODEL_DATA=1

ツールの入力と出力のログを無効化するには:

exportOPENAI_AGENTS_DONT_LOG_TOOL_DATA=1

[8]ページ先頭

©2009-2025 Movatter.jp