How microsoft/employee-self-service-agent-developer-kit works
This monorepo combines the ESS Maker Kit, deployment-readiness checks, and migration tooling. The documented maker workflow starts with a developer using Copilot in VS Code to set up and customize an ESS agent; the ADK MCP server exposes automation including topic creation, FlightCheck, and evaluation generation. FlightCheck checks live deployment readiness, while the NextGen toolkit has distinct input, transformation, and output stages. The graph includes those documented branches, but sampled source does not establish how the migration CLI wires its stages together.
Main entry points: adk/server.py Maker automation · pipeline.py Pipeline engine · output_pipeline.py Output stage · servicenow/server.py ServiceNow tools
Components 24
Maker Kit
- Maker automation
solutions/ess-maker-skills/src/mcp/adk/server.py - Local kit workspace
solutions/ess-maker-skills
MCP Integrations
- ServiceNow tools
solutions/ess-maker-skills/src/mcp/servicenow/server.py - ServiceNow client
solutions/ess-maker-skills/src/mcp/servicenow/client.py - Workday tools
solutions/ess-maker-skills/src/mcp/workday/server.py - Workday client
solutions/ess-maker-skills/src/mcp/workday/client.py - Landing-page tools
solutions/ess-maker-skills/src/mcp/agentconfig_landing_page/server.py - Agent config client
solutions/ess-maker-skills/src/mcp/agentconfig_landing_page/client.py
FlightCheck
- FlightCheck CLI
solutions/ess-maker-skills/scripts/flightcheck/cli.py - Check runner
solutions/ess-maker-skills/scripts/flightcheck/runner.py - Readiness checks
solutions/ess-maker-skills/scripts/flightcheck/checks
Migration Toolkit
- Migration CLI
tools/ess-nextgen-migration-toolkit/src/service/mtk_orchestrator.py - Input stage
tools/ess-nextgen-migration-toolkit/src/modules/preprocessing/input_pipeline.py - Transform stage
tools/ess-nextgen-migration-toolkit/src/modules/transformation/transformation_pipeline.py - Output stage
tools/ess-nextgen-migration-toolkit/src/modules/postprocessing/output_pipeline.py - Pipeline engine
tools/ess-nextgen-migration-toolkit/src/core/pipelines/pipeline.py - Migration report
tools/ess-nextgen-migration-toolkit/src/modules/postprocessing/steps/generate_report_step.py
Other components
- Developer
- Copilot in VS Code
- Copilot Studio agent
- Live environment
- ServiceNow
- Workday
- AgentConfiguration API
Connections 23
- Developer → Copilot in VS Code: customizes with
- Copilot in VS Code → Local kit workspace: opens kit
- Copilot in VS Code → Maker automation: invokes tools
- Maker automation → Local kit workspace: reads and writes
- Maker automation → Copilot Studio agent: pushes components
- Developer → FlightCheck CLI: runs checks
- FlightCheck CLI → Check runner: runs checks
- Check runner → Readiness checks: dispatches checks
- Readiness checks → Live environment: checks readiness
- Developer → ServiceNow tools: invokes tools
- ServiceNow tools → ServiceNow client: calls
- ServiceNow client → ServiceNow: requests data
- Developer → Workday tools: invokes tools
- Workday tools → Workday client: calls
- Workday client → Workday: requests data
- Developer → Landing-page tools: invokes tools
- Landing-page tools → Agent config client: calls
- Agent config client → AgentConfiguration API: reads and updates
- Migration CLI → Input stage
- Input stage → Pipeline engine: executes steps
- Transform stage → Pipeline engine: executes steps
- Output stage → Pipeline engine: executes steps
- Output stage → Migration report: generates report