カスタマーサポートのトリアージでOpenAI APIキーを安全に使う方法
カスタマーサポートのトリアージでOpenAIを使うための実践的なセキュリティ手順を解説します。APIキーの保護、ログのマスキング、権限の最小化、認証情報のローテーション、人による承認について紹介します。
要約 · TL;DR
カスタマーサポートのトリアージでは、OpenAIのアプリケーションキーを信頼できるサーバー側コンポーネントに保管し、必要最小限に絞ってマスキングしたケース情報だけを送信します。機密情報や会話全文ではなく判断内容を記録し、顧客向けの対応には人の承認を必須にします。用途ごとに最小権限の認証情報を使い、ローテーションや失効の手順を文書化しましょう。
要点
- アプリケーションAPIキーを、エージェントが生成したコード、ブラウザー、コンテナイメージ、ソース管理、ログに含めないでください。
- サポートケースをモデルに送る前に、個人情報や機密情報をマスキングしてください。送信後に保持する情報も必要最小限にします。
- モデルにはカテゴリ、優先度、返信案の提案をさせるにとどめ、ケースのクローズ、返金、返信送信は人の承認なしに行わせないでください。
- 用途ごとに認証情報を分け、必要なAPI権限だけを付与し、キーのローテーションと失効を事前に訓練してください。
目次 (7)
安全な基本方針:モデルには提案させ、実行はさせない
カスタマーサポートのトリアージでは、自動で問題を解決させるのではなく、まず分類と要約に使うのが一般的に有効です。モデルに振り分け先、緊急度、要約案を提案させ、サポート担当者が根拠を確認して次の対応を決めます。
APIリクエストを行う、信頼できるサーバー側サービスにOpenAIのアプリケーションキーを保管してください。顧客が使うブラウザーや、エージェント環境で実行されるコードにキーを公開してはいけません。OpenAIのサンドボックスセキュリティガイドでは、エージェントが生成したコードは、その環境で利用可能なファイル、認証情報、ネットワークリソースにアクセスできると警告しています。アプリケーションキーをその環境の外に保管し、ソースコード、イメージ、ログに埋め込まないよう推奨しています。OpenAIのサンドボックスセキュリティガイダンス
以下の例は仕組みを示すためのものであり、動作確認済みの設定ではありません。使用するAPIクライアント、プライバシー要件、サポートシステムに合わせて調整してください。
最小限のトリアージフロー
- サポートシステムがケースを受け取り、トリアージに不要な項目を削除します。
- 信頼できるバックエンドが機密情報をマスキングし、サーバー側の認証情報を使って残りのテキストをOpenAIに送信します。
- モデルがカテゴリ、優先度、短い要約を提案します。
- アプリケーションが提案を権限のあるサポート担当者に表示します。担当者が次の対応を承認または編集します。
- シークレットを保持したり、会話全文を不必要に複製したりせず、判断内容と必要な監査メタデータをシステムに記録します。
たとえば、バックエンドから範囲を意図的に絞ったプロンプトと、マスキング済みのケースを渡せます。パスワード、決済カード情報、認証トークン、無関係なアカウント履歴は含めないでください。マスキングルールは、ログ記録時だけでなく、リクエストの送信前に適用してください。
# Illustrative pseudocode: provide an already-redacted case to your API client.
# Keep credential loading and the API call in a trusted backend service.
def propose_triage(api_client, redacted_case):
response = api_client.create_response(
instructions=(
"Suggest a support category, priority, and concise summary. "
"Do not claim to have resolved the case or send a reply. "
"If information is insufficient, say what is missing."
),
input=redacted_case,
)
return response
この例は、そのまま使えるOpenAI SDKのサンプルではありません。メソッド名やリクエストのフィールドは、利用するクライアントやAPIエンドポイントによって異なります。実装前に最新のAPIリファレンスで、エンドポイント、対応パラメーター、レスポンス形式を確認してください。モデルの出力を、サポート対応を実行する許可として扱ってはいけません。
キーと権限を分けて管理する
可能であれば、アプリケーションやワークロードごとに別の認証情報を使いましょう。これにより、誤りがあった場合の影響範囲を限定でき、無関係なサービスに影響を与えずに認証情報を失効しやすくなります。キーが必要なシステムだけにアクセスを制限し、管理されたシークレットストアなど、保護されたサーバー側の仕組みに保管してください。リクエストを行う信頼できるコンポーネントにのみ注入します。
OpenAIのガイダンスで説明されているAgents API環境では、セッション用のアプリケーションキーにapi.agents.readとapi.agents.writeが、推論用にapi.responses.writeが必要です。Vaultの管理にはapi.vaults.readとapi.vaults.writeが必要です。このガイドでは、環境キーとアプリケーションキーを区別しています。環境キーは環境の接続を許可しますが、その他のAPI操作を認可することはできません。実際に使用するAPI機能に必要な権限を確認し、Vaultを管理しないトリアージサービスにはVaultの権限を付与しないでください。
エージェント環境やサンドボックスを使う場合、その中のコードが利用できるものはすべて、エージェントが生成したコードにも公開されると考えてください。サードパーティーの認証情報について、ガイダンスでは、状況に応じて環境の外に保管し、信頼できるプロキシまたはVaultを使う方法を推奨しています。環境に注入されたシークレットも、その中で実行されるコードからアクセスできます。
監査に必要な情報を保ちつつログをマスキングする
ログは誤分類、アクセス上の問題、インシデントの調査に役立ちますが、サポート受信箱の複製になってはいけません。APIキー、認証ヘッダー、プロンプト全文、顧客メッセージの生データ、機密情報を再掲する可能性のあるモデルのレスポンスは記録しないでください。
内部ケース参照番号、リクエスト時刻、モデルまたはエンドポイントの識別子、マスキング状況、提案されたカテゴリ、人による判断、エラー種別など、構造化された必要最小限の記録を優先してください。これらの記録にはアクセス制御と保持期間を設定します。品質確認のためにレビュアーが会話例を必要とする場合は、本番のペイロードを気づかれないまま保持するのではなく、別途管理し、情報を絞ったデータセットを作成してください。
個人情報が自由記述、引用されたメールのやり取り、添付ファイル、特殊な形式に含まれていると、マスキングに失敗することがあります。現実的なケースでルールをテストし、システムから送信されるデータを確認してください。機密情報を確実に取り除けない場合に備え、安全な代替手段も用意します。
ローテーションと失効の手順を定める
ローテーション計画には、担当者、認証情報の保管場所、使用しているサービス、認証情報を交換できる人、変更を確認する方法を明記します。実践的な手順の例は次のとおりです。
- 必要な権限だけを持つ新しい認証情報を作成します。
- 信頼できるサービスのシークレットストアを更新し、通常の変更手順でデプロイまたは再読み込みします。
- 診断情報に認証情報を露出させず、安全なトリアージリクエストが成功することを確認します。
- 古い認証情報を失効させ、サービスがそれに依存していないことを確認します。
- 日付、担当者、対象ワークロード、結果を記録します。シークレットの値は記録しないでください。
組織のリスクと運用要件に合った頻度で定期的に見直してください。情報漏えいが疑われる場合は、次の定期ローテーションを待たずに速やかにキーを失効させます。OpenAIのガイダンスでも、必要に応じてキーをローテーションまたは失効させ、漏えいが疑われる場合は直ちに認証情報を失効させるよう明示しています。
人による承認と障害時の対応
承認をプロンプトだけの指示にせず、システムのルールにしてください。このワークフローでは、モデルに顧客へのメッセージ送信、アカウント状態の変更、返金を行うツールへ直接アクセスさせるべきではありません。モデルの提案をあくまで案として提示し、関連するマスキング済みの根拠を表示したうえで、重大な影響を伴う対応は権限のある人が確認して承認するようにします。
APIが利用できない、レスポンス形式が不正、マスキングに失敗した場合は、既存の手動キューにケースを回してください。確信の持てない分類を、自動対応に黙って切り替えてはいけません。
チェックリスト
- アプリケーションキーは信頼できるバックエンドに保管し、ブラウザーやエージェント環境には置かない。
- 認証情報をワークロードごとに分け、必要な権限だけに制限する。
- 推論の前に機密項目を削除し、通常のログには含めない。
- トリアージ結果は助言として扱い、顧客向けの対応やアカウント変更を人が承認する。
- 認証情報を交換または失効できる担当者を定め、手順を訓練している。
- 障害や確信の持てない出力は、安全な手動対応に戻す。
設計で最も重要なのは、認証情報と重大な影響を伴う操作をモデルから切り離すことです。モデルはサポート業務の整理に活用し、渡すデータを最小限にし、最後の確認を人の承認に委ねましょう。
よくある質問
OpenAI APIキーをエージェントのサンドボックスに置いてもよいですか?
アプリケーションキーをエージェント環境に置くのは避けてください。OpenAIのサンドボックスセキュリティガイダンスによると、エージェントが生成したコードは環境内のファイル、認証情報、ネットワークにアクセスできるため、アプリケーションキーはその環境の外に保管することが推奨されています。APIリクエストには信頼できるバックエンドを使ってください。
カスタマーサポートのトリアージログには何を記録すべきですか?
内部ケース参照番号、タイムスタンプ、マスキング状況、提案されたカテゴリ、人による判断、エラー種別など、運用と監査に必要なメタデータだけを記録してください。APIキー、認証ヘッダー、顧客メッセージ全文、機密情報を含む可能性のあるモデル出力は記録しないでください。
モデルにサポート返信を自動送信させるべきですか?
人が承認するトリアージのワークフローでは、いいえ。モデルの出力は提案として扱い、顧客向けの対応やアカウント変更は、権限のあるサポート担当者が確認して承認するようにしてください。
OpenAI APIキーはいつローテーションすべきですか?
リスクと運用要件に合った頻度で定期的に見直し、必要に応じて認証情報をローテーションしてください。漏えいが疑われる場合は直ちに認証情報を失効させ、交換と確認の手順に従ってください。
関連記事
Guides
認証情報を漏らさずにOpenAI APIの障害を調査する方法
APIキーを保護し、権限を最小限に抑え、認証情報のローテーションを計画しながら、OpenAI APIの障害を有用なシグナルで調査する実践ガイドです。
Guides
人の承認を組み込んだサポートトリアージでOpenAI APIの障害を診断する
認証エラー、レート制限、タイムアウト、不正な形式のモデル応答に対処し、失敗したトリアージ結果が顧客に届くのを防ぐための実践ガイドです。
Guides
文書Q&AワークフローでOpenAI APIキーを安全に管理する
OpenAIを使った文書Q&Aアプリを安全に運用するための実践的な方法を解説します。認証情報の分離、最小権限の設定、ログの機密情報のマスキング、出典表示、キーの安全なローテーションを紹介します。
Guides
OpenAI APIの認証・レート制限・タイムアウト・不正レスポンスを安全に診断する方法
認証、リクエスト制限、タイムアウト、不正なレスポンスなどのOpenAI APIエラーを、認証情報やユーザーデータを漏らさず診断するための実践的なガイドです。