This addon uses an external AI service (like OpenAI or MS Azure OpenAI) to help technical documentation writers generate content.

Release Notes 6.0.0

1. Support for OpenAI GPT-4.1 Models – Choose from the latest GPT-4.1 models (Full, Mini, Nano) to balance quality, speed, and cost, depending on your use case.
2. Default Model Updated to GPT-4.1 – GPT-4.1 is now the default model for the OpenAI connector. According to the OpenAI documentation, it is the flagship model for complex tasks and is well suited for problem-solving across various domains.
3. Improved Quality for All AI Action Prompts – Prompts for all pre-defined AI actions have been optimized for greater accuracy and relevance. They are now developed using the DITA XML standard, enabling content reuse for more consistent prompts that follow similar patterns and structure.
4. Automatic Validation and Correction – By default, AI-generated content is now automatically validated when it is inserted into your document. If errors are detected, the AI automatically tries to correct the validation errors.
5. AI Positron Fix: Dynamic Context Expansion – The AI Positron Fix action now provides better solutions for complex validation issues by automatically expanding the document context as needed.
6. Rules Saved as Persistent Memories – Ask the AI to remember rules about your activity or profile. These are saved as persistent memories and used in all future interactions.
7. Load Extra Context from a File – Add content from a specified file as additional context for all AI actions and chat, configurable in the AI Positron Assistant preferences.
8. Drag-and-Drop or Copy-Paste Attachments – Attach files to chat by dragging and dropping or copying and pasting them into the chat box.
9. Record Prompts Using the Microphone – Dictate prompts directly using your microphone in both the AI Positron Assistant view and the Rewrite content dialog. This action is available when connecting to an OpenAI service or to a speech service hosted on Microsoft Azure.
10. Invoke AI Actions from Chat – Run any AI action directly from the chat input by entering general instructions (e.g., Invoke the action that corrects the grammar in the current document and then update the document content based on the result.).
11. Grouped Function Calls – Function calls are now grouped and listed at the end of each response. For functions that read or write content, inline links to the target resources are provided.
12. Compact AI Message Presentation – You see AI messages in a more compact format, allowing you to view more content at once and reducing scrolling, so you can review conversations more efficiently.
13. New AI Connector for Google Gemini – Connect the Enterprise distributions of Oxygen AI Positron Assistant to the Google Gemini service and use Gemini’s AI capabilities directly within your content creation workflows.
14. New AI Connector for the Vertex AI Service – Integrate with Google Cloud’s Vertex AI by installing the Oxygen AI Positron Vertex AI Connector add-on. Use your custom or pre-trained Vertex AI models in Oxygen to generate and enhance content with AI-driven suggestions and automation.
15. Microsoft Entra ID Support for Azure OpenAI Connector – The Microsoft Azure OpenAI connector now supports OAuth 2.0 authorization code flow. Sign in using your browser, leverage single sign-on and multi-factor authentication, and manage permissions centrally through Microsoft Entra ID for improved security and easier access management.
16. Simplified Configuration for Microsoft Azure OpenAI – Use the base endpoint for both text and image processing, eliminating the need for separate settings for image analysis. This makes setup faster and easier.
17. Configure the AI Service Using a JSON File – Configure the AI Service for the Oxygen AI Positron Assistant Enterprise add-on by placing a JSON file in the installation directory. This automates the initial setup and prevents users from changing the configuration in the preferences page.
18. Improve Readability by Audience Level – Configure the Improve Readability action for specific audience levels (Beginner, Intermediate, Advanced, Expert) using the Customize button.
19. Development Actions Available for More Document Types – The actions Generate Code, Explain Code, and Chat About Code are now available for a wide variety of document types.
20. Easier Custom AI Action Creation – Access the new documentation and use the simplified configuration for creating custom AI actions. Older definitions remain compatible.

Release Notes 5.0.0

1. AI Creates and Updates Files with User Control - The AI Positron Assistant has the ability to utilize the "save_document()" callback function to create new files or to update existing files while keeping you in control. You can view the changes in the built-in visual file comparison tool and choose to accept or revert them, ensuring that you maintain oversight over your documents.
2. AI-based DITA Conversion, Analysis and Update Tools - Transform existing documents or DITA topics into various specialized DITA types (Task, Concept, Reference, Troubleshooting, Glossary). Also, an AI-powered analysis action can restructure topics by dynamically splitting the document into parts and applying the conversion to the appropriate topic types for each part.
3. AI-Driven File Creation - Generate XSLT, XML Schema (XSD), Schematron, JSON Schema, or DTD files by providing a simple text description, shortening the setup time for new projects and enabling authors to focus on content innovation.
4. Exclude Resources from AI Processing - A newly implemented mechanism allows you to specify files or folders that you want to exclude from the AI analysis process. Resources are excluded by adding them in the .ai-ignore file. A new contextual menu action (named Exclude from AI processing) is available in the Project view, DITA Maps Manager, and the Text and Author pages of the current editor, to easily add resources to the ignore file.
5. Attach Word, PowerPoint, and PDF Files - You can now attach Word (docx), PowerPoint (pptx), and PDF documents in the Chat view, allowing you to provide more context to the AI. This enhances the accuracy and relevance of AI responses by utilizing text and images (images are supported for Word and PDF) from these documents.
6. Generate Documentation Draft Can Read External Files - You can now add references to external files that contain relevant information for generating the new draft. These files can be in plain text format (including Markdown or XML) or document format (PDF, Word, PowerPoint).
7. Reasoning Models Support - The following advanced reasoning models are now available in the AI Positron Assistant through the OpenAI connector: o1, o3, o3-mini, and o4-mini. Reasoning models excel in complex problem solving, coding, scientific reasoning, and multi-step planning for agentic workflows.
8. Integration with xAI Grok - The OpenAI connector was tested and modified to allow connecting to the xAI Grok engine.
9. Quickly find a Positron action - You can now search for an AI-powered action by clicking the Search actions button located at the bottom of the AI Positron Assistant view or by using the Ctrl + Space keyboard shortcut within the chat box.
10. Generate Alternate Text from Floating Toolbar - you can now conveniently access the Generate Alternate Text action from the floating toolbar that appears when you select an image.
11. Performance Optimization for Fix Validation Problems - Experience faster performance and reduced token consumption with the optimized Fix Validation Problems AI action.
12. New functions available:
    • get_related_content_from_specific_feedback_site() - Retrieve content from a specified feedback site using an Oxygen Feedback WebHelp token. This function is available when external retrieval sources are enabled in your preferences.
    • validate_current_document() - Validates the current document and returns the validation issues.
13. Distribute or Filter AI Actions via Plugins and Frameworks - In Oxygen XML Web Author 27.1 or newer, plugins or frameworks may contain a folder named ai-positron-actions where AI actions are automatically loaded from. A file named excluded-action-ids.txt may also be placed in the same folder to define action IDs (on a line-by-line basis) that should be filtered out from the UI, useful for actions intended to be used in a different context, not directly invoked by the user.
14. Reference Prompt Files in AI Actions - Custom defined AI actions can use the "prompt_ref" JSON property to refer to an external text or Markdown file containing the prompt.
15. Translated AI Actions - The titles, categories, and descriptions for the AI Positron default actions are now translated into the language set for the user interface.
16. GPT-3.5 Turbo Model Removed - The legacy GPT-3.5 Turbo AI model was removed. GPT-4o Mini can be used instead, which is smarter, faster, and cheaper.

Release Notes 4.1.1

• Various security fixes.
• Added support for a custom read timeout for AI-service connections.
• Added content completion for built-in AI functions when referenced from Positron custom actions.
• Fixed an issue where the streaming functionality was automatically disabled when debugging mode was activated.
• Fixed an issue where the ai:invoke-action function could not be invoked from the xpath_eval editor variable.

Release Notes 4.1.0

               

• New Fix Validation Problems action - This new action (located in the Intelligent Agents category) validates the entire content of the current document, finds problems, and then uses AI to fix all the reported problems.
• New Formula/Equation Action action - This new action (located in the Content Generation category) can be used to generate an AI proposal for a MathML formula or equation based on information provided by the user when invoking the action (for example, a description of a substance, physics formula, mathematical expression, or LaTeX code).
• New Annotate Code action - This new 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.
• Enhancements to the Resolve Comments action - Invoking this action is now much more efficient as it now appears directly in the contextual menu when right-clicking 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.
• Enhancements to the Create Topics action - This action has been restructured using a multi-agent architecture and now leverages the new invoke_ai_action() function. These improvements ensure better adherence to system instructions and more consistent execution.
• Enhancements to the Expand Draft action - The functionality of this action has been upgraded to include the features previously offered by Add Structured Content, making the latter redundant and subsequently removed.
• No-Change Label on AI Responses - A label has been added on AI responses to inform users when the AI does not propose any changes.
• Preview Changes Feature - Users can now preview changes to documents that the AI wants to update, ensuring accuracy and control over AI-proposed modifications. This feature applies to AI actions like 'Split Topic' and 'Create Topics'.
• New functions:
  • invoke_ai_action() - Invoke an action by passing an action ID and content to process.
  • retrieve_all_ai_actions() - Get IDs and descriptions for each available AI action.
  • validate_document_content() - Validate a specified document's content and report error messages in JSON format.
• You can now define actions that are hidden in the interface and intended only for use by other actions using the new "invoke_ai_action()" function. These actions must have their IDs prefixed with "agent.hidden.action".
• Function calls displayed in the AI Positron Assistant side-view now include the values of their parameters.
• The dialog displaying function call details has been improved with a clearer presentation, making it easier to inspect and understand the calls.
• Export/Import chat - Chats can now be exported to JSON files and imported back when needed. This feature is particularly useful for developers of custom Positron actions, as it simplifies debugging issues encountered during user interactions.
• Enable AI Positron Assistant - A new setting in the AI Positron Preferences page allows disabling the add-on on a per-project basis.
• gpt-4o-2024-11-20 is now the default model for the OpenAI Connector. This model is more cost-effective than our previous default and supports four times more maximum output tokens while maintaining very similar performance.

Release Notes 4.0.1

• Various security fixes.
• Create Topics AI action has been enhanced to deliver improved results for generating DITA XML topics.
• Fixed an issue where the AI was unable to compute the URL of related topics when expanding drafts.
• Preview support fixes when using Oxygen with the Tridion CMS and processing elements containing varref attributes.
• Resolved an issue where the get_content_for_document_url function did not return an error message as expected when encountering invalid input or processing issues.

Release Notes 4.0.0

               

• Security Enhancements - Various security enhancements were implemented. Information regarding favorite prompts, chat history, or AI XPath functions are stored encrypted. The Retrieval-Augmented Generation (RAG) preferences page has some new security-related options to choose whether or not to enable reading and writing content in the project.
• Intuitive Identification of XML Code in Markdown - If the AI returns a response with Markdown content that contains XML code (for example, from a chat session where you give the AI a task such as converting a list into a table), the AI might start with some 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.
• Markdown Syntax Highlight in Chat Response Area - When using the add-on in Oxygen 27 or newer, the chat response area can have either Markdown or XML syntax highlight depending on the response content.
• Open Links from Chat Response Area - URL links present in the chat response area can be opened by pressing Ctrl/Command and then mouse clicking on the link.
• AI Positron Fix with RAG - The AI Positron Fix action now uses Retrieval-Augmented Generation to get more context from the current document.
• Oxygen Feedback based Retrieval Augmentation - If the Oxygen Feedback product is used to provide search for a web site generated from the DITA XML project, the Feedback search system can be used to retrieve related content instead of the current indexed DITA XML project. In the Feedback administrator Installation page the embed HTML information contains an unique token which can be copied and pasted in the AI Positron Retrieval-Augmented Generation (RAG) preferences page in the WebHelp Feedback token field.
• Document type context in chat - If there is content selected in the main editor area when a chat is initiated, the selection is passed to the AI along with the document type as context for the conversation.
• Split Large DITA Topics - When working with DITA XML documents, the new Split Topic AI action (located in the Intelligent Agents category) can be used to split 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.
• Expand DITA Topic Draft - The new Expand Draft AI action (located in the Intelligent Agents category) enhances a draft of a DITA XML topic by refining the content, adding markup that is consistent with similar topics, and generating documentation based on the referenced images using Vision support. The AI looks for similar content in topics gathered from the related links or through the Retrieval-Augmented Generation (RAG) process that looks in both the current project and WebHelp output with the Oxygen Feedback component deployed for search functionality. This action is available for DITA XML documents.
• Create DITA Topics - The new Create Topics AI action (located in the Intelligent Agents category) generates DITA XML topics based upon 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 looks for similar content in topics gathered from the related links or through the Retrieval-Augmented Generation (RAG) process that looks in both the current project and WebHelp output (with the Oxygen Feedback component deployed for search functionality). This action is available for DITA XML documents.
• Reuse Component - Added in the 'Reuse' category a new 'Component' action which asks the AI to identify the closest existing reusable component which matches the current selected paragraph.
• Reuse Product Names - Added in the 'Reuse' category a new 'Product Names' action which finds product names in the selected content and replaces them with key references.
• Suggest Refactoring for Selected Code - The new Suggest Refactoring AI action (located in the Development category) can be used to generate 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.
• New functions:
  • add_to_toc - Modifies a the DITA map and adds a topic reference to it at a certain relative location.
  • find_similar_reusable_content - Retrieves a list of reusable DITA XML components which match keywords provided by the AI.
  • get_content_for_document_url - Retrieves the content of a certain document.
  • get_corresponding_dita_keyrefs - Finds DITA key references that correspond to product names in the context DITA map.
  • get_current_editor_file_location - Retrieves the location (absolute path/URL) of the current file that is open in the editor.
  • get_related_content_from_webhelp - Returns content from the associated Oxygen Feedback WebHelp system for which a token has been configured in the Retrieval-Augmented Generation (RAG) preferences page.
  • get_topic_context_in_toc - Returns from the DITA map opened in the DITA Maps Manager view the hierarchical structure path which references the selected topic.
  • resolve_dita_key_or_content_reference - Resolves a DITA XML key reference, a content key reference, or a content reference to the target text.
  • save_document - Saves the document at a specified URL path and writes content to it.
