Azure DevOps Integration

What it does

  • Connect Azure DevOps so VDF can help with project management, work item creation, and team productivity insights. VDF can access your Azure DevOps projects and help create, update, and analyze work items.

Adding the App

  1. In VDF, go to Integrations → Microsoft → Azure DevOps → Connect.
  2. Sign in with your Microsoft account and grant access to VDF.
  3. You'll be redirected back to VDF. Select your Azure DevOps organization and projects.
  4. Confirm the connection shows "Connected" for your selected projects.

Usage

Prerequisites:

  • An active VDF account and Azure DevOps account with project access.
  • Recommended: Ensure you have the necessary permissions to authorize Microsoft apps and access Azure DevOps projects.

After connecting:

  • VDF can access your Azure DevOps projects and work items.
  • You can create, update, and analyze work items directly from VDF conversations.
  • Team metrics and project insights become available in your VDF cockpit.

Use in VDF (examples):

  1. Ask in chat: "Create a new user story for implementing user authentication with acceptance criteria."
  2. Ask: "Show me all open bugs in the current sprint and prioritize them by severity."
  3. Ask: "Update work item ABC-123 with the latest status and add a comment about the implementation progress."
  4. Ask: "Generate a sprint report with completed work items and remaining tasks."

Removing the App

There are two parts: disconnect in VDF and remove access in Microsoft.

  • Disconnect in VDF (stops processing immediately):

    1. In VDF, go to Integrations → Microsoft → Azure DevOps → Disconnect.
    2. This removes your active Microsoft authorization from VDF and stops Azure DevOps access.

  • Remove access in Microsoft (Account settings):

    1. Open your Microsoft account → Security → App permissions.
    2. Find "VDF" (or your app name) and select it.
    3. Click Remove access.

Potential implications of removal:

  • VDF will no longer be able to access your Azure DevOps projects.
  • Existing VDF artifacts (work items, reports) remain available until deleted per your workspace retention settings.
  • Any stored authorization tokens are revoked; future Azure DevOps access is blocked.

Tips

  • Start with specific projects if you have access to many Azure DevOps organizations.
  • You can change your selected projects anytime in the Microsoft integration settings.
  • Use VDF to generate comprehensive work item descriptions and acceptance criteria.

Examples and use cases

  • Work Item Management:
    • "Create a bug report for the login issue with detailed steps to reproduce."
    • "Update all user stories in the current sprint with their latest status."
  • Project Analysis:
    • "Show me the velocity trend for the last 3 sprints."
    • "Identify work items that have been in progress for more than 5 days."
  • Sprint Planning:
    • "Generate a sprint goal based on the top 5 backlog items."
    • "Create acceptance criteria for the user authentication story."

Prompt categories

Category Examples
Work Items "Create user story for Google Sign-In with acceptance criteria"
Project Analysis "Show velocity trends and sprint performance"
Sprint Planning "Generate sprint goals and prioritize backlog items" 
sequenceDiagram
  participant U as You
  participant V as VDF AI
  participant A as Azure DevOps
  U->>V: "Create a story for Google Sign-In..."
  V-->>U: Draft story + acceptance criteria
  U->>V: Send to Azure DevOps
  V->>A: Create work item
  A-->>V: Work item ID ABC-123
  V-->>U: Confirm created ABC-123

Troubleshooting

  • Authorization errors: Start the connection from VDF → Integrations → Microsoft → Azure DevOps. Ensure your Microsoft account can grant the requested permissions.
  • Project access issues: Confirm you have the right permissions in Azure DevOps and that the projects are accessible.
  • Work item creation fails: Verify you have the necessary permissions to create work items in the selected projects.
  • Organization not found: Ensure your Azure DevOps organization is properly configured and accessible.

FAQ

  • Which Azure DevOps projects can VDF access? — VDF can access projects where you have appropriate permissions.
  • Can I change the selected projects? — Yes, you can update your project selection in the integration settings.
  • What happens to my data if I disconnect? — VDF stops accessing Azure DevOps. Generated artifacts in VDF remain until you delete them.
  • Do I need specific Azure DevOps permissions? — Yes, you need permissions to read and create work items in the selected projects.

Contact Support

  • Email: support@vdf.ai
  • Hours: Mon–Fri, 09:00–18:00 UTC
  • First response SLA: Within 1 business day
  • To open a case: Email us with your workspace name, Microsoft email, and a brief description of the issue.