python development environment, pycharm setup - Alibaba Cloud SDK: Central de Documentação do Alibaba Cloud

Instale o PyCharm no Windows, crie um projeto Python e faça sua primeira chamada de API da Alibaba Cloud.

Antes de começar

Um computador com Windows.
Python instalado no sistema.
Um par de AccessKey de um usuário RAM. Não use o par de AccessKey da sua conta Alibaba Cloud.

Instale o PyCharm e crie um projeto

Etapa 1: Instalar o PyCharm

Acesse a página oficial de download do PyCharm.
Localize a Community Edition e clique em Download.
Execute o instalador baixado e siga o assistente de configuração.

Importante
Na etapa Installation Options, selecione Add "bin" folder to the PATH para habilitar o acesso ao PyCharm pela linha de comando.

Etapa 2: Criar um novo projeto

Abra o PyCharm e clique em New Project.
Na caixa de diálogo New Project, configure o projeto:
- Name: Insira um nome para o projeto, como my-first-app.
- Location: O diretório para os arquivos do projeto.
- Interpreter type: O ambiente de execução do projeto.
  - Project venv (Recomendado): Cria um ambiente virtual isolado (venv) para o projeto e evita conflitos de dependências entre projetos.
    
    Python version: Usa a versão do Python instalada no sistema por padrão. Selecione outra versão se houver múltiplas instalações.
    
    Na caixa de diálogo New Project, conclua a seguinte configuração:
    - Name: Insira um nome para o projeto, por exemplo my-first-app.
    - Location: Selecione o diretório onde o projeto será armazenado, por exemplo D:\ide\PythonProjects.
    - Create a welcome script: Selecione esta opção se necessário.
    Após concluir a configuração, clique em Create no canto inferior direito para criar o projeto.
  - Base conda: Usa o gerenciador de pacotes Conda. Ideal para ciência de dados, computação científica e projetos multilíngues com dependências complexas.
  - Custom environment: Configura o ambiente manualmente.
    - Environment: Crie um novo ambiente ou use um existente.
    - Type: A ferramenta de ambiente. Virtualenv é o padrão.
    - Base python: A versão do interpretador Python para o ambiente.
    - Location: O diretório do ambiente.
      - Inherit packages from base interpreter: Inclui pacotes do interpretador base.
      - Make available to all projects: Torna este ambiente acessível a outros projetos.
        
        Na caixa de diálogo New Project, selecione o tipo de projeto Pure Python à esquerda, defina Name (por exemplo, my-first-app) e Location (o diretório onde o projeto é salvo) à direita e clique em Create.
Clique em Create.

Etapa 3: Criar e executar um arquivo Python

Na janela de ferramentas Project à esquerda, clique com o botão direito na pasta do projeto (como my-first-app) e escolha New > Python File.
Na caixa de diálogo, insira um nome para o arquivo, como hello_alibabacloud, e pressione Enter.
Na janela do editor para hello_alibabacloud.py, digite o seguinte código:
```
print("Hello, Alibaba Cloud!")
```
Para executar o script, clique no ícone verde Run no canto superior direito do editor. A saída Hello, Alibaba Cloud! aparece na janela de ferramentas Run na parte inferior.

Use o terminal integrado

O terminal integrado do PyCharm usa automaticamente o ambiente virtual do seu projeto. Clique na aba Terminal ou pressione Alt+F12 para abri-lo. Use-o para executar scripts (python hello_alibabacloud.py) ou instalar pacotes com pip (pip install requests).

Conteúdo de hello_alibabacloud.py:

print("Hello, Alibaba Cloud!")

No terminal, execute o script com o comando python e instale pacotes de terceiros com 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)

Próximos passos

Comece a criar aplicações que interagem com services da Alibaba Cloud.

Exemplo 1: Chamar uma API de service com o SDK da Alibaba Cloud

Use o SDK da Alibaba Cloud para Python para chamar a operação DescribeInstanceTypeFamilies do ECS.

Configurar autenticação

As chamadas de API exigem um par de AccessKey de um usuário RAM. Para mais informações, consulte Create an AccessKey.

Importante

Sempre armazene credenciais em variáveis de ambiente, nunca no código. Para instruções, consulte Configure environment variables in Linux, macOS, and Windows.

Gerar e executar o código de exemplo do SDK

Acesse o SDK Center.
Selecione o service (como ECS) e a operação de API (como DescribeInstanceTypeFamilies).
Na aba Parameters, preencha os parâmetros obrigatórios. Neste exemplo, defina RegionId como cn-qingdao e Generation como ecs-5.
Na coluna mais à direita, clique na aba SDK Sample Code, selecione Python e clique em Download Project.

Na área de amostra do SDK à direita, defina a geração do SDK como V2.0 Recommended e a linguagem como Python.
Descompacte o pacote baixado e abra o projeto no PyCharm.

Após executar o código, um valor statusCode igual a 200 na resposta indica que a chamada de API foi bem-sucedida e o corpo da resposta contém a lista de famílias de tipos de instância ECS. Veja abaixo parte da resposta:

: '1rHpYSAeV5ewkgoDCes4x8A7'}, 'statusCode': 200, 'body': {'InstanceTypeFamilies': {'InstanceTypeFamily': [{'Generation': 'ecs-5', 'InstanceTypeFamilyId': 'ecs.g6'}, {'Generation': 'ecs-5', 'InstanceTypeFamilyId': 'ecs.ebmg

Para mais informações, consulte Use the Alibaba Cloud Python SDK in an IDE.

Exemplo 2: Chamar um modelo de linguagem grande (Qwen)

Chame o modelo de linguagem grande (LLM) Qwen pela API compatível com OpenAI do Alibaba Cloud Model Studio.

Configurar autenticação

Ative o Model Studio e obtenha uma chave de API. Para mais informações, consulte Account setup.

Importante

Configure sua chave de API como uma variável de ambiente chamada DASHSCOPE_API_KEY. Para instruções, consulte Set your API key as an environment variable.

Instalar o SDK e executar o código de exemplo

No terminal do PyCharm, instale o SDK OpenAI para Python:

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

Uma mensagem Successfully installed ... openai-x.x.x confirma a instalação.

Crie um novo arquivo Python e adicione o seguinte código:

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}")

Execute o script. Você verá uma resposta do modelo 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.

Para mais informações, consulte OpenAI Python SDK.