Skip to main content

Azure DevOps — Story Agent

The Aprity Story Agent for Azure DevOps adds an AI-powered hub to your Azure Boards backlog. It generates a structured EPIC / FEATURE / USER STORY hierarchy grounded in your Salesforce org's metadata, business rules, and dependencies, then exports it as work items.

info

The Azure DevOps integration rides on the Story Agent, which is available on the Intelligence and Trial plans (not on Documentation).

Your Azure DevOps organization is connected through its base URL, which is validated against an allowlist (dev.azure.com/* or *.visualstudio.com).

Prerequisites​

Before you begin, make sure you have:

  • An Azure DevOps Services organization (cloud). Azure DevOps Server (on-premises) is not supported.
  • Project Collection Administrator or Organization Owner permissions to install extensions.
  • An active aprity account with a connected Salesforce org (at least one completed scan).
  • Access to the Connectors tab in the aprity Salesforce app.

Step 1 — Install the extension​

  1. Go to the Visual Studio Marketplace and search for Aprity Story Agent.
  2. Click Get it free.
  3. Select the Azure DevOps organization where you want to install it.
  4. Click Install.

The extension requests the following scope:

ScopePurpose
vso.work_writeRead and create work items in Azure Boards

Once installed, you will see:

  • Aprity Story Agent — a new hub in the Backlog hub group of Azure Boards.
  • Aprity Configuration — a settings hub in the Project Admin area.
tip

If you manage multiple organizations, make sure you install the extension on the correct one. Each organization requires its own installation.

Step 2 — Generate an activation code in Salesforce​

  1. Open Salesforce and navigate to the aprity app.
  2. Go to the Connectors tab.
  3. Locate the Azure DevOps card and click Connect Azure DevOps (or Generate New Code).
  4. A code in the format APRT-XXXX-XXXX appears. It expires in 30 minutes and can only be used once.
  5. Copy the code.
caution

The code expires after 30 minutes. If it expires before you use it, generate a new one from the Connectors tab.

Step 3 — Connect Azure DevOps to aprity​

  1. In Azure DevOps, navigate to your project.
  2. Go to Project Settings (gear icon at the bottom of the sidebar).
  3. Find Aprity Configuration in the settings list and open it.
  4. You will see a setup page with instructions:
    • Open Salesforce → aprity app → Connectors
    • Click "Connect Azure DevOps" (already done)
    • Paste the code below
  5. Enter the activation code (APRT-XXXX-XXXX) in the input field.
  6. Click Connect.
  7. If the code is valid, the page shows a green checkmark with the message Connected to Aprity.

Step 4 — Verify the connection​

Once connected:

  1. Navigate to Boards > Backlogs in your Azure DevOps project.
  2. Look for the Aprity Story Agent hub in the backlog hub group.
  3. Click on it to open the Story Agent panel.

If the hub is not visible, verify that:

  • The extension is installed for your organization (Organization Settings > Extensions).
  • Your user account has access to the project.

Using the Story Agent​

With the connection active, you can:

  • Generate work items — describe requirements in natural language, and the Story Agent creates a structured EPIC / FEATURE / USER STORY hierarchy based on your org's metadata.
  • Get impact analysis — each generated item includes which Salesforce objects, automations, and validation rules are involved.
  • Export to your backlog — push the generated work items directly into Azure Boards. The export is idempotent: re-running it updates existing work items rather than creating duplicates. This is a push to Azure DevOps, not a downloadable documentation file.

Disconnecting​

To disconnect Azure DevOps from aprity:

  1. Open Aprity Configuration in your project settings.
  2. Click Disconnect (if available in the settings page).
  3. Alternatively, uninstall the extension from Organization Settings > Extensions.

After disconnecting, the Story Agent hub will no longer function. You will need a new activation code to reconnect.

Troubleshooting​

IssueSolution
"Invalid format" errorVerify the code format is APRT-XXXX-XXXX.
"Code expired" errorGenerate a new code from the aprity Connectors tab in Salesforce.
Hub not visible in BoardsVerify the extension is installed (Organization Settings > Extensions) and enabled for your project.
"No scan data"Run at least one scan from the aprity app before using the Story Agent.
Extension not in MarketplaceThe extension may still be in private preview. Contact support@aprity.ai for access.