Skip to main content

Configuration

Once the package is deployed and the app is approved, GriMoire still needs runtime configuration in the web part property pane.

The current property pane exposes these fields:

  • Proxy URL
  • Proxy API Key
  • Backend API Resource
  • Backend Model
  • Environment ID

Web part property pane fields

Setting-by-setting guide​

Proxy URL​

The base backend API URL used by the web part to reach the Azure Functions proxy.

The backend deployment script prints it in the final summary:

  • Proxy URL: https://<function-app>.azurewebsites.net/api

Proxy API Key​

The shared key the web part sends to the backend to authenticate requests.

The backend deployment script prints it in the final summary as Proxy API Key.

Backend API Resource​

The Application ID URI for the Entra app registration that protects the backend's user data routes (/api/user/notes and /api/user/preferences) via Easy Auth.

The backend deployment script prints it in the final summary as Backend API URI. The format is api://<app-id>.

Backend Model​

The route selection used for text completions from the web part. The current options are:

  • Reasoning (recommended)
  • Fast (lightweight)

Both models are deployed by the deploy script. Reasoning is the primary model for chat and tool dispatch. The fast model is also used internally for intent classification, query expansion, sentiment analysis, and context compression — regardless of which backend model is selected here.

Environment ID​

The Agent 365 MCP servers are hosted behind a gateway scoped to a Power Platform environment. The Environment ID is the GUID used to construct the server URLs. Every Microsoft 365 tenant has a default Power Platform environment.

See Find your environment and organization IDs in the Microsoft documentation.

For a stable first run, use:

  • Proxy URL: the exact /api URL printed by backend deployment
  • Proxy API Key: the exact key printed by backend deployment
  • Backend API Resource: the api://<app-id> URI printed by backend deployment
  • Backend Model: Reasoning (recommended)
  • Environment ID: the default Power Platform environment GUID

Quick diagnostic checklist​

If GriMoire loads but feels partially broken, check these in order:

  1. Does the backend health URL respond?
  2. Is the Proxy URL using the /api form?
  3. Was the Proxy API Key copied correctly?
  4. Is Backend API Resource set to the api://<app-id> URI from deployment?
  5. Is Backend Model set to Reasoning?
  6. Is Environment ID a GUID, not a URL or name?
  7. Were the SharePoint API access requests approved?