ProjectsAgentsModelFactory Class

An agent implementing the A2A protocol.

An A2A tool stored in a toolbox.

Configuration specific to the A2A protocol.

An A2A tool stored in a toolbox.

Configuration specific to the activity protocol.

The AgentBlueprintReference. Please note this is the abstract base class. The derived classes available for instantiation are: ManagedAgentIdentityBlueprintReference.

The AgentCard.

The AgentCardSkill.

The AgentEndpointAuthorizationScheme. Please note this is the abstract base class. The derived classes available for instantiation are: BotServiceAuthorizationScheme, BotServiceRbacAuthorizationScheme, BotServiceTenantAuthorizationScheme, and EntraAuthorizationScheme.

The AgentEndpointConfiguration.

Multipart request body for creating a new code-based agent (POST /agents). Inherits from CreateAgentVersionFromCodeContent for future extensibility.

A managed runtime and agent loop used to execute a prompt agent. Please note this is the abstract base class. The derived classes available for instantiation are: GitHubCopilotHarness.

The AgentIdentity.

The AgentManifestOptions.

The AgentObjectVersions.

Aggregated evaluation result for a single candidate agent configuration across all tasks.

Evaluation criterion: a name + instruction pair used for per-item scoring.

Base discriminated model for dataset input. Either inline items or a registered reference. Please note this is the abstract base class. The derived classes available for instantiation are: AgentOptimizationInlineDatasetInput and AgentOptimizationReferenceDatasetInput.

A single item in an inline dataset.

Reference to a named evaluator, optionally pinned to a version.

Inline dataset — items supplied directly in the request body.

Caller-supplied inputs for an optimization job.

In-flight progress; only populated while status is queued or in_progress.

Terminal-state result body. Populated when status is succeeded or failed.

Tuning knobs and run-mode for an optimization job.

Reference to a registered Foundry dataset.

A skill resource.

JSON metadata for code-based agent operations (create, update, create version). The agent name comes from the URL path parameter or the x-ms-agent-name header, so it is not included in this model. The content hash (SHA-256 of the zip) is carried in the x-ms-code-zip-sha256 header.

The input definition information for an Azure AI search tool as used to configure an agent.

An Azure AI Search tool stored in a toolbox.

A AI Search Index resource.

A set of index resources used by the azure_ai_search tool.

The structure for keeping storage queue name and URI.

The definition of Azure function.

The AzureFunctionDefinitionFunction.

The structure for keeping storage queue name and URI.

The input definition information for an Azure Function Tool, as used to configure an Agent.

A bing custom search configuration.

The input definition information for a Bing custom search tool as used to configure an agent.

The bing custom search tool parameters.

Search configuration for Bing Grounding.

The bing grounding search tool parameters.

The input definition information for a bing grounding search tool as used to configure an agent.

The BotServiceAuthorizationScheme.

The BotServiceRbacAuthorizationScheme.

The BotServiceTenantAuthorizationScheme.

The input definition information for a Browser Automation Tool, as used to configure an Agent.

A browser automation tool stored in a toolbox.

Definition of input parameters for the connection used by the Browser Automation Tool.

Definition of input parameters for the Browser Automation Tool.

A tool for capturing structured outputs.

Code-based deployment configuration for a hosted agent.

A code interpreter tool stored in a toolbox.

Container-based deployment configuration for a hosted agent.

The ContainerSkill. Please note this is the abstract base class. The derived classes available for instantiation are: InlineSkillParam and SkillReferenceParam.

Configuration for Responsible AI (RAI) content filtering and safety features.

The CreateAgentVersionFromManifestRequest.

The request to create a Microsoft Teams Phone Extension binding.

The request to create a telephony binding. Please note this is the abstract base class. The derived classes available for instantiation are: CreateTeamsPhoneExtensionTelephonyBindingContent and CreateTwilioTelephonyBindingContent.

A request to create one durable direct outbound call job.

