Skip to main content

ProPM Agent User Guide

Highly recommended reading

To successfully adopt ProPM Agent in the organization and fully leverage the application, it is strongly recommended to read this guide from the start of the project, then refer to it during deployment, connector setup, governance and daily operation.

This documentation describes only the functions observed in the application, in the code, in the deployment configuration and in the automated tests of ProPM Agent.

It is organized for two audiences:

  • Business users who work on a project;
  • Technical administrators who manage access, integrations, AI provider, subscription and supervision.

Overview of the application

I want to find the right page quickly

Observed situationFirst openThen
I cannot log inGetting startedMaintenance, support and FAQ to distinguish tenant, redirect URI, seat or health status
No projects appearGetting startedProjects and workspace, then Maintenance, support and FAQ if adding to the project or role remains doubtful
A page stays empty until an active project is definedGetting startedProjects and workspace to confirm project context, then Maintenance, support and FAQ if the empty state still seems abnormal
An action is visible but blockedGovernance, decisions and actionsConnectors and integrations, then Portfolio and technical administration if the block comes from a connector, a binding or an entitlement
The AI provider does not seem operationalPortfolio and technical administrationMaintenance, support and FAQ and Reports, AI Log and traceability to confirm the actual provider

If you are looking for a verification procedure or an operational reference, open Maintenance, support and FAQ.

If you’re looking for…Start here
Deploy a new instance in AzureAzure Marketplace deployment
Log in, verify authentication and create your first projectGetting started
Understand the interface, palette, notifications and healthInterface and navigation
Manage project context and workspace settingsProjects and workspace
Administer members, roles, delegations and project RBAC guardrailsAccess control and project roles
Import documents, search evidence and work with agentsKnowledge and agents
Read a structured output correctly, its evidence and freshnessStructured outputs, evidence and freshness
Handle signals, governance and actions requiring approvalGovernance, decisions and actions
Review an artifact, publish a PM Document and investigate in the AI LogReports, AI Log and traceability
Understand supported connectors and integrationsConnectors and integrations
Compare projects, manage integrations, AI and seatsPortfolio and technical administration
Consult support and verification proceduresMaintenance, support and FAQ
Clarify product termsGlossary

Quick path by profile

ProfilePages to open first
Business user / contributorGetting startedInterface and navigationProjects and workspaceKnowledge and agentsStructured outputs, evidence and freshness
Project ownerGetting startedProjects and workspaceAccess control and project rolesGovernance, decisions and actionsConnectors and integrationsReports, AI Log and traceability
Technical administratorAzure Marketplace deploymentGetting startedPortfolio and technical administrationConnectors and integrationsMaintenance, support and FAQ
Support / auditGetting startedStructured outputs, evidence and freshnessReports, AI Log and traceabilityGovernance, decisions and actionsGlossary

Short chain to remember: Active project → Agents → structured output → artifact / PM Doc → review / diff / lineage → Approve / Publish / Add to knowledge.

In real usage, the most frequent flow is:

  1. deploy or retrieve the published URL;
  2. log in with an authorized Microsoft Entra ID account;
  3. create or select an active project;
  4. let the project creator delegate the first useful roles;
  5. load the Knowledge of the project;
  6. launch an exchange in Agents;
  7. review the structured output, its evidence, freshness and confidence;
  8. transform the result into an artifact or a PM Document, then review before downloading DOCX / XLSX, publishing or adding to knowledge;
  9. handle proactive signals, Actions & approvals and, if needed, external integration flows;
  10. administer at the platform level only when the subject goes beyond the project.

Label convention

When the platform exposes a French translation, this documentation prefers this label:

  • Workspace;
  • Knowledge;
  • PM Documents;
  • AI Log;
  • Access control;
  • Governance policies;
  • Project integrations;
  • Platform integrations;
  • AI provider settings;
  • Actions & approvals.

When an English label is useful to remove ambiguity, it is cited occasionally in code, e.g. Trace ID or OpenAI-compatible.

What ProPM Agent covers

Based on verified behaviours, ProPM Agent organizes work around the project context:

  1. you open or create a project;
  2. you feed the Knowledge;
  3. you query the Agents;
  4. you review the structured outputs;
  5. you transform those results into PM Documents and artifacts;
  6. you verify traceability in the AI Log;
  7. you handle signals, digests, drafts and governed actions;
  8. you use connectors and integrations only when they are validated and bound to the project;
  9. administrators steer the technical layer in Platform Administration.

Observed functional architecture

DomainWhat it allows
DashboardSee overall status, metrics, points of attention and next steps
ProjectsCreate, open and remember project context
WorkspaceGroup project summary, operational transparency, signals, shortcuts and project settings
Access controlManage members, standard roles, custom roles and project permissions
KnowledgeSearch, upload, import, re‑read metadata and track ingestion history
AgentsChoose an agent, launch an exchange, use voice input in Agents if the environment still exposes it, and manage custom agents according to rights
Structured outputsRead summary, evidence, freshness, confidence, artifact proposals and next steps
PM Documents / Reports & artifactsReview, compare, approve, publish, download and reinject deliverables into knowledge
AI LogInspect runs, activity, technical IDs and AI runtime transparency
Connectors and integrationsSeparate platform definitions, project bindings, action policies and governed execution
Portfolio command centreCompare multiple projects with signals, weights, thresholds and saved cohorts
Platform AdministrationManage integrations, AI provider, subscription, seats and platform activity

What distinguishes the application

The following elements are explicitly visible in the interface, seeded data or tests:

  • structured outputs with sections, evidence, freshness, confidence and follow‑up decisions;
  • lineage between a run, a structured output, an artifact, an artifact version and a PM Document;
  • proactive signals for contradictions, freshness, blockages, follow‑ups and certain portfolio pressures;
  • governed documentary chain from an agent result to DOCX / XLSX downloads, publication and reinjection into knowledge;
  • governed connectors separated between Platform integrations, Project integrations and Actions & approvals;
  • AI runtime transparency with actual provider, provider selected at deployment and model family.

Audiences and responsibilities

ProfileMain needs
Project manager / PMOProject context, agents, deliverables, signals, governance and traceability
ContributorSearch in knowledge, generate content, review outputs and track runs
Project ownerProject settings, role delegation, document categories, project integrations and governance policies
Technical administrator / subscriptionDeployment, authentication, platform integrations, AI provider, subscription, seats and supervision

Screenshots and diagrams

Screenshots of the application were generated on the observed environment. When some available screenshots mainly showed a loading state or incomplete demo data, this French version also favours explanatory diagrams to keep a usable reading before final translation and publication.

Demo content can also vary by environment: some projects do not always expose the same seeded documents, seeded reports or examples shown in the documentation.

What stays local to the browser and what is shared

Two logics coexist in the product:

  • some convenience features, such as the remembered current project or saved chat continuity, stay local to the browser;
  • project data, documents, artifacts, approvals and publications belong to the shared platform.

A visible chat history in one browser should therefore not be treated as a central archive shared by all users.

Support and contact

Use the appropriate channel depending on the request type:

Request typePriority to forward
Technical supportDeployment URL, project in question, observed situation, approximate time, Trace ID if visible
Access, tenant or identity questionExpected tenant, account used, actual URL opened, Microsoft message or screenshot
Commercial or subscription questionAccount context, plan in question, number of seats or capacity need

All these requests can be sent to the following contact point:

Next