Add the OpenAI capability

After you have created a connection to your OpenAI project in your Edge or Collibra Cloud site, you can add the OpenAI capability to the connection.

A separate Edge connection is required for each OpenAI project. OpenAI API keys are scoped to a single project, so a key issued in one project cannot access another. Create one connection per project, each using the API key for that specific project.

Prerequisites

In your Collibra environment:

• To use the OpenAI integration, you need Collibra Platform 2026.09 or newer.

• You either created and installed an Edge site or were granted a Collibra Cloud site.
• You have created a connection to your OpenAI project in your Edge or Collibra Cloud site.
• You have a global role that has the Manage connections and capabilities global permission, for example, Edge integration engineer.

Steps

1. Open a site.
   1. On the main toolbar, click → Settings.
      The Settings page opens.
   2. In the tab pane, click Edge.
      The Sites tab opens and shows a table with an overview of your sites.
   3. In the table, click the name of the site whose status is Healthy.
      The site page opens.
2. In the Capabilities section, click Add capability.
   The Create capability page appears.
3. Select OpenAI.
4. Enter the required information.

   Field	Description	Required
   Capability	This section contains general information about the capability.
   Name	The name of the capability.	Yes
   Description	The description of the capability.	No
   OpenAI Connection	The OpenAI connection to be used.	Yes
   Save Input Metadata	Select the checkbox if you want to save the input metadata extracted from the data source in ZIP files. The files can be useful for troubleshooting. Select this option only on request of Collibra Support. If this option is selected, you can download the files from the Synchronization Result dialog box once the synchronization activity is completed.	No
   Advanced Configuration	These configuration options help when investigating issues with the capability. Important  Only complete the fields Save Input Metadata, Logging configuration, Memory (MiB), and JVM arguments on request of or together with Collibra Support. Only use Log level if your data source is a commercial JDBC offering. For more information, go to the Collibra Marketplace.	No
   Debug	This field is ignored when you integrate metadata from OpenAI. An option to automatically send Edge infrastructure log files to Collibra Platform. By default, this option is set to false. Note We highly recommend to only send Edge infrastructure log files to Collibra Platform when you have issues with Edge. If you set it to true, it will automatically revert to false after 24h.	No
   Log level	Only complete this field on the request of or together with Collibra Support. An option to determine the verbosity level of Catalog connector log files. By default, this option is set to No logging.	No

5. Click Add.
   The capability is added to the Edge or Collibra Cloud site.
   The fields become read-only.

What's next

You can synchronize the OpenAI capability.