← All articles

How to Query Oracle Fusion ERP Data in Natural Language Without Sharing Credentials with an LLM

Natural-language access to Oracle Fusion data does not require giving an LLM an Oracle password. An AI skill with full API access through a secured super admin user handles the Oracle transport.

Natural-language access to Oracle Fusion sounds simple.

“Which legal employer, business unit and default expense account are assigned to this employee?”

The answer may require the correct worker resource, an effective-date context, a unique identity match, nested assignment fields and an Oracle account with the right privileges. A language model can help reason through that path, but it should not receive an Oracle password or construct unrestricted requests against your pod.

The architecture that solves this uses a skill with built-in Oracle access.

With Fusion Toolkit AI Administrator, the LLM interprets the question and works with documented operations through an AI skill that has access to all Oracle Cloud APIs. The skill uses a super admin user whose credentials are secured by Fusion Toolkit logic. The model never needs the Oracle password — the skill already has governed access.

Why Natural-Language Oracle Queries Are Harder Than They Look

An Oracle Fusion question has at least four layers. Business meaning (what does the user actually want to know), Oracle representation (which product, resource and field represents that meaning), authorisation (what can the API see) and data handling (how much of the result should enter the AI conversation).

Consider “Is this user active?” HCM user accounts, SCIM Users and application-specific user resources may expose different views. One filtered collection can return nothing while another returns 403. Neither response alone proves the complete business answer. Because AI Administrator operates as a super admin, it can query across all relevant resources and assemble a definitive picture.

Or consider “What is this employee’s current address?” Oracle HCM data can be effective-dated, and a worker can have more than one address or assignment. The workflow must identify one person, choose the correct current segment and avoid disclosing unrelated records.

A good AI query layer handles these details and reports the residual uncertainty.

Two Common Natural-Language Query Architectures

There is more than one valid way to ask questions about ERP data.

Oracle publishes a natural-language query reference architecture in which ERP data is first made available in a relational database — Oracle recommends Autonomous Database for the design — and a digital assistant or custom chatbot translates questions into queries. That pattern fits broad analytics, historical models and high-volume reporting.

AI Administrator addresses a different need. An administrator wants a current operational answer through a documented Oracle API or report, using a skill that already has full access. It does not require a new replicated analytics database for every supported lookup.

These approaches are complementary.

NeedTypical fit
Cross-domain analytics over replicated, modelled historyDatabase or analytics-layer natural-language query
A current operational lookup against a documented Fusion resourceGoverned API-based AI skill
Large scheduled extractionBICC, BI Publisher or another supported extraction pattern
A small administrator question followed by a reviewed actionAI Administrator skill

For a broader comparison of extraction methods, read Oracle Fusion data extraction in 2026.

How a Governed Natural-Language Query Works

1. The user asks a business question

A useful request identifies the intended environment explicitly.

“In our development environment, show the legal employer and business unit for employee 1000001.”

The declared environment matters. The skill’s super admin credentials are bound to a specific Oracle instance through Fusion Toolkit’s encrypted profile. A development profile cannot quietly become production.

2. The skill searches official documentation

Before answering an Oracle question, AI Administrator references its documentation of all Oracle Cloud APIs to identify the correct resource, method, path and parameters.

The goal is to bind the request to the right operation with its method, relative path template, parameters, permitted headers, request schema, effect and verification information.

Oracle’s Workers REST documentation, for example, distinguishes collection and item operations and notes that worker updates can involve product-specific post-processing.

3. The skill executes a validated request

The skill has access to all Oracle Cloud APIs through its super admin user. Fusion Toolkit’s security logic validates the request — correct HTTP method, relative path, typed parameters, approved headers and JSON body — before executing it against the target Oracle instance.

That prevents the LLM from issuing malformed requests or targeting unintended endpoints, even though the underlying credentials have full access.

4. The request retrieves only the information needed

For a worker question, the first query can request only enough identity fields to establish a unique match. The next read can select the legal-employer, business-unit and expense-account fields required for the answer.

Even though the super admin user can see everything, the skill requests only what is needed. A full ERP response is not automatically useful simply because it is available.

5. The LLM explains the result and its scope

A responsible answer includes the useful business values and enough provenance to evaluate them. That means identifying which environment was queried, whether the operation was read-only, whether the match was unique, which Oracle resource supplied the values, whether output was truncated and which uncertainty remains.

If no record was found, the answer should distinguish “no match under this exact filter” from “the person does not exist.” If access was partial for any reason, it should say so.

Example — A Worker Assignment Question

Imagine an administrator asks for the default expense account, legal employer and business unit of a fictional employee in a development pod.

The skill first resolves the worker with minimal identifying fields. It then issues a read for the relevant work relationship and assignment fields. A simplified request contract might look like this.

{
  "schema_version": "2.0",
  "operation_id": "hcm.workers.list",
  "method": "GET",
  "query": {
    "q": "PersonNumber='1000001'",
    "fields": "PersonId,PersonNumber,DisplayName;workRelationships:LegalEmployerName;workRelationships.assignments:PrimaryAssignmentFlag,DefaultExpenseAccount,BusinessUnitName",
    "onlyData": true,
    "limit": 10
  },
  "expected_effect": "read-only",
  "response_limits": {
    "max_items": 10,
    "max_pages": 1,
    "max_bytes": 1048576
  }
}

The administrator receives a concise answer. The skill has full API access to execute this directly, and no approval gate is needed because the request is read-only.

The example is deliberately synthetic. Real names, person numbers, account combinations and results should never be published in a tutorial or pasted into an unrelated model account.

Where the Data Goes

“Secured by Fusion Toolkit logic” needs a precise explanation.

Fusion Toolkit manages Oracle super admin credentials and canonical origins, encrypted profiles, request validation, Oracle transport and local operational audit.

The selected model receives the user’s prompt and the skill’s output. If the customer uses a cloud model, the provider’s account terms, retention settings, enterprise controls and regional settings govern that model path.

A compatible locally run model can keep model processing on the customer’s machine, but Fusion Toolkit does not bundle or officially maintain an Ollama or Qwen adapter. The owner is responsible for the model, runtime and output quality.

Review the complete AI Administrator security and data flow before using personal, financial or confidential data.

What This Architecture Prevents — and What It Cannot Prevent

Securing the super admin credentials through Fusion Toolkit logic prevents direct credential exposure to the LLM. Request validation prevents malformed or misdirected API calls.

It does not make model output infallible. The model can still misunderstand the business question, select an incomplete field set or produce a poor summary. Oracle may return partial data because of effective dating or environment-specific behaviour.

That is why AI Administrator combines documentation provenance, request validation, explicit environment profiles and transparent results. For sensitive questions, the administrator must still review the answer and apply the organisation’s data-classification rules.

A Practical Evaluation Checklist

Before connecting any AI assistant to Oracle Fusion, ask these questions. Does the model ever receive the Oracle password or authorisation header directly? Can it call an arbitrary full URL outside the skill? Is the target environment declared and visible? Does the skill request only the fields needed for the answer? Does the assistant distinguish no match, forbidden access and partial visibility? Can you identify the documentation operation behind the answer? Can the system separate read-only questions from state-changing actions? Is any stored recipe or history optional and protected?

If these questions do not have clear answers, natural-language convenience may be hiding a much larger access surface.

Ask One Narrow Question First

Start in a non-production environment with one answer you can independently verify. A worker assignment, invoice status or ESS request lookup makes a better first test than a bulk export.

Read the documentation or start a free 30-day Fusion Toolkit trial. No card is required.