• New custom action types:
  • prompt-user - Prompt the user for extra details and then perform the action.
  • replace-selection-based-on-image-analysis - Use details obtained from the referenced DITA XML images to perform the action prompt.
• Current Element Highlighted When Applying an AI Action in Text Mode - When utilizing AI actions while you are editing in Text mode, it is now easier to identify the element that is affected by an AI action. This is especially beneficial when there is no specific selection in the editor. The current element, which serves as the context for applying the action, is now highlighted for improved visibility and ease of identification.

Release Notes 3.0.0

               

• Actions using Retrieval-Augmented Generation (RAG) - For Oxygen version 26.1 (latest build) and newer, certain actions that generate content, such as New DITA Topic or Add Structured Content, now use information from the project opened in the Project view to enrich the AI context and receive more meaningful and project-targeted responses. The new Retrieval-Augmented Generation (RAG) preferences page allows changing various settings related to RAG.
• Chat using RAG - RAG is also enabled for chat sessions in Oxygen version 26.1 (latest build) and newer.
• Generate Documentation Draft using RAG - When the use-related-content-from-project="true" attribute is set on the <draft-summary> element, RAG is enabled for the Generate Documentation Draft action.
• Function Calls - Both built-in and user-defined actions can refer in their definition to existing functions that are to be called by the AI engine when giving a response. This gives actions more context information and allows for more tailored and accurate answers to be constructed.
• AI Positron Assistant Widget - For documents opened in the Author visual editor, you can click the AI Positron Assistant widget located in the top-right corner of the editing area or use the configurable "Ctrl+Alt+Enter" (Windows/Linux) or "Ctrl+Enter" (Mac) shortcut to access useful AI actions.
• Rewrite content - Added a new action that opens a floating input box at 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). This action is available in the AI Positron Assistant Widget or by using the configurable "Ctrl+Alt+R" (Windows/Linux) / "Cmd+Alt+R" (Mac) shortcut.
• Select AI Model - A drop-down was added to the AI Positron Assistant side view in order to quickly select the default AI model to use for chat and actions.
• Content Generation > Add Structured Content - A new action is available that can be used to replace the current selection with new structured content that is generated based upon similar content from the current project (if available).
• Content Generation > New DITA Topic - For Oxygen version 26.1 (latest build) and newer, the New DITA Topic action now uses related information from the current project when constructing the content and structure of the new topic.
• Rewrite > Improve Structure - A new action is available that can be used to improve the selected DITA XML content by adding additional structure or inline elements.
• Review > Proofread - A new action is available that can be used to add comments in content that has logical consistency problems, grammar or spelling mistakes, or is hard to read and comprehend.
• Review > Resolve Comments - A new action is available that changes the selected content based on suggestions found within comments and then removes the comments.
• Regenerate Response - After you receive a response from the AI, you have the possibility to ask it to generate another one. You can also decide which AI model to be used when generating the new response.
• Default model - For the OpenAI connector, GPT-4o, the most intelligent model from OpenAI, is now the default model in the AI Positron Assistant.
• GPT-4o mini - For the OpenAI connector, the most affordable intelligent model from OpenAI is now available in the AI Positron Assistant.
• Preview Response for Text Mode - When using AI actions while working with your documents in the Text mode, you now have the ability to preview the AI response before inserting the changes in the document.
• For the OpenAI connector, each answer from the AI presented in the chat panel now specifies the model that has been used for generating it.
• The actions related to an AI-generated message in the chat panel (Insert, Replace, Preview, etc.) are now buttons with icons instead of links.

Release Notes 2.1.0

               

• The new Generate Image Alternate Text action allows generating an alternate text for a DITA XML image that is selected in the main editing area in the Author visual editing mode.
• If you start a conversation with the AI and there is selection in the current editor area, that selection is passed as a context to the chat engine.
• The add-on contributes three new XML refactoring actions in the Oxygen XML Refactoring dialog box, in the new AI category:
  • Generate alternate text for images in DITA XML topics
  • Generate missing short descriptions in DITA XML topics
  • Shorten existing short descriptions in DITA XML topics
• For the OpenAI connector, gpt-4o, the latest model from OpenAI, has been added to the list of supported models.
• The MS Azure connector now supports authentication using Microsoft Entra ID, enhancing security and flexibility.
• When selecting an AI assistant response in the chat view, you now have contextual actions available to insert the selection into the document or preview the insertion.

Release Notes 2.0.0

               

• Added support to connect to the Anthropic Claude AI engine.
• Added support in the MS Azure OpenAI connector to configure separate Vision Endpoint, Deployment and API Key settings used for analyzing messages which contain images.
• A new action called "Generate Documentation Draft" is available, and it can be used to draft a DITA topic based on a configuration file that fine tunes the generation process.
• A new action called "Update content based on images" is available, and it can be used to update the content of a DITA XML topic based on the images that it refers.
• Images, XML files, and text files can be attached to messages in the Chat panel.
• Useful AI actions (Correct Grammar, Improve Readability, Use Active Voice) are now available as quick assist fixes in the editor by clicking the bulb located on the navigation vertical stripe.
• 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.
• You can now specify in the "Oxygen AI Positron Assistant Enterprise" preferences page which actions to exclude from being presented in the available actions list.
• For the OpenAI connector, the gpt-4-turbo-preview model has been replaced with the recently released gpt-4-turbo.

Release Notes 1.2.0

               

• Oxygen XML Enterprise edition license now includes access to Oxygen AI Positron Assistant Enterprise at no extra cost.

Release Notes 1.1.1

               

• Fixed an issue where the connection to MS Azure OpenAI failed when the configured endpoint URL address included a path.

Release Notes 1.1.0

               

• The new Oxygen AI Positron Assistant Enterprise addon enables direct access to your own OpenAI account or AI service hosted on Microsoft Azure. This can be configured in the "Preferences->Oxygen AI Positron Assistant / AI Service Configuration" page. A special license key is required for this feature.
• The AI Positron Assistant Enterprise side view supports content generation and refinement of the AI response. This includes:
  • 'Content Generation' for creating new DITA XML topics, continuing writing, generating short descriptions, index terms, and following instructions.
  • 'Rewrite' actions for grammar correction, readability improvement, content conversion to active voice, itemization, and joining items.
  • 'Overview' actions for answering and generating questions, summarizing content, and improving readability.
  • 'Translation' actions support English, German, French, and Japanese languages, with an option to provide a target language.
  • 'Marketing' features for creating release notes, marketing posts, improving SEO, and rewriting content using the Pain-Agitate-Solution and Features-Advantages-Benefits frameworks.
• The AI Positron Refactoring action is available for refactoring multiple files simultaneously using AI.
• The 'Validation Quick Fixes' feature allows the use of the AI Positron Fix action to rectify validation issues.
• Custom actions and prompts can be created in the AI Positron Assistant by recording changes.
• Two XPath extension functions are available in the content completion proposals for Schematron, XSLT, XQuery, and XPath:
  • 'ai:transform-content(instruction, content)' for automatic content transformation using AI.
  • 'ai:verify-content(instruction, content)' for automatic content validation using AI.

This addon uses an external AI service (like OpenAI or MS Azure OpenAI) to help technical documentation writers generate content.

Release Notes 5.0.0

1. AI Creates and Updates Files with User Control - The AI Positron Assistant has the ability to utilize the "save_document()" callback function to create new files or to update existing files while keeping you in control. You can view the changes in the built-in visual file comparison tool and choose to accept or revert them, ensuring that you maintain oversight over your documents.
2. AI-based DITA Conversion, Analysis and Update Tools - Transform existing documents or DITA topics into various specialized DITA types (Task, Concept, Reference, Troubleshooting, Glossary). Also, an AI-powered analysis action can restructure topics by dynamically splitting the document into parts and applying the conversion to the appropriate topic types for each part.
3. AI-Driven File Creation - Generate XSLT, XML Schema (XSD), Schematron, JSON Schema, or DTD files by providing a simple text description, shortening the setup time for new projects and enabling authors to focus on content innovation.
4. Exclude Resources from AI Processing - A newly implemented mechanism allows you to specify files or folders that you want to exclude from the AI analysis process. Resources are excluded by adding them in the .ai-ignore file. A new contextual menu action (named Exclude from AI processing) is available in the Project view, DITA Maps Manager, and the Text and Author pages of the current editor, to easily add resources to the ignore file.
5. Attach Word, PowerPoint, and PDF Files - You can now attach Word (docx), PowerPoint (pptx), and PDF documents in the Chat view, allowing you to provide more context to the AI. This enhances the accuracy and relevance of AI responses by utilizing text and images (images are supported for Word and PDF) from these documents.
6. Generate Documentation Draft Can Read External Files - You can now add references to external files that contain relevant information for generating the new draft. These files can be in plain text format (including Markdown or XML) or document format (PDF, Word, PowerPoint).
7. Reasoning Models Support - The following advanced reasoning models are now available in the AI Positron Assistant through the OpenAI connector: o1, o3, o3-mini, and o4-mini. Reasoning models excel in complex problem solving, coding, scientific reasoning, and multi-step planning for agentic workflows.
8. Integration with xAI Grok - The OpenAI connector was tested and modified to allow connecting to the xAI Grok engine.
9. Quickly find a Positron action - You can now search for an AI-powered action by clicking the Search actions button located at the bottom of the AI Positron Assistant view or by using the Ctrl + Space keyboard shortcut within the chat box.
10. Generate Alternate Text from Floating Toolbar - you can now conveniently access the Generate Alternate Text action from the floating toolbar that appears when you select an image.
11. Performance Optimization for Fix Validation Problems - Experience faster performance and reduced token consumption with the optimized Fix Validation Problems AI action.
12. New functions available:
    • get_related_content_from_specific_feedback_site() - Retrieve content from a specified feedback site using an Oxygen Feedback WebHelp token. This function is available when external retrieval sources are enabled in your preferences.
    • validate_current_document() - Validates the current document and returns the validation issues.
13. Distribute or Filter AI Actions via Plugins and Frameworks - In Oxygen XML Web Author 27.1 or newer, plugins or frameworks may contain a folder named ai-positron-actions where AI actions are automatically loaded from. A file named excluded-action-ids.txt may also be placed in the same folder to define action IDs (on a line-by-line basis) that should be filtered out from the UI, useful for actions intended to be used in a different context, not directly invoked by the user.
14. Reference Prompt Files in AI Actions - Custom defined AI actions can use the "prompt_ref" JSON property to refer to an external text or Markdown file containing the prompt.
15. Translated AI Actions - The titles, categories, and descriptions for the AI Positron default actions are now translated into the language set for the user interface.
16. GPT-3.5 Turbo Model Removed - The legacy GPT-3.5 Turbo AI model was removed. GPT-4o Mini can be used instead, which is smarter, faster, and cheaper.

