python development environment, pycharm setup - Alibaba Cloud SDK - Alibaba Cloud ドキュメントセンター

事前準備

Windows が動作するコンピューター。
システムに Python がインストールされていること。
RAM ユーザーの AccessKey ペア。Alibaba Cloud アカウントの AccessKey ペアは使用しないでください。

PyCharm のインストールとプロジェクトの作成

ステップ 1: PyCharm のインストール

PyCharm 公式ダウンロードページにアクセスします。
[コミュニティ版] を見つけ、[ダウンロード] をクリックします。
ダウンロードしたインストーラーを実行し、セットアップウィザードに従います。

重要
[インストールオプション] ステップでは、PyCharm へのコマンドラインアクセスを有効にするために、["bin" フォルダーを PATH に追加] を選択します。

ステップ 2: 新しいプロジェクトの作成

PyCharm を開き、[新規プロジェクト] をクリックします。
[新しいプロジェクト] ダイアログボックスで、プロジェクトを設定します：
- [名前]: my-first-app などのプロジェクト名を入力します。
- [ロケーション]：プロジェクトファイル用のディレクトリです。
- [インタープリタータイプ]: プロジェクトのランタイム環境です。
  - [プロジェクト venv] (推奨): プロジェクト用に分離された仮想環境 (venv) を作成し、プロジェクト間の依存関係の競合を防ぎます。
    
    [Python バージョン]: デフォルトでは、システムの Python バージョンが使用されます。複数インストールされている場合は、別のバージョンを選択します。
    [新規プロジェクト] ダイアログボックスで、次の設定を行います。
    - Name: Enter a project name, for example my-first-app.
    - Location: Select the directory where the project is stored, for example D:\ide\PythonProjects.
    - Create a welcome script: Select this option if needed.
    設定が完了したら、右下隅の[作成]をクリックしてプロジェクトを作成します。
  - [Base conda]: Conda パッケージマネージャーを使用します。データサイエンス、科学計算、および複雑な依存関係を持つ多言語プロジェクトに適しています。
  - [カスタム環境]: 環境を手動で設定します。
    - [環境]：新しい環境を作成するか、既存の環境を使用します。
    - [タイプ]: 環境ツールです。 Virtualenv がデフォルトです。
    - [ベース Python]: 環境の Python インタープリターのバージョンです。
    - [ロケーション]: 環境のディレクトリです。
      - [ベースインタープリターからパッケージを継承]: ベースインタープリターのパッケージを含みます。
      - [すべてのプロジェクトで利用可能にする]: この環境が他のプロジェクトからアクセス可能になります。
        [新規プロジェクト] ダイアログボックスで、左側で [Pure Python] プロジェクトタイプを選択し、右側で [名前] (たとえば my-first-app) と [場所] (プロジェクトが保存されるディレクトリ) を設定してから、[作成] をクリックします。
[作成] をクリックします。

ステップ 3: Python ファイルの作成と実行

左側のプロジェクトツールウィンドウで、プロジェクトフォルダー (my-first-app など) を右クリックし、[新規] > [Python ファイル] を選択します。
ダイアログボックスで、ファイル名 (hello_alibabacloud など) を入力し、Enter キーを押します。
hello_alibabacloud.py のエディターウィンドウで、次のコードを入力します。
```
print("Hello, Alibaba Cloud!")
```
スクリプトを実行するには、エディターの右上隅にある緑色の [実行] アイコンをクリックします。出力 Hello, Alibaba Cloud! は、下部の [実行] ツールウィンドウに表示されます。

統合ターミナルの使用

PyCharm の統合ターミナルは、プロジェクトの仮想環境を自動的に使用します。[ターミナル] タブをクリックするか、Alt+F12 を押して開きます。これを使用して、スクリプト (python hello_alibabacloud.py) を実行したり、pip (pip install requests) でパッケージをインストールしたりできます。

hello_alibabacloud.py の内容：

print("Hello, Alibaba Cloud!")

ターミナルで、python コマンドでスクリプトを実行し、pip install でサードパーティパッケージをインストールします。

(.venv) PS D:\ide\PythonProjects\my-first-app> python hello_alibabacloud.py
Hello, Alibaba Cloud!
(.venv) PS D:\ide\PythonProjects\my-first-app> pip install requests
Collecting requests
  Obtaining dependency information for requests from https://files.pythonhosted.org/packages/70/8e/0e2d847013cb52cd35b38c009bb167a1a26b2ce6cd6965bf26b47bc0bf44/requests-2.31.0-py3-none-any.whl.metadata
  Downloading requests-2.31.0-py3-none-any.whl.metadata (4.6 kB)
Collecting charset-normalizer<4,>=2 (from requests)
  Obtaining dependency information for charset-normalizer<4,>=2 from https://files.pythonhosted.org/packages/b6/7c/8debebb4f90174074b827c63242c23851bdf00a53249fba57fef3416e40/charset_normalizer-3.3.2-cp312-cp312-win_amd64.whl.metadata
  ...ding charset_normalizer-3.3.2-cp312-cp312-win_amd64.whl.metadata (34 kB)
Collecting idna<4,>=2.5 (from requests)
  Obtaining dependency information for idna<4,>=2.5 from https://files.pythonhosted.org/packages/e5/3e/741d8c82801c347547f8a2a06a57dbb01992be9e948df2ea0eda2c8b79e8/idna-3.7-py3-none-any.whl.metadata
  Downloading idna-3.7-py3-none-any.whl.metadata (9.9 kB)

