MR4DevOps and CP4DevOps Q&A v1

1. Q: A Smart Doc is missing the “Linked WI” column. Which version includes it?

A: The “Linked WI Type” field is available starting in MR 2025. Upgrade to MR 2025 to access this functionality.

2. Q: Will API endpoint changes affect our automation?

A: Existing API endpoints remain functional. New API builds typically add endpoints rather than modifying old ones to prevent regression. Teams should verify deployment timelines before switching.

3. Q: “Acceptance Criteria” is missing in Smart Doc templates. Why?

A: This usually happens due to differences in the process template. Creating a dummy project using the same template often helps confirm whether the field should appear.

4. Q: MR suddenly becomes unavailable. What’s the usual cause?

A: Most outages relate to server updates or pending OS patches. After updates, services stabilize. It's recommended to avoid update windows during active work.

5. Q: Copilot4DevOps fails when using a custom “Use My LLM” setup. What should we check?

A:

• Switch to a supported model (e.g., GPT‑4.1).
• Ensure your MR version supports GPT‑5 (requires v7+).
• Some translation and long‑input issues are fixed in v7.1.

6. Q: Baseline or Smart Review API is slow or shows dropped API calls. Why?

A: Causes include:

• Server configuration changes
• Prior workarounds (DLL edits, lowered timeouts) no longer applying
• Template-specific errors
  Support typically requests console logs, HAR files, and MR build version for further diagnosis.

7. Q: Can reviewers & approvers be forced into a strict sequence (1 → 2 → 3)?

A: No. Sequential enforcement creates workflow bottlenecks and is not supported.

8. Q: A Review module bug has returned. How to proceed?

A:

• Clear cache
• Try on the latest MR release
• Verify whether the issue is user‑specific
  Many Review issues result from browser cache or older deployments.

9. Q: Copilot4DevOps does not analyze all work items or is slow. Why?

A:

• Older versions used paginated fetches (10 items per batch).
• v7 optimizes performance (approx. 2 minutes for 80+ items).
  Recommended: fetch all items first, then prompt Copilot to analyze the full set.

10. Q: Can Smart Reports embed attachments directly instead of linking them?

A: No. Smart Reports currently only link attachments. Embedding is not supported.

11. Q: Copilot4DevOps extension is not updating to the newest version. What to do?

A:

• Ensure installation from the correct Marketplace.
• Clear extension cache from Azure DevOps Server local directory.
• Verify the actual version under Copilot Admin (the extension’s displayed version may differ).

12. Q: A licensed user cannot activate Copilot4DevOps. Why?

A: Common causes:

• User logged in with a different ADO identity
• Cached license activation needing reset
• License removal/re‑assignment required
  Support often resolves this with a quick license reset.

13. Q: Copilot tools freeze at 90% or show a blank output. What causes this?

A:

• Third‑party cookies disabled
• Network policies blocking LLM endpoints
• Local security rules (especially in MS Edge Local Network Access)
  Try Chrome, enable third‑party cookies, or contact IT to lift restrictions.

14. Q: How can deleted SmartDocs be restored?

A:

• Cloud deployments → MR support handles this.
• On‑prem → restore from backup or request support assistance.
  SmartDocs can usually be restored if the underlying work items still exist.

15. Q: Can I customize which fields Baseline compares?

A: Yes. In Admin → General, move fields into the “Selected” list under Baseline Comparison settings.

16. Q: Browser warns or blocks SmartDoc/Report downloads. What should I do?

A:

• Allow downloads for the MR domain
• Try another browser
• Disable ad-blockers or strict privacy tools

17. Q: Why am I getting token limit errors in Copilot4DevOps?

A: Each license tier has a monthly token quota. Exceeding it triggers 429/limit errors. Quotas reset monthly and can be increased by upgrading.

18. Q: How do I get a list of licensed users or free up licenses?

A:

• Contact MR support for a roster export.
• Users can clear their own assignments; support removes them from the license server afterward.

19. Q: SmartDoc templates are missing in some projects. Why?

A:

• Required work item types may not exist in that project
• Process templates may differ
• Upgrading MR build commonly resolves these inconsistencies

20. Q: Copilot Chat or sidebar options are not appearing in Azure DevOps.

A:

• Feature requires extension authorization by a Project Collection Administrator
• Some sidebar features are only available with Standalone Copilot, but MR-integrated versions now support them after recent updates
• Reload the browser after authorization