Forum Discussion

sapanpatel's avatar
sapanpatel
Copper Contributor
Oct 23, 2026

Understand the Copilot Studio app-building harness

The first important distinction is that building an app is different from building a conversational agent.

An app provides an interactive user interface. An agent reasons about a request and may use tools to accomplish a task. A workflow executes defined business logic.

You can combine all three in a business solution.

ComponentResponsibilityExample
Copilot Studio AppsUser interface and application experienceAn employee service dashboard
GitHub Copilot harnessAI-powered building and orchestration runtimePlanning multi-step tasks and generating app components
AgentReasoning and task executionInvestigating a service request
WorkflowRepeatable business processRouting an approved request
Data layerStores and retrieves business informationRequests, users, approvals, and status
Connectors and APIsIntegrates enterprise systemsSharePoint, Microsoft Graph, or ServiceNow

The GitHub Copilot harness in Copilot Studio is not the same thing as using the GitHub Copilot service. It is a Copilot Studio runtime for advanced reasoning and orchestration. Microsoft's documentation states that the normal Copilot Studio security, privacy, compliance, and data residency commitments continue to apply. 

2. Before building: define the application properly

One of the biggest mistakes is asking the builder to create an app with a vague prompt.

For example:

Weak prompt

"Build an employee management app."

This leaves too many decisions to the AI. It might generate an attractive interface but miss important business requirements.

Instead, define these eight elements before generating the application.

ElementWhat to specify
Business problemWhat problem does the application solve?
Target usersWho will use it?
User journeysWhat tasks must users complete?
Data modelWhat entities, fields, and relationships are needed?
UI requirementsWhat screens, components, filters, and interactions are required?
Business rulesWhat validations and conditions must be enforced?
IntegrationsWhat APIs, data sources, and systems are involved?
SecurityWho can view, create, edit, approve, or delete records?

Also define the acceptance criteria before generation.

For example:

  • Users can search requests by ID, owner, status, and date.
  • Selecting a request opens its detailed view.
  • Users can update permitted fields.
  • Invalid status transitions are rejected.
  • Loading, empty, and error states are handled.
  • Changes are persisted to the intended data source.

My recommendation: Write the requirements first, then build the app. Don't use repeated prompts to discover the business requirements while simultaneously generating the UI.

3. Step-by-step guide to building an app

Step 1: Open the app-building experience

  1. Open copilot studio

Step 2: Start with a complete application specification

Let's use an example: an Enterprise AI Operations Dashboard.

The app will help employees and administrators monitor AI automation requests, investigate failures, track processing time, and manage remediation.

Start with a structured prompt.

Master app-generation prompt

You can adapt this prompt for your first build.

Build a professional enterprise application called Enterprise AI Operations Dashboard.

BUSINESS OBJECTIVE

Create a centralized interface for monitoring AI automation requests, execution outcomes, failures, processing time, and remediation activities.

TARGET USERS

  1. Operations analysts who monitor executions.
  2. Administrators who investigate failures.
  3. Managers who review operational performance.

APPLICATION STRUCTURE

Create the following pages:

  1. Overview Dashboard
    • Total executions
    • Successful executions
    • Failed executions
    • Success rate
    • Average processing time
    • Execution trend over time
    • Recent failures
    • Status distribution
  2. Execution Explorer
    • Search by execution ID
    • Filter by status, application, owner, and date
    • Sort by execution time and duration
    • Paginated or appropriately limited results
    • Select an execution to open its details
  3. Execution Details
    • Execution ID
    • Application name
    • Initiated by
    • Start time and end time
    • Duration
    • Status
    • Error summary
    • Diagnostic information, when available
    • Remediation history
  4. Remediation Center
    • Display unresolved failures
    • Allow authorized users to assign an owner
    • Add investigation notes
    • Update remediation status
    • Record timestamps for changes
  5. Settings
    • Configurable filters and display preferences
    • Clear explanation of administrative permissions
    • No destructive administrative actions without confirmation

DATA MODEL

Create a logical data model containing:

Execution:

  • ExecutionId
  • ApplicationName
  • InitiatedBy
  • StartTime
  • EndTime
  • DurationSeconds
  • Status
  • ErrorSummary
  • Environment
  • RemediationStatus

