skills.rest
microsoft
microsoftOFFICIAL
Explore all skills by this author →
Website𝕏@OpenAtMicrosoftGitHub

troubleshoot

Diagnose ESS agent connectivity and authentication failures with Workday, ServiceNow, and SAP.

25|8|Updated Apr 8, 2026
Search Tags:#authentication#integration#diagnostic#ess#workday#copilot studio#connectivity troubleshooting
One-click install
npx skills add https://github.com/microsoft/Employee-Self-Service-Agent-Developer-Kit --skill troubleshoot-microsoft
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: troubleshoot
Source: https://github.com/microsoft/Employee-Self-Service-Agent-Developer-Kit/tree/main/solutions/ess-maker-skills/src/skills/troubleshoot
Command: npx skills add https://github.com/microsoft/Employee-Self-Service-Agent-Developer-Kit --skill troubleshoot-microsoft

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the time-consuming, error-prone process of manually diagnosing ESS agent connectivity failures with external enterprise systems like Workday, ServiceNow, and SAP, which can disrupt critical business workflows and leave makers without clear resolution paths.

Core Features & Use Cases

  • Read-Only Diagnostic Guidance: Safely walk through config checks without modifying agent files, running scripts, or creating checkpoints, eliminating risk of accidental changes during troubleshooting.
  • Structured Error Matching: Match exact error messages or described symptoms to specific config checks using built-in reference tables, cutting down diagnosis time significantly.
  • End-to-End Resolution Support: Get guided steps for fixing identified config issues, performing layer-by-layer authentication resets, or compiling a full escalation package for support teams if the issue persists.
  • Use Case: For example, if your ESS agent suddenly fails to authenticate with Workday after a password rotation, this skill guides you through checking the relevant integration configs, applying the fix, and verifying the resolution works for end users in BizChat.

Quick Start

Invoke the troubleshoot skill, share the exact error message your ESS agent is showing when connecting to Workday, and follow the guided step-by-step diagnosis to identify and resolve the issue.

Frequently Asked Questions about troubleshoot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot ESS agent connectivity failures with Workday in Copilot Studio?▼

To troubleshoot ESS agent connectivity failures in Copilot Studio, you match the exact error message to structured diagnostic workflows, perform read-only config validation, and apply guided authentication reset steps without modifying agent files.

Why does my ESS agent authentication fail with ServiceNow after a password rotation?▼

ESS agent authentication fails after a password rotation because integration configs become mismatched. Resolve this by running layer-by-layer authentication reset guidance to update the relevant external service credentials and verify end-user resolution.

Does diagnostic troubleshooting for ESS agents modify my existing configurations?▼

Diagnostic troubleshooting for ESS agents is strictly read-only. It safely walks through config checks and structured error matching without modifying agent files, running scripts, or creating checkpoints, eliminating the risk of accidental changes during diagnosis.

What is the best way to compile an escalation package for unresolved ESS integration errors?▼

The best way to compile an escalation package for unresolved ESS integration errors is to follow the guided end-to-end resolution support, which gathers diagnostic workflows and config validation results into a structured package for support teams.

Can I use this diagnostic workflow for SAP integration errors and unexpected agent behavior?▼

Yes, you can use this diagnostic workflow for SAP integration errors and unexpected agent behavior. It resolves connectivity and authentication failures across external enterprise systems including Workday, ServiceNow, and SAP through structured error matching.

When should I escalate ESS connectivity issues instead of applying config fixes myself?▼

You should escalate ESS connectivity issues when guided authentication resets and config validation steps fail to resolve the integration errors. The skill helps compile a full escalation package containing diagnostic data for support teams at this stage.

Related Skills

Explore More Software Engineering Skills→
mkalkeremkalkere
4

debugging

Reproduce, isolate, and diagnose code failures with evidence-based techniques.

Community
Advanced
hiddink-aihiddink-ai
1

stuck-recovery

Detect repetitive failure loops in agent task execution via tool call monitoring.

Official
Advanced
githubgithub
37.6k

workiq-copilot

Query live Microsoft 365 emails, meetings, documents, Teams messages, and people data.

Official
Advanced
PlaneInABottlePlaneInABottle

websocket-testing

Test WebSocket endpoints for connectivity, message framing, and lifecycle events.

Community
Advanced