The request to create a Twilio binding.

The prompt agent definition.

The EntraAuthorizationScheme.

The external agent definition. Represents a third-party agent hosted outside Foundry (for example, on GCP or AWS). Registration is metadata-only: Foundry records the agent definition to light up observability experiences (traces, evaluations) over customer-emitted OpenTelemetry data.

The fabric data agent tool parameters.

A FabricIQ tool stored in a toolbox.

A file search tool stored in a toolbox.

The FixedRatioVersionSelectionRule.

The inputs for generating a voice agent. Only kind and name are always required. The authoring service expands these inputs into a full, editable VoiceAgentDefinition, which is then created through POST /agents. The generated instructions and audio/voice settings are stored as separate fields on the resulting agent definition, so the caller can edit or override any of them afterward via standard agent versioning.

The GitHub Copilot managed harness for prompt agents.

Header-based secret authentication for a telemetry endpoint. The resolved secret value is injected as an HTTP header.

The hosted agent definition.

The hosted agent definition.

The InlineSkillParam.

Inline skill payload.

Configuration specific to the invocations protocol.

Configuration specific to the WebSocket-based invocations protocol.

The ManagedAgentIdentityBlueprintReference.

Configuration specific to the MCP protocol.

An MCP tool stored in a toolbox.

A tool for integrating memories into the agent.

Memory search options.

The input definition information for a Microsoft Fabric tool as used to configure an agent.

Security details for OpenApi anonymous authentication.

authentication details for OpenApiFunctionDefinition Please note this is the abstract base class. The derived classes available for instantiation are: OpenAPIAnonymousAuthenticationDetails, OpenApiProjectConnectionAuthenticationDetails, and OpenAPIManagedAuthenticationDetails.

The input definition information for an openapi function.

The OpenAPIFunctionEntry.

Security details for OpenApi managed_identity authentication.

Security scheme for OpenApi managed_identity authentication.

Security details for OpenApi project connection authentication.

Security scheme for OpenApi managed_identity authentication.

The input definition information for an OpenAPI tool as used to configure an agent.

An OpenAPI tool stored in a toolbox.

Identifies the registered Foundry agent to optimize (request-only). Skills, tools, and system_prompt are specified in options.optimization_config.

An OTLP (OpenTelemetry Protocol) telemetry export endpoint.

The PatchAgentOptions.

An agent session providing a long-lived compute sandbox for hosted agent invocations.

The ProjectsAgentDefinition. Please note this is the abstract base class. The derived classes available for instantiation are: DeclarativeAgentDefinition, ExternalAgentDefinition, HostedAgentDefinition, VoiceAgentDefinition, and WorkflowAgentDefinition.

Creates a new instance of ProjectsAgentRecord for mocking.

A tool that can be used to generate a response. Please note this is the abstract base class. The derived classes available for instantiation are: Azure.AI.Projects.Agents.FabricIQPreviewTool, BingGroundingTool, MicrosoftFabricPreviewTool, SharepointPreviewTool, AzureAISearchTool, OpenAPITool, BingCustomSearchPreviewTool, BrowserAutomationPreviewTool, AzureFunctionTool, CaptureStructuredOutputsTool, A2APreviewTool, Azure.AI.Projects.Agents.A2ATool, Azure.AI.Projects.Agents.WorkIQPreviewTool, Azure.AI.Projects.Agents.WebIQPreviewTool, MemorySearchPreviewTool, OpenAI.ProgrammaticToolCallingParam, and Azure.AI.Projects.Agents.ToolSearchTool.

The ProjectsAgentVersion.

The ProjectsAgentVersionCreationOptions.

A web search configuration for bing custom search.

Promotion metadata recorded when a candidate is deployed to a Foundry agent.

Per-protocol configuration for the agent endpoint.

A record mapping for a single protocol and its version.

A PSTN destination for a telephony transfer target.

Declares where request/response text lives so content-safety guardrails can extract it.

