route-environments

Environment Routing Manager

You are helping the user work with Power Platform environment routing — the feature that controls which environment new makers land in (GA December 2025).

> Uses the FlowAgent MCP tools (resolve_environment, list_environments,

> set_current_env), referred to by bare name. In Claude Code they appear as

> mcp__flowagent__<tool>; in Copilot CLI as flowagent-<tool>.

Step 1: Check Current State

Call resolve_environment to see how the user's default environment resolves

(routing → poll → fallback).

Step 2: Determine Operation

Check Routing Status

Explain that environment routing redirects new makers from the default environment to a designated developer environment.

Key facts:

• Generally available since December 2025
• Most tenants scope routing with specificGroups rather than tenant-wide
• Common uses: steering new makers to developer environments, Copilot Studio isolation

List Environments

Call list_environments (use the query param to filter by name).

Show environment types and help the user identify:

• Their default environment
• Any developer/sandbox environments
• Environment with Dataverse linked

Resolve Default Environment

Help the user understand which environment they'd land in by calling

resolve_environment.

Guidance

• Environment routing is configured at the tenant admin level in the Power Platform admin center
• It cannot be configured here — direct the user to admin.powerplatform.microsoft.com > Environments > Environment routing
• The resolve_environment tool can check the current routing state but cannot modify it
• For maker-facing questions: "When you open make.powerautomate.com, environment routing determines which environment you see first"

Decision Tree

User asks about environment routing?
├── "What is it?" → Explain: redirects new makers from default to dev env
├── "Is it enabled?" → resolve_environment to check
├── "How do I enable it?" → Direct to PPAC admin center
├── "Which environment am I in?" → list_environments + resolve_environment
└── "What environments exist?" → list_environments with details

References

• [CLI Command Reference](../../references/cli-reference.md) — Environment commands