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 utilize 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 ativar 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 seu 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, evitando conflitos de dependências entre projetos.
    
    Python version: Usa por padrão a versão do Python instalada no sistema. Selecione outra versão se houver múltiplas instalações.
  - Base conda: Utiliza 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: Permite configurar 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.
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 utiliza automaticamente o ambiente virtual do seu projeto. Clique na aba Terminal ou pressione Alt+F12 para abri-lo. Utilize-o para executar scripts (python hello_alibabacloud.py) ou instalar pacotes com pip (pip install requests).

PyCharm IDE showing the integrated terminal window.

Próximos passos

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

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

Utilize 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 Criar um AccessKey.

Importante

Sempre armazene credenciais em variáveis de ambiente, nunca no código. Para instruções, consulte Configurar variáveis de ambiente no Linux, macOS e Windows.

Gerar e executar o código de exemplo do SDK

Acesse o SDK Center.
Selecione o serviço (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.
Descompacte o pacote baixado e abra o projeto no PyCharm.
Execute o script. Você deverá ver uma resposta semelhante a esta:

Para mais informações, consulte Usar o SDK Python da Alibaba Cloud em uma IDE.

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

Chame o modelo de linguagem grande (LLM) Qwen através da 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 Primeira chamada à API do Qwen.

Importante

Configure sua chave de API como uma variável de ambiente chamada DASHSCOPE_API_KEY. Para instruções, consulte Primeira chamada à API do Qwen.

Instalar o SDK e executar o código de exemplo

No terminal do PyCharm, instale o SDK Python da OpenAI:
```
pip install -U openai
```
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ê deverá ver uma resposta do modelo Qwen.

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