次のステップ

Alibaba Cloud サービスと連携するアプリケーションの構築を開始します。

例 1: Alibaba Cloud SDK によるサービス API の呼び出し

Alibaba Cloud SDK for Python を使用して、Elastic Compute Service (ECS) の DescribeInstanceTypeFamilies API を呼び出します。

認証のセットアップ

API 呼び出しには、RAM ユーザーの AccessKey ペアが必要です。詳細については、「AccessKey の作成」をご参照ください。

重要

認証情報は必ず環境変数に保存し、コードには記述しないでください。手順については、「Linux、macOS、Windows での環境変数の設定」をご参照ください。

SDK サンプルコードの生成と実行

SDK センターにアクセスします。
サービス ([ECS] など) と API 操作 ([DescribeInstanceTypeFamilies] など) を選択します。
[パラメーター] タブで、必要なパラメーターを入力します。この例では、RegionId を cn-qingdao に、Generation を ecs-5 に設定します。
右端の列で、[SDK サンプルコード] タブをクリックし、[Python] を選択して、[プロジェクトのダウンロード] をクリックします。
右側の SDK サンプルエリアで、SDK の生成を [V2.0 推奨] に、言語を [Python] に設定します。
ダウンロードしたパッケージを解凍し、PyCharm でプロジェクトを開きます。
コードを実行すると、レスポンスの statusCode 値が 200 であれば API 呼び出しが成功したことを示し、レスポンスボディには ECS インスタンスタイプファミリーのリストが含まれます。以下はレスポンスの一部です。
```
: '1rHpYSAeV5ewkgoDCes4x8A7'}, 'statusCode': 200, 'body': {'InstanceTypeFamilies': {'InstanceTypeFamily': [{'Generation': 'ecs-5', 'InstanceTypeFamilyId': 'ecs.g6'}, {'Generation': 'ecs-5', 'InstanceTypeFamilyId': 'ecs.ebmg
```

詳細については、「IDE での Alibaba Cloud Python SDK の使用」をご参照ください。

例 2: 大規模言語モデル (Qwen) の呼び出し

Alibaba Cloud Model Studio の OpenAI 互換 API を通じて、Qwen 大規模言語モデル (LLM) を呼び出します。

認証のセットアップ

Model Studio を有効化し、API キーを取得します。詳細については、「アカウントのセットアップ」をご参照ください。

重要

API キーを DASHSCOPE_API_KEY という名前の環境変数として設定します。手順については、「API キーを環境変数として設定」をご参照ください。

SDK のインストールとサンプルコードの実行

PyCharm ターミナルで、OpenAI Python SDK をインストールします。

pip install -U openai

Downloading jiter-0.8.2-cp312-cp312-win_amd64.whl (204 kB)
   204.7/204.7 kB 654.9 kB/s eta 0:00:00
Downloading pydantic-2.10.6-py3-none-any.whl (431 kB)
   431.7/431.7 kB 642.5 kB/s eta 0:00:00
Downloading pydantic_core-2.27.2-cp312-cp312-win_amd64.whl (2.0 MB)
   2.0/2.0 MB 715.4 kB/s eta 0:00:00
Downloading sniffio-1.3.1-py3-none-any.whl (10 kB)
Downloading tqdm-4.67.1-py3-none-any.whl (78 kB)
   78.5/78.5 kB 875.6 kB/s eta 0:00:00
Downloading typing_extensions-4.12.2-py3-none-any.whl (37 kB)
Downloading annotated_types-0.7.0-py3-none-any.whl (13 kB)
Downloading h11-0.14.0-py3-none-any.whl (58 kB)
   58.3/58.3 kB 762.2 kB/s eta 0:00:00
Installing collected packages: typing-extensions, tqdm, sniffio, jiter, h11, distro, annotated-types, pydantic-core, httpcore, anyio, pydantic, httpx, openai
Successfully installed annotated-types-0.7.0 anyio-4.8.0 distro-1.9.0 h11-0.14.0 httpcore-1.0.7 httpx-0.28.1 jiter-0.8.2 openai-1.65.2 pydantic-2.10.6 pydantic-core-2.27.2 sniffio-1.3.1 tqdm-4.67.1 typing-extensions-4.12.2

Successfully installed ... openai-x.x.x というメッセージが表示されれば、インストールが完了しています。

新しい Python ファイルを作成し、次のコードを追加します。

import os
from openai import OpenAI

try:
    client = OpenAI(
        # DASHSCOPE_API_KEY 環境変数から API キーを読み取ります。
        api_key=os.getenv("DASHSCOPE_API_KEY"),
        base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
    )

    completion = client.chat.completions.create(
        model="qwen-plus",
        messages=[
            {'role': 'system', 'content': 'You are a helpful assistant.'},
            {'role': 'user', 'content': 'Who are you?'}
        ]
    )
    print(completion.choices[0].message.content)
except Exception as e:
    print(f"An error occurred: {e}")

スクリプトを実行します。Qwen モデルからのレスポンスが表示されます。

D:\official_site\Demo\venv\Scripts\python.exe D:\official_site\Demo\venv\ecsram\TongYi.py
I am a large language model from Alibaba Cloud. My name is Qwen.

詳細については、「OpenAI Python SDK」をご参照ください。