Release Notes 4.1.1

• Various security fixes.
• Added support for a custom read timeout for AI-service connections.
• Added content completion for built-in AI functions when referenced from Positron custom actions.
• Fixed an issue where the streaming functionality was automatically disabled when debugging mode was activated.
• Fixed an issue where the ai:invoke-action function could not be invoked from the xpath_eval editor variable.

Release Notes 4.1.0

• New Fix Validation Problems action - This new action (located in the Intelligent Agents category) validates the entire content of the current document, finds problems, and then uses AI to fix all the reported problems.
• New Formula/Equation Action action - This new action (located in the Content Generation category) can be used to generate an AI proposal for a MathML formula or equation based on information provided by the user when invoking the action (for example, a description of a substance, physics formula, mathematical expression, or LaTeX code).
• New Annotate Code action - This new 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.
• Enhancements to the Resolve Comments action - Invoking this action is now much more efficient as it now appears directly in the contextual menu when right-clicking 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.
• Enhancements to the Create Topics action - This action has been restructured using a multi-agent architecture and now leverages the new invoke_ai_action() function. These improvements ensure better adherence to system instructions and more consistent execution.
• Enhancements to the Expand Draft action - The functionality of this action has been upgraded to include the features previously offered by Add Structured Content, making the latter redundant and subsequently removed.
• No-Change Label on AI Responses - A label has been added on AI responses to inform users when the AI does not propose any changes.
• Preview Changes Feature - Users can now preview changes to documents that the AI wants to update, ensuring accuracy and control over AI-proposed modifications. This feature applies to AI actions like 'Split Topic' and 'Create Topics'.
• New functions:
  • invoke_ai_action() - Invoke an action by passing an action ID and content to process.
  • retrieve_all_ai_actions() - Get IDs and descriptions for each available AI action.
  • validate_document_content() - Validate a specified document's content and report error messages in JSON format.
• You can now define actions that are hidden in the interface and intended only for use by other actions using the new "invoke_ai_action()" function. These actions must have their IDs prefixed with "agent.hidden.action".
• Function calls displayed in the AI Positron Assistant side-view now include the values of their parameters.
• The dialog displaying function call details has been improved with a clearer presentation, making it easier to inspect and understand the calls.
• Export/Import chat - Chats can now be exported to JSON files and imported back when needed. This feature is particularly useful for developers of custom Positron actions, as it simplifies debugging issues encountered during user interactions.
• Enable AI Positron Assistant - A new setting in the AI Positron Preferences page allows disabling the add-on on a per-project basis.
• gpt-4o-2024-11-20 is now the default model for the OpenAI Connector. This model is more cost-effective than our previous default and supports four times more maximum output tokens while maintaining very similar performance.

Release Notes 4.0.1

• Various security fixes.
• Create Topics AI action has been enhanced to deliver improved results for generating DITA XML topics.
• Fixed an issue where the AI was unable to compute the URL of related topics when expanding drafts.
• Preview support fixes when using Oxygen with the Tridion CMS and processing elements containing varref attributes.
• Resolved an issue where the get_content_for_document_url function did not return an error message as expected when encountering invalid input or processing issues.

Release Notes 4.0.0

• Security Enhancements - Various security enhancements were implemented. Information regarding favorite prompts, chat history, or AI XPath functions are stored encrypted. The Retrieval-Augmented Generation (RAG) preferences page has some new security-related options to choose whether or not to enable reading and writing content in the project.
• Intuitive Identification of XML Code in Markdown - If the AI returns a response with Markdown content that contains XML code (for example, from a chat session where you give the AI a task such as converting a list into a table), the AI might start with some 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.
• Markdown Syntax Highlight in Chat Response Area - When using the add-on in Oxygen 27 or newer, the chat response area can have either Markdown or XML syntax highlight depending on the response content.
• Open Links from Chat Response Area - URL links present in the chat response area can be opened by pressing Ctrl/Command and then mouse clicking on the link.
• AI Positron Fix with RAG - The AI Positron Fix action now uses Retrieval-Augmented Generation to get more context from the current document.
• Oxygen Feedback based Retrieval Augmentation - If the Oxygen Feedback product is used to provide search for a web site generated from the DITA XML project, the Feedback search system can be used to retrieve related content instead of the current indexed DITA XML project. In the Feedback administrator Installation page the embed HTML information contains an unique token which can be copied and pasted in the AI Positron Retrieval-Augmented Generation (RAG) preferences page in the WebHelp Feedback token field.
• Document type context in chat - If there is content selected in the main editor area when a chat is initiated, the selection is passed to the AI along with the document type as context for the conversation.
• Split Large DITA Topics - When working with DITA XML documents, the new Split Topic AI action (located in the Intelligent Agents category) can be used to split 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.
• Expand DITA Topic Draft - The new Expand Draft AI action (located in the Intelligent Agents category) enhances a draft of a DITA XML topic by refining the content, adding markup that is consistent with similar topics, and generating documentation based on the referenced images using Vision support. The AI looks for similar content in topics gathered from the related links or through the Retrieval-Augmented Generation (RAG) process that looks in both the current project and WebHelp output with the Oxygen Feedback component deployed for search functionality. This action is available for DITA XML documents.
• Create DITA Topics - The new Create Topics AI action (located in the Intelligent Agents category) generates DITA XML topics based upon 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 looks for similar content in topics gathered from the related links or through the Retrieval-Augmented Generation (RAG) process that looks in both the current project and WebHelp output (with the Oxygen Feedback component deployed for search functionality). This action is available for DITA XML documents.
• Reuse Component - Added in the 'Reuse' category a new 'Component' action which asks the AI to identify the closest existing reusable component which matches the current selected paragraph.
• Reuse Product Names - Added in the 'Reuse' category a new 'Product Names' action which finds product names in the selected content and replaces them with key references.
• Suggest Refactoring for Selected Code - The new Suggest Refactoring AI action (located in the Development category) can be used to generate 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.
• New functions:
  • add_to_toc - Modifies a the DITA map and adds a topic reference to it at a certain relative location.
  • find_similar_reusable_content - Retrieves a list of reusable DITA XML components which match keywords provided by the AI.
  • get_content_for_document_url - Retrieves the content of a certain document.
  • get_corresponding_dita_keyrefs - Finds DITA key references that correspond to product names in the context DITA map.
  • get_current_editor_file_location - Retrieves the location (absolute path/URL) of the current file that is open in the editor.
  • get_related_content_from_webhelp - Returns content from the associated Oxygen Feedback WebHelp system for which a token has been configured in the Retrieval-Augmented Generation (RAG) preferences page.
  • get_topic_context_in_toc - Returns from the DITA map opened in the DITA Maps Manager view the hierarchical structure path which references the selected topic.
  • resolve_dita_key_or_content_reference - Resolves a DITA XML key reference, a content key reference, or a content reference to the target text.
  • save_document - Saves the document at a specified URL path and writes content to it.
• New custom action types:
  • prompt-user - Prompt the user for extra details and then perform the action.
  • replace-selection-based-on-image-analysis - Use details obtained from the referenced DITA XML images to perform the action prompt.
• Current Element Highlighted When Applying an AI Action in Text Mode - When utilizing AI actions while you are editing in Text mode, it is now easier to identify the element that is affected by an AI action. This is especially beneficial when there is no specific selection in the editor. The current element, which serves as the context for applying the action, is now highlighted for improved visibility and ease of identification.

Release Notes 3.0.0

• Actions using Retrieval-Augmented Generation (RAG) - For Oxygen version 26.1 (latest build) and newer, certain actions that generate content, such as New DITA Topic or Add Structured Content, now use information from the project opened in the Project view to enrich the AI context and receive more meaningful and project-targeted responses. The new Retrieval-Augmented Generation (RAG) preferences page allows changing various settings related to RAG.
• Chat using RAG - RAG is also enabled for chat sessions in Oxygen version 26.1 (latest build) and newer.
• Generate Documentation Draft using RAG - When the use-related-content-from-project="true" attribute is set on the <draft-summary> element, RAG is enabled for the Generate Documentation Draft action.
• Function Calls - Both built-in and user-defined actions can refer in their definition to existing functions that are to be called by the AI engine when giving a response. This gives actions more context information and allows for more tailored and accurate answers to be constructed.
• AI Positron Assistant Widget - For documents opened in the Author visual editor, you can click the AI Positron Assistant widget located in the top-right corner of the editing area or use the configurable "Ctrl+Alt+Enter" (Windows/Linux) or "Ctrl+Enter" (Mac) shortcut to access useful AI actions.
• Rewrite content - Added a new action that opens a floating input box at 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). This action is available in the AI Positron Assistant Widget or by using the configurable "Ctrl+Alt+R" (Windows/Linux) / "Cmd+Alt+R" (Mac) shortcut.
• Select AI Model - A drop-down was added to the AI Positron Assistant side view in order to quickly select the default AI model to use for chat and actions.
• Content Generation > Add Structured Content - A new action is available that can be used to replace the current selection with new structured content that is generated based upon similar content from the current project (if available).
• Content Generation > New DITA Topic - For Oxygen version 26.1 (latest build) and newer, the New DITA Topic action now uses related information from the current project when constructing the content and structure of the new topic.
• Rewrite > Improve Structure - A new action is available that can be used to improve the selected DITA XML content by adding additional structure or inline elements.
• Review > Proofread - A new action is available that can be used to add comments in content that has logical consistency problems, grammar or spelling mistakes, or is hard to read and comprehend.
• Review > Resolve Comments - A new action is available that changes the selected content based on suggestions found within comments and then removes the comments.
• Regenerate Response - After you receive a response from the AI, you have the possibility to ask it to generate another one. You can also decide which AI model to be used when generating the new response.
• Default model - For the OpenAI connector, GPT-4o, the most intelligent model from OpenAI, is now the default model in the AI Positron Assistant.
• GPT-4o mini - For the OpenAI connector, the most affordable intelligent model from OpenAI is now available in the AI Positron Assistant.
• Preview Response for Text Mode - When using AI actions while working with your documents in the Text mode, you now have the ability to preview the AI response before inserting the changes in the document.
• For the OpenAI connector, each answer from the AI presented in the chat panel now specifies the model that has been used for generating it.
• The actions related to an AI-generated message in the chat panel (Insert, Replace, Preview, etc.) are now buttons with icons instead of links.

Release Notes 2.1.0

• The new Generate Image Alternate Text action allows generating an alternate text for a DITA XML image that is selected in the main editing area in the Author visual editing mode.
• If you start a conversation with the AI and there is selection in the current editor area, that selection is passed as a context to the chat engine.
• The add-on contributes three new XML refactoring actions in the Oxygen XML Refactoring dialog box, in the new AI category:
  • Generate alternate text for images in DITA XML topics
  • Generate missing short descriptions in DITA XML topics
  • Shorten existing short descriptions in DITA XML topics
• For the OpenAI connector, gpt-4o, the latest model from OpenAI, has been added to the list of supported models.
• The MS Azure connector now supports authentication using Microsoft Entra ID, enhancing security and flexibility.
• When selecting an AI assistant response in the chat view, you now have contextual actions available to insert the selection into the document or preview the insertion.

Release Notes 2.0.0

• Added support to connect to the Anthropic Claude AI engine.
• Added support in the MS Azure OpenAI connector to configure separate Vision Endpoint, Deployment and API Key settings used for analyzing messages which contain images.
• A new action called "Generate Documentation Draft" is available, and it can be used to draft a DITA topic based on a configuration file that fine tunes the generation process.
• A new action called "Update content based on images" is available, and it can be used to update the content of a DITA XML topic based on the images that it refers.
• Images, XML files, and text files can be attached to messages in the Chat panel.
• Useful AI actions (Correct Grammar, Improve Readability, Use Active Voice) are now available as quick assist fixes in the editor by clicking the bulb located on the navigation vertical stripe.
• 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.
• You can now specify in the "Oxygen AI Positron Assistant Enterprise" preferences page which actions to exclude from being presented in the available actions list.
• For the OpenAI connector, the gpt-4-turbo-preview model has been replaced with the recently released gpt-4-turbo.

Release Notes 1.2.0