An SSE event-type to text-field selector for streaming invocation output.

The RealtimeFunctionToolParameters.

A reminder tool stored in a toolbox.

Configuration specific to the responses protocol.

Session defaults applied to sessions created for a hosted agent version.

A single entry in a directory listing.

Response from uploading a file to a session sandbox.

A single Server-Sent Event frame emitted by the hosted agent session log stream. Each frame contains an event field identifying the event type and a data field carrying the payload as plain text. Although the current data payload is JSON-formatted, its schema is not contractual — additional keys may appear and the format may change over time. Clients should treat data as an opaque string and optionally attempt JSON parsing. New event types may be added in the future. Clients should gracefully ignore unrecognized event types. Wire format:

event: log
data: {"timestamp":"2026-03-10T09:33:17.121Z","stream":"stdout","message":"Starting server on port 18080"}
event: log
data: {"timestamp":"2026-03-10T09:34:52.714Z","stream":"status","message":"Successfully connected to container"}

The sharepoint grounding tool parameters.

The input definition information for a sharepoint tool as used to configure an agent.

A shell tool stored in a toolbox. This model is additive to toolbox configuration and does not modify the OpenAI tool contract or existing toolbox tool definitions.

A SIP destination for a telephony transfer target.

A deleted skill.

Inline content for defining a simple skill without uploading files. Follows the agentskills.io SKILL.md specification.

A reference to a versioned Foundry skill.

The SkillReferenceParam.

A specific version of a skill.

A deleted skill version.

An structured input that can participate in prompt template substitutions and tool argument binding.

A structured output that can be produced by the agent.

A Microsoft Teams Phone Extension binding owned by a voice agent.

A Microsoft Teams Phone Extension binding returned in a list, including its entity tag.

A Microsoft Teams destination for a telephony transfer target.

Customer-supplied telemetry configuration for exporting container logs, traces, and metrics.

A telemetry export endpoint configuration. Please note this is the abstract base class. The derived classes available for instantiation are: OtlpTelemetryEndpoint.

Authentication configuration for a telemetry endpoint. Please note this is the abstract base class. The derived classes available for instantiation are: HeaderTelemetryEndpointAuth.

A telephony binding owned by a voice agent. Please note this is the abstract base class. The derived classes available for instantiation are: TeamsPhoneExtensionTelephonyBinding and TwilioTelephonyBinding.

A telephony binding returned in a list, including its entity tag. Please note this is the abstract base class. The derived classes available for instantiation are: TeamsPhoneExtensionTelephonyBindingListItem and TwilioTelephonyBindingListItem.

A durable direct or campaign-created outbound call intent.

A cancellation request recorded for an outbound call job.

The optional execution window for a direct outbound call.

A bounded durable observation in the lifecycle of one telephony call.

Detailed diagnostics for a durable inbound call to a voice agent.

A summary of a durable inbound call to a voice agent.

Detailed provider-neutral timing for an inbound telephony call.

Correlation from a durable telephony call record to its customer-facing Foundry trace.

The destination of an outbound call.

The frozen fixed-interval retry policy returned for an outbound call or campaign.

The retry policy for one durable outbound call intent. max_attempts includes the first attempt. Strategy-specific settings are defined by the derived policy. Please note this is the abstract base class. The derived classes available for instantiation are: TelephonyOutboundFixedIntervalRetryPolicyResult.

A destination for a telephony transfer target. Please note this is the abstract base class. The derived classes available for instantiation are: PSTNTelephonyTransferDestination, SipTelephonyTransferDestination, and TeamsTelephonyTransferDestination.

A named destination to which the voice agent may transfer a call.

The telephony transfer targets configured for one voice agent.

Policy configuration for a toolbox, including content safety and other governance settings.

A toolbox that stores reusable tool definitions for agents.

A toolbox search tool stored in a toolbox.

An automatically provisioned container environment for a shell tool stored in a toolbox.