Remediation:

  • RemediationId
  • ExecutionId
  • AssignedTo
  • Notes
  • Status
  • CreatedAt
  • UpdatedAt

Define a relationship between Execution and Remediation.

If a persistent data source is not configured, use clearly identified sample data. Do not present sample data as live production data.

UI AND DESIGN

Use a clean, modern enterprise dashboard with:

  • Clear visual hierarchy
  • Readable typography
  • Consistent spacing
  • Responsive layouts
  • Accessible contrast
  • Reusable UI components
  • Summary cards
  • Appropriate charts
  • Searchable and filterable tables
  • Clear loading, empty, success, and error states

FUNCTIONAL REQUIREMENTS

  • Search and filters must work.
  • Dashboard metrics must be calculated from the underlying dataset.
  • Selecting a row must display the corresponding execution details.
  • Form inputs must be validated.
  • Status changes must update the intended data source.
  • Display clear error messages when operations fail.
  • Prevent duplicate submissions where appropriate.
  • Confirm potentially destructive actions.
  • Preserve filters when navigating between related screens where feasible.

SECURITY

  • Respect the signed-in user's permissions.
  • Do not expose secrets, access tokens, or sensitive diagnostic information.
  • Do not rely on hiding a UI button as the only authorization control.
  • Enforce authorization at the data source or API.
  • Do not create external integrations without explicitly identifying their requirements.

IMPLEMENTATION PROCESS

First, summarize the proposed architecture, data entities, pages, and assumptions.

Ask clarifying questions if a critical requirement is ambiguous.

Then generate the first functional version of the application.

After generation, test the primary user journeys and identify incomplete functionality.

Clearly distinguish implemented features, simulated features, and integrations that still require configuration.

This is a starting specification, not a guarantee that every requested capability will be generated correctly. Inspect the resulting application and verify its actual behavior.

Step 3: Review the generated application

Once the app preview appears, don't immediately ask for more features.

First, inspect the application against the specification.

Check:

  • Does the navigation work?
  • Are the pages connected logically?
  • Do the tables display consistent data?
  • Do the filters actually change the results?
  • Are dashboard metrics calculated correctly?
  • Does selecting a record open the correct details?
  • Do forms validate required fields?
  • Does saving actually persist the changes?
  • Are the displayed integrations real or simulated?

This distinction is essential: a functional-looking interface is not proof of a working backend.

Microsoft's app-building experience provides an interactive preview and lets you refine the app through conversation. It also exposes the underlying code for inspection. 

4. Technical prompting techniques for better apps

This is where you can significantly improve the quality of generated applications.

Technique 1: Build in controlled iterations

Avoid asking the builder to implement every feature, integration, chart, and workflow in one enormous request.

Use a sequence of targeted changes.

Iteration 1: Application foundation

"Review the generated application and identify missing requirements. Fix the navigation structure, page layout, data model, and core interactions before adding new features."

Iteration 2: Data integrity

"Review the application data model. Ensure each execution has a unique identifier, remediation records reference valid executions, and dashboard metrics are calculated from the underlying records. Identify any assumptions that require confirmation."

Iteration 3: UI quality

"Improve the visual hierarchy, spacing, typography, responsive behavior, table readability, and empty states. Preserve existing functionality and data relationships."

Iteration 4: Functional behavior

"Test search, filtering, sorting, record selection, form validation, and save operations. Fix broken interactions. Do not replace functional data operations with hardcoded sample results."

Iteration 5: Error handling

"Add appropriate handling for failed API requests, unavailable data, validation errors, empty results, and repeated submissions. Provide useful user-facing messages without exposing secrets or internal stack traces."

Iteration 6: Final verification

"Compare the application against the original requirements. List each requirement as implemented, partially implemented, or not implemented. Identify any feature that uses mock data or still needs external configuration."

This approach makes failures easier to isolate and reduces the risk of breaking working functionality during a large rewrite.

Technique 2: Specify behavior, not just appearance

A prompt such as:

"Add a modern search bar."

defines appearance, not behavior.

A better instruction is:

"Add a search field above the execution table. Search across ExecutionId and ApplicationName. Apply the search when the user submits or after a short debounce. Combine the search with existing status and date filters. Show an empty state when no records match. Provide a clear-search action and preserve the selected sort order."