• Oxygen XML Enterprise edition license now includes access to Oxygen AI Positron Assistant Enterprise at no extra cost.

Release Notes 1.1.1

• Fixed an issue where the connection to MS Azure OpenAI failed when the configured endpoint URL address included a path.

Release Notes 1.1.0

• The new Oxygen AI Positron Assistant Enterprise addon enables direct access to your own OpenAI account or AI service hosted on Microsoft Azure. This can be configured in the "Preferences->Oxygen AI Positron Assistant / AI Service Configuration" page. A special license key is required for this feature.
• The AI Positron Assistant Enterprise side view supports content generation and refinement of the AI response. This includes:
  • 'Content Generation' for creating new DITA XML topics, continuing writing, generating short descriptions, index terms, and following instructions.
  • 'Rewrite' actions for grammar correction, readability improvement, content conversion to active voice, itemization, and joining items.
  • 'Overview' actions for answering and generating questions, summarizing content, and improving readability.
  • 'Translation' actions support English, German, French, and Japanese languages, with an option to provide a target language.
  • 'Marketing' features for creating release notes, marketing posts, improving SEO, and rewriting content using the Pain-Agitate-Solution and Features-Advantages-Benefits frameworks.
• The AI Positron Refactoring action is available for refactoring multiple files simultaneously using AI.
• The 'Validation Quick Fixes' feature allows the use of the AI Positron Fix action to rectify validation issues.
• Custom actions and prompts can be created in the AI Positron Assistant by recording changes.
• Two XPath extension functions are available in the content completion proposals for Schematron, XSLT, XQuery, and XPath:
  • 'ai:transform-content(instruction, content)' for automatic content transformation using AI.
  • 'ai:verify-content(instruction, content)' for automatic content validation using AI.

This addon uses an external AI service (like OpenAI or MS Azure OpenAI) to help technical documentation writers generate content.

Release Notes 4.1.1

• Various security fixes.
• Added support for a custom read timeout for AI-service connections.
• Added content completion for built-in AI functions when referenced from Positron custom actions.
• Fixed an issue where the streaming functionality was automatically disabled when debugging mode was activated.
• Fixed an issue where the ai:invoke-action function could not be invoked from the xpath_eval editor variable.

Release Notes 4.1.0

• New Fix Validation Problems action - This new action (located in the Intelligent Agents category) validates the entire content of the current document, finds problems, and then uses AI to fix all the reported problems.
• New Formula/Equation Action action - This new action (located in the Content Generation category) can be used to generate an AI proposal for a MathML formula or equation based on information provided by the user when invoking the action (for example, a description of a substance, physics formula, mathematical expression, or LaTeX code).
• New Annotate Code action - This new 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.
• Enhancements to the Resolve Comments action - Invoking this action is now much more efficient as it now appears directly in the contextual menu when right-clicking 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.
• Enhancements to the Create Topics action - This action has been restructured using a multi-agent architecture and now leverages the new invoke_ai_action() function. These improvements ensure better adherence to system instructions and more consistent execution.
• Enhancements to the Expand Draft action - The functionality of this action has been upgraded to include the features previously offered by Add Structured Content, making the latter redundant and subsequently removed.
• No-Change Label on AI Responses - A label has been added on AI responses to inform users when the AI does not propose any changes.
• Preview Changes Feature - Users can now preview changes to documents that the AI wants to update, ensuring accuracy and control over AI-proposed modifications. This feature applies to AI actions like 'Split Topic' and 'Create Topics'.
• New functions:
  • invoke_ai_action() - Invoke an action by passing an action ID and content to process.
  • retrieve_all_ai_actions() - Get IDs and descriptions for each available AI action.
  • validate_document_content() - Validate a specified document's content and report error messages in JSON format.
• You can now define actions that are hidden in the interface and intended only for use by other actions using the new "invoke_ai_action()" function. These actions must have their IDs prefixed with "agent.hidden.action".
• Function calls displayed in the AI Positron Assistant side-view now include the values of their parameters.
• The dialog displaying function call details has been improved with a clearer presentation, making it easier to inspect and understand the calls.
• Export/Import chat - Chats can now be exported to JSON files and imported back when needed. This feature is particularly useful for developers of custom Positron actions, as it simplifies debugging issues encountered during user interactions.
• Enable AI Positron Assistant - A new setting in the AI Positron Preferences page allows disabling the add-on on a per-project basis.
• gpt-4o-2024-11-20 is now the default model for the OpenAI Connector. This model is more cost-effective than our previous default and supports four times more maximum output tokens while maintaining very similar performance.

Release Notes 4.0.1

• Various security fixes.
• Create Topics AI action has been enhanced to deliver improved results for generating DITA XML topics.
• Fixed an issue where the AI was unable to compute the URL of related topics when expanding drafts.
• Preview support fixes when using Oxygen with the Tridion CMS and processing elements containing varref attributes.
• Resolved an issue where the get_content_for_document_url function did not return an error message as expected when encountering invalid input or processing issues.

Release Notes 4.0.0

• Security Enhancements - Various security enhancements were implemented. Information regarding favorite prompts, chat history, or AI XPath functions are stored encrypted. The Retrieval-Augmented Generation (RAG) preferences page has some new security-related options to choose whether or not to enable reading and writing content in the project.
• Intuitive Identification of XML Code in Markdown - If the AI returns a response with Markdown content that contains XML code (for example, from a chat session where you give the AI a task such as converting a list into a table), the AI might start with some 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.
• Markdown Syntax Highlight in Chat Response Area - When using the add-on in Oxygen 27 or newer, the chat response area can have either Markdown or XML syntax highlight depending on the response content.
• Open Links from Chat Response Area - URL links present in the chat response area can be opened by pressing Ctrl/Command and then mouse clicking on the link.
• AI Positron Fix with RAG - The AI Positron Fix action now uses Retrieval-Augmented Generation to get more context from the current document.
• Oxygen Feedback based Retrieval Augmentation - If the Oxygen Feedback product is used to provide search for a web site generated from the DITA XML project, the Feedback search system can be used to retrieve related content instead of the current indexed DITA XML project. In the Feedback administrator Installation page the embed HTML information contains an unique token which can be copied and pasted in the AI Positron Retrieval-Augmented Generation (RAG) preferences page in the WebHelp Feedback token field.
• Document type context in chat - If there is content selected in the main editor area when a chat is initiated, the selection is passed to the AI along with the document type as context for the conversation.
• Split Large DITA Topics - When working with DITA XML documents, the new Split Topic AI action (located in the Intelligent Agents category) can be used to split 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.
• Expand DITA Topic Draft - The new Expand Draft AI action (located in the Intelligent Agents category) enhances a draft of a DITA XML topic by refining the content, adding markup that is consistent with similar topics, and generating documentation based on the referenced images using Vision support. The AI looks for similar content in topics gathered from the related links or through the Retrieval-Augmented Generation (RAG) process that looks in both the current project and WebHelp output with the Oxygen Feedback component deployed for search functionality. This action is available for DITA XML documents.
• Create DITA Topics - The new Create Topics AI action (located in the Intelligent Agents category) generates DITA XML topics based upon 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 looks for similar content in topics gathered from the related links or through the Retrieval-Augmented Generation (RAG) process that looks in both the current project and WebHelp output (with the Oxygen Feedback component deployed for search functionality). This action is available for DITA XML documents.
• Reuse Component - Added in the 'Reuse' category a new 'Component' action which asks the AI to identify the closest existing reusable component which matches the current selected paragraph.
• Reuse Product Names - Added in the 'Reuse' category a new 'Product Names' action which finds product names in the selected content and replaces them with key references.
• Suggest Refactoring for Selected Code - The new Suggest Refactoring AI action (located in the Development category) can be used to generate 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.
• New functions:
  • add_to_toc - Modifies a the DITA map and adds a topic reference to it at a certain relative location.
  • find_similar_reusable_content - Retrieves a list of reusable DITA XML components which match keywords provided by the AI.
  • get_content_for_document_url - Retrieves the content of a certain document.
  • get_corresponding_dita_keyrefs - Finds DITA key references that correspond to product names in the context DITA map.
  • get_current_editor_file_location - Retrieves the location (absolute path/URL) of the current file that is open in the editor.
  • get_related_content_from_webhelp - Returns content from the associated Oxygen Feedback WebHelp system for which a token has been configured in the Retrieval-Augmented Generation (RAG) preferences page.
  • get_topic_context_in_toc - Returns from the DITA map opened in the DITA Maps Manager view the hierarchical structure path which references the selected topic.
  • resolve_dita_key_or_content_reference - Resolves a DITA XML key reference, a content key reference, or a content reference to the target text.
  • save_document - Saves the document at a specified URL path and writes content to it.
• New custom action types:
  • prompt-user - Prompt the user for extra details and then perform the action.
  • replace-selection-based-on-image-analysis - Use details obtained from the referenced DITA XML images to perform the action prompt.
• Current Element Highlighted When Applying an AI Action in Text Mode - When utilizing AI actions while you are editing in Text mode, it is now easier to identify the element that is affected by an AI action. This is especially beneficial when there is no specific selection in the editor. The current element, which serves as the context for applying the action, is now highlighted for improved visibility and ease of identification.

Release Notes 3.0.0

• Actions using Retrieval-Augmented Generation (RAG) - For Oxygen version 26.1 (latest build) and newer, certain actions that generate content, such as New DITA Topic or Add Structured Content, now use information from the project opened in the Project view to enrich the AI context and receive more meaningful and project-targeted responses. The new Retrieval-Augmented Generation (RAG) preferences page allows changing various settings related to RAG.
• Chat using RAG - RAG is also enabled for chat sessions in Oxygen version 26.1 (latest build) and newer.
• Generate Documentation Draft using RAG - When the use-related-content-from-project="true" attribute is set on the <draft-summary> element, RAG is enabled for the Generate Documentation Draft action.
• Function Calls - Both built-in and user-defined actions can refer in their definition to existing functions that are to be called by the AI engine when giving a response. This gives actions more context information and allows for more tailored and accurate answers to be constructed.
• AI Positron Assistant Widget - For documents opened in the Author visual editor, you can click the AI Positron Assistant widget located in the top-right corner of the editing area or use the configurable "Ctrl+Alt+Enter" (Windows/Linux) or "Ctrl+Enter" (Mac) shortcut to access useful AI actions.
• Rewrite content - Added a new action that opens a floating input box at 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). This action is available in the AI Positron Assistant Widget or by using the configurable "Ctrl+Alt+R" (Windows/Linux) / "Cmd+Alt+R" (Mac) shortcut.
• Select AI Model - A drop-down was added to the AI Positron Assistant side view in order to quickly select the default AI model to use for chat and actions.
• Content Generation > Add Structured Content - A new action is available that can be used to replace the current selection with new structured content that is generated based upon similar content from the current project (if available).
• Content Generation > New DITA Topic - For Oxygen version 26.1 (latest build) and newer, the New DITA Topic action now uses related information from the current project when constructing the content and structure of the new topic.
• Rewrite > Improve Structure - A new action is available that can be used to improve the selected DITA XML content by adding additional structure or inline elements.
• Review > Proofread - A new action is available that can be used to add comments in content that has logical consistency problems, grammar or spelling mistakes, or is hard to read and comprehend.
• Review > Resolve Comments - A new action is available that changes the selected content based on suggestions found within comments and then removes the comments.
• Regenerate Response - After you receive a response from the AI, you have the possibility to ask it to generate another one. You can also decide which AI model to be used when generating the new response.
• Default model - For the OpenAI connector, GPT-4o, the most intelligent model from OpenAI, is now the default model in the AI Positron Assistant.
• GPT-4o mini - For the OpenAI connector, the most affordable intelligent model from OpenAI is now available in the AI Positron Assistant.
• Preview Response for Text Mode - When using AI actions while working with your documents in the Text mode, you now have the ability to preview the AI response before inserting the changes in the document.
• For the OpenAI connector, each answer from the AI presented in the chat panel now specifies the model that has been used for generating it.
• The actions related to an AI-generated message in the chat panel (Insert, Replace, Preview, etc.) are now buttons with icons instead of links.

Release Notes 2.1.0

• The new Generate Image Alternate Text action allows generating an alternate text for a DITA XML image that is selected in the main editing area in the Author visual editing mode.
• If you start a conversation with the AI and there is selection in the current editor area, that selection is passed as a context to the chat engine.
• The add-on contributes three new XML refactoring actions in the Oxygen XML Refactoring dialog box, in the new AI category:
  • Generate alternate text for images in DITA XML topics
  • Generate missing short descriptions in DITA XML topics
  • Shorten existing short descriptions in DITA XML topics
