Why should I choose AI Positron integrated in Oxygen XML desktop Author/Editor/Developer over a generic capable AI Assistant tool?

Let's assume your company has already provided access to other capable AI assistant tools, such as Claude Code or Copilot, and your question is why should I spend more to use the AI Positron Assistant? In this article, I will try to answer that question.

Does the AI Positron Assistant offer features similar to those of other highly capable AI assistants?

The AI Positron add-on has support to create custom AI actions, skills and tools. It has support for hooks. It also comes with support for the MCP (Model Context Protocol) standard and with connectors for a wide variety of LLM platforms. We release new versions of AI Positron every 2-3 months and we are responsive to user suggestions.

What can AI Positron do for a technical writer that other AI assistant tools cannot realistically do?

AI Positron is tightly integrated into Oxygen XML Editor as a side view. It can show modifications in the visual comparison editor and lets you accept, reject, or partially accept changes. It also includes built-in tools to validate documents and perform XML-specific checks.

Which Positron capabilities are specifically enabled by its native integration with Oxygen XML Editor, XML, and DITA?

• AI Positron comes bundled with a set of predefined AI actions (correct grammar, review, improve readability, translate) that use fine-tuned prompts designed to work very well with XML content. You can also add your own AI actions. AI Positron also includes powerful tools for vibe writing.
• The visual preview comparison tool allows you to review the changes made by the LLM.
• After AI Positron saves content to a document, XML validation runs automatically and reports validation problems back to the LLM, which uses this feedback loop to automatically correct them. Validation is performed using the associated validation scenario, which may include DTD validation, Schematron, and validation rules specific to the DITA standard.
• Support for AI Refactoring allows you to apply an AI action (for example, Correct Grammar or Translate) on an entire folder of XML files.
• AI Positron includes various Chat modes, one of them is a generic Agent but we also have a DITA agent specialized on DITA XML editing.
• You can attach various resources (XML, Markdown, PDF, Excel, Microsoft Word, images, CSV) directly in the chat view and ask the LLM to convert them to DITA XML or use them as data. The Planner chat mode can be used to split and convert large PDF or Word documents into DITA XML.
• There are specific builtin tools available for vibe writing. These tools can be used to validate XML content, check terminology, refactor XML content by applying XSLT stylesheets, or make changes to a DITA map opened in the DITA Maps Manager view. More tools are also planned, including tools to validate a DITA map and check it for completeness.

Are there tasks that Positron can perform directly on XML/DITA documents or projects that would not be possible, or would be significantly more difficult, to implement with a third-party agent?

Because AI Positron automatically sends feedback to the LLM when it attempts to save invalid XML documents, the LLM can reconsider and improve its changes based on the validation scenarios you have defined in Oxygen.

How does Positron's awareness of the XML/DITA structure, Oxygen validation, refactoring, and document model provide an advantage over using third party agents alongside Oxygen?

Oxygen helps the LLM generate XML content that adheres to your terminology, style guide, and validation rules.

Can Positron make structured changes to XML/DITA content while preserving document validity and allowing the writer to review the changes through Oxygen's XML-aware diff functionality?

Yes, this is one of its main advantages. AI Positron also integrates well with other Oxygen add-ons. For example, it works with the Oxygen Terminology Checker add-on, which can be used to check terminology in generated content, and with the Git Client add-on, which can use AI Positron to create commit messages or resolve conflicts.

How does Positron compare with a custom third-party agent specifically for tasks such as reviewing documentation against a style guide, restructuring DITA topics, generating new topics, checking consistency across a documentation project, and making project-wide changes?

AI Positron's tools allow the LLM to perform project-wide changes. These tools also allow Oxygen to report validation problems back to the LLM. In the future, the DITA agent will also include a tool to validate an entire DITA map and check it for completeness. This feedback helps the LLM make correct changes from the start.

Are there any important Positron features that would still provide significant value if we already use a third-party AI assistant?

As an experimental feature, the AI Positron-provided tools from Oxygen (for example, tools that apply validation) can also be used by third-party assistants by starting Oxygen as an MCP server. This allows a third-party AI assistant to call, for example, validation or terminology checking tools from the running Oxygen application. So AI Positron can be used both as an assistant integrated inside Oxygen and as a provider of Oxygen-specific tools to a third-party AI assistant.

Do you have a few concrete examples or workflows where you would recommend Positron over a custom third-party agent for a technical-writing team using Oxygen XML Editor?

• I have a fairly large PDF document containing text and images that I want to convert to DITA XML. I switch to the AI Positron Planner chat mode, attach the PDF, and tell it to convert it to DITA XML (or a DITA map with XML topics). The attachment is automatically split into smaller Markdown files, and all images are extracted. Then the Planner launches DITA agent sub-agents for each small topic, copies the referenced images to the proper location, and converts the content to DITA XML. For each converted topic, it applies validation and reports validation problems to the LLM.
• I have a DITA XML topic with image references. I ask in the chat view tell me if the referenced images match the surrounding text, if not change the text. AI Positron obtains descriptions for each referenced image and makes the relevant changes.
• I ask AI Positron to review my currently opened topic. AI Positron inserts Oxygen review comments in the topic. These comments can then be addressed either by a colleague or by AI Positron if I ask it to fix the review comments.
• I ask AI Positron to replace all product names in the current topic with the corresponding defined keys.
• I ask AI Positron to find a paragraph similar to the current one and use a content reference instead of duplicating the content.

I hope this short article was helpful. If you have any remarks or questions, you can use the comment box below.