Språk

ProjectsAgentsModelFactory Class

Definition

A factory class for creating instances of the models for mocking.

public static class ProjectsAgentsModelFactory
type ProjectsAgentsModelFactory = class
Public Class ProjectsAgentsModelFactory
Inheritance
ProjectsAgentsModelFactory

Methods

Name Description
A2APreviewTool(Uri, String, String)

An agent implementing the A2A protocol.

A2APreviewToolboxTool(String, String, IDictionary<String,ToolConfig>, Uri, String, String, Nullable<Boolean>)

An A2A tool stored in a toolbox.

A2AProtocolConfiguration()

Configuration specific to the A2A protocol.

A2AToolboxTool(String, String, IDictionary<String,ToolConfig>, Uri, String, String, Nullable<Boolean>, A2AProtocolVersion)

An A2A tool stored in a toolbox.

ActivityProtocolConfiguration(Nullable<Boolean>, IEnumerable<ActivityProtocolAccessBoundary>)

Configuration specific to the activity protocol.

AgentBlueprintReference(String)

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

AgentCard(String, String, IEnumerable<AgentCardSkill>)

The AgentCard.

AgentCardSkill(String, String, String, IEnumerable<String>, IEnumerable<String>)

The AgentCardSkill.

AgentEndpointAuthorizationScheme(String)

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

AgentEndpointConfiguration(VersionSelector, ProtocolConfiguration, IEnumerable<AgentEndpointAuthorizationScheme>, Nullable<PublishApprovalStatus>)

The AgentEndpointConfiguration.

AgentFromCodeOptions(AgentVersionFromCodeMetadata, BinaryData)

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

AgentHarness(String)

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 and MicrosoftCopilotHarness.

AgentIdentity(String, String, Nullable<AgentIdentityStatus>)

The AgentIdentity.

AgentManifestOptions(IDictionary<String,String>, String, String, IDictionary<String,BinaryData>)

The AgentManifestOptions.

AgentObjectVersions(ProjectsAgentVersion)

The AgentObjectVersions.

AgentOptimizationAgentCandidateOutput(IEnumerable<AgentOptimizationMutation>)

Candidate output produced by an agent-optimization job.

AgentOptimizationBaselineAgentConfiguration(String, String, IEnumerable<AgentOptimizationSkill>, IEnumerable<ChatTool>)

Caller-supplied baseline agent values that cannot be resolved from the target agent.

AgentOptimizationCandidate(String, String, String, AgentOptimizationCandidateStatus, DateTimeOffset, AgentOptimizationCandidateOutput, String, String, AgentOptimizationCandidateEvaluation, AgentOptimizationCandidatePromotionInfo)

A candidate generated by an optimization job.

AgentOptimizationCandidateEvaluation(Nullable<Double>, Nullable<Double>, Nullable<TimeSpan>, String, String, Nullable<DateTimeOffset>)

Comparative evaluation summary for a candidate.

AgentOptimizationCandidateOutput(String)

Base candidate output. Job types define derived output models with their own fields. Please note this is the abstract base class. The derived classes available for instantiation are: AgentOptimizationAgentCandidateOutput and AgentOptimizationPromptCandidateOutput.

AgentOptimizationCandidatePromotionInfo(DateTimeOffset, AgentReference)

Promotion metadata recorded for a candidate.

AgentOptimizationCandidateSearchConfiguration(Nullable<Int32>)

Candidate search settings.

AgentOptimizationConfiguration(Nullable<AgentOptimizationGoal>, AgentOptimizationEvaluationConfiguration, AgentOptimizationCandidateSearchConfiguration, AgentOptimizationBaselineAgentConfiguration, AgentOptimizationSpace)

Configuration for optimizing an agent for measured quality.

AgentOptimizationConfigurationBase(String)

Base model for type-specific optimization configuration. Please note this is the abstract base class. The derived classes available for instantiation are: AgentOptimizationConfiguration and PromptOptimizationConfiguration.

AgentOptimizationCostEstimate(String, AgentOptimizationEstimateBand, AgentOptimizationStageEstimate, IEnumerable<AgentOptimizationStage>)

Estimated monetary cost. Present only when at least one contributing model has pricing data.

AgentOptimizationEstimateBand(Double, Double, Double)

A low/typical/ceiling range for an estimated quantity. Cost values apply average per-call usage assumptions to each call-count scenario. Expected values may be fractional, including estimated model-call counts.

AgentOptimizationEstimateInputs(AgentOptimizationTargetConfiguration, AgentOptimizationModelConfiguration, AgentOptimizationConfiguration)

Inputs for estimating an agent-optimization job.

AgentOptimizationEstimateResult(AgentOptimizationStageEstimate, AgentOptimizationCostEstimate, Nullable<DateTimeOffset>)

Result returned when estimating an agent-optimization job.

AgentOptimizationEvaluationConfiguration(AgentOptimizationEvaluationSet, AgentOptimizationEvaluationSet, IEnumerable<AgentOptimizationEvaluator>, EvaluationModelConfiguration, Nullable<Int32>)

Reusable quality-measurement configuration.

AgentOptimizationEvaluationSet(String)

Base discriminated model for an optimization evaluation set. Please note this is the abstract base class. The derived classes available for instantiation are: AgentOptimizationTargetCompletionEvaluationSet and AgentOptimizationUserConversationSimulationEvaluationSet.

AgentOptimizationEvaluator(String, String, IDictionary<String,BinaryData>)

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

AgentOptimizationFoundryAgentTargetConfiguration(String, String)