An existing container environment for a shell tool stored in a toolbox.

An execution environment for a shell tool stored in a toolbox. This environment model is scoped to toolbox configuration and does not modify the OpenAI shell environment contract. Please note this is the abstract base class. The derived classes available for instantiation are: ToolboxShellContainerAutoEnvironment and ToolboxShellContainerReferenceEnvironment.

Network access policy for an automatically provisioned toolbox shell container. Please note this is the abstract base class. The derived classes available for instantiation are: ToolboxShellNetworkPolicyDisabled.

A network policy that disables outbound access from a toolbox shell container.

A skill source included in a toolbox. Please note this is the abstract base class. The derived classes available for instantiation are: ToolboxSkillReference.

A reference to an existing skill to include in a toolbox.

An abstract representation of a tool stored in a toolbox. Please note this is the abstract base class. The derived classes available for instantiation are: A2APreviewToolboxTool, A2AToolboxTool, AzureAISearchToolboxTool, BrowserAutomationPreviewToolboxTool, CodeInterpreterToolboxTool, FabricIQPreviewToolboxTool, FileSearchToolboxTool, MCPToolboxTool, OpenApiToolboxTool, ReminderPreviewToolboxTool, ShellToolboxTool, ToolSearchToolboxTool, ToolboxSearchPreviewToolboxTool, WebIQPreviewToolboxTool, WebSearchToolboxTool, and WorkIQPreviewToolboxTool.

A specific version of a toolbox.

The versions associated with a toolbox.

A project connection resource.

A toolbox search tool stored in a toolbox.

A Twilio binding owned by a voice agent.

A Twilio binding returned in a list, including its entity tag.

The UpdateToolboxRequest.

Version indicator determining which agent version backs the session. Please note this is the abstract base class. The derived classes available for instantiation are: VersionRefIndicator.

Version indicator that references a specific agent version by name.

The VersionSelectionRule. Please note this is the abstract base class. The derived classes available for instantiation are: FixedRatioVersionSelectionRule.

The VersionSelector.

The audio configuration for a voice agent. These values are session defaults and may be overridden when connecting.

Input audio configuration for a voice agent.

Output audio configuration for a voice agent. Provider-specific fields are selected by voice_type:

• `openai`: `voice` and `speed`.
• `azure-standard`: `voice`, `voice_locale`, `speed`, `voice_temperature`, `custom_lexicon_url`,

• `azure-custom`: all `azure-standard` fields except `style`, plus `custom_voice_endpoint_id`.
• `azure-personal`: all `azure-standard` fields except `style`, plus `personal_voice_model`.
• `avatar-voice-sync`: all `azure-standard` fields except `voice` and `style`, plus `personal_voice_model`; the voice name is derived from the avatar.
• `azure-realtime-native`: `voice` and `speed`.

Avatar configuration for a voice agent. These values are session defaults and may be overridden when connecting.

Avatar placement and motion settings.

The avatar video background.

The rectangular crop applied to avatar video.

Avatar video encoder and presentation settings.

The avatar video resolution.

English-optimized Azure semantic voice activity detection.

Multilingual Azure semantic voice activity detection.

Azure semantic voice activity detection.

The voice agent definition. Its configuration (model, instructions, audio, tools, and optional avatar) drives a managed speech-to-speech experience. Establish realtime voice sessions through GET /agents/{agent_name}/endpoint/protocols/voice. Every create or update produces a new immutable version.

Server-side echo cancellation settings for input audio.

A service-managed control that ends the active conversation.

Semantic end-of-utterance detection configuration.

A native function tool executed by the client.

Session-start greeting configuration for a voice agent. Please note this is the abstract base class. The derived classes available for instantiation are: VoiceAgentLlmGeneratedGreetingConfig and VoiceAgentTemplateGreetingConfig.

Asynchronous input-audio transcription configuration. Extends the OpenAI Realtime transcription options with the Azure and MAI transcription models, custom speech models, and phrase hints.

