Released: Nov 1, 2024

Atualizações na V4.0

Recursos

Retrieval-Augmented Generation (RAG)

• Improved AI Fixes - When using the AI Positron Assistant add-on with Oxygen versions 26.1 or newer, the AI Positron Fix action now leverages the RAG process to enhance the AI's response by using information from the current document, leading to more relevant responses.
• RAG using the search provided by Oxygen Feedback - If the Oxygen Feedback product is used to provide search functionality for a web site, the Oxygen Feedback search system can be used to retrieve relevant content that will be used by AI to enhance the provided responses.
• New AI tool functions - Within the definition of custom actions, you can reference functions that may be called by the AI engine to interact with the application. These functions can provide additional information that allows for more relevant answers to be constructed by the AI, or they may allow the AI to directly act in a controlled way on the application workspace. The following functions have been added in this version:
  • add_to_toc - Modifies a DITA map and adds a specified topic reference to it.
  • find_similar_reusable_content - Retrieves a list of reusable DITA XML components that match keywords provided by the AI.
  • get_content_for_document_url - Retrieves the content of a certain document.
  • get_corresponding_dita_keyrefs - Can be used to find if there are key definitions for corresponding values.
  • get_current_editor_file_location - Retrieves the location (URL) of the current file that is open in the editor.
  • get_related_content_from_webhelp - Accesses the search functionality provided by the Oxygen Feedback product when a connection to Oxygen Feedback is defined in the preferences page.
  • get_topic_context_in_toc - Returns the hierarchical structure path that references the selected topic from the DITA map that is open in the DITA Maps Manager view, providing context such as its parent, siblings, and surrounding nodes within the DITA map. This is useful for understanding the topic's location in relation to other elements in the DITA map.
  • resolve_dita_key_or_content_reference - Resolves a DITA XML key reference, content key reference, or content reference to the target content.
  • save_document - Saves the document at the specified path within the project and writes content to it. If a resource already exists at the specified URL, the content of the document is overridden with the new content.

Intelligent Agents
Intelligent Agents is a category of AI-powered actions designed to streamline DITA XML topic management. These agents offer advanced capabilities to save files, add references to the DITA map, and access functions for contextual understanding and project structure modification.

• Expand DITA Topic Draft - The new Expand Draft AI action enhances a draft of a DITA XML topic by refining the content, adding consistent markup, and generating documentation based on referenced images using Vision support. The AI searches for similar content in topics gathered from related links or through Retrieval-Augmented Generation (RAG). This action is available for DITA XML documents.
• Split Large DITA Topics - The Split Topic AI action splits large topics with numerous subjects into multiple topic files. The newly created topics are also conveniently referenced in the DITA map that is currently open in the DITA Maps Manager.
• Create DITA Topics - The new Create Topics AI action generates DITA XML topics based on user input, incorporating relevant project content. It creates a topic hierarchy, assigns DITA document types, and proposes a DITA map location. Topics are then saved and added upon user approval. The AI searches for similar content in topics gathered from related links or through the Retrieval-Augmented Generation (RAG) process.

Interface Improvements

• Current Element Highlighted When Applying an AI Action in Text Mode - When utilizing AI actions in Text mode, it is easier to identify the element affected by an AI action. The current element, serving as the context for the action, is now highlighted for improved visibility and ease of identification.

AI-Powered Actions

• Reuse DITA XML Component - A new Component action in the Reuse category asks the AI to identify the most similar existing reusable component that matches the selected paragraph, saving you from searching for the correct reusable component.
• Find Product Names - The new Product Name AI action (located in the Reuse category) searches for product names in the selected content and replaces them with key references (keyref) if keys are defined for the particular product names. If keys are not defined for specific product names, those names are wrapped in <keyword> elements instead.
• Suggest Refactoring for Selected Code - The new Suggest Refactoring AI action (in the Development category) generates a suggestion for refactoring the selected code to simplify it and make it easier to read and understand. This action is available for XSLT and XSD documents.
• Generate Code Action Reuses Components - The Generate Code AI action that is used to generate code for the current editor type (XSL, XQuery, CSS, JSON, XML Schema, or Schematron) now reuses components found in the current document, making the responses more relevant.
• New Action Types - New action types are now available when implementing custom user-specific actions:
  • prompt-user - Prompts the user for extra details passed to the action prompt.
  • replace-selection-based-on-image-analysis - Uses details obtained from the referenced DITA XML images when performing the action prompt.

Miscellaneous

• Document Type Sent to AI for Context - When starting a new chat with the AI, the document type and any selected content in the main editor area are automatically provided as context. This feature allows you to get responses more tailored for that specific document.
• Intuitive Identification of XML Content in Markdown - An AI response might contain explanations followed by the actual response wrapped in the ```xml marker. This type of response is now detected and the block of XML code can be inserted or previewed.
• Security Enhancements - Information regarding favorite prompts, chat history, or AI XPath functions are stored encrypted in the options file. The Retrieval-Augmented Generation (RAG) preferences page has new security-related options to enable reading and writing content in the project or to control if the end user is prompted to allow the use of function calls for particular actions.

Web Author

• Attach Image, XML, or Text File to a Chat - Users can attach multiple images, XML, or text files to a chat message by clicking on an interface button. The selected file will be inserted into the chat, allowing the AI to utilize it for additional context during the conversation.
• Document Type Sent to AI for Context - When starting a new chat with the AI, the document type and any selected content in the main editor area are automatically provided as context. This feature allows you to get responses more tailored for that specific document.
• Intuitive Identification of XML Content in Markdown - An AI response might contain explanations followed by the actual response wrapped in the ```xml marker. This type of response is now detected and the block of XML code can be inserted or previewed.
• Expand DITA Topic Draft - The new Expand Draft AI action enhances a draft of a DITA XML topic by refining the content, adding consistent markup, and generating documentation based on referenced images using Vision support. The AI searches for similar content in topics gathered from related links or through Retrieval-Augmented Generation (RAG). This action is available for DITA XML documents.
• Split Large DITA Topics - The Split Topic AI action splits large topics with numerous subjects into multiple topic files. The newly created topics are also conveniently referenced in the DITA map that is currently open in the DITA Maps Manager.
• New AI tool functions - Within the definition of custom actions, you can reference functions that may be called by the AI engine to interact with the application. These functions can provide additional information that allows for more relevant answers to be constructed by the AI, or they may allow the AI to directly act in a controlled way on the application workspace. The following functions have been added in this version:
  • get_content_for_document_url - Retrieves the content of a certain document.
  • get_current_editor_file_location - Retrieves the location (URL) of the current file that is open in the editor.
  • get_related_content_from_webhelp - Accesses the search functionality provided by the Oxygen Feedback product when a connection to Oxygen Feedback is defined in the preferences page.
  • save_document - Saves the document at the specified path within the project and writes content to it. If a resource already exists at the specified URL, the content of the document is overridden with the new content.