Identifies the Foundry agent that owns the configuration being optimized.

AgentOptimizationInstructionsMutation(String)

Instructions mutation.

AgentOptimizationJobLatency(AgentOptimizationStage, String, TimeSpan, Int64)

Average latency for one optimization stage and model.

AgentOptimizationJobResult(AgentOptimizationResultCandidateSummary, IEnumerable<AgentOptimizationJobTokenUsage>, IEnumerable<AgentOptimizationJobLatency>, Nullable<AgentOptimizationTerminationReason>)

Partial or terminal result produced by an agent optimization job.

AgentOptimizationJobTokenUsage(AgentOptimizationStage, String, Nullable<Int64>, Nullable<Int64>, Nullable<Int64>, Nullable<Int64>, Nullable<Int64>)

Aggregated token usage for one optimization stage and model.

AgentOptimizationModelConfiguration(String)

Identifies a model used by an optimization or evaluation step.

AgentOptimizationModelMutation(String)

Model mutation.

AgentOptimizationMutation(String)

Base candidate mutation. Please note this is the abstract base class. The derived classes available for instantiation are: AgentOptimizationInstructionsMutation, AgentOptimizationModelMutation, AgentOptimizationSkillsMutation, and AgentOptimizationToolsMutation.

AgentOptimizationPromptCandidateOutput(IEnumerable<AgentOptimizationMutation>)

Candidate output produced by a prompt-optimization job.

AgentOptimizationResultCandidateSummary(Int32, String, String, Nullable<Double>, Nullable<Double>, AgentOptimizationCandidatePromotionInfo)

Summary of candidates produced by an agent optimization job.

AgentOptimizationSkill(String, String, String)

A skill in the manually supplied agent optimization surface.

AgentOptimizationSkillsMutation(IEnumerable<AgentOptimizationSkill>)

Skill mutations.

AgentOptimizationSpace(IEnumerable<TargetAttribute>, IEnumerable<String>)

The agent attributes and alternative values available to an agent-optimization search.

AgentOptimizationStageEstimate(AgentOptimizationEstimateBand, AgentOptimizationEstimateBand, AgentOptimizationEstimateBand)

Estimated values grouped by optimization stage.

AgentOptimizationTargetCompletionDatasetReferenceDataSource(String, String)

References an explicitly versioned registered Foundry dataset for target-completion evaluation.

AgentOptimizationTargetCompletionDataSource(String)

Base source for a target-completion optimization evaluation set. Please note this is the abstract base class. The derived classes available for instantiation are: AgentOptimizationTargetCompletionDatasetReferenceDataSource and AgentOptimizationTargetCompletionInlineDataSource.

AgentOptimizationTargetCompletionEvaluationSet(AgentOptimizationTargetCompletionDataSource)

Evaluation set containing independent single-turn inputs.

AgentOptimizationTargetCompletionInlineDataSource(IEnumerable<AgentOptimizationTargetCompletionTestCase>)

Supplies single-turn rows directly in the optimization request.

AgentOptimizationTargetCompletionTestCase(String, String)

A single item in an inline evaluation set.

AgentOptimizationTargetConfiguration(String)

Base target configuration for an optimization job. Please note this is the abstract base class. The derived classes available for instantiation are: AgentOptimizationFoundryAgentTargetConfiguration.

AgentOptimizationToolsMutation(IEnumerable<ChatTool>)

Tool mutations.

AgentOptimizationUserConversationSimulationDatasetReferenceDataSource(String, String)

References an explicitly versioned registered Foundry dataset for user-conversation-simulation evaluation.

AgentOptimizationUserConversationSimulationDataSource(String)

Base source for a user-conversation-simulation optimization evaluation set. Please note this is the abstract base class. The derived classes available for instantiation are: AgentOptimizationUserConversationSimulationDatasetReferenceDataSource and AgentOptimizationUserConversationSimulationInlineDataSource.

AgentOptimizationUserConversationSimulationEvaluationSet(AgentOptimizationUserConversationSimulationDataSource, UserConversationSimulationConfiguration)

Evaluation set containing scenarios for simulated conversations.

AgentOptimizationUserConversationSimulationInlineDataSource(IEnumerable<UserConversationSimulationTestCase>)

Supplies Evals user-conversation simulation test cases directly in the optimization request.

AgentReference(String, String)

The AgentReference.

AgentsSkill(String, String, String, DateTimeOffset, String, String)

A skill resource.

AgentVersionFromCodeMetadata(String, IDictionary<String,String>, HostedAgentDefinition)

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.

AzureAISearchTool(AzureAISearchToolOptions)

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

AzureAISearchToolboxTool(String, String, IDictionary<String,ToolConfig>, AzureAISearchToolOptions)

An Azure AI Search tool stored in a toolbox.

AzureAISearchToolIndex(String, String, Nullable<AzureAISearchQueryType>, Nullable<Int32>, String, String)

A AI Search Index resource.

AzureAISearchToolOptions(IEnumerable<AzureAISearchToolIndex>)

A set of index resources used by the azure_ai_search tool.

AzureFunctionBinding(AzureFunctionStorageQueue)

The structure for keeping storage queue name and URI.

AzureFunctionDefinition(AzureFunctionDefinitionFunction, AzureFunctionBinding, AzureFunctionBinding)

The definition of Azure function.

AzureFunctionDefinitionFunction(String, String, BinaryData)

The AzureFunctionDefinitionFunction.

AzureFunctionStorageQueue(String, String)

