Oracle Cloud Infrastructure Documentation

Creating a Project

Create a project in the OCI Generative AI service.

This task documents the steps for creating a project by using the Oracle Cloud Console.

Tip

After you create a project, you can view its details and perform other tasks, such as updating it, moving it to a different compartment, managing its tags, or deleting it. Use the Actions menu (three dots) in the Console to access these tasks. For more information, see Listing a project.

To create a project, in the list page, select Create project. If you need help finding the list page, see Listing a project.

Basic Information

  1. (Optional) Enter a name for the project. Start the name with a letter or underscore, followed by letters, numbers, hyphens, or underscores. The length can be 1 to 255 characters. If you don't enter a name, the system generates a name that you can change later.
    The generated name has the format generativeaiproject<timestamp>. Example: generativeaiproject20260316042443
  2. (Optional) Enter a description for the project.
  3. Select a compartment to create the project in. The default compartment is the same as the list page, but you can select any compartment that you have permission to work in.

Data Retention

Configure how long responses and conversations can be stored. Response retention controls how long individual responses are preserved after generation before automatic deletion. Conversation retention controls how long conversations will be stored after the most recent update. The maximum retention duration is 720 hours (30 days).

  1. Enter Response retention time in hours.
  2. Enter the Conversation retention in hours.

Short-term memory compaction config

Continuously summarizes and compresses recent conversation context into a compact, structured representation to preserve key information while reducing token usage and latency

Note

Compaction model can only be set during creation. It cannot be changed later. Short-term memory compaction can be enabled at any time, but it cannot be disabled or deleted once it has been enabled unless this project is deleted.
  1. (Optional) Enable short‑term memory compaction to summarize earlier chat history and keep context lightweight.
  2. If you enable the short-term memory compaction feature, then select a model from the list for compaction.
    The list of models varies by region. For available models, see Generative AI Models and Regions for Agentic API.

Long-term memory config

Enable long‑term memory to extract key information from conversations and store it for later retrieval. Stored information is embedded as searchable vectors.

Note

Extraction and embedding models can only be set during creation. They can't be changed later. Long-term memory can be enabled at any time, but it can't be disabled or deleted after it has been enabled unless this project is deleted.
Tip

If you enable this long-term memory feature, for best results we recommend that in the Data retention section, you set both the Response and the Conversation retention time to the maximum available value (720 hours).
  1. (Optional) Enable long‑term memory to help store key information for retrieval in future conversations.
  2. If you enable the long‑term memory feature, then select models:
    • Long-term memory extraction model: The model for capturing and identifying key information to store. The list of models varies by region. For available models, see Generative AI Models and Regions for Agentic API.
    • Long-term memory embedding model: The model for converting the stored information into searchable vectors.

Tags

  1. (Optional) Select Add tag and assign tags to this project. See Resource Tags.
  2. Select Create.