Configuração do Python para uso com o Analytics

O Analytics oferece diferentes opções de integração da linguagem de programação Python e o script do Python com seus fluxos de trabalho de automação e análise de dados.

Área funcional do Analytics	Número de bits do Python necessário	Versão do Python compatível	Método de configuração do Python
Comando IA do ACLScript (AICOMMAND) Comando ACLScript Python (PYCOMMAND)	64 bits (recomendado) 32 bits	3.12.4 (testado) Outras versões do Python não foram testadas, mas provavelmente funcionarão.	O cliente instala e configura o Python separadamente do Analytics Consulte Configurar o Python para oferecer suporte aos comandos do ACLScript de IA e Python
Funções do ACLScript Python	32 bits	3,7, 3,8, 3,9	O cliente instala e configura o Python separadamente do Analytics Consulte Configurar o Python para compatibilidade com as funções Python do ACLScript
Comandos de aprendizado de máquina do ACLScript	32 bits	3.7.9	O cliente seleciona a instalação opcional do Python durante o processo de instalação do Consultar Instalar o ACL para Windows

Configurar o Python para oferecer suporte aos comandos do ACLScript de IA e Python

Instale e configure o Python para ser compatível com o uso do comando do ACLScript de IA e Python (AICOMMAND e PYCOMMAND). Você também deve instalar o módulo Pandas. Para usar o comando de IA, você também precisa instalar a biblioteca de API Python da OpenAI.

O comando de IA permite incorporar processamento de IA fornecido externamente à sua análise de dados no Analytics. Um script Python é usado como intermediário entre o Analytics e o serviço de IA.

O comando Python permite que você integre perfeitamente os scripts do Analytics e do Python e movimente dados entre os dois ambientes.

Instale o Python (64 bits ou 32 bits)

1. Na página de downloads do Python, baixe uma versão recente do Python para seu computador ou servidor.

   Os comandos do ACLScript de IA e Python foi testado com Python 3.12.4. Não há garantias de que outras versões do Python funcionem, mas existe a possibilidade.

2. No computador ou servidor, clique duas vezes no arquivo de instalação do Python.

3. No instalador, selecione Usar privilégios de administrador ao instalar py.exe.

4. Clique em Instalar agora e siga as instruções na tela.

Adicione os caminhos da pasta do Python à variável de ambiente PATH

Adicione dois caminhos de pasta para a instalação do Python à variável de ambiente PATH.

1. Na barra de ferramentas do Windows, pesquise por variáveis de ambiente.

2. Selecione Editar as variáveis​de ambiente do sistema.

   A caixa de diálogo Propriedades do Sistema é exibida.

3. Na guia Avançado, selecione Variáveis de ambiente.

   A caixa de diálogo Variáveis de ambiente é exibida.

4. Na lista Variáveis​do sistema, selecione Caminho e selecione Editar.

   A caixa de diálogo Editar variável de ambiente é exibida.

5. Para adicionar dois caminhos de pasta Python, faça o seguinte:

   1. Selecione Novo e adicione esse caminho de pasta (local de instalação padrão do Python):

      C:\Users\<USER>\AppData\Local\Programs\Python\Python<version>\

      Observação

      Se você instalou o Python em um local diferente, especifique o caminho correto para a pasta que contém o executável do Python (python.exe).

   2. Selecione o caminho recém-adicionado e use Mover para cima para mover o caminho para o topo da lista.

   3. Selecione Novo mais uma vez e adicione esse caminho de pasta, fazendo as alterações necessárias:

      C:\Users\<USER>\AppData\Local\Programs\Python\Python<version>\Scripts

   4. Selecione o segundo caminho adicionado e use Mover para cima para mover o caminho para baixo do primeiro caminho adicionado.

6. Para salvar suas alterações, selecione OK em cada caixa de diálogo:

   • Edite a variável de ambiente

   • Variáveis de ambiente

   • Propriedades do sistema

7. Reinicie o computador ou o servidor para garantir que as atualizações na variável de ambiente Path entrem em vigor.

   Observação

   Pode não ser necessário reiniciar, dependendo do seu sistema operacional e do ambiente. No entanto, se o próximo conjunto de etapas não funcionar, reinicie o computador ou o servidor antes de tentar executar as etapas novamente.

Crie um ambiente virtual do Python

1. Crie uma pasta do Windows para colocar o ambiente virtual do Python.

   Por exemplo, C:\Python_ACL_integration.

2. Abra um prompt de comando do Windows e Executar como administrador.

3. Digite python.exe --version e aperte Enter.

   A versão do Python que você instalou deve ser retornada. Por exemplo:
   Python 3.12.4.

   Se o comando não for reconhecido pelo prompt de comando do Windows, suas atualizações na variável de ambiente Path podem não ter estar em vigor. Reinicie o computador ou o servidor e tente novamente.

4. Mude para a pasta que você criou para o ambiente virtual do Python.

   Por exemplo, cd C:\Python_ACL_integração.

5. Para criar o ambiente virtual do Python, digite este comando: python -m venv venv.

   O primeiro venv especifica que o módulo venv do Python é usado. O segundo venv nomeia o ambiente virtual. Se desejar, você pode especificar um nome diferente para o ambiente virtual, mas certifique-se de que o nome faça uma referência óbvia a um ambiente virtual.

   Agora você deve ter uma subpasta venv na pasta que criou para o ambiente virtual do Python. Por exemplo, C:\Python_ACL_integration\venv.

   Se a criação do ambiente virtual do Python não foi bem-sucedida, suas atualizações na variável de ambiente Path podem não estar em vigor. Reinicie o computador ou o servidor e tente novamente.