The structure for keeping storage queue name and URI.

AzureFunctionTool(AzureFunctionDefinition)

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

BingCustomSearchConfiguration(String, String, String, String, Nullable<Int64>, String)

A bing custom search configuration.

BingCustomSearchPreviewTool(BingCustomSearchToolOptions)

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

BingCustomSearchToolOptions(IEnumerable<BingCustomSearchConfiguration>)

The bing custom search tool parameters.

BingGroundingSearchConfiguration(String, String, String, Nullable<Int64>, String)

Search configuration for Bing Grounding.

BingGroundingSearchToolOptions(IEnumerable<BingGroundingSearchConfiguration>)

The bing grounding search tool parameters.

BingGroundingTool(BingGroundingSearchToolOptions)

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

BotServiceAuthorizationScheme()

The BotServiceAuthorizationScheme.

BotServiceRbacAuthorizationScheme()

The BotServiceRbacAuthorizationScheme.

BotServiceTenantAuthorizationScheme()

The BotServiceTenantAuthorizationScheme.

BrowserAutomationPreviewTool(BrowserAutomationToolOptions)

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

BrowserAutomationPreviewToolboxTool(String, String, IDictionary<String,ToolConfig>, BrowserAutomationToolOptions)

A browser automation tool stored in a toolbox. BrowserAutomationPreviewToolboxTool is deprecated. Please use BrowserAutomationToolboxTool instead. See https://aka.ms/bat/docs for more information on Browser automation tool.

BrowserAutomationToolboxTool(String, String, IDictionary<String,ToolConfig>, BrowserAutomationToolOptions)

A browser automation tool stored in a toolbox.

BrowserAutomationToolConnectionParameters(String)

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

BrowserAutomationToolOptions(BrowserAutomationToolConnectionParameters)

Definition of input parameters for the Browser Automation Tool.

CaptureStructuredOutputsTool(StructuredOutputDefinition)

A tool for capturing structured outputs.

CodeConfiguration(String, IEnumerable<String>, CodeDependencyResolution, String)

Code-based deployment configuration for a hosted agent.

CodeInterpreterToolboxTool(String, String, IDictionary<String,ToolConfig>, IEnumerable<CallableToolAllowedCaller>, BinaryData)

A code interpreter tool stored in a toolbox.

ContainerConfiguration(String, String)

Container-based deployment configuration for a hosted agent.

ContainerSkill(String)

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

ContentFilterConfiguration(String, RaiInvocationModeration)

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

CreateAgentVersionFromManifestRequest(IDictionary<String,String>, String, String, IDictionary<String,BinaryData>)

The CreateAgentVersionFromManifestRequest.

CreateTeamsPhoneExtensibilityTelephonyBindingContent(String, String, String, String)

The request to create a Microsoft Teams Phone extensibility binding.

CreateTelephonyBindingContent(String, String, String)

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

CreateTelephonyCallJobContent(TelephonyOutboundDestination, String, String, String, IDictionary<String,BinaryData>, TelephonyCallJobSchedule, TelephonyOutboundRetryPolicy)

A request to create one durable direct outbound call job.

CreateTwilioTelephonyBindingContent(String, String, String)

The request to create a Twilio binding.

DeclarativeAgentDefinition(ContentFilterConfiguration, AgentHarness, String, String, IEnumerable<SkillReference>, Nullable<Single>, Nullable<Single>, ResponseReasoningOptions, IEnumerable<ResponseTool>, BinaryData, ResponseTextOptions, IDictionary<String,StructuredInputDefinition>)

The prompt agent definition.

EntraAuthorizationScheme()

The EntraAuthorizationScheme.

EvaluationAzureStandardVoiceModelConfiguration(String, Nullable<Single>)

Configures an Azure standard neural voice used to convert text to speech for evaluation through the Voice Live endpoint.

EvaluationModelConfiguration(String, ModelSamplingParams, EvaluationVoiceModelConfiguration)

Configures the model that plays the simulated user. This model is separate from the evaluated target.

EvaluationVoiceModelConfiguration(String)

Voice configuration used to convert text to speech for evaluation through the Voice Live endpoint. Please note this is the abstract base class. The derived classes available for instantiation are: EvaluationAzureStandardVoiceModelConfiguration.

ExternalAgentDefinition(ContentFilterConfiguration, String)

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.

FabricDataAgentToolOptions(IEnumerable<ToolProjectConnection>)

The fabric data agent tool parameters.

FabricIQPreviewToolboxTool(String, String, IDictionary<String,ToolConfig>, String, String, Uri, BinaryData)

A FabricIQ tool stored in a toolbox.

FileSearchToolboxTool(String, String, IDictionary<String,ToolConfig>, Nullable<Int64>, Object, BinaryData, IEnumerable<String>)

A file search tool stored in a toolbox.

FixedRatioVersionSelectionRule(String, Int32)

The FixedRatioVersionSelectionRule.

GenerateVoiceAgentRequest(String, Nullable<VoiceModelType>, String, String, String, String, IEnumerable<VoiceAgentTool>, Nullable<Boolean>)

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.

GitHubCopilotHarness()

The legacy GitHub Copilot managed harness retained for compatibility. Use MicrosoftCopilotHarness for new prompt agents.

HeaderTelemetryEndpointAuth(String, String, String)

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

HostedAgentDefinition(ContentFilterConfiguration, IEnumerable<ProjectsAgentTool>, IEnumerable<ProtocolVersionRecord>, String, String, IDictionary<String, String>, String)

