Oracle Cloud Infrastructure Documentation

Adding OCI Generative AI to a Cost Advisor Workspace

Add OCI Generative AI as a provider for a Cost Advisor workspace.

Important

Pre-General Availability: 2026-10-27

The following legal notice applies to Oracle pre-GA releases. For copyright and other applicable notices, see Oracle Legal Notices.

Pre-General Availability Draft Documentation Notice

This documentation is in pre-General Availability status and is intended for demonstration and preliminary use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.

This documentation is not a commitment by Oracle to deliver any material, code, functionality or services. This documentation, and Oracle Pre-GA programs and services are subject to change at any time without notice and, accordingly, should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality for Oracle’s Pre-GA programs and services remains at the sole discretion of Oracle. All release dates or other predictions of future events are subject to change. The future availability of any future Oracle program or service should not be relied on in entering into any license or service agreement with Oracle.

Before you begin, ensure that you're authorized to approve the access and resources described in the provider setup.

Cost Advisor for AI uses OCI cost reports to analyze your tenancy's OCI Generative AI costs. These reports cover billable resources across the tenancy and are stored in an Oracle-owned Object Storage bucket hosted by OCI.

Cost Advisor for AI extracts OCI Generative AI cost data from the reports and transfers it to a separate, Oracle-owned Cost Advisor for AI tenancy. The extracted data is stored for analysis in an Object Storage bucket created for the workspace within that tenancy.

  1. Open the workspace, select AI providers, and then select Add in the OCI Generative AI row.
  2. In Add OCI Generative AI service provider, review the data access and the resources to be created in your tenancy.
    • User group: cost-advisor-for-ai-group-{suffix}, with permission to read cost reports through the access policy.
    • User: cost-advisor-for-ai-user-{suffix}, added to the group and used to retrieve reports automatically.
    • API key: A key for the new user, used to authenticate report retrieval. The setup displays the key's fingerprint.
    • Access policy: cost-advisor-for-ai-metering-report-reader-{suffix}, granting the group access to the cost reports.

    User, group, and policy names include automatically generated suffixes. The policy is tagged with the associated workspace ID. Review the policy statements displayed in the setup:

    define tenancy usage-report as {OCI cost report tenancy OCID}
endorse group id {new user group OCID} to read objects in tenancy usage-report
  3. Review the approval statement and select the checkbox if you're authorized to approve creation of these resources, access to your OCI cost reports, and transfer of OCI Generative AI cost data for storage and analysis in the Oracle-owned Cost Advisor for AI tenancy.
  4. Select Approve and create.
    Adding the provider takes about 10 minutes.
Cost Advisor for AI submits the provider setup. Review the operation on the workspace's Work requests tab.

To associate the collected OCI Generative AI costs with a management hierarchy and cost center, add a project ID mapping. Use OCI as the provider code and the tenancy OCID as the project ID. The tenancy's collected costs map to one hierarchy and cost center. This mapping doesn't divide them by compartment or cost-allocation tag.

To review Cost Advisor data and insights, ensure that the workspace also has a Fusion EPM destination.