Oracle Cloud Infrastructure Documentation

Projects

OCI Generative AI projects organize conversations and responses under a shared set of settings. In a project, you define how long data is retained, enable long-term memory to persist context across conversations, and enable short-term memory compaction to optimize how conversation history is processed.

Projects are isolated from each other to support lifecycle management and compliance boundaries. Reference the project OCID in API and SDK calls to apply project settings at runtime.

About Projects

A project is an OCI resource that organizes agent-specific artifacts created through the Generative AI service, including responses, conversations, files, and containers. Projects are isolated from each other, so artifacts in one project aren’t accessible from another project. A project is required to call the OCI OpenAI-compatible API for agent-related tasks.

A project setting can include:

  • Data retention for responses and conversations
  • Long-term memory settings
  • Conversation history compaction (short-term memory compaction) settings
  • Deleting a project deletes all associated artifacts (responses, conversations, files, and containers) created within that project.
  • API calls use the Project OCID.

Data Retention

Data retention defines how long project artifacts are kept before they’re automatically removed. In OCI Generative AI projects, you set retention separately for responses and conversations.

  • Response retention: Controls how long generated responses are retained.
  • Conversation retention: Controls how long conversations are retained after the most recent update.

Retention settings help you control storage duration and align with your organization’s data handling requirements.

QuickStart Permissions

  1. Add the minimal IAM policy needed to get a project OCID. 
    allow group <your-group-name> to use generative-ai-project 
in compartment <your-compartment>
  2. (Optional) Instead of the previous permission, if you need to create and delete projects, add the following policy: 
    allow group <your-group-name> to manage generative-ai-project 
in compartment <your-compartment>

    For guidance, see IAM Policies for OCI Generative AI.