The hosted agent definition.

HostedAgentDefinition(ContentFilterConfiguration, String, String, IDictionary<String,String>, ContainerConfiguration, IEnumerable<ProtocolVersionRecord>, CodeConfiguration, TelemetryConfig, SessionConfiguration, Nullable<Boolean>)

The hosted agent definition.

InlineSkillParam(String, String, InlineSkillSourceParam)

The InlineSkillParam.

InlineSkillSourceParam(String)

Inline skill payload.

InvocationsProtocolConfiguration()

Configuration specific to the invocations protocol.

InvocationsWsProtocolConfiguration()

Configuration specific to the WebSocket-based invocations protocol.

ManagedAgentIdentityBlueprintReference(String)

The ManagedAgentIdentityBlueprintReference.

McpProtocolConfiguration()

Configuration specific to the MCP protocol.

MCPToolboxTool(String, String, IDictionary<String,ToolConfig>, String, Uri, Nullable<McpToolConnectorId>, String, String, String, IDictionary<String,String>, McpToolFilter, IEnumerable<CallableToolAllowedCaller>, BinaryData, Nullable<Boolean>, String)

An MCP tool stored in a toolbox.

MemorySearchPreviewTool(String, String, MemorySearchToolOptions, Nullable<Int32>)

A tool for integrating memories into the agent.

MemorySearchToolOptions(Nullable<Int32>)

Memory search options.

MicrosoftCopilotHarness()

The Microsoft Copilot managed harness for prompt agents.

MicrosoftFabricPreviewTool(FabricDataAgentToolOptions)

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

ModelSamplingParams(Nullable<Single>, Nullable<Single>, Nullable<Int32>, Nullable<Int32>)

Represents a set of parameters used to control the sampling behavior of a language model during text generation.

OpenAPIAnonymousAuthenticationDetails()

Security details for OpenApi anonymous authentication.

OpenApiAuthenticationDetails(String)

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

OpenApiFunctionDefinition(String, String, IDictionary<String, BinaryData>, OpenApiAuthenticationDetails, IEnumerable<String>, IEnumerable<OpenAPIFunctionEntry>)

The input definition information for an openapi function.

OpenAPIFunctionEntry(String, String, IDictionary<String,BinaryData>)

The OpenAPIFunctionEntry.

OpenAPIManagedAuthenticationDetails(OpenAPIManagedSecurityScheme)

Security details for OpenApi managed_identity authentication.

OpenAPIManagedSecurityScheme(String)

Security scheme for OpenApi managed_identity authentication.

OpenApiProjectConnectionAuthenticationDetails(OpenApiProjectConnectionSecurityScheme)

Security details for OpenApi project connection authentication.

OpenApiProjectConnectionSecurityScheme(String)

Security scheme for OpenApi managed_identity authentication.

OpenAPITool(OpenApiFunctionDefinition)

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

OpenApiToolboxTool(String, String, IDictionary<String,ToolConfig>, OpenApiFunctionDefinition)

An OpenAPI tool stored in a toolbox.

OptimizationContext(String)

Base model for typed optimization context. Please note this is the abstract base class. The derived classes available for instantiation are: SteeringPromptOptimizationContext.

OtlpTelemetryEndpoint(IEnumerable<ExportedDataTypes>, TelemetryEndpointAuthentication, Uri, TelemetryTransportProtocol)

An OTLP (OpenTelemetry Protocol) telemetry export endpoint.

PatchAgentOptions(AgentEndpointConfiguration, AgentCard)

The PatchAgentOptions.

ProjectAgentSession(String, VersionIndicator, AgentSessionStatus, DateTimeOffset, DateTimeOffset, DateTimeOffset, Nullable<DateTimeOffset>)

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

ProjectsAgentDefinition(String, ContentFilterConfiguration)

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

ProjectsAgentRecord(String, String, AgentState)

Creates a new instance of ProjectsAgentRecord for mocking.

ProjectsAgentTool(String)

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.

ProjectsAgentVersion(IDictionary<String,String>, String, String, String, String, DateTimeOffset, ProjectsAgentDefinition, Nullable<Boolean>, Nullable<AgentVersionStatus>, AgentIdentity, AgentIdentity, AgentBlueprintReference, String)

The ProjectsAgentVersion.

ProjectsAgentVersionCreationOptions(IDictionary<String,String>, String, ProjectsAgentDefinition, AgentBlueprintReference, Nullable<DigitalWorkerType>, Nullable<Boolean>)

The ProjectsAgentVersionCreationOptions.

ProjectWebSearchConfiguration(String, String)

A web search configuration for bing custom search.

PromptOptimizationConfiguration(IEnumerable<OptimizationContext>)

Configuration for a one-shot prompt transformation without comparative evaluation.

ProtocolConfiguration(ActivityProtocolConfiguration, ResponsesProtocolConfiguration, A2AProtocolConfiguration, McpProtocolConfiguration, InvocationsProtocolConfiguration, InvocationsWsProtocolConfiguration)

Per-protocol configuration for the agent endpoint.

ProtocolVersionRecord(ProjectsAgentProtocol, String)

A record mapping for a single protocol and its version.

PSTNTelephonyTransferDestination(String)

A PSTN destination for a telephony transfer target.

RaiInvocationModeration(Nullable<RaiInvocationContentType>, Nullable<RaiInvocationContentType>, RaiInvocationMode, IEnumerable<String>, IEnumerable<String>, IEnumerable<RaiSseTextSelector>)

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

