8 Managing AI Services

Retail Analytics and Planning solutions leverage certain common AI services which need to be configured and maintained by customer administrators in order to enable them for business users. Review this chapter to understand the available services and manage their configurations.

Customer Documents for Retrieval-Augmented Generation

In the AI chat interfaces found throughout the Analytics and Planning applications, it is possible to ask general questions about application workflows, configurations, errors, and other details where the answers may be found somewhere in Oracle documentation. Retrieval-Augmented Generation (RAG) enhances AI answers to questions by retrieving relevant information before generating a response. In addition to the service’s shared knowledge base, you can provide your organization’s own documents so the AI can use them when answering your users’ questions. When users ask questions through the chat interface, the service searches your document content together with the shared documentation that applies to your service.

The workflow for leveraging this service has three main steps:

  1. Upload PDF documents to your designated File Transfer Services (FTS) Object Storage path.
  2. Monitor ingestion through the vectorization status REST API.
  3. Test the new content in the chat interface once ingestion is complete.

The service handles security scanning, document processing, indexing, and retrieval automatically.

Upload Documents

File transfer services (FTS) are leveraged for document uploads through Object Storage. For a basic understanding of FTS, refer to the Managing File Transfers chapter of this document. Before you begin, obtain the following from your service administrator or implementation team:

  • Your Object Storage bucket and authorized FTS upload access
  • Your designated document path
  • The service host and tenant identifier for the status API
  • Access to the chat interface for your RAP application(s)

Your designated Object Storage path follows this format:

rais/vector_db/version/<version>/appl/<appCode>/module/<moduleCode>/tenant/<customerTenantId>/

Replace the placeholder values in the path with exact values provided for your environment. Uploading outside this path prevents the document from being picked up for your tenant’s RAG content.

Example path:

rais/vector_db/version/26.1.201.0/appl/ap/module/ap/tenant/fgta435gtc4590fn/

After upload, FTS automatically scans the document for security concerns. Documents that pass the scan are transferred to the RAG ingestion area and prepared for search.

Monitor File Status

Once the files are accepted into the platform, they must be vectorized and added to the AI services database. Use the vectorization status REST API to check whether your uploaded documents are ready for RAG. The API format is:

POST
https://<host>/<tenant>/app/rgbucommongenai/retailaiservices/filesVectorizationStatus

Example API URL:

https://rgbu.gbua.eu-frankfurt-1.oci.oraclecloud.com/fgta435gtc4590fn/app/rgbucommongenai/retailaiservices/filesVectorizationStatus

Example payload for the message body:

{{
{"appName": "ap","module": "ap","version": "26.1.201.0"}
}}

Continue checking the status until it returns COMPLETED.

Status Message Meaning Next action
In progress or other non-completed status The document is still being processed. Wait and check again.
COMPLETED The document has been indexed and is available to RAG. Test it in the chat interface.

Processing includes breaking the document into searchable sections, creating embeddings, and updating the vector index. Completion time can vary based on scheduled processing intervals and document volume.

Verify Chat Results

Once the documents have completed the upload process, you may begin asking questions about their content from the specific AI chat interface associated with the upload, such as the ones in AP or MFP applications. Follow these guidelines for verifying the document contents are correctly being used:

  • Ask a question whose answer is clearly contained in the uploaded document.
  • Use specific terminology, names, procedures, or values from the document.
  • Confirm that the response is accurate and useful for your intended audience.
  • Test a few alternative phrasings to ensure users can find the information naturally.
  • Start with a question that is not likely to be answered by the shared knowledge base alone.

Deleting Documents

There is a separate API available for removing documents from Object Storage. The API format is:

DELETE
https://<host>/<tenant>/app/rgbucommongenai/retailaiservices/deleteFilesInOS

Example API URL:

https://rgbu.gbua.eu-frankfurt-1.oci.oraclecloud.com/fgta435gtc4590fn/app/rgbucommongenai/retailaiservices/deleteFilesInOS

Example payload for the message body:

{{
{"appName": "ap","module": "ap","version": "26.1.201.0","fileName": "<filename to be deleted>"}
}}

Use your environment’s service host and tenant identifier. After deletion, confirm through your normal validation process that the document is no longer available through the chat interface. Only delete documents that your organization no longer wants available for RAG retrieval.