The second instruction describes expected behavior, interaction, and edge cases.

Technique 3: Define invariants

An invariant is a condition that must remain true throughout the application.

Examples:

  • Every remediation record must reference an existing execution.
  • Execution IDs must be unique.
  • Failed executions must not be marked successful merely because a remediation note was added.
  • A user cannot approve their own request if the business policy prohibits it.
  • Dashboard metrics must use the same filtering rules as the displayed data.
  • Failed writes must not display a false success notification.

Add important invariants to the application specification and ask the builder to preserve them during modifications.

Technique 4: Request minimal changes

When fixing a specific problem, avoid asking the builder to regenerate the entire application.

Instead, use an instruction such as:

"Fix the execution table's date filter. Preserve the existing navigation, data model, styling, and other filters. Change only the logic needed to make the date filter work. Verify that it works independently and in combination with the status filter."

This helps reduce unintended changes and makes troubleshooting easier.

Technique 5: Ask for evidence of completion

Don't accept a statement that a feature is complete without testing it.

Ask:

"Identify the implementation for this requirement, test the relevant user journey in the preview, and report any remaining limitation. If the functionality depends on an unconfigured API or connector, identify that dependency explicitly."

Where the preview does not allow a test to be performed, request a clear statement of what remains unverified.

5. Underlying code: what to inspect

Copilot Studio's app authoring experience includes a way to switch between the interactive preview and the underlying code. 

Use that capability to inspect the implementation rather than treating the generated UI as a black box.

A. Component structure

Look for whether the application separates responsibilities into logical components, such as:

  • Navigation
  • Dashboard cards
  • Charts
  • Data tables
  • Search and filter controls
  • Detail views
  • Forms
  • Notifications
  • Loading and error states

A large application that puts everything into one component can become difficult to maintain.

Prompt:

"Review the application structure and identify opportunities to separate repeated UI patterns into reusable components. Refactor only where the current authoring environment supports it, and preserve the existing behavior."

B. State management

Check how the app manages:

  • Selected records
  • Active filters
  • Search terms
  • Form values
  • Loading states
  • API errors
  • Unsaved changes

For example, changing the status filter should not unexpectedly clear the search term or cause the selected record to display stale data.

Prompt:

"Review state management for the search, filter, table, and detail views. Prevent stale selections, inconsistent filters, and UI updates that occur before a save operation succeeds."

C. Data access

Identify whether each data source is:

  • Hardcoded sample data
  • Local application state
  • A configured connector
  • A REST API
  • A persistent business data source

For production applications, ensure the data access layer has clear responsibilities and that failures are handled consistently.

Prompt:

"Identify every data source used by the application. Classify each as sample data, local state, or a live integration. Do not imply that data is persisted if it exists only in memory."

D. Security

Inspect the implementation for:

  • Sensitive values embedded in client-side code
  • Authorization implemented only through UI visibility
  • Excessive data exposure
  • Missing validation
  • Unrestricted destructive operations
  • Unclear handling of user identity

Never place API secrets or privileged credentials in browser-accessible code.

For sensitive operations, authorization must be enforced by the relevant backend or data source, not just by the interface.

Important: Access to the app and access to its underlying data are separate concerns. Microsoft's documentation explains that apps use the signed-in user's identity when connecting to organizational data, and sharing an app does not automatically grant access to data the recipient otherwise cannot access. 

6. Connecting the app to enterprise systems

For a Microsoft enterprise scenario, you might need to connect the app to SharePoint, Dataverse, Microsoft Graph, Power Automate, or an internal API.

The appropriate integration depends on the operation and the capabilities supported by the app-building environment.

RequirementPossible integrationTechnical consideration
Store business recordsDataverseDefine tables, relationships, permissions, and validation
Read or update SharePoint itemsSharePoint connector or APIRespect site and item permissions
Retrieve Microsoft 365 informationMicrosoft GraphConfigure authentication, consent, and least-privilege permissions
Execute deterministic business logicPower Automate or an appropriate workflowHandle failures, retries, and duplicate requests
Integrate a custom enterprise systemREST API or supported connectorDefine authentication, schemas, and error contracts
Use agent reasoningCopilot Studio agentRestrict tools and define clear instructions