RaiSseTextSelector(String, String)

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

RealtimeFunctionToolParameters()

The RealtimeFunctionToolParameters.

ReminderPreviewToolboxTool(String, String, IDictionary<String,ToolConfig>)

A reminder tool stored in a toolbox.

ResponsesProtocolConfiguration()

Configuration specific to the responses protocol.

SessionConfiguration(Nullable<TimeSpan>)

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

SessionDirectoryEntry(String, Int64, Boolean, DateTimeOffset)

A single entry in a directory listing.

SessionFileWriteResult(String, Int64)

Response from uploading a file to a session sandbox.

SessionLogEvent(SessionLogEventKind, String)

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"}
SharePointGroundingToolOptions(IEnumerable<ToolProjectConnection>)

The sharepoint grounding tool parameters.

SharepointPreviewTool(SharePointGroundingToolOptions)

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

ShellToolboxTool(String, String, IDictionary<String,ToolConfig>, IEnumerable<CallableToolAllowedCaller>, ToolboxShellEnvironment)

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.

SipTelephonyTransferDestination(Uri)

A SIP destination for a telephony transfer target.

SkillDeletionResult(String, String, Boolean)

A deleted skill.

SkillInlineContent(String, String, String, String, IDictionary<String,String>, IEnumerable<String>)

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

SkillReference(String, String)

A reference to a versioned Foundry skill.

SkillReferenceParam(String, String)

The SkillReferenceParam.

SkillVersion(String, String, String, String, String, DateTimeOffset)

A specific version of a skill.

SkillVersionDeletionResult(String, String, Boolean, String)

A deleted skill version.

SteeringPromptOptimizationContext(String)

Natural-language guidance for the desired optimization.

StructuredInputDefinition(String, BinaryData, IDictionary<String,BinaryData>, Nullable<Boolean>)

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

StructuredOutputDefinition(String, String, IDictionary<String,BinaryData>, Nullable<Boolean>)

A structured output that can be produced by the agent.

TeamsPhoneExtensibilityTelephonyBinding(String, String, String, TelephonyBindingStatus, Uri, String, String)

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

TeamsPhoneExtensibilityTelephonyBindingListItem(String, String, String, TelephonyBindingStatus, Uri, String, String, String)

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

TeamsTelephonyTransferDestination(String)

A Microsoft Teams destination for a telephony transfer target.

TelemetryConfig(IEnumerable<TelemetryEndpoint>)

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

TelemetryEndpoint(String, IEnumerable<ExportedDataTypes>, TelemetryEndpointAuthentication)

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

TelemetryEndpointAuthentication(String)

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

TelephonyBinding(String, String, String, String, TelephonyBindingStatus, Uri)

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

TelephonyBindingListItem(String, String, String, String, TelephonyBindingStatus, Uri, String)

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: TeamsPhoneExtensibilityTelephonyBindingListItem and TwilioTelephonyBindingListItem.

TelephonyCallJob(TelephonyOutboundDestination, String, String, String, IDictionary<String,BinaryData>, TelephonyCallJobSchedule, String, String, TelephonyCallJobStatus, TelephonyCallJobCancellation, TelephonyOutboundRetryPolicy, Int32, Nullable<DateTimeOffset>, Nullable<TelephonyCallJobTerminalReason>, Int64, DateTimeOffset, DateTimeOffset)

A durable direct or campaign-created outbound call intent.

TelephonyCallJobCancellation(String, String, DateTimeOffset, Int64)

A cancellation request recorded for an outbound call job.

TelephonyCallJobSchedule(Nullable<DateTimeOffset>, Nullable<DateTimeOffset>)

The optional execution window for a direct outbound call.

TelephonyCallLifecycleEvent(Int64, TelephonyCallLifecycleEventName, TelephonyCallLifecycleEventSource, TelephonyCallLifecycleEventOutcome, DateTimeOffset, Nullable<DateTimeOffset>, TelephonyCallTimestampSource, Nullable<TelephonyCallLifecycleEventReason>, String, Nullable<Int64>, Nullable<Int32>, Nullable<Int32>)

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

TelephonyCallRecord(String, TelephonyProvider, String, String, String, TelephonyCallStatus, TelephonyCallPhase, DateTimeOffset, Nullable<DateTimeOffset>, Nullable<DateTimeOffset>, Nullable<DateTimeOffset>, Nullable<DateTimeOffset>, Nullable<TimeSpan>, Nullable<TelephonyCallEndReason>, Nullable<Int32>, Nullable<Int32>, String, TelephonyCallTiming, TelephonyCallTrace, IEnumerable<TelephonyCallLifecycleEvent>, Boolean)

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

TelephonyCallSummary(String, TelephonyProvider, String, String, String, TelephonyCallStatus, TelephonyCallPhase, DateTimeOffset, Nullable<DateTimeOffset>, Nullable<DateTimeOffset>, Nullable<DateTimeOffset>, Nullable<DateTimeOffset>, Nullable<TimeSpan>, Nullable<TelephonyCallEndReason>, Nullable<Int32>, Nullable<Int32>, String)

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

TelephonyCallTiming(Nullable<DateTimeOffset>, Nullable<DateTimeOffset>, Nullable<DateTimeOffset>, Nullable<DateTimeOffset>, Nullable<DateTimeOffset>, Nullable<DateTimeOffset>, Nullable<DateTimeOffset>, Nullable<DateTimeOffset>, Nullable<DateTimeOffset>, Nullable<DateTimeOffset>, Nullable<TelephonyCallDurationBasis>, TelephonyCallTimestampSource)

