Oracle Cloud Infrastructure (OCI)

Este guia segue o exemplo em Python da Oracle para a versão beta e usa o provisionamento gerenciado pelo aplicativo. Seu aplicativo cria e exclui tanto a sessão da API de Agentes quanto o sandbox da OCI.

Consulte o exemplo de provisionamento gerenciado pelo aplicativo no OpenAI Cookbook.

Consulte Ciclo de vida do sandbox para saber como funcionam os modos de provisionamento e a conexão.

Antes de começar

Crie um projeto de IA generativa com suporte a sandbox habilitado. Conceda à sua identidade da OCI permissão para gerenciar projetos e sandboxes no compartimento do projeto. Nas políticas de IAM abaixo, substitua os campos entre sinais de menor e maior pelos nomes do grupo e do compartimento.

allow group <group-name> to manage generative-ai-sandbox in compartment <compartment-name>
allow group <group-name> to manage generative-ai-project in compartment <compartment-name>

Use um ambiente de execução de sandbox com Node.js e npm. Por padrão, o exemplo da Oracle solicita python-3.11. Se esse ambiente não incluir npm, escolha um ambiente de execução personalizado compatível.

Se o projeto restringir o tráfego de saída, permita conexões HTTPS com registry.npmjs.org para instalar o Codex, conexões HTTPS com api.openai.com e conexões WebSocket seguras com codex-cloud-environments.chatgpt.com. Consulte Acesso do executor à rede.

1. Instale a CLI da OCI e o SDK beta

Crie um ambiente virtual e instale a CLI da OCI.

123uv venv --python 3.14
source .venv/bin/activate
uv pip install --upgrade oci-cli

Em seguida, instale o SDK beta para Python fornecido pela Oracle durante a integração inicial.

uv pip install "/path/to/oci-<beta-version>-py3-none-any.whl"

Instale o SDK beta depois da CLI. Instalar ou atualizar oci-cli depois disso pode substituir o SDK beta pelo pacote oci do PyPI. Se isso acontecer, reinstale o arquivo wheel da versão beta. O SDK beta precisa incluir oci.generative_ai_sandbox.

2. Configure o ambiente da OCI

Autentique um perfil que usa token de segurança na região habilitada para sua conta.

oci session authenticate --profile-name Sandbox --region us-chicago-1

Defina o OCID do projeto e as credenciais da OpenAI sem incluí-los em um commit.

123export OCI_SANDBOX_PROJECT_ID="ocid1.generativeaiproject..."
export OPENAI_API_KEY="..."
export OPENAI_EXECUTOR_API_KEY="..."

Use OPENAI_API_KEY nas requisições do aplicativo. Atribua a OPENAI_EXECUTOR_API_KEY uma chave de ambiente e passe somente essa chave para o sandbox como CODEX_API_KEY.

O exemplo da Oracle lê o perfil Sandbox e usa a região us-chicago-1. Para substituir os valores padrão, defina as variáveis abaixo.

export OCI_SANDBOX_PROFILE="my-profile"
export OCI_SANDBOX_REGION="us-chicago-1"

O exemplo também aceita as seguintes configurações opcionais.

Ao configurar seu aplicativo, use o token de segurança e a chave privada do perfil com oci.auth.signers.SecurityTokenSigner. Crie um cliente de sandbox com a classe GenerativeAiSandboxClient do módulo oci.generative_ai_sandbox, usando a região e o endpoint selecionados.

3. Execute uma sessão gerenciada pelo aplicativo

Consulte o guia de conexão para ambientes auto-hospedados para ver as requisições à API de Agentes e o comando para iniciar o executor. Siga as mesmas etapas do exemplo da Oracle.

1. Crie uma sessão auto-hospedada da API de Agentes com /workspace como diretório de trabalho. Salve o ID da sessão e o ID do ambiente.
2. Crie um sandbox do OCI GenAI e aguarde até que ele atinja o estado RUNNING.
3. Instale o Codex e grave o arquivo /workspace/brief.txt no sandbox.
4. Inicie codex exec-server usando o ID do ambiente da sessão e a chave de ambiente.
5. Abra o fluxo de eventos da sessão e, em seguida, envie uma mensagem pedindo ao agente que transforme brief.txt em um plano de migração. Aguarde a conclusão da tarefa e leia o arquivo /workspace/plan.md gerado.
6. Pare e exclua o sandbox da OCI. Em seguida, exclua a sessão da API de Agentes. Tente executar as duas operações de limpeza mesmo que uma delas falhe.

Mantenha os dois recursos ativos para continuar a conversa e recupere os arquivos antes de excluir o sandbox. Use a versão do SDK beta indicada pela Oracle. Os nomes das APIs de sandbox podem mudar nas versões preliminares.

Referências

• Consulte a documentação do OCI Generative AI
• Consulte a documentação do SDK da OCI para Python
• Consulte a documentação do SDK da OCI para TypeScript
• Consulte a documentação sobre autenticação na CLI da OCI