Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Elaborate or shorten content in ADRs

Elaborate or shorten the Architectural Decision Records (ADR) content using the Now Assist in the Enterprise Architecture Workspace.

Before you begin

Note: Depending on your license, you will have access to certain application features, generative AI skills, agentic workflows, and AI agents. For more information, see ServiceNow product tiers.

Make sure that the ADR Doc Summarization and Actions skill is activated. For information, see Configure Now Assist for Enterprise Architecture (EA).

Note: The ADR feature in Enterprise Architecture Workspace uses the ServiceNow Docs component (sn_docs) to create pages in the Artifacts section. Docs component v6.0.0 is automatically installed with Enterprise Architecture Workspace v3.4.0.

If you're using an older version of Enterprise Architecture Workspace with Docs component v6.0.0, upgrade the workspace to v3.4.0 to fully use the ADR functionality. For more information, see KB2017926.

The default AI model provider for this skill is Azure OpenAI.

Role required: sn_apm.apm_user

Procedure

  1. Navigate to Workspaces > Enterprise Architecture Workspace.

  2. Open the Portfolio List view by selecting the Portfolio icon

Image omitted: portfolio-icon.png
Portfolio icon.
  1. Select the expand row icon (
Image omitted: ExpandIcon.png
Expand Row icon\) next to **Information Portfolio**.
  1. Select Architectural Decision Records.

  2. Select the ADR whose content you want to elaborate or shorten.

  3. From the Artifact content tab, select the text.

Image omitted: elaborate-shortent-adr-content.png
Ealborate, shorten ADR content
  1. Select the Now Assist drop-down to perform any of the following tasks.

    • Summarize: Summarizes the selected text.
    • Elaborate: Elaborates the selected text.
    • Shorten: Shortens the selected text.
    • Use the Refine button on Now Assist pop-up to Elaborate more or shorten the text.
Image omitted: adr-doc-refine.png
Refine content
  1. Select Insert below to insert the content in the ADR record.

Parent Topic:Using Now Assist for Enterprise Architecture (EA)

Related topics

Add or edit an architectural decision record (ADR)