Detailed provider-neutral timing for an inbound telephony call.

TelephonyCallTrace(TelephonyCallTraceStatus, String, String, String, Nullable<TelephonyCallTraceMode>)

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

TelephonyOutboundDestination(TelephonyOutboundDestinationType, String)

The destination of an outbound call.

TelephonyOutboundFixedIntervalRetryPolicyResult(Nullable<Int32>, TimeSpan)

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

TelephonyOutboundRetryPolicy(String, Nullable<Int32>)

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.

TelephonyTransferDestination(String)

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.

TelephonyTransferTarget(String, String, TelephonyTransferDestination)

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

TelephonyTransferTargets(IEnumerable<TelephonyTransferTarget>)

The telephony transfer targets configured for one voice agent.

ToolboxPolicies(ContentFilterConfiguration)

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

ToolboxRecord(String, String, DateTimeOffset, ToolboxVersions, String)

A toolbox that stores reusable tool definitions for agents.

ToolboxSearchPreviewToolboxTool(String, String, IDictionary<String,ToolConfig>)

A toolbox search tool stored in a toolbox.

ToolboxShellContainerAutoEnvironment(IEnumerable<String>, Nullable<ContainerMemoryLimit>, IEnumerable<ContainerSkill>, ToolboxShellNetworkPolicy)

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

ToolboxShellContainerReferenceEnvironment(String)

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

ToolboxShellEnvironment(String)

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.

ToolboxShellNetworkPolicy(String)

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.

ToolboxShellNetworkPolicyDisabled()

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

ToolboxSkill(String)

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

ToolboxSkillReference(String, String)

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

ToolboxTool(String, String, String, IDictionary<String,ToolConfig>)

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, Azure.AI.Projects.Agents.BrowserAutomationPreviewToolboxTool, BrowserAutomationToolboxTool, CodeInterpreterToolboxTool, FabricIQPreviewToolboxTool, FileSearchToolboxTool, MCPToolboxTool, OpenApiToolboxTool, ReminderPreviewToolboxTool, ShellToolboxTool, ToolSearchToolboxTool, ToolboxSearchPreviewToolboxTool, WebIQPreviewToolboxTool, WebSearchToolboxTool, and WorkIQPreviewToolboxTool.

ToolboxVersion(IDictionary<String,String>, String, String, String, String, DateTimeOffset, IEnumerable<ToolboxTool>, IEnumerable<ToolboxSkill>, ToolboxPolicies)

A specific version of a toolbox.

ToolboxVersions(ToolboxVersion)

The versions associated with a toolbox.

ToolProjectConnection(String)

A project connection resource.

ToolSearchToolboxTool(String, String, IDictionary<String,ToolConfig>)

A toolbox search tool stored in a toolbox.

TwilioTelephonyBinding(String, String, String, TelephonyBindingStatus, Uri, String)

A Twilio binding owned by a voice agent.

TwilioTelephonyBindingListItem(String, String, String, TelephonyBindingStatus, Uri, String, String)

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

UpdateToolboxRequest(String, String)

The UpdateToolboxRequest.

UserConversationSimulationAudioEffectsConfiguration(IEnumerable<UserConversationSimulationAudioEffect>, Nullable<Int32>)

Configures effects applied to simulated conversation audio.

UserConversationSimulationConfiguration(Nullable<Int32>, Nullable<Int32>, Nullable<Int32>, UserConversationSimulationAudioEffectsConfiguration, UserConversationSimulationUserBehaviorConfiguration)

Configures the number, length, audio effects, and simulated user behavior of conversations.

UserConversationSimulationDefaultInterruptionConfiguration()

Configures the default interruption behavior for the simulated user.

UserConversationSimulationInterruptionConfiguration(String)

Configuration for simulated user interruption behavior. Please note this is the abstract base class. The derived classes available for instantiation are: UserConversationSimulationDefaultInterruptionConfiguration.

UserConversationSimulationTestCase(String, String, String, UserConversationSimulationConfiguration)

Defines one test scenario. Simulation configuration properties specified here override the corresponding data-source defaults.

UserConversationSimulationUserBehaviorConfiguration(UserConversationSimulationInterruptionConfiguration)

Configures conversation behavior for the simulated user.

VersionIndicator(String)

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.

VersionRefIndicator(String)

Version indicator that references a specific agent version by name.

VersionSelectionRule(String, String)

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

VersionSelector(IEnumerable<VersionSelectionRule>)

The VersionSelector.

VoiceAgentAudioConfig(VoiceAgentAudioInputConfig, VoiceAgentAudioOutputConfig)

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

VoiceAgentAudioInputConfig(RealtimeAudioFormat, VoiceAgentNoiseReduction, VoiceAgentTurnDetectionConfig, VoiceAgentEchoCancellation, VoiceAgentInputTranscription)

Input audio configuration for a voice agent.

