Page 1 of 1

Configuring the AI Service Using a JSON File

Posted: Sat Jan 17, 2026 3:06 am
by jeff_hooker
I've found these instructions: https://www.oxygenxml.com/doc/ug-positr ... -file.html
But I can find no way of applying them with a service configured as shown in the attached screen shot: is it even possible?
AI service.png

Re: Configuring the AI Service Using a JSON File

Posted: Tue Jan 20, 2026 12:58 pm
by Cosmin Duna
Hello,
Yes, it is possible, but it only applies to that specific configuration mechanism. The JSON file must match the schema expected by Oxygen and be placed in the right location; otherwise Oxygen won’t load it and the Preferences UI remains unchanged.

A few key points:
  • The JSON file (typically named ai-service-configuration.json) must be placed in the AI Positron add‑on installation directory. This is the exact directory shown in Preferences > Plugins > Oxygen AI Positron Assistant Enterprise > Location, as described in the documentation. If it’s placed elsewhere, Oxygen will not pick it up.
  • When the JSON file is detected and valid, the AI service configuration preferences are hidden because the add‑on has been fully configured from the file. That means you won’t see the standard preferences UI for that service once it’s been applied. This is expected behaviour.
  • If your JSON file has syntax errors or doesn’t conform exactly to the expected format, Oxygen will ignore it and the AI Service Configuration preferences page will remain visible. For that reason, open your JSON file directly in Oxygen XML Editor and validate it — Oxygen will report any errors, and invalid JSON is the most common reason the automatic configuration doesn’t work.
If AI Service Configuration preferences page is still visible, then it probably means exactly one of the following:
  • The JSON file wasn’t placed in the correct directory.
  • The JSON file is not valid (syntax or structure) and therefore not loaded.
  • The file uses the wrong name or doesn’t match the documented schema.
You should verify the file location and then open it in Oxygen itself to see if there are validation errors. Once that file is correctly placed and syntactically correct, Oxygen will automatically apply it on startup and hide the manual configuration UI.

Best regards,
Cosmin