The agent to provision an identity for (AIAgent.ID).
OptionalConfigurationFree-form provider-specific provisioning hints (tenant id, OU, number region, …).
OptionalDisplayA human-friendly display name for the identity (e.g. the agent's name).
The kind of identity to provision. Email → a tenant calendar mailbox (the headline
invite/calendar method); PhoneNumber → a DID for inbound telephony; AccountID → a platform
account handle. Matches AIBridgeAgentIdentity.IdentityType.
The bridge provider the identity lives on (AIBridgeProvider.ID).
OptionalRequestedThe requested identity value when the caller already knows it (e.g. a desired mailbox address the admin pre-created). When omitted, the production provisioner allocates one (a mailbox in the tenant, a number from the carrier pool) and returns it.
A request to provision a tenant calendar/mailbox (or telephony) identity for an agent on a bridge provider — "give Sage a real
sage@customer.commailbox the customer's own directory."See
/plans/realtime/realtime-bridges-architecture.md§5 ("the agent as a first-class identity in the customer's tenant").