Reference for Generative AI Agents
This guide lists the predefined objects in OCI Resource Analytics for the Generative AI Agents service. You can find information about views, entity relationships, subject areas, and sample queries.
Views
This section provides information about views within OCI Resource Analytics Generative AI Agents and their columns, data types, keys, and the referred view and column names. The following views are available:
| Name | Description |
|---|---|
| GENERATIVE_AI_AGENT_AGENT_DIM_V | This view stores information about an agent, which is an LLM based autonomous system that understands and generates human-like text, enabling natural language processing interactions. |
| GENERATIVE_AI_AGENT_AGENT_ENDPOINT_DIM_V | This view stores information about the endpoint to access a deployed agent. |
| GENERATIVE_AI_AGENT_DATA_INGESTION_JOB_DIM_V | This view stores information about the data ingestion job for loading data source content into a knowledge base. |
| GENERATIVE_AI_AGENT_DATA_SOURCE_DIM_V | This view stores information about the data source points to the source of your data for agent knowledge retrieval. |
| GENERATIVE_AI_AGENT_KNOWLEDGE_BASE_DIM_V | This view stores information about a knowledge base, which is the base for all data sources that an agent can use to retrieve information. |
| GENERATIVE_AI_AGENT_TOOL_DIM_V | This view stores information about a tool attached to an agent to support agent capabilities. |
| GENERATIVE_AI_AGENT_AGENT_ENDPOINT_FACT_V | Fact table for agent endpoint level for Generative AI Agents resources. |
| GENERATIVE_AI_AGENT_DATA_INGESTION_JOB_FACT_V | Fact table for data ingestion job level for Generative AI Agents resources. |
The suffixes in the view names specify the view type:
- FACT_V: Fact
- DIM_V: Dimension
Relationship Diagram
This section provides diagrams that define the logical relationship of a fact table with different dimension tables.
The contents of each view and their relationships are listed in the following file: Generative AI Agents views.
GENERATIVE_AI_AGENT_AGENT_ENDPOINT_FACT_V

GENERATIVE_AI_AGENT_DATA_INGESTION_JOB_FACT_V

Relationships exist among dimensions. Dimensions can be joined directly to each other.
GENERATIVE_AI_AGENT_TOOL_DIM_V

Sample Queries
Sample queries for Generative AI Agents.
List the number of agents associated with each endpoint ID.
SELECT
AGENT_ENDPOINT_ID,
COUNT(AGENT_ID) AS AGENT_COUNT
FROM OCIRA.GENERATIVE_AI_AGENT_AGENT_ENDPOINT_FACT_V F
GROUP BY AGENT_ENDPOINT_ID;List the number of data ingestion jobs associated with each data source.
SELECT
DATA_SOURCE_ID,
COUNT(DATA_INGESTION_JOB_ID)
FROM OCIRA.GENERATIVE_AI_AGENT_DATA_INGESTION_JOB_FACT_V F
GROUP BY DATA_SOURCE_ID;Data Lineage
The Customer Experience Semantic Model Lineage spreadsheet and Metric Calculation Logic spreadsheet for Generative AI Agents provides an end-to-end data lineage summary report for physical and logical relationships in your data.
For more information, see Data Lineage.
Subject Areas
This section provides information on the subject areas with data you maintain in Generative AI Agents. These subject areas, with their corresponding data, are available for you to use when creating and editing analyses and reports. The information for each subject area includes:
-
Description of the subject area.
-
Business questions that can be answered by data in the subject area, with a link to more detailed information about each business question.
-
Job-specific groups and duty roles that can be used to secure access to the subject area, with a link to more detailed information about each job role and duty role.
-
Primary navigation to the work area that's represented by the subject area.
-
Time reporting considerations in using the subject area, such as whether the subject area reports historical data or only the current data. Historical reporting refers to reporting on historical transactional data in a subject area. With a few exceptions, all dimensional data are current as of the primary transaction dates or system date.
-
The lowest grain of transactional data in a subject area. The lowest transactional data grain decides how data are joined in a report.
-
Special considerations, tips, and things to look out for in using the subject area to create analyses and reports.
Other References
This section provides other references related to Generative AI Agents.
Oracle Cloud Infrastructure Documentation / API Reference