Azure.AI.Projects.Agents Namespace

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Classes

Name	Description
A2APreviewTool	An agent implementing the A2A protocol.
AgentAdministrationClient	The AgentAdministrationClient sub-client.
AgentAdministrationClientOptions	Client options for Azure.AI.Projects.Agents.InternalProjectsClient.
AgentAdministrationClientSettings	Represents the settings used to configure a AgentAdministrationClient that can be loaded from an IConfigurationSection.
AgentAdministrationSettings	Represents the settings used to configure a AgentAdministrationClient that can be loaded from an IConfigurationSection.
AgentBlueprintReference	The AgentBlueprintReference. Please note this is the abstract base class. The derived classes available for instantiation are: ManagedAgentIdentityBlueprintReference.
AgentCard	The AgentCard.
AgentCardSkill	The AgentCardSkill.
AgentEndpointAuthorizationScheme	The AgentEndpointAuthorizationScheme. Please note this is the abstract base class. The derived classes available for instantiation are: EntraAuthorizationScheme, BotServiceAuthorizationScheme, and BotServiceRbacAuthorizationScheme.
AgentEndpointConfiguration	The AgentEndpointConfiguration.
AgentIdentifier	Identifies the registered Foundry agent to optimize (request-only). Skills, tools, and system_prompt are specified in options.optimization_config.
AgentIdentity	The AgentIdentity.
AgentManifestOptions	The AgentManifestOptions.
AgentOptimizationJobs	The AgentOptimizationJobs sub-client.
AgentSessionFiles	Session-scoped file operations for hosted agent sandboxes. These endpoints enable uploading, downloading, listing, and deleting files within a live ADC sandbox session. All file content is streamed end-to-end (no buffering in Agents service memory). Sessions are scoped to agent endpoints (not individual versions), allowing the endpoint to evolve the backing agent version independently of the session lifecycle.
AgentsPagedResultOptimizationCandidate	The response data for a requested list of items.
AgentsSkill	A skill resource.
AgentToolboxes	The AgentToolboxes sub-client.
AzureAIProjectsAgentsContext	Context class which will be filled in by the System.ClientModel.SourceGeneration. For more information https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/core/System.ClientModel/src/docs/ModelReaderWriterContext.md
AzureAISearchTool	The input definition information for an Azure AI search tool as used to configure an agent.
AzureAISearchToolIndex	A AI Search Index resource.
AzureAISearchToolOptions	A set of index resources used by the `azure_ai_search` tool.
AzureFunctionBinding	The structure for keeping storage queue name and URI.
AzureFunctionDefinition	The definition of Azure function.
AzureFunctionDefinitionFunction	The AzureFunctionDefinitionFunction.
AzureFunctionStorageQueue	The structure for keeping storage queue name and URI.
AzureFunctionTool	The input definition information for an Azure Function Tool, as used to configure an Agent.
BingCustomSearchConfiguration	A bing custom search configuration.
BingCustomSearchPreviewTool	The input definition information for a Bing custom search tool as used to configure an agent.
BingCustomSearchToolOptions	The bing custom search tool parameters.
BingGroundingSearchConfiguration	Search configuration for Bing Grounding.
BingGroundingSearchToolOptions	The bing grounding search tool parameters.
BingGroundingTool	The input definition information for a bing grounding search tool as used to configure an agent.
BotServiceAuthorizationScheme	The BotServiceAuthorizationScheme.
BotServiceRbacAuthorizationScheme	The BotServiceRbacAuthorizationScheme.
BrowserAutomationPreviewTool	The input definition information for a Browser Automation Tool, as used to configure an Agent.
BrowserAutomationToolConnectionParameters	Definition of input parameters for the connection used by the Browser Automation Tool.
BrowserAutomationToolOptions	Definition of input parameters for the Browser Automation Tool.
CandidateDeployConfig	Deploy-config blob for a candidate. Suitable for setting OPTIMIZATION_CONFIG on a hosted-agent version.
CandidateFileInfo	File entry in a candidate's blob directory.
CandidateMetadata	Candidate metadata returned by GET /candidates/{id}.
CandidateResults	Full per-task evaluation results for a candidate, returned by GET /candidates/{id}/results.
CaptureStructuredOutputsTool	A tool for capturing structured outputs.
ClientConnectionProviderExtensions
CodeConfiguration	Code-based deployment configuration for a hosted agent.
ContainerConfiguration	Container-based deployment configuration for a hosted agent.
ContentFilterConfiguration	Configuration for Responsible AI (RAI) content filtering and safety features.
CreateAgentFromCodeOptions	Multipart request body for creating a new code-based agent (POST /agents). Inherits from CreateAgentVersionFromCodeContent for future extensibility.
CreateAgentVersionFromCodeMetadata	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.
CreateAgentVersionFromManifestRequest	The CreateAgentVersionFromManifestRequest.
DatasetInfo	Metadata about the dataset used for optimization, surfaced in the response.
DatasetRef	Reference to a registered dataset in the Foundry Dataset Service.
DeclarativeAgentDefinition	The prompt agent definition.
DeleteSkillResponse	A deleted skill.
DeleteSkillVersionResponse	A deleted skill version.
EntraAuthorizationScheme	The EntraAuthorizationScheme.
EntraIsolationKeySource	The EntraIsolationKeySource.
ExternalAgentDefinition	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	The fabric data agent tool parameters.
FabricIQPreviewTool	A FabricIQ server-side tool.
FixedRatioVersionSelectionRule	The FixedRatioVersionSelectionRule.
HeaderIsolationKeySource	The HeaderIsolationKeySource.
HeaderTelemetryEndpointAuth	Header-based secret authentication for a telemetry endpoint. The resolved secret value is injected as an HTTP header.
HostedAgentDefinition	The hosted agent definition.
IsolationKeySource	The IsolationKeySource. Please note this is the abstract base class. The derived classes available for instantiation are: EntraIsolationKeySource and HeaderIsolationKeySource.
ManagedAgentIdentityBlueprintReference	The ManagedAgentIdentityBlueprintReference.
McpToolExtensions
MemorySearchPreviewTool	A tool for integrating memories into the agent.
MemorySearchToolOptions	Memory search options.
MicrosoftFabricPreviewTool	The input definition information for a Microsoft Fabric tool as used to configure an agent.
OpenAPIAnonymousAuthenticationDetails	Security details for OpenApi anonymous authentication.
OpenApiAuthenticationDetails	authentication details for OpenApiFunctionDefinition Please note this is the abstract base class. The derived classes available for instantiation are: OpenAPIAnonymousAuthenticationDetails, OpenApiProjectConnectionAuthenticationDetails, and OpenAPIManagedAuthenticationDetails.
OpenApiFunctionDefinition	The input definition information for an openapi function.
OpenAPIFunctionEntry	The OpenAPIFunctionEntry.
OpenAPIManagedAuthenticationDetails	Security details for OpenApi managed_identity authentication.
OpenAPIManagedSecurityScheme	Security scheme for OpenApi managed_identity authentication.
OpenApiProjectConnectionAuthenticationDetails	Security details for OpenApi project connection authentication.
OpenApiProjectConnectionSecurityScheme	Security scheme for OpenApi managed_identity authentication.
OpenAPITool	The input definition information for an OpenAPI tool as used to configure an agent.
OptimizationAgentDefinition	Agent definition returned in response payloads (includes resolved config).
OptimizationCandidate	Aggregated evaluation result for a single candidate agent configuration across all tasks.
OptimizationJob	Agent optimization job resource — a long-running job that optimizes an agent's configuration (instructions, model, skills, tools) to maximize evaluation scores. On success, the result contains scored candidates.
OptimizationJobInputs	Caller-supplied inputs for an optimization job.
OptimizationJobProgress	In-flight progress; only populated while status is queued or in_progress.
OptimizationJobResult	Terminal-state result body. Populated when status is succeeded or failed.
OptimizationOptions	Tuning knobs and run-mode for an optimization job.
OptimizationTaskResult	Per-task evaluation result for a single candidate.
OtlpTelemetryEndpoint	An OTLP (OpenTelemetry Protocol) telemetry export endpoint.
PatchAgentOptions	The PatchAgentOptions.
ProjectAgentSession	An agent session providing a long-lived compute sandbox for hosted agent invocations.
ProjectAgentSkills	The ProjectAgentSkills sub-client.
ProjectsAgentDefinition	The ProjectsAgentDefinition. Please note this is the abstract base class. The derived classes available for instantiation are: HostedAgentDefinition, DeclarativeAgentDefinition, WorkflowAgentDefinition, and ExternalAgentDefinition.
ProjectsAgentRecord	The ProjectsAgentRecord.
ProjectsAgentsModelFactory	A factory class for creating instances of the models for mocking.
ProjectsAgentTool	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: BingGroundingTool, MicrosoftFabricPreviewTool, SharepointPreviewTool, AzureAISearchTool, OpenAPITool, BingCustomSearchPreviewTool, BrowserAutomationPreviewTool, AzureFunctionTool, CaptureStructuredOutputsTool, A2APreviewTool, WorkIQPreviewTool, FabricIQPreviewTool, MemorySearchPreviewTool, ToolboxSearchPreviewTool, and ToolSearchTool.
ProjectsAgentVersion	The ProjectsAgentVersion.
ProjectsAgentVersionCreationOptions	The ProjectsAgentVersionCreationOptions.
ProjectWebSearchConfiguration	A web search configuration for bing custom search.
PromoteCandidateRequest	Request body for promoting a candidate to a Foundry agent version.
PromoteCandidateResponse	Response after successfully promoting a candidate.
PromotionInfo	Promotion metadata recorded when a candidate is deployed to a Foundry agent.
ProtocolVersionRecord	A record mapping for a single protocol and its version.
ResponseToolExtensions
SessionDirectoryEntry	A single entry in a directory listing.
SessionFileWriteResponse	Response from uploading a file to a session sandbox.
SessionLogEvent	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	The sharepoint grounding tool parameters.
SharepointPreviewTool	The input definition information for a sharepoint tool as used to configure an agent.
SkillInlineContent	Inline content for defining a simple skill without uploading files. Follows the agentskills.io SKILL.md specification.
SkillVersion	A specific version of a skill.
StructuredInputDefinition	An structured input that can participate in prompt template substitutions and tool argument binding.
StructuredOutputDefinition	A structured output that can be produced by the agent.
TelemetryConfig	Customer-supplied telemetry configuration for exporting container logs, traces, and metrics.
TelemetryEndpoint	A telemetry export endpoint configuration. Please note this is the abstract base class. The derived classes available for instantiation are: OtlpTelemetryEndpoint.
TelemetryEndpointAuthentication	Authentication configuration for a telemetry endpoint. Please note this is the abstract base class. The derived classes available for instantiation are: HeaderTelemetryEndpointAuth.
ToolboxPolicies	Policy configuration for a toolbox, including content safety and other governance settings.
ToolboxRecord	A toolbox that stores reusable tool definitions for agents.
ToolboxSearchPreviewTool	A tool for searching over the agent's toolbox. When present, deferred tools are hidden from `tools/list` and only discoverable via `search_tools` queries at runtime.
ToolboxSkill	A skill source included in a toolbox. Please note this is the abstract base class. The derived classes available for instantiation are: ToolboxSkillReference.
ToolboxSkillReference	A reference to an existing skill to include in a toolbox.
ToolboxVersion	A specific version of a toolbox.
ToolConfig	Per-tool configuration that controls tool visibility and search behavior.
ToolProjectConnection	A project connection resource.
ToolSearchTool	Tool search tool.
UpdateToolboxRequest	The UpdateToolboxRequest.
VersionIndicator	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	Version indicator that references a specific agent version by name.
VersionSelectionRule	The VersionSelectionRule. Please note this is the abstract base class. The derived classes available for instantiation are: FixedRatioVersionSelectionRule.
VersionSelector	The VersionSelector.
WebSearchToolExtensions
WorkflowAgentDefinition	The workflow agent definition.
WorkIQPreviewTool	A WorkIQ server-side tool.

Structs

Name	Description
AgentEndpointProtocol
AgentListOrder
AgentSessionStatus	The status of an agent session.
AzureAISearchQueryType	Available query types for Azure AI Search tool.
CodeDependencyResolution	How package dependencies are resolved at deployment time for a code-based hosted agent.
EvaluationLevel	The level at which evaluation is performed.
ExportedDataTypes	The type of telemetry data to export.
JobStatus	Extensible status values shared by Foundry jobs.
ProjectsAgentKind
ProjectsAgentProtocol
SessionLogEventType	Known SSE event types emitted by the hosted agent session log stream. Additional event types may be introduced in future versions.
TelemetryTransportProtocol	The transport protocol for telemetry export.

Enums

Name	Description
AgentAdministrationClientOptions.ServiceVersion	The version of the service to use.
AgentDefinitionOptInKeys	Feature opt-in keys for agent definition operations supporting hosted or workflow agents.
AgentVersionStatus	The provisioning status of an agent version.
FoundryFeaturesOptInKeys

Feedback

Was this page helpful?