Oxygen AI Positron Assistant 4.1
January 30, 2025
The Oxygen AI Positron Assistant add-on is a powerful tool that helps users increase their productivity by providing support for using AI-generated content. Version 4.1 introduces some helpful new AI-powered actions to fix validation problems, generate MathML formulas, and generate XML comments for annotating code.
Some of the intelligent agent actions were upgraded to enhance their functionality. The Resolve Comments AI action is now accessible directly from the editor or Review view, making it a breeze to resolve all comments in a document with AI assistance. Message labels were also improved to indicate when submitted content requires no AI changes, new functions were implemented, and some features were added to assist with debugging and for security purposes.
Some of the features were also implemented for Oxygen XML Web Author, such as the new Fix Validation Problems action and its corresponding function. In addition, you can use the new Attach from Computer to incorporate files from your local machine into prompts.
There are changes in:
Desktop
Preview All AI-Proposed Changes to Files
You now have the ability to preview all the changes in the documents that the
AI proposes to create or update while processing particular actions (e.g. Split
Topic or Create Topics). You are no longer required to confirm
that you want to overwrite files. Instead, you can preview the proposed changes in all
files and choose how to proceed in each instance. This helps to ensure control over
AI-proposed modifications.
Notification for Unchanged Content
When an AI action processes content but does not result in any changes, you are now informed, eliminating the need for unnecessary previews or visual inspection. This improvement saves time and ensures a smoother workflow.
Fix Validation Problems
The Intelligent Agents category now includes a new Fix
Validation Problems action. This action validates the current document and
suggests fixes for all identified issues, streamlining both the validation process and the
resolution of validation problems, ensuring high-quality content.
AI-based MathML Generation
The new Formula/Equation action (located in the Content Generation category) leverages AI to generate MathML formulas based on your descriptions. This feature simplifies the creation of complex mathematical representations and enhances technical documentation workflows.
AI-based Code Annotations
The new Annotate Code AI action (located in the
Development category) can be used to generate XML comments within the
code found in the current selection, at the cursor location, or in the whole document. The
generated annotations explain key concepts of the code. This action is available for XSLT,
Schematron, and XSD documents.
Resolve Comments from Contextual Menu
Invoking the Resolve Comments AI action is much more efficient
as it now appears directly in the contextual menu when you right-click a comment callout
box in the editor or in the Review view. The action changes the selected content based on
the suggestions within comments and then removes the comments.
New AI Callback Functions to Enable Dynamic Workflows
The plugin now includes several new AI callback functions, which are
specialized mechanisms enabling the AI to dynamically invoke external processing and use
the results in generating its response. These new functions can be used to invoke another
AI action, to find all the available AI actions, and to validate a document, thus
empowering users to create complex, dynamic workflows as part of a custom AI action.
invoke_ai_action- This callback function invokes an AI action that enables the delegation of processing to other AI actions, allowing you to use a divide-et-impera approach to simplify and optimize the AI action processing.retrieve_all_ai_actions- Instead of specifying a predefined set of AI actions that can be invoked, you can use this callback function that returns all the defined actions. This allows the AI to discover all the available AI actions and invoke them dynamically as needed.validate_document_content- When processing or generating content, an AI action can now use this callback function that validates a document, ensuring that the generated content is valid. In case of errors, it offers the opportunity to automatically correct the detected problems.
Invoke Positron Actions from XPath
A new XPath function (ai:invoke-action) has been introduced,
enabling you to seamlessly invoke an AI Positron action from any XPath context (such as
XSLT, XQuery, Schematron, etc.) by providing the action ID, contextual text, and the
content to be processed.
XSLT Support Improved for Suggest Refactoring Action
The Suggest Refactoring action was updated with improved
support for XSLT files. Key improvements include selected XSLT code is upgraded to XSLT
version 3.0, it breaks down large, monolithic templates into smaller units for easier
maintainability, the error handling was enhanced by incorporating
'
xsl:try' and 'xsl:catch' instructions, and XML
comments were added to help clarify the purpose and functionality of the
code.Multi-agent Architecture for Create Topics
The Create Topics action has been restructured using a
multi-agent architecture and now leverages the
invoke_ai_action()
function. These improvements ensure better adherence to system instructions and more
consistent execution. Export and Import Chat Sessions
It is now possible to export a conversation with the AI to a JSON file using
the new Export Chat action that appears in the Actions
menu. You can also import a conversation from a JSON file using the new Import
Chat action. This feature is especially helpful for debugging purposes or to
resume an exported conversation with the AI. For example, an exported conversation could
be sent to the developer of a custom action to help them investigate issues that were
encountered and then you could import the previous conversation once you are ready to
resume.
Disable/Enable All AI Features for a Specific Project
An option was added in the Preferences page for you to disable (or enable) all
the AI features at project level (or globally for all projects). This allows you to
control which projects have AI features available.
Updated Default Model
For the SaaS distribution and for the OpenAI connector in the Enterprise
distribution, the default AI model has been updated to
gpt-4o-2024-11-20,
the latest gpt-4o snapshot from OpenAI. This model is more cost-effective
than the previous default one and supports four times as many maximum output tokens while
maintaining very similar performance.Web Author
Fix Validation Problems
The new Fix Validation Problems AI action validates the
current document and suggests fixes for all identified issues, streamlining both the
validation process and the resolution of validation problems, ensuring high-quality
content.
Attach Local Files
In addition to the support to attach a remote file, a new Attach from
computer option allows you to incorporate files from your local machine into
prompts. Attachments are useful in various use cases. For example, you can attach a
screenshot and ask the AI to update a documentation topic based on that
image.
AI-based MathML Generation
The new Formula/Equation action (located in the
Content Generation category) leverages AI to generate MathML formulas
based on your descriptions. This feature simplifies the creation of complex mathematical
representations and enhances technical documentation workflows.
New AI Tool Function
When processing or generating content, an AI action can now use the new
callback function,
validate_document_content, that validates a document,
ensuring that the generated content is valid. In case of errors, it offers the opportunity
to automatically correct the detected problems.Notification for Unchanged Content
When an AI action processes content but does not result in any changes, you are
now informed, eliminating the need for unnecessary previews or visual inspection. This
improvement saves time and ensures a smoother workflow.
Oxygen AI Positron Assistant 4.0
November 1, 2024
The Oxygen AI Positron Assistant add-on is a powerful tool that helps users increase their productivity by providing support for using AI-generated content. Version 4.0 enhances AI features by expanding the Retrieval-Augmented Generation (RAG) functionality, adding productivity-boosting interface improvements, implementing new AI-powered actions and functions, and integrating security enhancements.
There are changes in:
Retrieval-Augmented Generation (RAG)
Improved AI Fixes
When using the AI Positron Assistant add-on with Oxygen versions 26.1 or newer,
the AI Positron Fix action now leverages the RAG process to enhance the
AI's response by using information from the current document, leading to more relevant
responses. For more information, see Oxygen AI Positron Assistant - Validation Quick Fixes.
RAG using the search provided by Oxygen Feedback
If the Oxygen Feedback product is used to provide search functionality for a
web site, the Oxygen Feedback search system can be used to retrieve relevant content that
will be used by AI to enhance the provided responses. For more details, see Oxygen AI Positron
Assistant - Retrieval-Augmented Generation (RAG).
New AI tool functions
Within the definition of custom actions, you can reference functions that may
be called by the AI engine to interact with the application. These functions can provide
additional information that allows for more relevant answers to be constructed by the AI,
or they may allow the AI to directly act in a controlled way on the application workspace.
The following functions were added in this version:
add_to_toc- Modifies a DITA map and adds a specified topic reference to it.find_similar_reusable_content- Retrieves a list of reusable DITA XML components that match keywords provided by the AI.get_content_for_document_url- Retrieves the content of a certain document.get_corresponding_dita_keyrefs- Can be used to find if there are key definitions for corresponding values.get_current_editor_file_location- Retrieves the location (URL) of the current file that is open in the editor.get_related_content_from_webhelp- Accesses the search functionality provided by the Oxygen Feedback product when a connection to Oxygen Feedback is defined in the preferences page.get_topic_context_in_toc- Returns the hierarchical structure path that references the selected topic from the DITA map that is open in the DITA Maps Manager view, providing context such as its parent, siblings, and surrounding nodes within the DITA map. This is useful for understanding the topic's location in relation to other elements in the DITA map.resolve_dita_key_or_content_reference- Resolves a DITA XML key reference, content key reference, or content reference to the target content.save_document- Saves the document at the specified path within the project and writes content to it. If a resource already exists at the specified URL, the content of the document is overridden with the new content.
For more information about the AI tool functions, see Oxygen AI Positron Assistant - Function Calls.
Intelligent Agents
Intelligent Agents is a category of AI-powered actions designed
to streamline DITA XML topic management. These agents offer advanced capabilities to save
files, add references to the DITA map, and access functions for contextual understanding and
project structure modification.
Expand DITA Topic Draft
The new Expand Draft AI action enhances a draft of a DITA XML
topic by refining the content, adding consistent markup, and generating documentation
based on referenced images using Vision support. The AI searches for similar content in
topics gathered from related links or through Retrieval-Augmented Generation (RAG). This
action is available for DITA XML documents.
Split Large DITA Topics
The Split Topic AI action splits large topics with numerous
subjects into multiple topic files. The newly created topics are also conveniently
referenced in the DITA map that is currently open in the DITA Maps Manager.
Create DITA Topics
The new Create Topics AI action generates DITA XML topics
based on user input, incorporating relevant project content. It creates a topic hierarchy,
assigns DITA document types, and proposes a DITA map location. Topics are then saved and
added upon user approval. The AI searches for similar content in topics gathered from
related links or through the Retrieval-Augmented Generation (RAG) process.
Interface Improvements
Current Element Highlighted When Applying an AI Action in Text Mode
When utilizing AI actions in Text mode, it is easier to
identify the element affected by an AI action. The current element, serving as the context
for the action, is highlighted for improved visibility and ease of
identification.
AI-Powered Actions
Reuse DITA XML Component
A new Component action in the Reuse category
asks the AI to identify the most similar existing reusable component that matches the
selected paragraph, saving you from searching for the correct reusable
component.
Find Product Names
The new Product Name AI action (located in the
Reuse category) searches for product names in the selected content and
replaces them with key references (
keyref) if keys are defined for the
particular product names. If keys are not defined for specific product names, those names
are wrapped in <keyword> elements instead.Suggest Refactoring for Selected Code
The new Suggest Refactoring AI action (in the
Development category) generates a suggestion for refactoring the
selected code to simplify it and make it easier to read and understand. This action is
available for XSLT and XSD documents.
Generate Code Action Reuses Components
The Generate Code AI action that is used to generate code for
the current editor type (XSL, XQuery, CSS, JSON, XML Schema, or Schematron) now reuses
components found in the current document, making the responses more
relevant.
New Action Types
New action types are now available when implementing custom user-specific
actions:
prompt-user- Prompts the user for extra details passed to the action prompt.replace-selection-based-on-image-analysis- Uses details obtained from the referenced DITA XML images when performing the action prompt.
Miscellaneous
Document Type Sent to AI for Context
When starting a new chat with the AI, the document type and any selected
content in the main editor area are automatically provided as context. This feature allows
you to get responses more tailored for that specific document.
Intuitive Identification of XML Content in Markdown
An AI response might contain explanations followed by the actual response
wrapped in the
```xml marker. This type of response is now detected and
the block of XML code can be inserted or previewed.Security Enhancements
Information regarding favorite prompts, chat history, or AI XPath functions are
stored encrypted in the options file. The Retrieval-Augmented Generation (RAG) preferences
page has new security-related options to enable reading and writing content in the project
or to control if the end user is prompted to allow the use of function calls for
particular actions.
Web Author
Attach Image, XML, or Text File to a Chat
Users can attach multiple images, XML, or text files to a chat message by
clicking on an interface button. The selected file will be inserted into the chat,
allowing the AI to utilize it for additional context during the
conversation.
Document Type Sent to AI for Context
When starting a new chat with the AI, the document type and any selected
content in the main editor area are automatically provided as context. This feature allows
you to get responses more tailored for that specific document.
Intuitive Identification of XML Content in Markdown
An AI response might contain explanations followed by the actual response
wrapped in the
```xml marker. This type of response is now detected and
the block of XML code can be inserted or previewed.Expand DITA Topic Draft
The new Expand Draft AI action enhances a draft of a DITA XML
topic by refining the content, adding consistent markup, and generating documentation
based on referenced images using Vision support. The AI searches for similar content in
topics gathered from related links or through Retrieval-Augmented Generation (RAG). This
action is available for DITA XML documents.
Split Large DITA Topics
The Split Topic AI action splits large topics with numerous
subjects into multiple topic files. The newly created topics are also conveniently
referenced in the DITA map that is currently open in the DITA Maps Manager.
New AI tool functions
Within the definition of custom actions, you can reference functions that may
be called by the AI engine to interact with the application. These functions can provide
additional information that allows for more relevant answers to be constructed by the AI,
or they may allow the AI to directly act in a controlled way on the application workspace.
The following functions were added in this version:
get_content_for_document_url- Retrieves the content of a certain document.get_current_editor_file_location- Retrieves the location (URL) of the current file that is open in the editor.get_related_content_from_webhelp- Accesses the search functionality provided by the Oxygen Feedback product when a connection to Oxygen Feedback is defined in the preferences page.save_document- Saves the document at the specified path within the project and writes content to it. If a resource already exists at the specified URL, the content of the document is overridden with the new content.
Oxygen AI Positron Assistant 3.0
September 5, 2024
The Oxygen AI Positron Assistant add-on is a powerful tool that helps users increase their productivity by providing support for using AI-generated content. Version 3.0 continues to increase the efficiency of using the tool and the quality of the AI responses through the implementation of a project Retrieval-Augmented Generation (RAG) process, various interface improvements, and additional AI-powered actions.
There are changes in:
Retrieval-Augmented Generation (RAG)
Retrieve Project Information to Provide More Context to the AI
When using the AI Positron Assistant add-on with Oxygen versions 26.1 or newer,
certain actions (New DITA Topic, Add Structured Content,
Generate Documentation Draft) now leverage the Retrieval-Augmented Generation
(RAG) process. This output optimization process enhances the AI's responses by using
information from the current project opened in the Project view to enrich the AI context
for you to receive more meaningful and project-targeted responses.
RAG is also enabled by default for all chat sessions within the AI Positron Assistant. If you wish to configure the various RAG-specific settings, you can access the new Retrieval-Augmented Generation (RAG) preferences page.
Function Calls
Within the definition of custom actions, you can reference existing
functions that are called by the AI engine to interact with the application. This gives
actions more context information and allows for more accurate answers to be constructed by
the AI. The current available reference values for pre-defined function calls are:
get_related_content_from_project- Retrieves content from the user's local project based on given key words. It is limited to return a maximum of 50k characters and works with Oxygen version 26.1 or newer.get_related_resources_overview_from_projectandget_content_for_document_id- Retrieves an overview of a maximum of 5 documents that each contain an ID along with the most relevant information from each document (usually titles, key words, short descriptions). The second function can be called by the AI to retrieve the content of a certain document. It is also limited to return a maximum of 50k characters and works with Oxygen version 26.1 or newer.get_current_document_plain_text_content- Obtains all text without markup from the current document open in the editor.get_current_document_marked_up_content- Obtains all text with markup from the current document open in the editor.get_content_around_caret- Obtains size-limited content around the current cursor location within the document open in the editor.
For more information about the function calls, see Oxygen AI Positron Assistant - Function Calls.
Interface Improvements
AI Positron Assistant Widget
For documents that are open in the Author visual editing mode,
there is an AI Positron Assistant drop-down widget in the top-right corner of the editor.
It offers a very quick and convenient way of accessing useful AI actions to create and
improve the structure and content in the current document. The drop-down list can also be
accessed while editing by using the Ctrl - Alt - Enter (Windows) or Ctrl - Enter
(Mac) keyboard shortcuts. In this case, the drop-down list is displayed in a
floating dialog box close to the text cursor location, making the functionality even more
efficient.
In-place AI Prompt Input Field
The AI Positron Assistant drop-down widget contains a helpful
Rewrite content action that opens a floating input box close to the
text cursor location where you can provide the AI with instructions on how to rewrite the
selected content (or the current paragraph if there is no current
selection).
Regenerate Response
After you receive a response from the AI, you now have the option to ask the AI
to regenerate another answer. With OpenAI, you can also decide which engine model to
employ when regenerating the response. For more information, see Oxygen AI
Positron Assistant - Response Actions.
Preview Responses When Using AI Features in Text Mode
When using AI actions while working on your documents in the
Text mode, you now have the ability to preview the AI-generated
response before inserting the changes in the document.
Access Quick Assist Actions From Vertical Stripe Icon
Custom user-defined AI actions can now be configured to appear as Quick Assist
fixes in the editor. To access these actions, you simply click the light bulb icon located
on the vertical navigation stripe. This feature offers you convenience by providing direct
access to frequently used fixes without the need to navigate through menus, and supports
customization to better suit your workflow and preferences.
Easily Choose Between AI Models
The AI model used for each particular action or chat session can easily be
changed from the convenient drop-down list located in the toolbar of the AI
Positron Assistant view. The default model is now GPT-4o,
which is an advanced model that provides better results but is more expensive than other
models, so it is quite helpful to have a very quick and easy way of changing it for
actions that may not require advanced results.
Additionally, the chat panel now specifies which AI model was used for each response.
AI Models
GPT-4o-mini AI Model
The GPT-4o-mini AI model was added to the list of available
models. According to the OpenAI
documentation, it is the most advanced one in the "small models category" and
also the least expensive model. You can choose to use this new model on a case-by-case
basis or you can configure the connection settings to make it the default model used for
all actions.
Improved Credit Usage Efficiency
The credit system has been updated to enhance cost efficiency. Now, input
tokens and output tokens are treated differently when calculating consumed credits, with
input tokens being less expensive than output tokens.
AI-Powered Actions
Proofread Action
When editing DITA XML documents, a new Proofread AI action is
now available (in the Review category) to help you identify potential
issues in your content. The AI will proceed to add comments in the content regarding
logical consistency problems, grammar or spelling mistakes, or readability and
comprehension issues.
Resolve Comments Action
Another new AI action titled Resolve Comments was added in the
Review category that enables the AI to change the selected content
based on the suggestions found within comments. It then also removes the comments, saving
you time in the cleanup process. The action becomes available when working with DITA XML
documents.
Improve Structure Action
A new Improve Structure AI action (in the
Rewrite category) can be used when working with DITA XML documents to
instruct the AI to improve the selected DITA XML content by adding additional structure or
inline elements.
Add Structured Content Action
In the Content Generation category, a new Add
Structured Content AI action was implemented that enables you to continue the
content from a DITA XML document with additional structured content generated based upon
similar content from the current project (if available). This helps the AI with context
and leads to more accurate and higher quality results.
Web Author
Edit Messages Sent to AI
You can edit your message that you send to the AI by clicking a convenient edit
button that appears to the right of your message in the response area. Once you submit
your edited message, the AI regenerates the response. This streamlines the process of
fine-tuning the results to suit your needs.
Selected Content Sent to AI for Context
When directly initiating a new chat with the AI (without invoking an action),
any content selected in the main editor area is automatically passed as context for the
conversation. This feature allows you to effortlessly process content within the
editor.
Improve Structure Action
A new Improve Structure AI action can be used to instruct the
AI to improve the selected DITA XML content by adding additional structure or inline
elements.
Proofread Action
When editing DITA XML documents in Oxygen XML Web Author, a new
Proofread AI action is now available to aid you in identifying
potential issues in your content. The AI will then proceed to add comments in the content
regarding logical consistency problems, grammar or spelling mistakes, or readability and
comprehension issues.
Resolve Comments Action
A new Resolve Comments AI action was implemented in Oxygen XML
Web Author as well, enabling the AI to modify selected content based on suggestions in the
comments. It also automatically removes the comments, saving you time during the cleanup
process. This action is available when working with DITA XML documents.
Generate Image Alternate Text AI Action
When editing DITA XML files, you can use the new Generate Image
Alternate Text AI action to generate an alternate text for an image that is
selected in the editing area.
Function Calls
Within the definition of custom actions, you can reference existing
functions that are called by the AI engine to interact with the application. This gives
actions more context information and allows for more accurate answers to be constructed by
the AI. The current available reference values for pre-defined function calls for Web
Author are:
get_current_document_plain_text_content- Obtains all text without markup from the current document open in the editor.get_current_document_marked_up_content- Obtains all text with markup from the current document open in the editor.get_text_around_caret- Obtains size-limited content around the current cursor location within the document open in the editor.
Oxygen AI Positron Assistant 2.1
June 12, 2024
The Oxygen AI Positron Assistant add-on is a powerful tool that helps users increase their productivity by providing support for using AI-generated content. Version 2.1 expands upon the enhancements of the previous version by adding the advanced multi-modal GPT-4o to the list of models to choose from, as well as the Microsoft Azure OpenAI Service connector now supporting authentication using Microsoft Entra ID.
New AI actions have been introduced in this version, allowing users to generate, document, or explain specific code, initiate a conversation with the AI regarding certain code, and create alternate text for images. Furthermore, version 2.1 also introduces three AI XML refactoring actions aimed to improve the efficiency for users working with DITA XML topics.
For Web Author users who integrate the Oxygen AI Positron Assistant Enterprise for Web Author plugin, the ability to filter the list of AI actions is now available.
There are changes in:
Optimization
GPT-4o Model
GPT-4o was added to the list of models to choose from in the
Oxygen AI Positron Assistant preferences page. This is OpenAI's most
advanced multi-modal (able to accept text or image inputs) model and it is faster and less
expensive than the GPT-4 Turbo model.
When utilizing the Oxygen AI Positron Assistant Enterprise add-on, access to the GPT-4o model is possible when connected to the OpenAI platform.
Enhanced Microsoft Azure OpenAI Service Connector Using Microsoft Entra ID Authentication
For the Enterprise version of Oxygen AI Positron Assistant, the Microsoft Azure
OpenAI Service connector now supports authentication using Microsoft Entra ID, offering
improved security and flexibility. Environment variables can be used for various
authentication methods, including service principal and username/password
authentication.
AI-Powered Actions
Explain Code AI Action
The new Explain Code AI action (located in the
Development category) can be used to generate an explanation of the
code found in the current selection, at the cursor location, or in the whole document.
This action is available for XSLT, Schematron, XSD, CSS, XQuery, JSON, and JSON Schema
documents.
Chat About Code AI Action
The Chat about Code AI action (located in the
Development category) is now available and enables users to start a
conversation with the AI regarding the code found in the current selection, at the cursor
location, or in the whole document. Utilizing this feature, users can easily optimize and
rewrite code blocks with the help of the AI Positron Assistant, thus enhancing their
overall coding experience and efficiency. This action is available for XSLT, Schematron,
XSD, CSS, XQuery, JSON, and JSON Schema documents.
Document Code AI Action
The newly introduced Document Code AI action (located in the
Development category) can be used to generate the documentation for
selected content, the current node, or the entire document. The generated documentation
can then be inserted as an XML comment before the documented code. This feature is
applicable to XSLT, XSD, and Schematron documents.
Generate Code AI Action
The Generate Code AI action (located in the
Development category) allows users to generate code for various editor
types (such as XSLT, Schematron, XSD, CSS, XQuery, JSON, and JSON Schema) based on the
instruction specified in a selected text from the editor or in a comment preceding the
cursor location.
Generate Image Alternate Text AI Action
When editing DITA XML files, the new Generate Image Alternate
Text AI action can be used to generate an alternate text for an image that is
selected in the editing area.
AI XML Refactoring Actions
The AI Positron Assistant add-on introduces a new category titled
AI in the application's XML Refactoring wizard. This
category includes three new XML refactoring actions aimed to improve the efficiency for
users working with DITA XML topics: Generate alternate text for images in DITA XML
topics, Generate missing short descriptions in DITA XML
topics, and Shorten existing short descriptions in DITA XML
topics.
Web Author
Filter List of Available Actions for Web Author
Oxygen XML Web Author users who integrate the Oxygen AI Positron
Assistant Enterprise for Web Author plugin now have the ability to filter the
list of AI actions. An additional option has been included in the Preferences page,
enabling users to specify which actions should no longer appear in the list of available
actions.
Miscellaneous
Selected Content Sent to AI for Context
When directly initiating a new chat with the AI (without invoking an action),
any content selected in the main editor area is automatically passed as context for the
conversation. This feature allows users to effortlessly process content within the
editor.
Oxygen AI Positron Assistant 2.0
April 23, 2024
The Oxygen AI Positron Assistant add-on is a powerful tool that helps users increase their productivity by providing support for using AI-generated content. Version 2.0 adds support for Vision models, allowing the AI to also read and interpret images and thus supporting more use cases. The new Generate Documentation Draft action makes it possible for users to provide instructions and images to help the AI engine create a draft DITA topic. Furthermore, this version also introduces an action that enables users to simply update the images from a topic and have the AI analyze the images and propose content updates.
Oxygen XML Web Author users can now benefit from the new Oxygen AI Positron Assistant Enterprise plugin. Moreover, the Oxygen XML Enterprise edition license for Oxygen XML Editor, Author, and Developer products now includes access to the Oxygen AI Positron Assistant Enterprise add-on at no extra cost.
Oxygen XML Enterprise Edition Includes Free Access to AI Positron Assistant Enterprise Add-on
An Oxygen XML Enterprise edition license for Oxygen XML Editor, Author, and
Developer products now includes access to the Oxygen AI Positron Assistant Enterprise
add-on at no extra cost. The subscription license for Oxygen AI Positron Assistant
Enterprise add-on remains available for Oxygen Professional, Academic, and Personal
edition users that want to use the AI Positron Assistant Enterprise
Add-on.
Oxygen AI Positron Assistant Enterprise Connector for Anthropic Claude
The Enterprise version of the Oxygen AI Positron Assistant add-on introduces a
new connector for Anthropic Claude, along with the existing connectors
for OpenAI and Microsoft Azure OpenAI Service, thus allowing users to connect directly to
Anthropic Claude as well.
Vision Support
With the newly added vision support, the AI can now read and
interpret images, thus supporting more use cases such as generating a documentation draft
by also considering the content of some images or suggesting changes to the content of a
topic based on updated images. Images can be easily added to the prompts entered in the
Chat window using a dedicated attach action. The vision support is
available for both the version that uses the Positron Service, as well as in the
Enterprise version of the add-on (if the configured engine has vision
support).
Generate Documentation Drafts
A new action called Generate Documentation Draft is available that can be used to create a draft DITA topic. To control the draft generation process, users can specify the context for the new topic, instructions, and images that will be analyzed using the vision support in a dedicated drafting configuration file that gathers all this information. Oxygen provides a customized editing experience in the visual Author editing mode for these draft configuration files so you can easily create such files just by following the instructions from the visual editor.
Update the Content of a DITA Topic Based on the Images that it References
A new Update content based on images action can be used to
update the content of a DITA XML topic. This action reads the images referenced in the
topic and analyzes their content to identify any missing information from the
documentation, and suggests an update to the topic content.
Quick Assist Actions
Some of the most frequently used AI actions (e.g. Correct
Grammar, Improve Readability, Use Active
Voice) are now available as Quick Assist fixes in the editor by clicking the
bulb located on the vertical navigation stripe.
Variables to Obtain Selection with Track Changes Accepted/Rejected
Two new variables may be used when you write prompts:
${selection-original}, which expands to the selected text with all
track changes rejected, and ${selection-final}, which expands to the
selected text with all track changes accepted. Using these variables, you can provide the
AI with both the original and modified text and ask the AI engine to analyze the change.
For instance, you can determine if the AI considers that the final version demonstrates
improved readability.
Filter the List of Actions
You now have the ability to filter the list of actions to exclude those that
you do not use. An option was added in the Oxygen AI Positron Assistant
preferences page where you can specify which actions will no longer be presented in the
list of available actions.
GPT-4 Turbo
The GPT-4 Turbo Preview model, which could be used by the AI Positron Assistant
with the cloud-based Oxygen AI Positron Service or by the Enterprise add-on when
connecting to OpenAI, was replaced with the final GPT-4 Turbo engine
release.
Oxygen AI Positron Assistant Enterprise Plugin for Web Author
Oxygen XML Web Author users now have access to the new Oxygen AI Positron
Assistant Enterprise plugin for Web Author. This plugin provides connectors for direct
access to your own OpenAI account or AI service hosted on Microsoft Azure.
AI XPath Functions Updated to Allow Adding a Conversation History
The signatures of the AI XPath functions
ai:transform-content
and ai:verify-content were modified to allow adding a conversation
history when the functions are used. You can add multiple pairs of user-agent data that
will be passed to the AI as the history of the conversation. This can be used for more
complex actions that need to also set a context for the AI operation.Oxygen AI Positron Assistant 1.1
February 7, 2024
The Oxygen AI Positron Assistant add-on is a powerful tool that helps writers increase productivity by providing support for using AI-generated content with the Oxygen AI Positron service. Version 1.1 introduces a separate Enterprise version of the add-on for those who want to configure the service to use a company-specific AI service (OpenAI or Microsoft Azure OpenAI Service). Moreover, this update brings a selection of new document templates to help you create your own custom AI actions, and a new action was implemented that allows you to translate content into any language. The interface was enhanced to provide easier access to actions, alongside the introduction of various other user experience enhancements.
To try the Oxygen AI Positron Assistant for yourself, there is an option to start with a trial period. Additionally, there are several subscription plans to choose from to align with specific usage needs.
Oxygen AI Positron Assistant Enterprise
A separate Enterprise version of the Oxygen AI Positron Assistant add-on is now
available for those who have an OpenAI account or an OpenAI service hosted on Microsoft
Azure. This version of the add-on allows you to leverage your own personalized AI models.
You can configure your company-specific AI service details in the new AI Service
Configuration preferences page (Options->Preferences->Oxygen AI Positron
Assistant->AI Service Configuration). Oxygen AI Positron Assistant Enterprise
requires a subscription license key to operate.
Create Custom AI Actions
New document templates are available to help you easily create AI Positron
custom actions. The AI Positron Custom Action file template contains a
single custom action definition in JSON format and can be used to configure a single
action, while the AI Positron Custom Actions List file template provides
a convenient way of defining multiple actions inside the same file.
Translate Content to Any Language
A new action (named "Other") was added inside the Translation
section and can be used to translate content into any desired language. You are able to
choose from predefined values or type your own values.
AI Refactoring Available for Remote Resources
The AI Positron Assistant add-on contributes an AI Positron Refactoring action
in the contextual menu (Refactoring->AI Positron Refactoring) of both the
Project and DITA Maps Manager views that can be used to refactor multiple files at once.
Now, this feature also works when applied on remote resources (for example, resources
placed on WebDav servers or Content Management Systems).
Easier Access to Actions
The available AI actions are now displayed as buttons in the Oxygen AI Positron
Assistant view when the chat is empty (in addition to being displayed in the
Actions drop-down menu). This was meant to provide easier access to the
actions.
XML Syntax Highlights
The chat pane now uses XML syntax highlights for XML code to help make it
easier to see and understand the XML structure.
Introducing Oxygen AI Positron Assistant 1.0
November 10, 2023
The Oxygen AI Positron Assistant add-on is a powerful tool that helps writers increase productivity by providing support for using AI-generated content with the Oxygen AI Positron service. Once installed, writers can utilize AI-generated content to perform repetitive tasks, review grammar, generate structure and text, or propose changes to improve readability. It always keeps the writer in control, offering a visual diff comparison to help quickly identify proposed changes and understand how the AI-generated content will appear in the content and you have the ability to refine proposals by continuing the chat with the AI.
To try the Oxygen AI Positron Assistant for yourself, there is an option to start with a trial period. Additionally, there are several subscription plans to choose from to align with specific usage needs.
There are changes in:
AI-Powered Actions
AI Positron Actions
The AI Positron Assistant side-view and various menus offer an extensive array of AI-powered predefined actions that enable users to:
- Generate content such as DITA topics, document fragments, short descriptions, and index terms.
- Improve existing content in terms of grammar, readability, and the use of active voice.
- Get various insights to understand how readable the content is and how it responds to questions.
- Translate to various languages while preserving the XML structure.
- Write better marketing content with support for generating press releases, marketing posts, applying marketing frameworks, and for enhancing search engine optimization.
Custom AI Actions
In addition to the built-in AI actions, it is possible to create your own
custom actions. In the Oxygen AI Positron Assistant preferences page, you
can define a reference to a folder that contains custom actions, which can be easily
created using Oxygen's new file wizard. The benefit of this feature is that it provides
you with a seamless way to create, organize, and manage your custom actions to effectively
leverage the power of AI technology within Oxygen.
Additional Features
AI Chat
The AI Positron Chat allows you to conveniently track the
progress and view the results of triggered actions, along with the responses received from
the AI platform. With actions available to insert the response within the
document, preview the response insertion, or copy the
response to the clipboard, you have complete control over the AI-generated content before
it is incorporated into your document. Additionally, you can further refine the responses
by sending messages directly to the AI Positron platform. It also supports
storing favorite prompts, you can edit previously sent prompts, and a
History drop-down allows you to revisit previous conversations and
continue where you left off.
AI Fixes for Validation Problems
When validation problems are displayed in Oxygen's Results
pane, you can right-click on a problem and use the AI Positron Fix action
to request assistance from the Oxygen AI Positron platform to resolve the issue. It will
propose content that can be used to solve the problem.
AI Refactoring
Refactor one or more files at once using the AI Positron
Refactoring action that makes it possible to leverage the power of AI to
efficiently edit and manage the structure of documents within your project. This action
allows you to either choose from a list of predefined actions or provide custom
instructions for the AI to follow. Additionally, you can preview the proposed changes
before accepting them. The action is available in the Refactoring submenu when
right-clicking files in both the Project and DITA Maps Manager views.
Record Examples for a Set of Instructions
Streamline and automate repetitive tasks using the Record
button (located in the top left corner of the AI Positron Assistant view). It enables you
to provide a set of instructions and record a collection of examples directly in the
editing area to assist the AI in better understanding the given instructions. You can then
save the final result either as a favorite prompt or as an AI Positron
action that can be easily accessed and reused in future interactions
with the AI Positron Assistant.
Subscriptions
Subscription plans were implemented to provide an easy way for users to
purchase additional credits. There are 3 different subscription options to choose from,
depending on your usage. The Explorer option is good for covering daily
tasks when predominantly using GPT-3.5, the Professional option is great
for a balanced use of GPT-3.5 and GPT-4, while the Expert option is ideal
for intensive use of GPT-4.
Customization
AI Positron Preferences
The Oxygen AI Positron Assistant preferences page
(Options > Preferences > Plugins)
provides options for configuring custom actions and defining a context used in each action
and chat request. This ensures that the AI-generated content is more relevant and aligned
with your requirements, enhancing the overall quality of the responses. Additionally, the
preferences page includes an option to cache identical requests. This feature works by
sending fewer requests to the AI server, resulting in a faster and more efficient
process.
Change Default Model
The Oxygen AI Positron Assistant preferences page has an
option for changing the default model (GPT-3.5, GPT-4, or GPT-4
Turbo) to use for the chat view and for actions that do not explicitly specify a
model.
AI-based XPath Functions
The add-on contributes two XPath extension functions
[
ai:transform-content(instruction, content) and
ai:verify-content(instruction, content)] that can be used from custom
Schematron schemas or XML Refactoring actions to rephrase content or to perform validation
checks on existing content.