6. Para ativar o ambiente virtual do Python, digite este comando: .\venv\Scripts\activate.

   O prompt de comando deve retornar a pasta do ambiente virtual precedida por (venv). Por exemplo, (venv) c:\Python_ACL_integração>

7. Para instalar o módulo Pandas no ambiente virtual do Python, digite este comando: pip install pandas.

   Se a instalação do Pandas for bem-sucedida, a mensagem do prompt de comando deverá mostrar uma linha final como:

   Instalação bem-sucedida numpy-2.2.2 pandas-2.2.3 python-dateutil-2.9.0.post0 pytz-2024.2 six-1.17.0 tzdata-2025.1

8. Para instalar a biblioteca da API Python da OpenAI no ambiente virtual do Python, digite este comando: pip install openai.

   Se a instalação da biblioteca OpenAI for bem-sucedida, a mensagem no prompt de comando deverá exibir uma linha final semelhante a:

   Successfully installed annotated-types-0.7.0 anyio-4.11.0 certifi-2025.10.5 colorama-0.4.6 distro-1.9.0 h11-0.16.0 httpcore-1.0.9 httpx-0.28.1 idna-3.11 jiter-0.11.1 openai-2.6.0 pydantic-2.12.3 pydantic-core-2.41.4 sniffio-1.3.1 tqdm-4.67.1 typing-extensions-4.15.0 typing-inspection-0.4.2

Adicione o caminho do ambiente virtual às Opções do

1. Abra o ACL para Windows.

2. No menu principal do Analytics, selecione Ferramentas > Opções.

3. Selecione a guia Sistema.

4. No campo Caminho do Python, digite o caminho completo e o nome do arquivo para o executável do Python no ambiente virtual que você acabou de criar.

   Por exemplo, C:\Python_ACL_integration\venv\Scripts\python.exe

5. Clique em OK para salvar suas alterações.

Próximas etapas

Se a instalação e configuração do Python, do ambiente virtual, do Pandas e da biblioteca OpenAI foram bem-sucedidas, você está pronto para testar a integração entre o Analytics e o Python. Para obter mais informações, consulte:

• Usando IA com análise de dados

• Comando AICOMMAND

• Integração de scripts Python

• Comando PYCOMMAND

Configurar o Python para compatibilidade com as funções Python do ACLScript

Para configurar o Python para uso com o Analytics, é necessário instalar uma versão compatível do Python e adicionar o executável do Python à variável de ambiente de sistema PATH. Também é necessário definir as variáveis de ambiente de sistema ACLPYTHONDLL e PYTHONPATH.

Como funciona

Para executar scripts do Python, o Analytics deve ser capaz de chamar o executável do Python e encontrar os scripts que ele está instruído a executar. O Analytics usa a variável de ambiente PATH para localizar o Python e a variável de ambiente PYTHONPATH para localizar scripts.

Instale o Python (32 bits)

1. Na página Downloads Python, baixe uma das seguintes versões do Python no computador ou servidor:
   • 3.7.x
   • 3.8.x
   • 3.9.x

   Observação

   As versões listadas do Python foram testadas e verificadas como funcionais com o Analytics ou o Agente do Robôs.

   Qualquer versão do Python a partir de 3.7.x em diante deve funcionar. No entanto, não garantimos que versões diferentes das listadas funcionem.

2. No computador ou servidor, clique duas vezes no arquivo de instalação.
3. No instalador, selecione Adicionar Python número_da_versão ao PATH.
4. Clique em Instalar e siga as instruções na tela.
5. Reinicie o computador ou o servidor antes de executar qualquer script do Python chamado por um script do Analytics.

Defina as variáveis de ambiente de sistema ACLPYTHONDLL e PYTHONPATH

1. No drive C:\ do sistema operacional, crie uma ou mais pastas para hospedar os scripts do Python.

   ExemploC:\python_scripts

2. No sistema operacional, abra a caixa de diálogo Propriedades do sistema e clique em Variáveis do Ambiente.
3. Na seção Variáveis do sistema, clique em Novo e insira as seguintes variáveis:

   Nome da variável	Valor da variável
   PYTHONPATH	O caminho completo para a(s) pasta(s) que você criou para armazenar os scripts Python. Separe vários caminhos de pasta com um ponto e vírgula. Exemplo: C:\python_scripts;C:\dev;C:\tmp
   ACLPYTHONDLL	O caminho completo e o nome do arquivo DLL do Python na pasta de instalação do Python. Exemplo: c:\python_install\python35.dll Observação Após a instalação, o Python adiciona a DLL à pasta do sistema (c:\windows\system32\python35.dll) em vez da pasta de instalação. É necessário copiar a DLL da pasta do sistema para a pasta de instalação e usar a pasta de instalação como o valor da variável. O Analytics ou o Agente do Robôs procuram a DLL na pasta de instalação do Python. Você também pode precisar remover qualquer configuração somente leitura da pasta de instalação.

4. Para salvar a variável, clique em OK e na caixa de diálogo Propriedades do Sistema, clique em OK.

Use o Python em funções do Python do

No Analytics, use as funções do Python do Analytics para chamar funções dos scripts existentes no PYTHONPATH.

Para obter mais informações, consulte Python.