• For the OpenAI connector, gpt-4o, the latest model from OpenAI, has been added to the list of supported models.
• The MS Azure connector now supports authentication using Microsoft Entra ID, enhancing security and flexibility.
• When selecting an AI assistant response in the chat view, you now have contextual actions available to insert the selection into the document or preview the insertion.

Release Notes 2.0.0

• Added support to connect to the Anthropic Claude AI engine.
• Added support in the MS Azure OpenAI connector to configure separate Vision Endpoint, Deployment and API Key settings used for analyzing messages which contain images.
• A new action called "Generate Documentation Draft" is available, and it can be used to draft a DITA topic based on a configuration file that fine tunes the generation process.
• A new action called "Update content based on images" is available, and it can be used to update the content of a DITA XML topic based on the images that it refers.
• Images, XML files, and text files can be attached to messages in the Chat panel.
• Useful AI actions (Correct Grammar, Improve Readability, Use Active Voice) are now available as quick assist fixes in the editor by clicking the bulb located on the navigation vertical stripe.
• 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.
• You can now specify in the "Oxygen AI Positron Assistant Enterprise" preferences page which actions to exclude from being presented in the available actions list.
• For the OpenAI connector, the gpt-4-turbo-preview model has been replaced with the recently released gpt-4-turbo.

Release Notes 1.2.0

• Oxygen XML Enterprise edition license now includes access to Oxygen AI Positron Assistant Enterprise at no extra cost.

Release Notes 1.1.1

• Fixed an issue where the connection to MS Azure OpenAI failed when the configured endpoint URL address included a path.

Release Notes 1.1.0

• The new Oxygen AI Positron Assistant Enterprise addon enables direct access to your own OpenAI account or AI service hosted on Microsoft Azure. This can be configured in the "Preferences->Oxygen AI Positron Assistant / AI Service Configuration" page. A special license key is required for this feature.
• The AI Positron Assistant Enterprise side view supports content generation and refinement of the AI response. This includes:
  • 'Content Generation' for creating new DITA XML topics, continuing writing, generating short descriptions, index terms, and following instructions.
  • 'Rewrite' actions for grammar correction, readability improvement, content conversion to active voice, itemization, and joining items.
  • 'Overview' actions for answering and generating questions, summarizing content, and improving readability.
  • 'Translation' actions support English, German, French, and Japanese languages, with an option to provide a target language.
  • 'Marketing' features for creating release notes, marketing posts, improving SEO, and rewriting content using the Pain-Agitate-Solution and Features-Advantages-Benefits frameworks.
• The AI Positron Refactoring action is available for refactoring multiple files simultaneously using AI.
• The 'Validation Quick Fixes' feature allows the use of the AI Positron Fix action to rectify validation issues.
• Custom actions and prompts can be created in the AI Positron Assistant by recording changes.
• Two XPath extension functions are available in the content completion proposals for Schematron, XSLT, XQuery, and XPath:
  • 'ai:transform-content(instruction, content)' for automatic content transformation using AI.
  • 'ai:verify-content(instruction, content)' for automatic content validation using AI.

This addon uses an external AI service (like OpenAI or MS Azure OpenAI) to help technical documentation writers generate content.

Release Notes 4.1.0

• New Fix Validation Problems action - This new action (located in the Intelligent Agents category) validates the entire content of the current document, finds problems, and then uses AI to fix all the reported problems.
• New Formula/Equation Action action - This new action (located in the Content Generation category) can be used to generate an AI proposal for a MathML formula or equation based on information provided by the user when invoking the action (for example, a description of a substance, physics formula, mathematical expression, or LaTeX code).
• New Annotate Code action - This new 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.
• Enhancements to the Resolve Comments action - Invoking this action is now much more efficient as it now appears directly in the contextual menu when right-clicking 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.
• Enhancements to the Create Topics action - This action has been restructured using a multi-agent architecture and now leverages the new invoke_ai_action() function. These improvements ensure better adherence to system instructions and more consistent execution.
• Enhancements to the Expand Draft action - The functionality of this action has been upgraded to include the features previously offered by Add Structured Content, making the latter redundant and subsequently removed.
• No-Change Label on AI Responses - A label has been added on AI responses to inform users when the AI does not propose any changes.
• Preview Changes Feature - Users can now preview changes to documents that the AI wants to update, ensuring accuracy and control over AI-proposed modifications. This feature applies to AI actions like 'Split Topic' and 'Create Topics'.
• New functions:
  • invoke_ai_action() - Invoke an action by passing an action ID and content to process.
  • retrieve_all_ai_actions() - Get IDs and descriptions for each available AI action.
  • validate_document_content() - Validate a specified document's content and report error messages in JSON format.
• You can now define actions that are hidden in the interface and intended only for use by other actions using the new "invoke_ai_action()" function. These actions must have their IDs prefixed with "agent.hidden.action".
• Function calls displayed in the AI Positron Assistant side-view now include the values of their parameters.
• The dialog displaying function call details has been improved with a clearer presentation, making it easier to inspect and understand the calls.
• Export/Import chat - Chats can now be exported to JSON files and imported back when needed. This feature is particularly useful for developers of custom Positron actions, as it simplifies debugging issues encountered during user interactions.
• Enable AI Positron Assistant - A new setting in the AI Positron Preferences page allows disabling the add-on on a per-project basis.
• gpt-4o-2024-11-20 is now the default model for the OpenAI Connector. This model is more cost-effective than our previous default and supports four times more maximum output tokens while maintaining very similar performance.

Release Notes 4.0.1

• Various security fixes.
• Create Topics AI action has been enhanced to deliver improved results for generating DITA XML topics.
• Fixed an issue where the AI was unable to compute the URL of related topics when expanding drafts.
• Preview support fixes when using Oxygen with the Tridion CMS and processing elements containing varref attributes.
• Resolved an issue where the get_content_for_document_url function did not return an error message as expected when encountering invalid input or processing issues.

Release Notes 4.0.0

• Security Enhancements - Various security enhancements were implemented. Information regarding favorite prompts, chat history, or AI XPath functions are stored encrypted. The Retrieval-Augmented Generation (RAG) preferences page has some new security-related options to choose whether or not to enable reading and writing content in the project.
• Intuitive Identification of XML Code in Markdown - If the AI returns a response with Markdown content that contains XML code (for example, from a chat session where you give the AI a task such as converting a list into a table), the AI might start with some 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.
• Markdown Syntax Highlight in Chat Response Area - When using the add-on in Oxygen 27 or newer, the chat response area can have either Markdown or XML syntax highlight depending on the response content.
• Open Links from Chat Response Area - URL links present in the chat response area can be opened by pressing Ctrl/Command and then mouse clicking on the link.
• AI Positron Fix with RAG - The AI Positron Fix action now uses Retrieval-Augmented Generation to get more context from the current document.
• Oxygen Feedback based Retrieval Augmentation - If the Oxygen Feedback product is used to provide search for a web site generated from the DITA XML project, the Feedback search system can be used to retrieve related content instead of the current indexed DITA XML project. In the Feedback administrator Installation page the embed HTML information contains an unique token which can be copied and pasted in the AI Positron Retrieval-Augmented Generation (RAG) preferences page in the WebHelp Feedback token field.
• Document type context in chat - If there is content selected in the main editor area when a chat is initiated, the selection is passed to the AI along with the document type as context for the conversation.
• Split Large DITA Topics - When working with DITA XML documents, the new Split Topic AI action (located in the Intelligent Agents category) can be used to split 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.
• Expand DITA Topic Draft - The new Expand Draft AI action (located in the Intelligent Agents category) enhances a draft of a DITA XML topic by refining the content, adding markup that is consistent with similar topics, and generating documentation based on the referenced images using Vision support. The AI looks for similar content in topics gathered from the related links or through the Retrieval-Augmented Generation (RAG) process that looks in both the current project and WebHelp output with the Oxygen Feedback component deployed for search functionality. This action is available for DITA XML documents.
• Create DITA Topics - The new Create Topics AI action (located in the Intelligent Agents category) generates DITA XML topics based upon 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 looks for similar content in topics gathered from the related links or through the Retrieval-Augmented Generation (RAG) process that looks in both the current project and WebHelp output (with the Oxygen Feedback component deployed for search functionality). This action is available for DITA XML documents.
• Reuse Component - Added in the 'Reuse' category a new 'Component' action which asks the AI to identify the closest existing reusable component which matches the current selected paragraph.
• Reuse Product Names - Added in the 'Reuse' category a new 'Product Names' action which finds product names in the selected content and replaces them with key references.
• Suggest Refactoring for Selected Code - The new Suggest Refactoring AI action (located in the Development category) can be used to generate 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.
• New functions:
  • add_to_toc - Modifies a the DITA map and adds a topic reference to it at a certain relative location.
  • find_similar_reusable_content - Retrieves a list of reusable DITA XML components which match keywords provided by the AI.
  • get_content_for_document_url - Retrieves the content of a certain document.
  • get_corresponding_dita_keyrefs - Finds DITA key references that correspond to product names in the context DITA map.
  • get_current_editor_file_location - Retrieves the location (absolute path/URL) of the current file that is open in the editor.
  • get_related_content_from_webhelp - Returns content from the associated Oxygen Feedback WebHelp system for which a token has been configured in the Retrieval-Augmented Generation (RAG) preferences page.
  • get_topic_context_in_toc - Returns from the DITA map opened in the DITA Maps Manager view the hierarchical structure path which references the selected topic.
  • resolve_dita_key_or_content_reference - Resolves a DITA XML key reference, a content key reference, or a content reference to the target text.
  • save_document - Saves the document at a specified URL path and writes content to it.
• New custom action types:
  • prompt-user - Prompt the user for extra details and then perform the action.
  • replace-selection-based-on-image-analysis - Use details obtained from the referenced DITA XML images to perform the action prompt.
• Current Element Highlighted When Applying an AI Action in Text Mode - When utilizing AI actions while you are editing in Text mode, it is now easier to identify the element that is affected by an AI action. This is especially beneficial when there is no specific selection in the editor. The current element, which serves as the context for applying the action, is now highlighted for improved visibility and ease of identification.

Release Notes 3.0.0

• Actions using Retrieval-Augmented Generation (RAG) - For Oxygen version 26.1 (latest build) and newer, certain actions that generate content, such as New DITA Topic or Add Structured Content, now use information from the project opened in the Project view to enrich the AI context and receive more meaningful and project-targeted responses. The new Retrieval-Augmented Generation (RAG) preferences page allows changing various settings related to RAG.
• Chat using RAG - RAG is also enabled for chat sessions in Oxygen version 26.1 (latest build) and newer.
• Generate Documentation Draft using RAG - When the use-related-content-from-project="true" attribute is set on the <draft-summary> element, RAG is enabled for the Generate Documentation Draft action.
• Function Calls - Both built-in and user-defined actions can refer in their definition to existing functions that are to be called by the AI engine when giving a response. This gives actions more context information and allows for more tailored and accurate answers to be constructed.
• AI Positron Assistant Widget - For documents opened in the Author visual editor, you can click the AI Positron Assistant widget located in the top-right corner of the editing area or use the configurable "Ctrl+Alt+Enter" (Windows/Linux) or "Ctrl+Enter" (Mac) shortcut to access useful AI actions.
• Rewrite content - Added a new action that opens a floating input box at 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). This action is available in the AI Positron Assistant Widget or by using the configurable "Ctrl+Alt+R" (Windows/Linux) / "Cmd+Alt+R" (Mac) shortcut.
• Select AI Model - A drop-down was added to the AI Positron Assistant side view in order to quickly select the default AI model to use for chat and actions.
• Content Generation > Add Structured Content - A new action is available that can be used to replace the current selection with new structured content that is generated based upon similar content from the current project (if available).
• Content Generation > New DITA Topic - For Oxygen version 26.1 (latest build) and newer, the New DITA Topic action now uses related information from the current project when constructing the content and structure of the new topic.
• Rewrite > Improve Structure - A new action is available that can be used to improve the selected DITA XML content by adding additional structure or inline elements.
• Review > Proofread - A new action is available that can be used to add comments in content that has logical consistency problems, grammar or spelling mistakes, or is hard to read and comprehend.
• Review > Resolve Comments - A new action is available that changes the selected content based on suggestions found within comments and then removes the comments.
• Regenerate Response - After you receive a response from the AI, you have the possibility to ask it to generate another one. You can also decide which AI model to be used when generating the new response.
• Default model - For the OpenAI connector, GPT-4o, the most intelligent model from OpenAI, is now the default model in the AI Positron Assistant.
• GPT-4o mini - For the OpenAI connector, the most affordable intelligent model from OpenAI is now available in the AI Positron Assistant.
• Preview Response for Text Mode - When using AI actions while working with your documents in the Text mode, you now have the ability to preview the AI response before inserting the changes in the document.
• For the OpenAI connector, each answer from the AI presented in the chat panel now specifies the model that has been used for generating it.
• The actions related to an AI-generated message in the chat panel (Insert, Replace, Preview, etc.) are now buttons with icons instead of links.

