Configure AI search

This page appears if you selected Search FHIR Resource using AI on the Basic Info page. Enter a search query in natural language format to automatically generate a FHIR-equivalent search query against FHIR-compliant servers such as HAPI FHIR and more. Query parameters and model values are also automatically generated and available for additional editing.

Note:

This page is not visible if your Oracle Integration instance is in a region that cannot access the Oracle Cloud Infrastructure Generative AI Service. For information about which regions can access the Oracle Cloud Infrastructure Generative AI Service, see AI Innovation and Oracle Integration in Using Integrations in Oracle Integration 3.

If you subscribed to an AI engine and created AI-generated FHIR search queries on this page in release 25.04, and your Oracle Integration instance cannot access the Oracle Cloud Infrastructure Generative AI Service, your previous search queries are visible and backward compatible with the Search FHIR Resource option.

Natural language search queries are only supported for standard schema definitions. Natural language queries are not supported for FHIR profiles or custom FHIR resources.

Element Description

Description Box
Enter a query in natural language format. For example:
Find all patients named Mark in the city of San Francisco
Note the following guidelines:
  • Write the query in simple English language.
  • Write the statement clearly and explicitly.
  • Do not include quotes ("") or any other special characters.
  • The query must be related to FHIR search topics. If not, you receive the following message:
    This query is not related to FHIR Search. I can only assist with FHIR Search topics.

Submit Query
Click to automatically generate the query. For the natural language text entered above, the following query is created in the Generated FHIR URL field. The query shows the server you configured in the Connection URL field on the Connections page, appended with query parameters derived from your text input. For this example, parameters were created for name and city. 
https://hapi.fhir.org/baseR4/Patient?name=Mark&address-city=SanFrancisco

See Configure Connection Properties.

Test Query

 Click to validate your query.
  • If successful, the following message is displayed. Click the message to view details about the FHIR server search response.
    Valid FHIR URL. Click here to see the results.
  • If unsuccessful, the following message is displayed. Click the message to view error details.
    Invalid FHIR query. Please resubmit the query or modify query parameters manually. 
Click here to see the error.

To improve performance, the test query limits the number of records returned.

Additional validation also occurs when you click Continue to move to the next page in the Adapter Endpoint Configuration Wizard. Your query must be valid before you can successful move to the next page.

FHIR Resource Displays the resource automatically generated for your query. The resource (for this example, Patient) is displayed for the generated query https://hapi.fhir.org/baseR4/Patient?name=Mark&address-city=SanFrancisco.

Query Parameters
The query parameters and model values automatically generated for your query are displayed. If a parameter or model value requires updating, you can make changes.

  • Click Add to display a row for entering a new parameter name and model value. Press Enter when done.

  • Click Remove to delete a selected parameter and model value.

  • Double-click a selected parameter to modify the name or model value. Press Enter when done.

After completing any changes, click Update Query to regenerate the query shown in the Generated FHIR URL field. Click Test Query to revalidate the query.

Note: Guardrails are in place to prevent the use of invalid query parameters. For example, if you add a new query parameter (for this example, PatientName) without testing the query and click Continue to move to the next page in the Adapter Endpoint Configuration Wizard, you receive an error:
Configured search parameters {PatientName} are invalid to resource type Patient. 
Please update them as per the specification and retry.