python development environment, pycharm setup - Alibaba Cloud SDK

Windows'a PyCharm yükleyin, bir Python projesi oluşturun ve ilk Alibaba Cloud API çağrınızı yapın.

Başlamadan önce

Windows çalışan bir bilgisayar.
Sisteminizde yüklü Python.
Bir RAM kullanıcısına ait AccessKey çifti. Alibaba Cloud hesabınızın AccessKey çiftini kullanmayın.

PyCharm'ı yükleyin ve proje oluşturun

Adım 1: PyCharm'ı yükleyin

Resmi PyCharm indirme sayfasına gidin.
Community Edition seçeneğini bulun ve Download öğesine tıklayın.
İndirilen yükleyiciyi çalıştırın ve kurulum sihirbazındaki adımları izleyin.

Önemli
Installation Options adımında, PyCharm'a komut satırından erişimi etkinleştirmek için Add "bin" folder to the PATH seçeneğini belirleyin.

Adım 2: Yeni bir proje oluşturun

PyCharm'ı açın ve New Project öğesine tıklayın.
New Project iletişim kutusunda projenizi yapılandırın:
- Name: Projeniz için bir ad girin; örneğin my-first-app.
- Location: Proje dosyalarınızın bulunduğu dizin.
- Interpreter type: Projenizin çalışma zamanı ortamı.
  - Project venv (Önerilen): Projeler arası bağımlılık çakışmalarını önlemek için projenize özel izole bir sanal ortam (venv) oluşturur.
    
    Python version: Varsayılan olarak sisteminizdeki Python sürümünü kullanır. Birden fazla sürüm yüklüyse farklı bir sürüm seçebilirsiniz.
    
    New Project iletişim kutusunda aşağıdaki yapılandırmaları tamamlayın:
    - Name: Bir proje adı girin; örneğin my-first-app.
    - Location: Projenin kaydedileceği dizini seçin; örneğin D:\ide\PythonProjects.
    - Create a welcome script: Gerekirse bu seçeneği işaretleyin.
    Yapılandırma tamamlandığında, projeyi oluşturmak için sağ alt köşedeki Create düğmesine tıklayın.
  - Base conda: Conda paket yöneticisini kullanır. Veri bilimi, bilimsel hesaplama ve karmaşık bağımlılıklara sahip çok dilli projeler için uygundur.
  - Custom environment: Ortamı manuel olarak yapılandırmanızı sağlar.
    - Environment: Yeni bir ortam oluşturun veya mevcut olanı kullanın.
    - Type: Ortam aracı. Varsayılan olarak Virtualenv seçilidir.
    - Base python: Ortam için kullanılacak Python yorumlayıcı sürümü.
    - Location: Ortamın kaydedileceği dizin.
      - Inherit packages from base interpreter: Temel yorumlayıcıdaki paketleri dahil eder.
      - Make available to all projects: Bu ortamın diğer projeler tarafından kullanılabilmesini sağlar.
        
        New Project iletişim kutusunda solda Pure Python proje türünü seçin, sağ tarafta Name (örneğin my-first-app) ve Location (projenin kaydedileceği dizin) alanlarını doldurun ve ardından Create düğmesine tıklayın.
Create düğmesine tıklayın.

Adım 3: Python dosyası oluşturun ve çalıştırın

Soldaki Project araç penceresinde projenizin klasörüne (örneğin my-first-app) sağ tıklayın ve New > Python File seçeneklerini seçin.
İletişim kutusunda dosyanız için bir ad girin (örneğin hello_alibabacloud) ve Enter tuşuna basın.
hello_alibabacloud.py düzenleyici penceresine aşağıdaki kodu yazın:
```
print("Hello, Alibaba Cloud!")
```
Betik çalıştırmak için düzenleyicinin sağ üst köşesindeki yeşil Run simgesine tıklayın. Alt kısımdaki Run araç penceresinde Hello, Alibaba Cloud! çıktısı görüntülenir.

Entegre terminali kullanma