Release Notes 2.1.0

• The new Generate Image Alternate Text action allows generating an alternate text for a DITA XML image that is selected in the main editing area in the Author visual editing mode.
• If you start a conversation with the AI and there is selection in the current editor area, that selection is passed as a context to the chat engine.
• The add-on contributes three new XML refactoring actions in the Oxygen XML Refactoring dialog box, in the new AI category:
  • Generate alternate text for images in DITA XML topics
  • Generate missing short descriptions in DITA XML topics
  • Shorten existing short descriptions in DITA XML topics
• For the OpenAI connector, gpt-4o, the latest model from OpenAI, has been added to the list of supported models.
• The MS Azure connector now supports authentication using Microsoft Entra ID, enhancing security and flexibility.
• When selecting an AI assistant response in the chat view, you now have contextual actions available to insert the selection into the document or preview the insertion.

Release Notes 2.0.0

• Added support to connect to the Anthropic Claude AI engine.
• Added support in the MS Azure OpenAI connector to configure separate Vision Endpoint, Deployment and API Key settings used for analyzing messages which contain images.
• A new action called "Generate Documentation Draft" is available, and it can be used to draft a DITA topic based on a configuration file that fine tunes the generation process.
• A new action called "Update content based on images" is available, and it can be used to update the content of a DITA XML topic based on the images that it refers.
• Images, XML files, and text files can be attached to messages in the Chat panel.
• Useful AI actions (Correct Grammar, Improve Readability, Use Active Voice) are now available as quick assist fixes in the editor by clicking the bulb located on the navigation vertical stripe.
• 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.
• You can now specify in the "Oxygen AI Positron Assistant Enterprise" preferences page which actions to exclude from being presented in the available actions list.
• For the OpenAI connector, the gpt-4-turbo-preview model has been replaced with the recently released gpt-4-turbo.

Release Notes 1.2.0

• Oxygen XML Enterprise edition license now includes access to Oxygen AI Positron Assistant Enterprise at no extra cost.

Release Notes 1.1.1

• Fixed an issue where the connection to MS Azure OpenAI failed when the configured endpoint URL address included a path.

Release Notes 1.1.0

• The new Oxygen AI Positron Assistant Enterprise addon enables direct access to your own OpenAI account or AI service hosted on Microsoft Azure. This can be configured in the "Preferences->Oxygen AI Positron Assistant / AI Service Configuration" page. A special license key is required for this feature.
• The AI Positron Assistant Enterprise side view supports content generation and refinement of the AI response. This includes:
  • 'Content Generation' for creating new DITA XML topics, continuing writing, generating short descriptions, index terms, and following instructions.
  • 'Rewrite' actions for grammar correction, readability improvement, content conversion to active voice, itemization, and joining items.
  • 'Overview' actions for answering and generating questions, summarizing content, and improving readability.
  • 'Translation' actions support English, German, French, and Japanese languages, with an option to provide a target language.
  • 'Marketing' features for creating release notes, marketing posts, improving SEO, and rewriting content using the Pain-Agitate-Solution and Features-Advantages-Benefits frameworks.
• The AI Positron Refactoring action is available for refactoring multiple files simultaneously using AI.
• The 'Validation Quick Fixes' feature allows the use of the AI Positron Fix action to rectify validation issues.
• Custom actions and prompts can be created in the AI Positron Assistant by recording changes.
• Two XPath extension functions are available in the content completion proposals for Schematron, XSLT, XQuery, and XPath:
  • 'ai:transform-content(instruction, content)' for automatic content transformation using AI.
  • 'ai:verify-content(instruction, content)' for automatic content validation using AI.

This addon uses an external AI service (like OpenAI or MS Azure OpenAI) to help technical documentation writers generate content.

Release Notes 4.0.1

• Various security fixes.
• Create Topics AI action has been enhanced to deliver improved results for generating DITA XML topics.
• Fixed an issue where the AI was unable to compute the URL of related topics when expanding drafts.
• Preview support fixes when using Oxygen with the Tridion CMS and processing elements containing varref attributes.
• Resolved an issue where the get_content_for_document_url function did not return an error message as expected when encountering invalid input or processing issues.

Release Notes 4.0.0

• Security Enhancements - Various security enhancements were implemented. Information regarding favorite prompts, chat history, or AI XPath functions are stored encrypted. The Retrieval-Augmented Generation (RAG) preferences page has some new security-related options to choose whether or not to enable reading and writing content in the project.
• Intuitive Identification of XML Code in Markdown - If the AI returns a response with Markdown content that contains XML code (for example, from a chat session where you give the AI a task such as converting a list into a table), the AI might start with some 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.
• AI Positron Fix with RAG - The AI Positron Fix action now uses Retrieval-Augmented Generation to get more context from the current document.
• Oxygen Feedback based Retrieval Augmentation - If the Oxygen Feedback product is used to provide search for a web site generated from the DITA XML project, the Feedback search system can be used to retrieve related content instead of the current indexed DITA XML project. In the Feedback administrator Installation page the embed HTML information contains an unique token which can be copied and pasted in the AI Positron Retrieval-Augmented Generation (RAG) preferences page in the WebHelp Feedback token field.
• Document type context in chat - If there is content selected in the main editor area when a chat is initiated, the selection is passed to the AI along with the document type as context for the conversation.
• Split Large DITA Topics - When working with DITA XML documents, the new Split Topic AI action (located in the Intelligent Agents category) can be used to split 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.
• Expand DITA Topic Draft - The new Expand Draft AI action (located in the Intelligent Agents category) enhances a draft of a DITA XML topic by refining the content, adding markup that is consistent with similar topics, and generating documentation based on the referenced images using Vision support. The AI looks for similar content in topics gathered from the related links or through the Retrieval-Augmented Generation (RAG) process that looks in both the current project and WebHelp output with the Oxygen Feedback component deployed for search functionality. This action is available for DITA XML documents.
• Create DITA Topics - The new Create Topics AI action (located in the Intelligent Agents category) generates DITA XML topics based upon 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 looks for similar content in topics gathered from the related links or through the Retrieval-Augmented Generation (RAG) process that looks in both the current project and WebHelp output (with the Oxygen Feedback component deployed for search functionality). This action is available for DITA XML documents.
• Reuse Component - Added in the 'Reuse' category a new 'Component' action which asks the AI to identify the closest existing reusable component which matches the current selected paragraph.
• Reuse Product Names - Added in the 'Reuse' category a new 'Product Names' action which finds product names in the selected content and replaces them with key references.
• Suggest Refactoring for Selected Code - The new Suggest Refactoring AI action (located in the Development category) can be used to generate 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.
• New functions:
  • add_to_toc - Modifies a the DITA map and adds a topic reference to it at a certain relative location.
  • find_similar_reusable_content - Retrieves a list of reusable DITA XML components which match keywords provided by the AI.
  • get_content_for_document_url - Retrieves the content of a certain document.
  • get_corresponding_dita_keyrefs - Finds DITA key references that correspond to product names in the context DITA map.
  • get_current_editor_file_location - Retrieves the location (absolute path/URL) of the current file that is open in the editor.
  • get_related_content_from_webhelp - Returns content from the associated Oxygen Feedback WebHelp system for which a token has been configured in the Retrieval-Augmented Generation (RAG) preferences page.
  • get_topic_context_in_toc - Returns from the DITA map opened in the DITA Maps Manager view the hierarchical structure path which references the selected topic.
  • resolve_dita_key_or_content_reference - Resolves a DITA XML key reference, a content key reference, or a content reference to the target text.
  • save_document - Saves the document at a specified URL path and writes content to it.
• New custom action types:
  • prompt-user - Prompt the user for extra details and then perform the action.
  • replace-selection-based-on-image-analysis - Use details obtained from the referenced DITA XML images to perform the action prompt.
• Current Element Highlighted When Applying an AI Action in Text Mode - When utilizing AI actions while you are editing in Text mode, it is now easier to identify the element that is affected by an AI action. This is especially beneficial when there is no specific selection in the editor. The current element, which serves as the context for applying the action, is now highlighted for improved visibility and ease of identification.

Release Notes 3.0.0

• Actions using Retrieval-Augmented Generation (RAG) - For Oxygen version 26.1 (latest build) and newer, certain actions that generate content, such as New DITA Topic or Add Structured Content, now use information from the project opened in the Project view to enrich the AI context and receive more meaningful and project-targeted responses. The new Retrieval-Augmented Generation (RAG) preferences page allows changing various settings related to RAG.
• Chat using RAG - RAG is also enabled for chat sessions in Oxygen version 26.1 (latest build) and newer.
• Generate Documentation Draft using RAG - When the use-related-content-from-project="true" attribute is set on the <draft-summary> element, RAG is enabled for the Generate Documentation Draft action.
• Function Calls - Both built-in and user-defined actions can refer in their definition to existing functions that are to be called by the AI engine when giving a response. This gives actions more context information and allows for more tailored and accurate answers to be constructed.
• AI Positron Assistant Widget - For documents opened in the Author visual editor, you can click the AI Positron Assistant widget located in the top-right corner of the editing area or use the configurable "Ctrl+Alt+Enter" (Windows/Linux) or "Ctrl+Enter" (Mac) shortcut to access useful AI actions.
• Rewrite content - Added a new action that opens a floating input box at 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). This action is available in the AI Positron Assistant Widget or by using the configurable "Ctrl+Alt+R" (Windows/Linux) / "Cmd+Alt+R" (Mac) shortcut.
• Select AI Model - A drop-down was added to the AI Positron Assistant side view in order to quickly select the default AI model to use for chat and actions.
• Content Generation > Add Structured Content - A new action is available that can be used to replace the current selection with new structured content that is generated based upon similar content from the current project (if available).
• Content Generation > New DITA Topic - For Oxygen version 26.1 (latest build) and newer, the New DITA Topic action now uses related information from the current project when constructing the content and structure of the new topic.
• Rewrite > Improve Structure - A new action is available that can be used to improve the selected DITA XML content by adding additional structure or inline elements.
• Review > Proofread - A new action is available that can be used to add comments in content that has logical consistency problems, grammar or spelling mistakes, or is hard to read and comprehend.
• Review > Resolve Comments - A new action is available that changes the selected content based on suggestions found within comments and then removes the comments.
• Regenerate Response - After you receive a response from the AI, you have the possibility to ask it to generate another one. You can also decide which AI model to be used when generating the new response.
• Default model - For the OpenAI connector, GPT-4o, the most intelligent model from OpenAI, is now the default model in the AI Positron Assistant.
• GPT-4o mini - For the OpenAI connector, the most affordable intelligent model from OpenAI is now available in the AI Positron Assistant.
• Preview Response for Text Mode - When using AI actions while working with your documents in the Text mode, you now have the ability to preview the AI response before inserting the changes in the document.
• For the OpenAI connector, each answer from the AI presented in the chat panel now specifies the model that has been used for generating it.
• The actions related to an AI-generated message in the chat panel (Insert, Replace, Preview, etc.) are now buttons with icons instead of links.

Release Notes 2.1.0

• The new Generate Image Alternate Text action allows generating an alternate text for a DITA XML image that is selected in the main editing area in the Author visual editing mode.
• If you start a conversation with the AI and there is selection in the current editor area, that selection is passed as a context to the chat engine.
• The add-on contributes three new XML refactoring actions in the Oxygen XML Refactoring dialog box, in the new AI category:
  • Generate alternate text for images in DITA XML topics
  • Generate missing short descriptions in DITA XML topics
  • Shorten existing short descriptions in DITA XML topics
