mbrucedogs/ai-docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
35d8bb7b6b
ai-docs/docs/ai/troubleshooting.md
Matt Bruce 96a3497862 docs: add contents blocks
2026-02-11 10:57:28 -06:00

2.3 KiB
Raw Blame History

Troubleshooting and FAQ

You are here: AI Docs Home > Troubleshooting and FAQ

Contents

  • Common Setup Issues
  • Quick Diagnostic Flow
  • Quick Setup Verification Checklist
  • Extension Or Plugin Conflicts
  • Company Network Restrictions
  • Low-Quality Suggestions
  • Escalation
  • Next Steps

Common Setup Issues

  • Cannot sign in: confirm GitHub access and SSO.
  • No suggestions: verify Copilot is enabled in the editor.
  • Plugin missing: confirm the plugin or extension is installed.

Example: No Suggestions

  1. Confirm you are signed in.
  2. Confirm the extension is enabled.
  3. Open a new file and type a simple prompt.
  4. Restart the editor if needed.

Quick Diagnostic Flow

  1. Confirm account access and SSO.
  2. Confirm plugin or extension is installed and enabled.
  3. Restart the editor.
  4. Test with a small prompt in a new file.
  5. If still blocked, escalate.

Quick Setup Verification Checklist

Use this after install or updates:

  1. Open a code file and type a short comment prompt.
  2. Confirm an inline suggestion appears.
  3. Open Copilot Chat and ask a short question.
  4. If nothing appears, restart the editor and try again.
  5. If still blocked, follow the escalation steps below.

Extension or Plugin Conflicts

  • Disable overlapping AI extensions to avoid conflicts.
  • Restart the editor after enabling Copilot.

Company Network Restrictions

  • Check for blocked endpoints or proxy requirements.
  • Escalate to IT if access appears restricted.

Low-Quality Suggestions

  • Tighten the prompt with scope and context.
  • Provide a small example or expected output.

Example Fix

Example prompts:

Bad: Fix this.
Better: Refactor this function to remove duplication. Keep behavior the same.

What To Collect Before Escalation

  • Editor version and plugin version.
  • Error messages or screenshots.
  • Whether the issue is reproducible in another editor.

Example Escalation Note

Example note:

Copilot suggestions stopped in VS Code 1.92 after extension update. Restarted, still broken. Screenshot attached.

When to Escalate

  • Account access issues after setup.
  • Consistent failures across multiple editors.
  • Policy or security concerns.

Next Steps