Generate a summary for Architectural Decision Records \(ADRs\)

task brazil Updated Sep 10, 2026 2 min read summarize-docs-genai-skill-ea.md
Raw file servicenow.com

Quickly learn the details of the Architectural Decision Records (ADR) from the summary that is generated by ServiceNow Otto® in the Enterprise Architecture Workspace. Use ServiceNow Otto® to generate summaries of large ADR artifacts and understand architectural decisions faster.

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.

  • Important: This generative AI skill is turned on by default. The skill will be automatically available to appropriate role users for the application. For more information, see AI agents, skills, and agentic workflows on by default.

  • 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.

Note: Starting with the September 2026 release, Gemma 4 joins our growing portfolio of open-weight models available through Now LLM Service. The latest industry advancements are available alongside sovereignty-focused options. All models are hosted and governed by ServiceNow with the same infrastructure and data protections. Older models will remain available for existing published AI skills, agents, and agentic workflows, but will no longer be available for new development or configuration. For details, see the KB3066214: ServiceNow Otto Model Upgrades article in the Now Support Knowledge Base.

Role required: sn_apm.apm_user

About this task

When an Enterprise Architect receives an approval request for the ADR type of artifact, the Summarize button quickly generates a summary of the ADR document content. This saves time when reviewing large documents.

Procedure

  1. Navigate to Workspaces > Enterprise Architecture Workspace.

  2. Open the Portfolio List view by selecting the Portfolio icon [Omitted image "portfolio-icon.png"] Alt text: Portfolio icon.

  3. Select the expand row icon ([Omitted image "ExpandIcon.png"] Alt text: Expand Row icon) next to Information Portfolio.

  4. Select Architectural Decision Records.

  5. Select the ADR that you want to summarize the content for.

  6. In the Artifact content tab, select Ask Otto and then select Summarize.

    [Omitted image "adr-doc-summarize.png"] Alt text: Doc summarization page

  7. In the Tell Otto to box press enter or select the send button.

  8. Select Done to complete the summarization.

    You can also copy the summarized text.

Parent Topic:Manage architectural decision records (ADR)

Related topics

Add or edit an architectural decision record (ADR)

Exploring ServiceNow Otto for Enterprise Architecture (EA)

Configure ServiceNow Otto for Enterprise Architecture (EA)

ServiceNow Otto for Enterprise Architecture (EA) access roles

Search documentation
Search document titles and file paths on the brazil branch