• For the OpenAI connector, gpt-4o, the latest model from OpenAI, has been added to the list of supported models.
• The MS Azure connector now supports authentication using Microsoft Entra ID, enhancing security and flexibility.
• When selecting an AI assistant response in the chat view, you now have contextual actions available to insert the selection into the document or preview the insertion.

Release Notes 2.0.0

• Added support to connect to the Anthropic Claude AI engine.
• Added support in the MS Azure OpenAI connector to configure separate Vision Endpoint, Deployment and API Key settings used for analyzing messages which contain images.
• A new action called "Generate Documentation Draft" is available, and it can be used to draft a DITA topic based on a configuration file that fine tunes the generation process.
• A new action called "Update content based on images" is available, and it can be used to update the content of a DITA XML topic based on the images that it refers.
• Images, XML files, and text files can be attached to messages in the Chat panel.
• Useful AI actions (Correct Grammar, Improve Readability, Use Active Voice) are now available as quick assist fixes in the editor by clicking the bulb located on the navigation vertical stripe.
• 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.
• You can now specify in the "Oxygen AI Positron Assistant Enterprise" preferences page which actions to exclude from being presented in the available actions list.
• For the OpenAI connector, the gpt-4-turbo-preview model has been replaced with the recently released gpt-4-turbo.

Release Notes 1.2.0

• Oxygen XML Enterprise edition license now includes access to Oxygen AI Positron Assistant Enterprise at no extra cost.

Release Notes 1.1.1

• Fixed an issue where the connection to MS Azure OpenAI failed when the configured endpoint URL address included a path.

Release Notes 1.1.0

• The new Oxygen AI Positron Assistant Enterprise addon enables direct access to your own OpenAI account or AI service hosted on Microsoft Azure. This can be configured in the "Preferences->Oxygen AI Positron Assistant / AI Service Configuration" page. A special license key is required for this feature.
• The AI Positron Assistant Enterprise side view supports content generation and refinement of the AI response. This includes:
  • 'Content Generation' for creating new DITA XML topics, continuing writing, generating short descriptions, index terms, and following instructions.
  • 'Rewrite' actions for grammar correction, readability improvement, content conversion to active voice, itemization, and joining items.
  • 'Overview' actions for answering and generating questions, summarizing content, and improving readability.
  • 'Translation' actions support English, German, French, and Japanese languages, with an option to provide a target language.
  • 'Marketing' features for creating release notes, marketing posts, improving SEO, and rewriting content using the Pain-Agitate-Solution and Features-Advantages-Benefits frameworks.
• The AI Positron Refactoring action is available for refactoring multiple files simultaneously using AI.
• The 'Validation Quick Fixes' feature allows the use of the AI Positron Fix action to rectify validation issues.
• Custom actions and prompts can be created in the AI Positron Assistant by recording changes.
• Two XPath extension functions are available in the content completion proposals for Schematron, XSLT, XQuery, and XPath:
  • 'ai:transform-content(instruction, content)' for automatic content transformation using AI.
  • 'ai:verify-content(instruction, content)' for automatic content validation using AI.

This addon uses an external AI service (like OpenAI or MS Azure OpenAI) to help technical documentation writers generate content.

Release Notes 4.0.0

• Security Enhancements - Various security enhancements were implemented. Information regarding favorite prompts, chat history, or AI XPath functions are stored encrypted. The Retrieval-Augmented Generation (RAG) preferences page has some new security-related options to choose whether or not to enable reading and writing content in the project.
• Intuitive Identification of XML Code in Markdown - If the AI returns a response with Markdown content that contains XML code (for example, from a chat session where you give the AI a task such as converting a list into a table), the AI might start with some 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.
• AI Positron Fix with RAG - The AI Positron Fix action now uses Retrieval-Augmented Generation to get more context from the current document.
• Oxygen Feedback based Retrieval Augmentation - If the Oxygen Feedback product is used to provide search for a web site generated from the DITA XML project, the Feedback search system can be used to retrieve related content instead of the current indexed DITA XML project. In the Feedback administrator Installation page the embed HTML information contains an unique token which can be copied and pasted in the AI Positron Retrieval-Augmented Generation (RAG) preferences page in the WebHelp Feedback token field.
• Document type context in chat - If there is content selected in the main editor area when a chat is initiated, the selection is passed to the AI along with the document type as context for the conversation.
• Split Large DITA Topics - When working with DITA XML documents, the new Split Topic AI action (located in the Intelligent Agents category) can be used to split 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.
• Expand DITA Topic Draft - The new Expand Draft AI action (located in the Intelligent Agents category) enhances a draft of a DITA XML topic by refining the content, adding markup that is consistent with similar topics, and generating documentation based on the referenced images using Vision support. The AI looks for similar content in topics gathered from the related links or through the Retrieval-Augmented Generation (RAG) process that looks in both the current project and WebHelp output with the Oxygen Feedback component deployed for search functionality. This action is available for DITA XML documents.
• Create DITA Topics - The new Create Topics AI action (located in the Intelligent Agents category) generates DITA XML topics based upon 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 looks for similar content in topics gathered from the related links or through the Retrieval-Augmented Generation (RAG) process that looks in both the current project and WebHelp output (with the Oxygen Feedback component deployed for search functionality). This action is available for DITA XML documents.
• Reuse Component - Added in the 'Reuse' category a new 'Component' action which asks the AI to identify the closest existing reusable component which matches the current selected paragraph.
• Reuse Product Names - Added in the 'Reuse' category a new 'Product Names' action which finds product names in the selected content and replaces them with key references.
• Suggest Refactoring for Selected Code - The new Suggest Refactoring AI action (located in the Development category) can be used to generate 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.
• New functions:
  • add_to_toc - Modifies a the DITA map and adds a topic reference to it at a certain relative location.
  • find_similar_reusable_content - Retrieves a list of reusable DITA XML components which match keywords provided by the AI.
  • get_content_for_document_url - Retrieves the content of a certain document.
  • get_corresponding_dita_keyrefs - Finds DITA key references that correspond to product names in the context DITA map.
  • get_current_editor_file_location - Retrieves the location (absolute path/URL) of the current file that is open in the editor.
  • get_related_content_from_webhelp - Returns content from the associated Oxygen Feedback WebHelp system for which a token has been configured in the Retrieval-Augmented Generation (RAG) preferences page.
  • get_topic_context_in_toc - Returns from the DITA map opened in the DITA Maps Manager view the hierarchical structure path which references the selected topic.
  • resolve_dita_key_or_content_reference - Resolves a DITA XML key reference, a content key reference, or a content reference to the target text.
  • save_document - Saves the document at a specified URL path and writes content to it.
• New custom action types:
  • prompt-user - Prompt the user for extra details and then perform the action.
  • replace-selection-based-on-image-analysis - Use details obtained from the referenced DITA XML images to perform the action prompt.
• Current Element Highlighted When Applying an AI Action in Text Mode - When utilizing AI actions while you are editing in Text mode, it is now easier to identify the element that is affected by an AI action. This is especially beneficial when there is no specific selection in the editor. The current element, which serves as the context for applying the action, is now highlighted for improved visibility and ease of identification.

Release Notes 3.0.0

• Actions using Retrieval-Augmented Generation (RAG) - For Oxygen version 26.1 (latest build) and newer, certain actions that generate content, such as New DITA Topic or Add Structured Content, now use information from the project opened in the Project view to enrich the AI context and receive more meaningful and project-targeted responses. The new Retrieval-Augmented Generation (RAG) preferences page allows changing various settings related to RAG.
• Chat using RAG - RAG is also enabled for chat sessions in Oxygen version 26.1 (latest build) and newer.
• Generate Documentation Draft using RAG - When the use-related-content-from-project="true" attribute is set on the <draft-summary> element, RAG is enabled for the Generate Documentation Draft action.
• Function Calls - Both built-in and user-defined actions can refer in their definition to existing functions that are to be called by the AI engine when giving a response. This gives actions more context information and allows for more tailored and accurate answers to be constructed.
• AI Positron Assistant Widget - For documents opened in the Author visual editor, you can click the AI Positron Assistant widget located in the top-right corner of the editing area or use the configurable "Ctrl+Alt+Enter" (Windows/Linux) or "Ctrl+Enter" (Mac) shortcut to access useful AI actions.
• Rewrite content - Added a new action that opens a floating input box at 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). This action is available in the AI Positron Assistant Widget or by using the configurable "Ctrl+Alt+R" (Windows/Linux) / "Cmd+Alt+R" (Mac) shortcut.
• Select AI Model - A drop-down was added to the AI Positron Assistant side view in order to quickly select the default AI model to use for chat and actions.
• Content Generation > Add Structured Content - A new action is available that can be used to replace the current selection with new structured content that is generated based upon similar content from the current project (if available).
• Content Generation > New DITA Topic - For Oxygen version 26.1 (latest build) and newer, the New DITA Topic action now uses related information from the current project when constructing the content and structure of the new topic.
• Rewrite > Improve Structure - A new action is available that can be used to improve the selected DITA XML content by adding additional structure or inline elements.
• Review > Proofread - A new action is available that can be used to add comments in content that has logical consistency problems, grammar or spelling mistakes, or is hard to read and comprehend.
• Review > Resolve Comments - A new action is available that changes the selected content based on suggestions found within comments and then removes the comments.
• Regenerate Response - After you receive a response from the AI, you have the possibility to ask it to generate another one. You can also decide which AI model to be used when generating the new response.
• Default model - For the OpenAI connector, GPT-4o, the most intelligent model from OpenAI, is now the default model in the AI Positron Assistant.
• GPT-4o mini - For the OpenAI connector, the most affordable intelligent model from OpenAI is now available in the AI Positron Assistant.
• Preview Response for Text Mode - When using AI actions while working with your documents in the Text mode, you now have the ability to preview the AI response before inserting the changes in the document.
• For the OpenAI connector, each answer from the AI presented in the chat panel now specifies the model that has been used for generating it.
• The actions related to an AI-generated message in the chat panel (Insert, Replace, Preview, etc.) are now buttons with icons instead of links.

Release Notes 2.1.0

• The new Generate Image Alternate Text action allows generating an alternate text for a DITA XML image that is selected in the main editing area in the Author visual editing mode.
• If you start a conversation with the AI and there is selection in the current editor area, that selection is passed as a context to the chat engine.
• The add-on contributes three new XML refactoring actions in the Oxygen XML Refactoring dialog box, in the new AI category:
  • Generate alternate text for images in DITA XML topics
  • Generate missing short descriptions in DITA XML topics
  • Shorten existing short descriptions in DITA XML topics
• For the OpenAI connector, gpt-4o, the latest model from OpenAI, has been added to the list of supported models.
• The MS Azure connector now supports authentication using Microsoft Entra ID, enhancing security and flexibility.
• When selecting an AI assistant response in the chat view, you now have contextual actions available to insert the selection into the document or preview the insertion.

Release Notes 2.0.0

• Added support to connect to the Anthropic Claude AI engine.
• Added support in the MS Azure OpenAI connector to configure separate Vision Endpoint, Deployment and API Key settings used for analyzing messages which contain images.
• A new action called "Generate Documentation Draft" is available, and it can be used to draft a DITA topic based on a configuration file that fine tunes the generation process.
• A new action called "Update content based on images" is available, and it can be used to update the content of a DITA XML topic based on the images that it refers.
• Images, XML files, and text files can be attached to messages in the Chat panel.
• Useful AI actions (Correct Grammar, Improve Readability, Use Active Voice) are now available as quick assist fixes in the editor by clicking the bulb located on the navigation vertical stripe.
• 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.
• You can now specify in the "Oxygen AI Positron Assistant Enterprise" preferences page which actions to exclude from being presented in the available actions list.
• For the OpenAI connector, the gpt-4-turbo-preview model has been replaced with the recently released gpt-4-turbo.

Release Notes 1.2.0

• Oxygen XML Enterprise edition license now includes access to Oxygen AI Positron Assistant Enterprise at no extra cost.

Release Notes 1.1.1

• Fixed an issue where the connection to MS Azure OpenAI failed when the configured endpoint URL address included a path.

Release Notes 1.1.0