PyCharm'ın entegre terminali, projenizin sanal ortamını otomatik olarak kullanır. Terminali açmak için Terminal sekmesine tıklayın veya Alt+F12 tuşlarına basın. Betikleri çalıştırmak (python hello_alibabacloud.py) veya pip ile paket yüklemek (pip install requests) için terminali kullanabilirsiniz.

hello_alibabacloud.py dosyasının içeriği:

print("Hello, Alibaba Cloud!")

Terminalde betiği python komutuyla çalıştırın ve üçüncü taraf paketleri pip install komutuyla yükleyin:

(.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)

Sonraki adımlar

Alibaba Cloud hizmetleriyle etkileşime giren uygulamalar geliştirmeye başlayın.

Örnek 1: Alibaba Cloud SDK ile hizmet API'si çağırma

ECS DescribeInstanceTypeFamilies işlemini çağırmak için Python için Alibaba Cloud SDK'yı kullanın.

Kimlik doğrulamayı ayarlama

API çağrıları bir RAM kullanıcısına ait AccessKey çifti gerektirir. Daha fazla bilgi için bkz. AccessKey oluşturma.

Önemli

Kimlik bilgilerini her zaman ortam değişkenlerinde saklayın, kod içinde asla bulundurmayın. Talimatlar için bkz. Linux, macOS ve Windows'ta ortam değişkenlerini yapılandırma.

SDK örnek kodunu oluşturma ve çalıştırma

SDK Center sayfasına gidin.
Hizmeti (örneğin ECS) ve API işlemini (örneğin DescribeInstanceTypeFamilies) seçin.
Parameters sekmesinde gerekli parametreleri doldurun. Bu örnek için RegionId değerini cn-qingdao ve Generation değerini ecs-5 olarak ayarlayın.
Sağdaki sütunda SDK Sample Code sekmesine tıklayın, Python seçeneğini belirleyin ve Download Project düğmesine tıklayın.

Sağ taraftaki SDK örnek alanında SDK oluşturmayı V2.0 Recommended olarak, dili ise Python olarak ayarlayın.
İndirilen paketi sıkıştırılmış durumdan çıkarın ve projeyi PyCharm'da açın.
Kodu çalıştırdıktan sonra yanıttaki statusCode değeri 200 ise API çağrısı başarılı olmuş demektir ve yanıt gövdesi ECS örnek türü ailelerinin listesini içerir. Aşağıda yanıtın bir kısmı verilmiştir:
```
: '1rHpYSAeV5ewkgoDCes4x8A7'}, 'statusCode': 200, 'body': {'InstanceTypeFamilies': {'InstanceTypeFamily': [{'Generation': 'ecs-5', 'InstanceTypeFamilyId': 'ecs.g6'}, {'Generation': 'ecs-5', 'InstanceTypeFamilyId': 'ecs.ebmg
```

Daha fazla bilgi için bkz. IDE'de Alibaba Cloud Python SDK kullanma.

Örnek 2: Büyük dil modeli (Qwen) çağırma

Alibaba Cloud Model Studio üzerinden OpenAI uyumlu API kullanarak Qwen büyük dil modelini (LLM) çağırın.

Kimlik doğrulamayı ayarlama

Model Studio'yu etkinleştirin ve bir API anahtarı alın. Daha fazla bilgi için bkz. Hesap kurulumu.

Önemli

API anahtarınızı DASHSCOPE_API_KEY adlı bir ortam değişkeni olarak yapılandırın. Talimatlar için bkz. API anahtarınızı ortam değişkeni olarak ayarlama.

SDK'yı yükleme ve örnek kodu çalıştırma

PyCharm terminalinde OpenAI Python SDK'yı yükleyin:

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 mesajı yüklemenin başarılı olduğunu gösterir.

Yeni bir Python dosyası oluşturun ve aşağıdaki kodu ekleyin:

import os
from openai import OpenAI

try:
    client = OpenAI(
        # Reads the API key from the DASHSCOPE_API_KEY environment variable.
        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}")

Betiği çalıştırın. Qwen modelinden bir yanıt görmeniz gerekir.

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.

Daha fazla bilgi için bkz. OpenAI Python SDK.