VoiceAgentAudioOutputConfig(RealtimeAudioFormat, String, Nullable<VoiceType>, String, Nullable<Single>, Nullable<Single>, Uri, Uri, IEnumerable<String>, String, String, String, String, String, IEnumerable<VoiceAgentAudioTimestampType>)

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`,
`custom_text_normalization_url`, `prefer_locales`, `style`, `pitch`, and `volume`.
  • `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`.
`format` and `output_audio_timestamp_types` apply to every voice type.
VoiceAgentAvatarConfig(VoiceAgentAvatarType, String, String, Nullable<Boolean>, Nullable<VoiceAgentAvatarOutputProtocol>, String, VoiceAgentAvatarVideoParams, VoiceAgentAvatarScene, Nullable<Boolean>)

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

VoiceAgentAvatarScene(Nullable<Single>, Nullable<Single>, Nullable<Single>, Nullable<Single>, Nullable<Single>, Nullable<Single>, Nullable<Single>)

Avatar placement and motion settings.

VoiceAgentAvatarVideoBackground(Uri, String)

The avatar video background.

VoiceAgentAvatarVideoCrop(IEnumerable<UInt32>, IEnumerable<UInt32>)

The rectangular crop applied to avatar video.

VoiceAgentAvatarVideoParams(Nullable<Int32>, VoiceAgentAvatarVideoCrop, VoiceAgentAvatarVideoResolution, VoiceAgentAvatarVideoBackground, Nullable<Int32>)

Avatar video encoder and presentation settings.

VoiceAgentAvatarVideoResolution(Int32, Int32)

The avatar video resolution.

VoiceAgentAzureSemanticVadEnTurnDetection(Nullable<Boolean>, Nullable<Single>, Nullable<TimeSpan>, Nullable<TimeSpan>, Nullable<TimeSpan>, VoiceAgentEndOfUtteranceDetection, Nullable<TimeSpan>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>)

English-optimized Azure semantic voice activity detection.

VoiceAgentAzureSemanticVadMultilingualTurnDetection(Nullable<Boolean>, Nullable<Single>, Nullable<TimeSpan>, Nullable<TimeSpan>, Nullable<TimeSpan>, VoiceAgentEndOfUtteranceDetection, Nullable<TimeSpan>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, IEnumerable<String>)

Multilingual Azure semantic voice activity detection.

VoiceAgentAzureSemanticVadTurnDetection(Nullable<Boolean>, Nullable<Single>, Nullable<TimeSpan>, Nullable<TimeSpan>, Nullable<TimeSpan>, VoiceAgentEndOfUtteranceDetection, Nullable<TimeSpan>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, IEnumerable<String>)

Azure semantic voice activity detection.

VoiceAgentDefinition(ContentFilterConfiguration, Nullable<VoiceModelType>, String, VoiceConversationEngine, String, VoiceAgentGreetingConfig, VoiceAgentAudioConfig, VoiceAgentSoundscapeConfig, IEnumerable<VoiceOutputModality>, BinaryData, IEnumerable<VoiceAgentSessionIncludeOption>, VoiceAgentInterimResponseConfig, VoiceAgentAvatarConfig, IEnumerable<VoiceAgentTool>, BinaryData, Nullable<Boolean>, IDictionary<String,StructuredInputDefinition>, VoiceAgentSubagentConfig, VoiceAgentPostCallConfig, Nullable<Boolean>)

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.

VoiceAgentEchoCancellation(Nullable<VoiceAgentEchoCancellationReferenceSource>, Nullable<Int32>)

Server-side echo cancellation settings for input audio.

VoiceAgentEndConversationSystemTool(String)

A service-managed control that ends the active conversation.

VoiceAgentEndOfUtteranceDetection(VoiceAgentEndOfUtteranceDetectionModel, Nullable<VoiceAgentEndOfUtteranceThresholdLevel>, Nullable<TimeSpan>)

Semantic end-of-utterance detection configuration.

VoiceAgentEventGridPostCallDestination(String)

An Event Grid connection that receives post-call events.

VoiceAgentFunctionTool(String, RealtimeFunctionToolParameters, String)

A native function tool executed by the client.

VoiceAgentGreetingConfig(String)

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.

VoiceAgentInputTranscription(String, IEnumerable<String>, IEnumerable<String>, String, Nullable<VoiceAgentAudioInputConfigTranscriptionDelay>, VoiceAgentInputTranscriptionModel, IDictionary<String,String>, IEnumerable<String>, Nullable<VoiceAgentProfanityFilterMode>)

Settings for transcribing input audio, including the transcription model, Custom Speech deployments, and phrase hints. When model is azure-speech-streaming, transcription is supported for cascaded text-model conversations only (not realtime speech-to-speech models), requires a nonempty language such as en-US (comma-separated locales are supported), and supports custom_speech, phrase_list, and profanity_filter.

VoiceAgentInterimResponseConfig(String, IEnumerable<VoiceAgentInterimResponseTrigger>, Nullable<TimeSpan>)

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

VoiceAgentLlmGeneratedGreetingConfig(String, BinaryData)

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

VoiceAgentLlmInterimResponseConfig(IEnumerable<VoiceAgentInterimResponseTrigger>, Nullable<TimeSpan>, String, String, Nullable<Int32>)

An interim response generated by a language model.

VoiceAgentMcpTool(String, Uri, String, String, IDictionary<String, String>, McpToolFilter, IEnumerable<CallableToolAllowedCaller>, BinaryData, Nullable<Boolean>, String, IDictionary<String,ToolConfig>, Nullable<VoiceAgentToolResponseScheduling>)

An MCP tool available to a voice agent. Server endpoints use server_url; connector and tunnel identifiers are not supported.

VoiceAgentNoiseReduction(VoiceAgentNoiseReductionType)

Input audio noise reduction configuration. azure_deep_noise_suppression_headset and azure_personal_noise_suppression are modes for local voice activity detection that enhance detection audio without changing the audio used for recognition.

VoiceAgentPostCallConfig(IEnumerable<VoiceAgentPostCallDestination>, IEnumerable<VoiceAgentPostCallIncludeOption>)

Post-call delivery configuration.

VoiceAgentPostCallDestination(String)

A post-call destination. Please note this is the abstract base class. The derived classes available for instantiation are: VoiceAgentEventGridPostCallDestination and VoiceAgentRoutinePostCallDestination.

VoiceAgentRoutinePostCallDestination(String)

A routine that is dispatched with the post-call event.

VoiceAgentSemanticVadTurnDetection(Nullable<Boolean>, Nullable<RealtimeSemanticVadEagernessLevel>, Nullable<Boolean>, Nullable<Boolean>)

OpenAI semantic VAD turn-detection settings.

VoiceAgentServerVadTurnDetection(Nullable<Boolean>, Nullable<Double>, Nullable<Int64>, Nullable<Int64>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Int64>, Nullable<TimeSpan>, VoiceAgentEndOfUtteranceDetection)

Server-side voice activity detection.

VoiceAgentSoundscapeConfig(VoiceAgentSoundscapeTrackConfig, VoiceAgentSoundscapeWorkingTrackConfig, VoiceAgentSoundscapeTrackConfig, VoiceAgentSoundscapeTrackConfig, VoiceAgentSoundscapeTrackConfig)

Agent-owned background ambience and event cues. Each omitted track is disabled. The service rejects unknown fields; custom uploads, URLs, and inline audio are not supported.

VoiceAgentSoundscapeSourceConfig(VoiceAgentSoundscapeSound)

A packaged sound selected from the service-managed catalogue. The service rejects unknown source fields and discriminator values.

VoiceAgentSoundscapeTrackConfig(VoiceAgentSoundscapeSourceConfig, Nullable<Double>)

A soundscape track with its own audio source and playback volume.

VoiceAgentSoundscapeWorkingTrackConfig(VoiceAgentSoundscapeSourceConfig, Nullable<Double>, Nullable<TimeSpan>)

A working-loop track with a delay measured from the first pending non-call-control tool.

VoiceAgentStaticInterimResponseConfig(IEnumerable<VoiceAgentInterimResponseTrigger>, Nullable<TimeSpan>, IEnumerable<String>)

A static interim response selected from configured text.

VoiceAgentSubagent(String, String, String, VoiceAgentSubagentResponsePolicy, Nullable<TimeSpan>)

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

VoiceAgentSubagentConfig(IEnumerable<VoiceAgentSubagent>)

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

VoiceAgentSubagentResponsePolicy(Nullable<Boolean>, Nullable<TimeSpan>, String, String, Nullable<Boolean>, String, Nullable<TimeSpan>)

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

VoiceAgentSystemTool(String)

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

VoiceAgentTemplateGreetingConfig(String)

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

VoiceAgentTool(String)

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.

VoiceAgentToolboxTool(String, String, Nullable<VoiceAgentToolResponseScheduling>)

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

VoiceAgentTurnDetectionConfig(String, Nullable<Boolean>)

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.

VoiceAudioItem(String, String, Nullable<VoiceAudioRole>, Nullable<VoiceAudioContainerFormat>, Nullable<VoiceAudioCodec>, Nullable<Int32>, Nullable<Int32>, Nullable<TimeSpan>, Nullable<TimeSpan>, Uri)

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.

VoiceConversationEngine(String)

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.

VoiceGeneratedAudioItem(String, String, Nullable<VoiceAudioRole>, Nullable<VoiceAudioContainerFormat>, Nullable<VoiceAudioCodec>, Nullable<Int32>, Nullable<Int32>, Nullable<TimeSpan>, Nullable<TimeSpan>, Uri)

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.

VoiceHostedAgentConversationEngine(String, String)

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 declare voice_conversation_engine version 1.0.0. Voice Live connects through the dedicated voice-conversation-engine endpoint using the existing Bridge Protocol 1.0 wire semantics; the Bridge message version is independent of the container protocol version and the Hosted Agents API version v1. Declaring invocations_ws is optional and does not substitute for voice_conversation_engine.

VoiceRecording(String, VoiceAudioContainerFormat, Int32, Int32, VoiceRecordingChannelLayout, TimeSpan, Uri)

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.

VoiceRecordingChannelLayout()

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

VoiceResponseAudio(VoiceResponseAudioOutput)

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

VoiceResponseAudioOutput(String, Nullable<VoiceType>, String, RealtimeAudioFormat)

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

VoiceResult(String, Nullable<VoiceResponseObject>, Nullable<RealtimeResponseStatus>, RealtimeResponseStatusDetails, IEnumerable<RealtimeItem>, IDictionary<String, BinaryData>, RealtimeResponseUsage, String, IEnumerable<RealtimeOutputModality>, BinaryData, VoiceResponseAudio, Nullable<Single>, Nullable<DateTimeOffset>, Nullable<DateTimeOffset>)

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.

WebIQPreviewToolboxTool(String, String, IDictionary<String,ToolConfig>, String, String, BinaryData)

A WebIQ tool stored in a toolbox.

WebSearchToolboxTool(String, String, IDictionary<String,ToolConfig>, Nullable<Boolean>, WebSearchToolFilters, WebSearchToolApproximateLocation, Nullable<WebSearchToolContextSize>, WebSearchConfiguration)

A web search tool stored in a toolbox.

WorkflowAgentDefinition(ContentFilterConfiguration, String)

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.

WorkIQPreviewToolboxTool(String, String, IDictionary<String,ToolConfig>, String)

A WorkIQ tool stored in a toolbox.

Applies to