Skip to content
Last updated

Microsoft Power Platform Integration

Connect your Microsoft Power Platform environment to Capsule Security for complete visibility into your AI agents, workflows, and conversation history across Copilot Studio and Power Automate.

Overview

Microsoft Power Platform portal showing copilots and flows

This integration uses Microsoft Entra ID (Azure AD) authentication to sync:

  • Agents — Copilots built in Copilot Studio
  • Tools — Actions, plugins, Power Automate flows, and connectors
  • Knowledge Bases — Data sources and knowledge articles attached to copilots
  • Conversations — Chat sessions and conversation history
  • Audit — Activity logs with action invocations and session tracking

Prerequisites

Before you begin, ensure you have:

  • An active Microsoft Power Platform environment with Copilot Studio and/or Power Automate
  • An Azure Entra ID account with one of the following permissions:
    • Environment Admin role in Power Platform, OR
    • System Administrator role in the environment
  • Access to the Capsule Security portal

For more information about Power Platform roles, see Administering Power Platform.


Step 1: Configure the Integration in Capsule

Start the integration setup from the Capsule Security portal.

Steps

  1. Log in to the Capsule Security portal

  2. Click Integrations in the left sidebar

  3. Find the Microsoft Power Platform card and click Set up Integration

  4. Click Connect with Microsoft

  5. You'll be redirected to Microsoft's sign-in page


Step 2: Authorize the Capsule Application

Grant Capsule the necessary permissions to access your Power Platform resources.

Steps

  1. Sign in with your Microsoft account that has the required permissions (see Prerequisites)

  2. Review the permissions requested by the Capsule application

  3. Click Accept to grant consent

Permissions explained

PermissionPurpose
Read Power Platform environmentsDiscover environments and resources
Read Copilot Studio dataAccess copilot definitions, conversations, and topics
Read Power Automate flowsAccess flow definitions and run history
Manage role assignmentsConfigure access for ongoing data synchronization

For more information about the consent experience, see User and admin consent in Azure.


Step 3: Automatic Environment Discovery

After you grant consent, Capsule automatically configures the integration.

What happens

  • All Power Platform environments you have access to are discovered
  • Copilot Studio bots and Power Automate flows within those environments are detected
  • Required access permissions are configured automatically

No manual environment configuration is needed.


Synced Data Objects

Capsule ingests data from both Copilot Studio and Power Automate through a unified Power Platform integration. Both services share the same Entra ID app and are discovered automatically from each environment.

Environments

During setup, Capsule uses the Microsoft Discovery Service to automatically detect all Power Platform environments accessible by the authorizing user. Each environment is registered with:

FieldDescription
NameThe environment's friendly name in Power Platform
URLThe Dataverse instance URL
Environment TypeProduction, Sandbox, or Development — classified from the Microsoft organization type

All Copilot Studio agents, Power Automate flows, and users within each discovered environment are then synced automatically.

Copilot Studio

Agents

Copilot Studio bots are ingested as Agents in Capsule. Each agent includes:

FieldDescription
NameThe copilot name as defined in Copilot Studio
TypeConversational
AccessibilityPublic, Tenant, or Limited — derived from the bot's authentication mode and access control policy
OwnerThe platform user who owns the copilot

Agent Components

Each copilot's components are parsed and categorized:

ComponentCategoryDescription
Model AgentModelThe foundational LLM powering the copilot (e.g., GPT-4o). Includes system instructions.
SkillsToolActions and plugins the copilot can invoke, including connector-based tools
Knowledge SourcesData SourceKnowledge bases attached to the copilot (e.g., Dataverse, SharePoint, external websites)
File AttachmentsData SourceUploaded files used as data sources, categorized by MIME type
Access ChannelsAccess ChannelDeployment channels such as Copilot Chat and Microsoft Teams
External TriggersAccess ChannelExternal trigger integrations and their connection types
Connected AgentsConnected AgentOther AI agent plugins linked to the copilot

Conversation Transcripts

Capsule fetches conversation transcripts for each copilot and extracts individual activity events:

Activity TypeDescription
Tool InvocationA tool or action was called during the conversation
ErrorAn error occurred during the session
Session StartedA new conversation session was initiated
Agent ReasoningThe copilot's internal reasoning trace
Data Source AccessedA knowledge source or file was accessed
Channel AccessedAn access channel interaction was recorded
User MessageA message sent by the user
Agent MessageA response generated by the copilot

Power Automate

Flows

Power Automate workflows are ingested as Flows in Capsule. Only modern automation flows (non-managed) are collected.

FieldDescription
NameThe flow name as defined in Power Automate
TypeDAG (directed acyclic graph)
StatusActive, Inactive, or Draft — mapped from the workflow state code
DescriptionOptional flow description

Flow Steps

Each flow's definition is parsed to extract its individual steps:

Step TypeDescription
InputTrigger steps that start the flow (e.g., scheduled, manual, event-based)
OutputResponse steps that return data
ConditionBranching logic (If, Switch)
LoopIteration steps (Foreach, Until)
SubflowNested scopes or child workflow invocations
External CallHTTP requests, API connections, and OpenAPI connector calls
LLMAI Builder model invocations
Data OperationVariable manipulation, data transformation (Compose, Filter, Select, etc.)

Flow Step Connections

Connections between steps represent the execution graph:

Connection TypeDescription
DataStandard sequential execution
ConditionalBranch taken when a condition evaluates to true, or a specific switch case
DefaultFallback branch (else / default case)
ErrorBranch taken when a preceding step fails

Flow Runs

Capsule collects flow run history from the last 30 days:

FieldDescription
StatusThe run outcome (e.g., Succeeded, Failed, Cancelled)
DurationTotal run time
Trigger TypeWhat initiated the run
Error Code / MessageError details if the run failed

Connectors

Power Platform connectors are captured across both Copilot Studio and Power Automate:

  • In Copilot Studio — connector references are extracted from bot component actions. Each skill's connector type is identified from its connection reference (e.g., SharePoint, Outlook, Dataverse).
  • In Power Automate — connector references are extracted from the flow definition. Each step that uses an API connection (OpenApiConnection, ApiConnection, Http) captures the connector's API ID, operation ID, and connection name.

Connectors provide visibility into which external services and data sources your AI agents and automation flows are interacting with.

Power Apps

Capsule extends the Power Platform integration to cover Power Apps, providing visibility into canvas and model-driven apps within each discovered environment.

Users

Platform users are collected from each Power Platform environment and deduplicated across Copilot Studio and Power Automate. Each user includes their name, email, and job title from the Dataverse system user record.


After Setup

Once the integration is configured:

  • Initial sync begins automatically
  • First sync may take several minutes depending on data volume
  • View synced agents in Inventory → Agents
  • View conversations in Observability → Filter Activity Type - Session

Troubleshooting

Common Issues

  1. Consent failed or permissions error

    • Verify you have Environment Admin or System Administrator permissions
    • Ensure your account has access to the Power Platform environments
  2. No environments discovered

    • Confirm Copilot Studio or Power Automate resources exist in your environments
    • Check that you have the necessary permissions to access these resources
  3. Sync not completing

    • Allow several minutes for the initial sync to complete
    • Contact support if the issue persists

Support

For help with this integration:

  • Email: support@capsule.security
  • Include: Your organization ID, integration status, and any error messages

For Power Platform-specific issues: