Cloud Shell の Python から Azure OpenAI を呼び出す

openai SDK を使って Azure OpenAI のチャット補完を呼び出し、会話履歴の持ち回り、ストリーミング、トークン使用量の読み取りまでを Cloud Shell 上の Python で実装します。

入門約 60 分Azure 実環境

ラボ概要

このラボでは、社内ヘルプデスク ボットを Web アプリに組み込む前段として、Azure OpenAI をプログラムから呼び出す一連の基本を Cloud Shell の Python で実装します。プレイグラウンドで試したことを、そのままコードに置き換える練習です。

学習目標:

  • Azure OpenAI リソースと小型モデルのデプロイ(chat)を用意する
  • Cloud Shell に openai SDK をインストールし、環境変数でエンドポイントとキーを渡す
  • chat.completions.create でシステム メッセージ付きの応答を得る
  • 会話履歴(messages 配列)を持ち回って多ターンの対話を実装する
  • ストリーミング応答を受け取り、usage からトークン使用量を読む
前提知識:
  • Python の基本(関数・リスト・辞書)
  • bash の基本コマンド(cd, pip install, 環境変数)
完了条件:
  • Azure OpenAI リソースと、名前に mini を含むモデルのデプロイ chat が存在すること
  • Cloud Shell で作成したスクリプトが応答を表示し、トークン使用量が出力されること
> このラボのサンドボックスでは、小型モデルのみ・容量 10K TPM 以下のデプロイだけが許可されています。

ラボの構成

  1. 1Azure Portal にサインインしてラボ環境を確認する
  2. 2Azure OpenAI リソースを作成する
  3. 3Cloud Shell からモデルをデプロイする
  4. 4SDK をインストールして環境変数を設定する
  5. 5最初の呼び出しを書く
  6. 6会話履歴を持ち回る多ターン対話にする
  7. 7ストリーミングで応答を逐次表示する
  8. 8エラー処理とリトライを加える
  9. 9結果を考察する

詳細な手順は、ラボ開始後に画面内のガイドとして表示されます。

手順のプレビュー(最初のステップ)

1. Azure Portal にサインインしてラボ環境を確認する

  • 学習者ポータルに表示されている URL / Username / Password で https://portal.azure.com にサインインする
  • 「サインインの状態を維持しますか?」と表示されたら いいえ を選択する
  • 本ラボ用のリソース グループ(名前が lab- で始まる)を開いて名前を控える
> 注: シークレット(InPrivate)ウィンドウでの操作を推奨します。
残り 8 セクションの手順は、ラボを開始すると画面内に表示されます

構成図

構成図

参考リソース

このラボが対応する試験の模擬問題集

本番形式の問題で理解度を確認できます。各試験とも先頭 15 問は無料です。

AI-103Azure AI Engineer練習テスト 2 回・全 160 問