• The new Oxygen AI Positron Assistant Enterprise addon enables direct access to your own OpenAI account or AI service hosted on Microsoft Azure. This can be configured in the "Preferences->Oxygen AI Positron Assistant / AI Service Configuration" page. A special license key is required for this feature.
• The AI Positron Assistant Enterprise side view supports content generation and refinement of the AI response. This includes:
  • 'Content Generation' for creating new DITA XML topics, continuing writing, generating short descriptions, index terms, and following instructions.
  • 'Rewrite' actions for grammar correction, readability improvement, content conversion to active voice, itemization, and joining items.
  • 'Overview' actions for answering and generating questions, summarizing content, and improving readability.
  • 'Translation' actions support English, German, French, and Japanese languages, with an option to provide a target language.
  • 'Marketing' features for creating release notes, marketing posts, improving SEO, and rewriting content using the Pain-Agitate-Solution and Features-Advantages-Benefits frameworks.
• The AI Positron Refactoring action is available for refactoring multiple files simultaneously using AI.
• The 'Validation Quick Fixes' feature allows the use of the AI Positron Fix action to rectify validation issues.
• Custom actions and prompts can be created in the AI Positron Assistant by recording changes.
• Two XPath extension functions are available in the content completion proposals for Schematron, XSLT, XQuery, and XPath:
  • 'ai:transform-content(instruction, content)' for automatic content transformation using AI.
  • 'ai:verify-content(instruction, content)' for automatic content validation using AI.

This addon uses an external AI service (like OpenAI or MS Azure OpenAI) to help technical documentation writers generate content.

Release Notes 3.0.0

• Actions using Retrieval-Augmented Generation (RAG) - For Oxygen version 26.1 (latest build) and newer, certain actions that generate content, such as New DITA Topic or Add Structured Content, now use information from the project opened in the Project view to enrich the AI context and receive more meaningful and project-targeted responses. The new Retrieval-Augmented Generation (RAG) preferences page allows changing various settings related to RAG.
• Chat using RAG - RAG is also enabled for chat sessions in Oxygen version 26.1 (latest build) and newer.
• Generate Documentation Draft using RAG - When the use-related-content-from-project="true" attribute is set on the <draft-summary> element, RAG is enabled for the Generate Documentation Draft action.
• Function Calls - Both built-in and user-defined actions can refer in their definition to existing functions that are to be called by the AI engine when giving a response. This gives actions more context information and allows for more tailored and accurate answers to be constructed.
• AI Positron Assistant Widget - For documents opened in the Author visual editor, you can click the AI Positron Assistant widget located in the top-right corner of the editing area or use the configurable "Ctrl+Alt+Enter" (Windows/Linux) or "Ctrl+Enter" (Mac) shortcut to access useful AI actions.
• Rewrite content - Added a new action that opens a floating input box at 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). This action is available in the AI Positron Assistant Widget or by using the configurable "Ctrl+Alt+R" (Windows/Linux) / "Cmd+Alt+R" (Mac) shortcut.
• Select AI Model - A drop-down was added to the AI Positron Assistant side view in order to quickly select the default AI model to use for chat and actions.
• Content Generation > Add Structured Content - A new action is available that can be used to replace the current selection with new structured content that is generated based upon similar content from the current project (if available).
• Content Generation > New DITA Topic - For Oxygen version 26.1 (latest build) and newer, the New DITA Topic action now uses related information from the current project when constructing the content and structure of the new topic.
• Rewrite > Improve Structure - A new action is available that can be used to improve the selected DITA XML content by adding additional structure or inline elements.
• Review > Proofread - A new action is available that can be used to add comments in content that has logical consistency problems, grammar or spelling mistakes, or is hard to read and comprehend.
• Review > Resolve Comments - A new action is available that changes the selected content based on suggestions found within comments and then removes the comments.
• Regenerate Response - After you receive a response from the AI, you have the possibility to ask it to generate another one. You can also decide which AI model to be used when generating the new response.
• Default model - For the OpenAI connector, GPT-4o, the most intelligent model from OpenAI, is now the default model in the AI Positron Assistant.
• GPT-4o mini - For the OpenAI connector, the most affordable intelligent model from OpenAI is now available in the AI Positron Assistant.
• Preview Response for Text Mode - When using AI actions while working with your documents in the Text mode, you now have the ability to preview the AI response before inserting the changes in the document.
• For the OpenAI connector, each answer from the AI presented in the chat panel now specifies the model that has been used for generating it.
• The actions related to an AI-generated message in the chat panel (Insert, Replace, Preview, etc.) are now buttons with icons instead of links.

Release Notes 2.1.0

• The new Generate Image Alternate Text action allows generating an alternate text for a DITA XML image that is selected in the main editing area in the Author visual editing mode.
• If you start a conversation with the AI and there is selection in the current editor area, that selection is passed as a context to the chat engine.
• The add-on contributes three new XML refactoring actions in the Oxygen XML Refactoring dialog box, in the new AI category:
  • Generate alternate text for images in DITA XML topics
  • Generate missing short descriptions in DITA XML topics
  • Shorten existing short descriptions in DITA XML topics
• For the OpenAI connector, gpt-4o, the latest model from OpenAI, has been added to the list of supported models.
• The MS Azure connector now supports authentication using Microsoft Entra ID, enhancing security and flexibility.
• When selecting an AI assistant response in the chat view, you now have contextual actions available to insert the selection into the document or preview the insertion.

Release Notes 2.0.0

• Added support to connect to the Anthropic Claude AI engine.
• Added support in the MS Azure OpenAI connector to configure separate Vision Endpoint, Deployment and API Key settings used for analyzing messages which contain images.
• A new action called "Generate Documentation Draft" is available, and it can be used to draft a DITA topic based on a configuration file that fine tunes the generation process.
• A new action called "Update content based on images" is available, and it can be used to update the content of a DITA XML topic based on the images that it refers.
• Images, XML files, and text files can be attached to messages in the Chat panel.
• Useful AI actions (Correct Grammar, Improve Readability, Use Active Voice) are now available as quick assist fixes in the editor by clicking the bulb located on the navigation vertical stripe.
• 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.
• You can now specify in the "Oxygen AI Positron Assistant Enterprise" preferences page which actions to exclude from being presented in the available actions list.
• For the OpenAI connector, the gpt-4-turbo-preview model has been replaced with the recently released gpt-4-turbo.

Release Notes 1.2.0

• Oxygen XML Enterprise edition license now includes access to Oxygen AI Positron Assistant Enterprise at no extra cost.

Release Notes 1.1.1

• Fixed an issue where the connection to MS Azure OpenAI failed when the configured endpoint URL address included a path.

Release Notes 1.1.0

• The new Oxygen AI Positron Assistant Enterprise addon enables direct access to your own OpenAI account or AI service hosted on Microsoft Azure. This can be configured in the "Preferences->Oxygen AI Positron Assistant / AI Service Configuration" page. A special license key is required for this feature.
• The AI Positron Assistant Enterprise side view supports content generation and refinement of the AI response. This includes:
  • 'Content Generation' for creating new DITA XML topics, continuing writing, generating short descriptions, index terms, and following instructions.
  • 'Rewrite' actions for grammar correction, readability improvement, content conversion to active voice, itemization, and joining items.
  • 'Overview' actions for answering and generating questions, summarizing content, and improving readability.
  • 'Translation' actions support English, German, French, and Japanese languages, with an option to provide a target language.
  • 'Marketing' features for creating release notes, marketing posts, improving SEO, and rewriting content using the Pain-Agitate-Solution and Features-Advantages-Benefits frameworks.
• The AI Positron Refactoring action is available for refactoring multiple files simultaneously using AI.
• The 'Validation Quick Fixes' feature allows the use of the AI Positron Fix action to rectify validation issues.
• Custom actions and prompts can be created in the AI Positron Assistant by recording changes.
• Two XPath extension functions are available in the content completion proposals for Schematron, XSLT, XQuery, and XPath:
  • 'ai:transform-content(instruction, content)' for automatic content transformation using AI.
  • 'ai:verify-content(instruction, content)' for automatic content validation using AI.

This addon uses an external AI service (like OpenAI or MS Azure OpenAI) to help technical documentation writers generate content.

Release Notes 1.2.0

• Oxygen XML Enterprise distribution now includes access to Oxygen AI Positron Assistant Enterprise at no extra cost.

Release Notes 1.1.1

• Fixed an issue where the connection to MS Azure OpenAI failed when the configured endpoint URL address included a path.

Release Notes 1.1.0

• The new Oxygen AI Positron Assistant Enterprise addon enables direct access to your own OpenAI account or AI service hosted on Microsoft Azure. This can be configured in the "Preferences->Oxygen AI Positron Assistant / AI Service Configuration" page. A special license key is required for this feature.
• The AI Positron Assistant Enterprise side view supports content generation and refinement of the AI response. This includes:
  • 'Content Generation' for creating new DITA XML topics, continuing writing, generating short descriptions, index terms, and following instructions.
  • 'Rewrite' actions for grammar correction, readability improvement, content conversion to active voice, itemization, and joining items.
  • 'Overview' actions for answering and generating questions, summarizing content, and improving readability.
  • 'Translation' actions support English, German, French, and Japanese languages, with an option to provide a target language.
  • 'Marketing' features for creating release notes, marketing posts, improving SEO, and rewriting content using the Pain-Agitate-Solution and Features-Advantages-Benefits frameworks.
• The AI Positron Refactoring action is available for refactoring multiple files simultaneously using AI.
• The 'Validation Quick Fixes' feature allows the use of the AI Positron Fix action to rectify validation issues.
• Custom actions and prompts can be created in the AI Positron Assistant by recording changes.
• Two XPath extension functions are available in the content completion proposals for Schematron, XSLT, XQuery, and XPath:
  • 'ai:transform-content(instruction, content)' for automatic content transformation using AI.
  • 'ai:verify-content(instruction, content)' for automatic content validation using AI.

This addon uses an external AI service (like OpenAI or MS Azure OpenAI) to help technical documentation writers generate content.

Release Notes 2.0.0

• Added support to connect to the Anthropic Claude AI engine.
• Added support in the MS Azure OpenAI connector to configure separate Vision Endpoint, Deployment and API Key settings used for analyzing messages which contain images.
• A new action called "Generate Documentation Draft" is available, and it can be used to draft a DITA topic based on a configuration file that fine tunes the generation process.
• A new action called "Update content based on images" is available, and it can be used to update the content of a DITA XML topic based on the images that it refers.
• Images, XML files, and text files can be attached to messages in the Chat panel.
• Useful AI actions (Correct Grammar, Improve Readability, Use Active Voice) are now available as quick assist fixes in the editor by clicking the bulb located on the navigation vertical stripe.
• You can now specify in the "Oxygen AI Positron Assistant Enterprise" preferences page which actions to exclude from being presented in the available actions list.

Release Notes 1.2.0

• Oxygen XML Enterprise edition license now includes access to Oxygen AI Positron Assistant Enterprise at no extra cost.

Release Notes 1.1.1

• Fixed an issue where the connection to MS Azure OpenAI failed when the configured endpoint URL address included a path.

Release Notes 1.1.0

• The new Oxygen AI Positron Assistant Enterprise addon enables direct access to your own OpenAI account or AI service hosted on Microsoft Azure. This can be configured in the "Preferences->Oxygen AI Positron Assistant / AI Service Configuration" page. A special license key is required for this feature.
• The AI Positron Assistant Enterprise side view supports content generation and refinement of the AI response. This includes:
  • 'Content Generation' for creating new DITA XML topics, continuing writing, generating short descriptions, index terms, and following instructions.
  • 'Rewrite' actions for grammar correction, readability improvement, content conversion to active voice, itemization, and joining items.
  • 'Overview' actions for answering and generating questions, summarizing content, and improving readability.
  • 'Translation' actions support English, German, French, and Japanese languages, with an option to provide a target language.
  • 'Marketing' features for creating release notes, marketing posts, improving SEO, and rewriting content using the Pain-Agitate-Solution and Features-Advantages-Benefits frameworks.
• The AI Positron Refactoring action is available for refactoring multiple files simultaneously using AI.
• The 'Validation Quick Fixes' feature allows the use of the AI Positron Fix action to rectify validation issues.
• Custom actions and prompts can be created in the AI Positron Assistant by recording changes.
• Two XPath extension functions are available in the content completion proposals for Schematron, XSLT, XQuery, and XPath:
  • 'ai:transform-content(instruction, content)' for automatic content transformation using AI.
  • 'ai:verify-content(instruction, content)' for automatic content validation using AI.