Oxygen AI Positron Vertex AI Connector Add-on
The Oxygen AI Positron Vertex AI Connector add-on allows you to connect the Oxygen
AI Positron add-on with Vertex AI from Google Cloud.
Note:
The Oxygen AI
Positron Vertex AI Connector add-on is compatible with Oxygen XML
Editor/Author/Developer version 27.1 or newer.
Installation
To install this add-on, follow these steps:
- Go to to open the add-on selection dialog box. Enter or paste https://www.oxygenxml.com/InstData/Addons/default/updateSite.xml in the Show add-ons from field or select it from the drop-down menu.
- Select the Oxygen AI Positron Vertex AI Connector add-on and click Next.
- Read the end-user license agreement. Then select the I accept all terms of the end-user license agreement option and click Install.
- Restart the application.
Result: The Connections table in the preferences page is extended with a Vertex AI Service connector type that you can use when creating a new connection.
Alternatively, you can install the add-on by downloading the JAR file from the Releases page and unzipping it inside {oXygenInstallDir}/plugins. Ensure there are no intermediate folders and that the plugin.xml file is present in the correct location.
How to Configure a Vertex AI Service Connection
To configure a Vertex AI Service connection, open the AI
Service Configuration preferences page and click Add in
the Connections table. In the Add Connection
dialog box, select Vertex AI Service from the Connector
type combo box. The following configuration options are available:
- Project ID
- The ID of your Google Cloud project.
- Location
- The location of your Google Cloud project (e.g.,
us-central1). - Model
- The AI model to use (e.g.,
google/gemini-2.5-flash). - Credential
- The content of the Google credential JSON file. The connector supports using a
service account key file for authentication. If this field is left empty, the
application will use Google Cloud’s Application Default Credentials (documentation), searching for credentials in
the following locations:
GOOGLE_APPLICATION_CREDENTIALSenvironment variable.- The attached service account.