These are architecture options, not a claim that every integration is automatically configured by the app builder.

Recommended architecture

For an enterprise application, consider the following logical design:

User
↓
Copilot Studio app and UI
↓
Approved application actions
↓
Connector, workflow, or API
↓
Business data source

Where reasoning is required, the app can also invoke an appropriately configured agent.

Keep responsibilities separate:

  • UI: Collect input and display results.
  • Business logic: Enforce validation and business rules.
  • Agent: Handle tasks that benefit from reasoning.
  • Workflow: Execute predictable, repeatable steps.
  • Data source: Persist records and enforce applicable access controls.

For example, an AI-generated remediation recommendation can be presented in the UI, but changing a production system should require an authorized action and the appropriate validation.

7. App testing: use a structured checklist

Before publishing, test the main user journeys, not just the visual design.

Test categoryExample test
FunctionalCan the user create, view, and update a record?
ValidationDoes the app reject a missing required field?
Data integrityDoes a remediation reference the correct execution?
FilteringDo search and status filters work together?
Error handlingWhat happens when the API returns an error?
PersistenceDoes the update remain after refreshing or reopening the app?
AuthorizationCan an unauthorized user perform a restricted action?
AccessibilityAre controls labelled and keyboard-accessible?
Responsive designDoes the layout remain usable at narrower widths?
PerformanceDoes the interface remain responsive with realistic data volumes?
SecurityAre secrets excluded from client-side code?
Data integrity under failureDoes a failed write avoid displaying a false success message?

For each critical requirement, define an expected result and test it.

For an application that modifies business data, also test repeated submissions, concurrent updates, and partial failures where applicable.

8. Optimize Copilot Credits and iteration time

App creation, previewing, testing, and refinement can consume Copilot Credits. Microsoft documents usage-based billing for the app-building experience. 

These practices can help reduce unnecessary iterations.

  1. Write a complete specification first.
    Resolve critical questions about users, data, and business behavior before generation.
  2. Generate a minimum viable application.
    Start with the core pages and one complete user journey.
  3. Fix related problems together.
    Instead of making five separate requests for spacing, typography, card alignment, and table readability, group those visual changes into one clearly scoped request.
  4. Avoid unnecessary full rewrites.
    Ask for a targeted fix and explicitly preserve unrelated functionality.
  5. Separate requirements from optional enhancements.
    Finish the core user journey before adding animations, elaborate charts, and secondary features.
  6. Reuse a master specification.
    Keep the requirements, data model, and acceptance criteria in a reusable document so you don't need to reconstruct them for every iteration.
  7. Verify before requesting another change.
    Test the current result first. Otherwise, you may spend credits fixing an issue that no longer exists or introduce a new issue while fixing an old one.

These are practical optimization strategies, not a guarantee of a particular percentage reduction in credit consumption.

9. Publishing and sharing the application

Once the app has passed its tests:

  1. Review the final UI and application behavior.
  2. Confirm that sample data is clearly distinguished from live data.
  3. Verify configured connections and permissions.
  4. Test the intended user experience.
  5. Use the available publish action to publish the app.
  6. Share it with the intended users or groups.
  7. Verify access with an appropriately authorized test account.
  8. Document known limitations and outstanding integrations.

The preview status matters. Microsoft explicitly notes that Apps in Copilot Studio is a preview feature, which may have restricted functionality and is not intended for production use. Therefore, don't assume that a successful preview or publishing action alone makes the application suitable for production. Confirm the current feature terms, organizational approval, and production-readiness requirements before deploying it for business-critical use. 

My final recommendation

For your work with Copilot Studio, Power Platform, Cowork, MCP integrations, and enterprise automation, I would develop a reusable App Builder Playbook with five parts:

  1. A requirements template.
  2. A master app-generation prompt.
  3. A reusable set of UI and data-model refinement prompts.
  4. A testing and security checklist.
  5. A credit-optimization and publishing checklist.

That gives you a repeatable engineering process instead of relying on trial-and-error prompting for every new app.

The most important principle is this: use natural language to accelerate implementation, but use engineering discipline to verify the result.

No RepliesBe the first to reply