Fields shared by interim-response configurations. Please note this is the abstract base class. The derived classes available for instantiation are: VoiceAgentLlmInterimResponseConfig and VoiceAgentStaticInterimResponseConfig.

A greeting authored by the session model from a scoped opening-turn prompt.

An interim response generated by a language model.

An MCP tool available to a voice agent.

Input audio noise reduction configuration.

OpenAI semantic VAD turn-detection settings.

Server-side voice activity detection.

A static interim response selected from configured text.

A sibling Foundry text agent that a voice agent may consult as a background specialist.

Configuration for sibling Foundry text agents that a voice agent may consult.

Policy for delivering responses while a voice agent waits for a subagent.

A service-managed control that acts on the active voice session without customer code or external authentication.

A deterministic greeting rendered with the voice agent's structured inputs and synthesized without model-authored generation.

A tool usable by a voice agent. Please note this is the abstract base class. The derived classes available for instantiation are: VoiceAgentFunctionTool, VoiceAgentMcpTool, VoiceAgentSystemTool, and VoiceAgentToolboxTool.

A reference to a Foundry toolbox, which is a versioned bundle of tools executed through its MCP endpoint.

Turn-detection configuration for a voice agent. Please note this is the abstract base class. The derived classes available for instantiation are: VoiceAgentAzureSemanticVadEnTurnDetection, VoiceAgentAzureSemanticVadMultilingualTurnDetection, VoiceAgentAzureSemanticVadTurnDetection, VoiceAgentSemanticVadTurnDetection, and VoiceAgentServerVadTurnDetection.

Metadata for a single conversation item's audio segment. For bring-your-own-storage (BYOS), the response includes blob_uri, a direct customer-storage URI without a SAS token, that the customer accesses with their own credentials. For Foundry-managed storage, blob_uri is absent and the bytes are streamed through the item's /audio/content route.

An engine that owns conversation handling for a voice agent. Please note this is the abstract base class. The derived classes available for instantiation are: VoiceHostedAgentConversationEngine.

Metadata for a conversation item's generated audio. For bring-your-own-storage (BYOS), the response includes blob_uri, a direct customer-storage URI without a SAS token, that the customer accesses with their own credentials. For Foundry-managed storage, blob_uri is absent and the bytes are streamed through the item's /audio/generated/content route.

A closed reference to the hosted text agent that owns conversation handling for a voice agent. The hosted agent is resolved within the same project and must support the invocations_ws protocol, Voice Live compatibility, and Bridge Protocol 1.0.

Metadata for the merged, whole-call stereo recording of a voice conversation (user audio on the left channel, agent audio on the right). Built once from the per-turn segments after the session ends and durably cached. The common metadata (format, sample rate, channels, channel layout, duration) is returned for both Foundry-managed and bring-your-own-storage (BYOS) recordings. For BYOS the response also includes blob_uri, the URI of the recording in the customer's own storage (no SAS token), which the customer downloads using their own storage credentials. For Foundry-managed storage blob_uri is absent and the bytes are streamed via the /audio/content route instead.

The role assigned to each channel of a merged stereo voice recording.

A persisted voice response representing one model inference turn within a conversation. In list results the output projection may be omitted; retrieve the full response (GET .../responses/{response_id}) or the paged response-items route (GET .../responses/{response_id}/items) for its output items. created_at/completed_at are Foundry durable ordering extensions.

Audio configuration for a response. Follows the OpenAI Realtime GA audio object shape.

The flat response audio-output projection, with optional voice, voice_type, voice_locale, and format fields.

Properties shared by persisted voice responses.

A WebIQ tool stored in a toolbox.

A web search tool stored in a toolbox.

The workflow agent definition. Microsoft Foundry is retiring workflows on December 1, 2026. If you're looking to build new workflows, use Microsoft Agent Framework. To migrate existing workflows, see the Migration guide.

A WorkIQ tool stored in a toolbox.