Criando um Projeto

Crie um projeto no serviço OCI Generative AI.

Crie um projeto usando a Console do Oracle Cloud. Configure definições de retenção de dados e memória para conversas e respostas. Para executar código e trabalhar com arquivos em ambientes isolados, também ative sandboxes para o projeto.

Dica

Depois de criar um projeto, você poderá exibir seus detalhes e executar outras tarefas, como atualizá-lo, movê-lo para outro compartimento, gerenciar suas tags ou excluí-lo. Use o menu Ações (três pontos) na Console para acessar essas tarefas. Para obter mais informações, consulte Listando um projeto.

Para criar um projeto, na página de lista, selecione Criar projeto. Se precisar de ajuda para localizar a página da lista, consulte Listando um projeto.

Informações básicas

  1. (Opcional) Informe um nome para o projeto. Inicie o nome com uma letra ou sublinhado, seguido de letras, números, hifens ou sublinhados. O comprimento pode ser de 1 a 255 caracteres. Se você não informar um nome, o sistema irá gerar um nome que você poderá alterar posteriormente.
    O nome gerado tem o formato generativeaiproject<timestamp>. Exemplo: generativeaiproject20260316042443
  2. (Opcional) Digite uma descrição para o projeto.
  3. Selecione um compartimento no qual criar o projeto. de O compartimento padrão é o mesmo da página de lista, mas você pode selecionar qualquer compartimento em que tenha permissão para trabalhar.

Retenção de Dados

Configure por quanto tempo as respostas e conversas podem ser armazenadas. A retenção de resposta controla por quanto tempo as respostas individuais são preservadas após a geração antes da exclusão automática. A retenção de conversas controla por quanto tempo as conversas são armazenadas após a atualização mais recente. A duração máxima de retenção é de 720 horas (30 dias).

  1. Para Retenção de resposta (horas), informe por quanto tempo manter cada resposta após a geração.
  2. Para Retenção de conversação (horas), informe por quanto tempo manter uma conversa após sua atualização mais recente.

Compactação de Memória de Curto Prazo

Em Configuração de compactação de memória de curto prazo, configure o resumo do contexto da conversa para preservar as principais informações e, ao mesmo tempo, reduzir o uso de token.

Observação

O modelo de compactação só pode ser definido durante a criação. Não pode ser alterado mais tarde. A compactação de memória de curto prazo pode ser ativada a qualquer momento, mas não poderá ser desativada ou excluída depois de ter sido ativada, a menos que esse projeto seja excluído.
  1. (Opcional) Ative a compactação de memória de curto prazo para resumir o histórico de bate-papo anterior e manter o contexto leve.
  2. Se você ativar a compactação de memória de curto prazo, selecione um modelo Compactação (summarização).
    A lista de modelos varia de acordo com a região. Para obter os modelos disponíveis, consulte Modelos e Regiões de IA Generativa para Agentes de IA Corporativos.

Memória de Longo Prazo

Em Configuração de memória de longo prazo, habilite a memória de longo prazo para extrair informações importantes de conversas e armazená-las para recuperação posterior. As informações armazenadas são incorporadas como vetores pesquisáveis.

Observação

Os modelos de extração e incorporação só podem ser definidos durante a criação. Eles não podem ser alterados mais tarde. A memória de longo prazo pode ser ativada a qualquer momento, mas não pode ser desativada ou excluída depois de ter sido ativada, a menos que este projeto seja excluído.
Dica

Se você ativar esse recurso de memória de longo prazo, para obter os melhores resultados, recomendamos que, na seção Retenção de dados, defina o tempo de retenção da Resposta e da Conversa para o valor máximo disponível (720 horas).
  1. (Opcional) Ative a memória de longo prazo para ajudar a armazenar informações importantes para recuperação em conversas futuras.
  2. Se você ativar o recurso de memória de longo prazo, selecione os modelos:
    • Modelo de extração de memória de longo prazo: O modelo para capturar e identificar informações-chave a serem armazenadas. A lista de modelos varia de acordo com a região. Para obter os modelos disponíveis, consulte Modelos e Regiões de IA Generativa para Agentes de IA Corporativos.
    • Modelo de incorporação de memória de longo prazo: O modelo para converter as informações armazenadas em vetores pesquisáveis.

Configuração de Sandbox

Ative sandboxes para criar runtimes isolados para este projeto. Cada sandbox pode executar comandos e ler ou gravar arquivos. O projeto fornece definições de rede compartilhada. Consulte Sandboxes na OCI Generative AI e Permissões no Nível da API para Sandboxes.

Importante

Depois de ativar os sandboxes de um projeto, não será possível desativá-los. Selecione a configuração de rede antes de criar sandboxes. Para usar uma sub-rede personalizada diferente ou um conjunto de grupos de segurança de rede, crie outro projeto.
  1. (Opcional) Expanda a configuração de sandbox e ative Habilitar sandboxes neste projeto.
    Os novos sandboxes criados por meio da CLI ou do SDK usam a configuração de sandbox do projeto. Você poderá deixar as sandboxes desativadas se o projeto não precisar de um ambiente de execução.
  2. Se você ativar sandboxes, selecione um modo de Rede.
    • Gerenciado: Use a rede de saída gerenciada pelo serviço. Selecione um modo de política de rede que permita o acesso aos destinos de suas necessidades de carga de trabalho. ALLOW_ALL permite acesso de saída. Revise essa seleção antes de criar o projeto.
    • Personalizado: Roteia o tráfego de saída por meio da sua sub-rede. Informe o OCID da Sub-rede de uma sub-rede privada na mesma região do projeto. Para adicionar um grupo de segurança de rede opcional, selecione Adicionar tag de grupo de segurança de rede e digite seu OCID do grupo de segurança de rede. Você pode fornecer até cinco NSGs exclusivos na mesma VCN que a sub-rede.
    Com a rede personalizada, suas rotas de VCN, listas de segurança e NSGs controlam o acesso de saída. Consulte Networking for Sandboxes.
  3. (Opcional) Em Configuração de pool quente, configure a capacidade de preparação antes da chegada das solicitações de sandbox.

    Pools quentes são criados após o projeto se tornar ativo. O modo de rede e o tipo de pool quente são opções separadas: ambos os modos de rede podem ser usados com os dois tipos de pool.

    • Gerenciado (padrão): Use uma imagem de runtime gerenciada pelo serviço. Informe um Nome exclusivo, selecione uma Forma e selecione o Destino de capacidade ociosa desejado mostrado no formulário.
    • Personalizado: Use sua própria imagem de contêiner. Informe um Nome exclusivo e uma Imagem do contêiner. Em seguida, selecione uma Forma e um Destino de capacidade ociosa desejado. Prepare a imagem e as permissões de acesso descritas em Using a Custom Image for a Sandbox.

    Selecione Adicionar pool para configurar outro pool. Para criar o projeto sem pools quentes, remova cada entrada de pool selecionando seu ícone de remoção. Consulte Warm Pools for Sandboxes.

Tags

  1. (Opcional) Selecione Adicionar tag e designe tags a este projeto. Consulte Tags de Recursos.
  2. Selecione Criar.
    Aguarde o projeto se tornar Ativo. Se você ativou sandboxes, consulte Criando e Usando um Sandbox para criar um runtime no projeto.