Azure.AI.Projects 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
Agent |
Represents an agent that can call the model and use tools. |
AgentFile |
Represents an agent that can call the model and use tools. |
AgentPageableListOfVectorStore |
The response data for a requested list of items. |
AgentPageableListOfVectorStoreFile |
The response data for a requested list of items. |
AgentsApiResponseFormat |
An object describing the expected output of the model. If |
AgentsClient |
The Agents sub-client. |
AgentsNamedToolChoice |
Specifies a tool the model should use. Use to force the model to call a specific tool. |
AgentThread |
Information about a single thread associated with an agent. |
AgentThreadCreationOptions |
The details used to create a new agent thread. |
AIClientModelFactory | |
AIProjectClient |
The AzureAI service client. |
AIProjectClientOptions |
Client options for AIProjectClient. |
AIProjectsModelFactory |
Model factory for models. |
ApplicationInsightsConfiguration |
Data Source for Application Insights. |
AzureAISearchResource |
A set of index resources used by the |
AzureAISearchToolDefinition |
The input definition information for an Azure AI search tool as used to configure an agent. |
BingGroundingToolDefinition |
The input definition information for a bing grounding search tool as used to configure an agent. |
CodeInterpreterToolDefinition |
The input definition information for a code interpreter tool as used to configure an agent. |
CodeInterpreterToolResource |
A set of resources that are used by the |
ConnectionProperties |
Connection properties Please note ConnectionProperties is the base class. According to the scenario, a derived class of the base class might need to be assigned here, or this property needs to be casted to one of the possible derived classes. The available derived classes include ConnectionPropertiesApiKeyAuth. |
ConnectionPropertiesApiKeyAuth |
Connection properties for connections with API key authentication. |
ConnectionResponse |
Response from the listSecrets operation. |
ConnectionsClient |
The Endpoints sub-client. |
CredentialsApiKeyAuth |
The credentials needed for API key authentication. |
CronTrigger |
Cron Trigger Definition. |
Dataset |
Dataset as source for evaluation. |
Evaluation |
Evaluation Definition. |
EvaluationSchedule |
Evaluation Schedule Definition. |
EvaluationsClient |
The Evaluations sub-client. |
EvaluatorConfiguration |
Evaluator Configuration. |
FileSearchRankingOptions |
Ranking options for file search. |
FileSearchToolDefinition |
The input definition information for a file search tool as used to configure an agent. |
FileSearchToolDefinitionDetails |
Options overrides for the file search tool. |
FileSearchToolResource |
A set of resources that are used by the |
FunctionName |
The function name that will be used, if using the |
FunctionToolDefinition |
The input definition information for a function tool as used to configure an agent. |
GetWorkspaceResponse |
Response from the Workspace - Get operation. |
IndexResource |
A Index resource. |
InputData |
Abstract data class for input data configuration. Please note InputData is the base class. According to the scenario, a derived class of the base class might need to be assigned here, or this property needs to be casted to one of the possible derived classes. The available derived classes include ApplicationInsightsConfiguration and Dataset. |
ListConnectionsResponse |
Response from the list operation. |
MessageAttachment |
This describes to which tools a file has been attached. |
MessageContent |
An abstract representation of a single item of thread message content. Please note MessageContent is the base class. According to the scenario, a derived class of the base class might need to be assigned here, or this property needs to be casted to one of the possible derived classes. The available derived classes include MessageImageFileContent and MessageTextContent. |
MessageContentUpdate |
Represents a streaming update to ThreadMessage content as part of the Assistants API. |
MessageDelta |
Represents the typed 'delta' payload within a streaming message delta chunk. |
MessageDeltaChunk |
Represents a message delta i.e. any changed fields on a message during streaming. |
MessageDeltaContent |
The abstract base representation of a partial streamed message content payload. Please note MessageDeltaContent is the base class. According to the scenario, a derived class of the base class might need to be assigned here, or this property needs to be casted to one of the possible derived classes. The available derived classes include MessageDeltaImageFileContent and MessageDeltaTextContent. |
MessageDeltaImageFileContent |
Represents a streamed image file content part within a streaming message delta chunk. |
MessageDeltaImageFileContentObject |
Represents the 'image_file' payload within streaming image file content. |
MessageDeltaTextAnnotation |
The abstract base representation of a streamed text content part's text annotation. Please note MessageDeltaTextAnnotation is the base class. According to the scenario, a derived class of the base class might need to be assigned here, or this property needs to be casted to one of the possible derived classes. The available derived classes include MessageDeltaTextFileCitationAnnotation and MessageDeltaTextFilePathAnnotation. |
MessageDeltaTextContent |
Represents a streamed text content part within a streaming message delta chunk. |
MessageDeltaTextContentObject |
Represents the data of a streamed text content part within a streaming message delta chunk. |
MessageDeltaTextFileCitationAnnotation |
Represents a streamed file citation applied to a streaming text content part. |
MessageDeltaTextFileCitationAnnotationObject |
Represents the data of a streamed file citation as applied to a streaming text content part. |
MessageDeltaTextFilePathAnnotation |
Represents a streamed file path annotation applied to a streaming text content part. |
MessageDeltaTextFilePathAnnotationObject |
Represents the data of a streamed file path annotation as applied to a streaming text content part. |
MessageImageFileContent |
A representation of image file content in a thread message. |
MessageIncompleteDetails |
Information providing additional detail about a message entering an incomplete status. |
MessageStatusUpdate |
The update type presented when the status of a message changes. |
MessageTextAnnotation |
An abstract representation of an annotation to text thread message content. Please note MessageTextAnnotation is the base class. According to the scenario, a derived class of the base class might need to be assigned here, or this property needs to be casted to one of the possible derived classes. The available derived classes include MessageTextFileCitationAnnotation and MessageTextFilePathAnnotation. |
MessageTextContent |
A representation of a textual item of thread message content. |
MessageTextFileCitationAnnotation |
A citation within the message that points to a specific quote from a specific File associated with the agent or the message. Generated when the agent uses the 'file_search' tool to search files. |
MessageTextFilePathAnnotation |
A citation within the message that points to a file located at a specific path. |
MicrosoftFabricToolDefinition |
The input definition information for a Microsoft Fabric tool as used to configure an agent. |
PageableList<T> |
Represents a pageable list of data items with item ID cursors representing the start and end of the current page. |
RecurrenceSchedule |
RecurrenceSchedule Definition. |
RecurrenceTrigger |
Recurrence Trigger Definition. |
RequiredAction |
An abstract representation of a required action for an agent thread run to continue. Please note RequiredAction is the base class. According to the scenario, a derived class of the base class might need to be assigned here, or this property needs to be casted to one of the possible derived classes. The available derived classes include SubmitToolOutputsAction. |
RequiredActionUpdate |
The update type presented when the status of a ThreadRun has changed to |
RequiredFunctionToolCall |
A representation of a requested call to a function tool, needed by the model to continue evaluation of a run. |
RequiredToolCall |
An abstract, base representation for a tool call that an Assistants API run requires outputs from in order to continue. |
RunCompletionUsage |
Usage statistics related to the run. This value will be |
RunError |
The details of an error as encountered by an agent thread run. |
RunStep |
Detailed information about a single step of an agent thread run. |
RunStepAzureAISearchToolCall |
A record of a call to an Azure AI Search tool, issued by the model in evaluation of a defined tool, that represents executed Azure AI search. |
RunStepBingGroundingToolCall |
A record of a call to a bing grounding tool, issued by the model in evaluation of a defined tool, that represents executed search with bing grounding. |
RunStepCodeInterpreterImageOutput |
A representation of an image output emitted by a code interpreter tool in response to a tool call by the model. |
RunStepCodeInterpreterImageReference |
An image reference emitted by a code interpreter tool in response to a tool call by the model. |
RunStepCodeInterpreterLogOutput |
A representation of a log output emitted by a code interpreter tool in response to a tool call by the model. |
RunStepCodeInterpreterToolCall |
A record of a call to a code interpreter tool, issued by the model in evaluation of a defined tool, that represents inputs and outputs consumed and emitted by the code interpreter. |
RunStepCodeInterpreterToolCallOutput |
An abstract representation of an emitted output from a code interpreter tool. Please note RunStepCodeInterpreterToolCallOutput is the base class. According to the scenario, a derived class of the base class might need to be assigned here, or this property needs to be casted to one of the possible derived classes. The available derived classes include RunStepCodeInterpreterImageOutput and RunStepCodeInterpreterLogOutput. |
RunStepCompletionUsage |
Usage statistics related to the run step. |
RunStepDelta |
Represents the delta payload in a streaming run step delta chunk. |
RunStepDeltaChunk |
Represents a run step delta i.e. any changed fields on a run step during streaming. |
RunStepDeltaCodeInterpreterDetailItemObject |
Represents the Code Interpreter tool call data in a streaming run step's tool calls. |
RunStepDeltaCodeInterpreterImageOutput |
Represents an image output as produced the Code interpreter tool and as represented in a streaming run step's delta tool calls collection. |
RunStepDeltaCodeInterpreterImageOutputObject |
Represents the data for a streaming run step's Code Interpreter tool call image output. |
RunStepDeltaCodeInterpreterLogOutput |
Represents a log output as produced by the Code Interpreter tool and as represented in a streaming run step's delta tool calls collection. |
RunStepDeltaCodeInterpreterOutput |
The abstract base representation of a streaming run step tool call's Code Interpreter tool output. Please note RunStepDeltaCodeInterpreterOutput is the base class. According to the scenario, a derived class of the base class might need to be assigned here, or this property needs to be casted to one of the possible derived classes. The available derived classes include RunStepDeltaCodeInterpreterImageOutput and RunStepDeltaCodeInterpreterLogOutput. |
RunStepDeltaCodeInterpreterToolCall |
Represents a Code Interpreter tool call within a streaming run step's tool call details. |
RunStepDeltaDetail |
Represents a single run step detail item in a streaming run step's delta payload. Please note RunStepDeltaDetail is the base class. According to the scenario, a derived class of the base class might need to be assigned here, or this property needs to be casted to one of the possible derived classes. The available derived classes include RunStepDeltaMessageCreation and RunStepDeltaToolCallObject. |
RunStepDeltaFileSearchToolCall |
Represents a file search tool call within a streaming run step's tool call details. |
RunStepDeltaFunction |
Represents the function data in a streaming run step delta's function tool call. |
RunStepDeltaFunctionToolCall |
Represents a function tool call within a streaming run step's tool call details. |
RunStepDeltaMessageCreation |
Represents a message creation within a streaming run step delta. |
RunStepDeltaMessageCreationObject |
Represents the data within a streaming run step message creation response object. |
RunStepDeltaToolCall |
The abstract base representation of a single tool call within a streaming run step's delta tool call details. Please note RunStepDeltaToolCall is the base class. According to the scenario, a derived class of the base class might need to be assigned here, or this property needs to be casted to one of the possible derived classes. The available derived classes include RunStepDeltaCodeInterpreterToolCall, RunStepDeltaFileSearchToolCall and RunStepDeltaFunctionToolCall. |
RunStepDeltaToolCallObject |
Represents an invocation of tool calls as part of a streaming run step. |
RunStepDetails |
An abstract representation of the details for a run step. Please note RunStepDetails is the base class. According to the scenario, a derived class of the base class might need to be assigned here, or this property needs to be casted to one of the possible derived classes. The available derived classes include RunStepMessageCreationDetails and RunStepToolCallDetails. |
RunStepDetailsUpdate |
The update type presented when run step details, including tool call progress, have changed. |
RunStepError |
The error information associated with a failed run step. |
RunStepFileSearchToolCall |
A record of a call to a file search tool, issued by the model in evaluation of a defined tool, that represents executed file search. |
RunStepFunctionToolCall |
A record of a call to a function tool, issued by the model in evaluation of a defined tool, that represents the inputs and output consumed and emitted by the specified function. |
RunStepMessageCreationDetails |
The detailed information associated with a message creation run step. |
RunStepMessageCreationReference |
The details of a message created as a part of a run step. |
RunStepMicrosoftFabricToolCall |
A record of a call to a Microsoft Fabric tool, issued by the model in evaluation of a defined tool, that represents executed Microsoft Fabric operations. |
RunStepSharepointToolCall |
A record of a call to a SharePoint tool, issued by the model in evaluation of a defined tool, that represents executed SharePoint actions. |
RunStepToolCall |
An abstract representation of a detailed tool call as recorded within a run step for an existing run. Please note RunStepToolCall is the base class. According to the scenario, a derived class of the base class might need to be assigned here, or this property needs to be casted to one of the possible derived classes. The available derived classes include RunStepAzureAISearchToolCall, RunStepBingGroundingToolCall, RunStepCodeInterpreterToolCall, RunStepFileSearchToolCall, RunStepFunctionToolCall, RunStepMicrosoftFabricToolCall and RunStepSharepointToolCall. |
RunStepToolCallDetails |
The detailed information associated with a run step calling tools. |
RunStepUpdate |
The update type presented when the status of a run step changes. |
RunUpdate |
The update type presented when the status of a ThreadRun has changed. |
SharepointToolDefinition |
The input definition information for a sharepoint tool as used to configure an agent. |
StreamingUpdate |
Represents a single item of streamed Assistants API data. |
StreamingUpdate<T> |
Represents a single item of streamed data that encapsulates an underlying response value type. |
SubmitToolOutputsAction |
The details for required tool calls that must be submitted for an agent thread run to continue. |
SystemData |
Metadata pertaining to creation and last modification of the resource. |
TelemetryClient |
The Evaluations sub-client. |
TextAnnotationUpdate | |
ThreadMessage |
A single, existing message within an agent thread. |
ThreadMessageOptions |
A single message within an agent thread, as provided during that thread's creation for its initial state. |
ThreadRun |
Data representing a single evaluation run of an agent thread. |
ThreadUpdate |
The update type presented when a streamed event indicates a thread was created. |
ToolConnection |
A connection resource. |
ToolConnectionList |
A set of connection resources currently used by either the |
ToolDefinition |
An abstract representation of an input tool definition that an agent can use. Please note ToolDefinition is the base class. According to the scenario, a derived class of the base class might need to be assigned here, or this property needs to be casted to one of the possible derived classes. The available derived classes include AzureAISearchToolDefinition, BingGroundingToolDefinition, CodeInterpreterToolDefinition, FileSearchToolDefinition, FunctionToolDefinition, MicrosoftFabricToolDefinition and SharepointToolDefinition. |
ToolOutput |
The data provided during a tool outputs submission to resolve pending tool calls and allow the model to continue. |
ToolResources |
A set of resources that are used by the agent's tools. The resources are specific to the type of
tool. For example, the |
Trigger |
Abstract data class for input data configuration. Please note Trigger is the base class. According to the scenario, a derived class of the base class might need to be assigned here, or this property needs to be casted to one of the possible derived classes. The available derived classes include CronTrigger and RecurrenceTrigger. |
TruncationObject |
Controls for how a thread will be truncated prior to the run. Use this to control the initial context window of the run. |
UpdateCodeInterpreterToolResourceOptions |
Request object to update |
UpdateFileSearchToolResourceOptions |
Request object to update |
UpdateToolResourcesOptions |
Request object. A set of resources that are used by the agent's tools. The resources are specific to the type of tool.
For example, the |
VectorStore |
A vector store is a collection of processed files can be used by the |
VectorStoreAutoChunkingStrategyRequest |
The default strategy. This strategy currently uses a max_chunk_size_tokens of 800 and chunk_overlap_tokens of 400. |
VectorStoreAutoChunkingStrategyResponse |
This is returned when the chunking strategy is unknown. Typically, this is because the file was indexed before the chunking_strategy concept was introduced in the API. |
VectorStoreChunkingStrategyRequest |
An abstract representation of a vector store chunking strategy configuration. Please note VectorStoreChunkingStrategyRequest is the base class. According to the scenario, a derived class of the base class might need to be assigned here, or this property needs to be casted to one of the possible derived classes. The available derived classes include VectorStoreAutoChunkingStrategyRequest and VectorStoreStaticChunkingStrategyRequest. |
VectorStoreChunkingStrategyResponse |
An abstract representation of a vector store chunking strategy configuration. Please note VectorStoreChunkingStrategyResponse is the base class. According to the scenario, a derived class of the base class might need to be assigned here, or this property needs to be casted to one of the possible derived classes. The available derived classes include VectorStoreAutoChunkingStrategyResponse and VectorStoreStaticChunkingStrategyResponse. |
VectorStoreConfiguration |
Vector storage configuration is the list of data sources, used when multiple files can be used for the enterprise file search. |
VectorStoreConfigurations |
The structure, containing the list of vector storage configurations i.e. the list of azure asset IDs. |
VectorStoreDataSource |
The structure, containing Azure asset URI path and the asset type of the file used as a data source for the enterprise file search. |
VectorStoreDeletionStatus |
Response object for deleting a vector store. |
VectorStoreExpirationPolicy |
The expiration policy for a vector store. |
VectorStoreFile |
Description of a file attached to a vector store. |
VectorStoreFileBatch |
A batch of files attached to a vector store. |
VectorStoreFileCount |
Counts of files processed or being processed by this vector store grouped by status. |
VectorStoreFileDeletionStatus |
Response object for deleting a vector store file relationship. |
VectorStoreFileError |
Details on the error that may have ocurred while processing a file for this vector store. |
VectorStoreStaticChunkingStrategyOptions |
Options to configure a vector store static chunking strategy. |
VectorStoreStaticChunkingStrategyRequest |
A statically configured chunking strategy. |
VectorStoreStaticChunkingStrategyResponse |
A statically configured chunking strategy. |
WorkspaceProperties |
workspace properties. |
Structs
AgentFilePurpose |
The possible values denoting the intended usage of a file. |
AgentPageableListOfVectorStoreFileObject |
The OpenAIPageableListOfVectorStoreFile_object. |
AgentPageableListOfVectorStoreObject |
The OpenAIPageableListOfVectorStore_object. |
AgentsApiResponseFormatMode |
Represents the mode in which the model will handle the return format of a tool call. |
AgentsApiToolChoiceOptionMode |
Specifies how the tool choice will be used. |
AgentsNamedToolChoiceType |
Available tool types for agents named tools. |
AgentStreamEvent |
Each event in a server-sent events stream has an
We emit events whenever a new object is created, transitions to a new state, or is being
streamed in parts (deltas). For example, we emit We may add additional events over time, so we recommend handling unknown events gracefully in your code. |
ApiResponseFormat |
Possible API response formats. |
DoneEvent |
Terminal event indicating the successful end of a stream. |
ErrorEvent |
Terminal event indicating a server side error while streaming. |
FileState |
The state of the file. |
Frequency |
Frequency of the schedule - day, week, month, hour, minute. |
IncompleteRunDetails |
The reason why the run is incomplete. This will point to which specific token limit was reached over the course of the run. |
ListSortOrder |
The available sorting options when requesting a list of response objects. |
MessageDeltaChunkObject |
The MessageDeltaChunk_object. |
MessageIncompleteDetailsReason |
A set of reasons describing why a message is marked as incomplete. |
MessageRole |
The possible values for roles attributed to messages in a thread. |
MessageStatus |
The possible execution status values for a thread message. |
MessageStreamEvent |
Message operation related streaming events. |
RunStatus |
Possible values for the status of an agent thread run. |
RunStepDeltaChunkObject |
The RunStepDeltaChunk_object. |
RunStepErrorCode |
Possible error code values attributable to a failed run step. |
RunStepStatus |
Possible values for the status of a run step. |
RunStepStreamEvent |
Run step operation related streaming events. |
RunStepType |
The possible types of run steps. |
RunStreamEvent |
Run operation related streaming events. |
ThreadStreamEvent |
Thread operation related streaming events. |
TruncationStrategy |
Possible truncation strategies for the thread. |
VectorStoreDeletionStatusObject |
The VectorStoreDeletionStatus_object. |
VectorStoreExpirationPolicyAnchor |
Describes the relationship between the days and the expiration of this vector store. |
VectorStoreFileBatchObject |
The VectorStoreFileBatch_object. |
VectorStoreFileBatchStatus |
The status of the vector store file batch. |
VectorStoreFileDeletionStatusObject |
The VectorStoreFileDeletionStatus_object. |
VectorStoreFileErrorCode |
Error code variants for vector store file processing. |
VectorStoreFileObject |
The VectorStoreFile_object. |
VectorStoreFileStatus |
Vector store file status. |
VectorStoreFileStatusFilter |
Query parameter filter for vector store file retrieval endpoint. |
VectorStoreObject |
The VectorStore_object. |
VectorStoreStatus |
Vector store possible status. |
WeekDays |
WeekDay of the schedule - Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday. |
Enums
AIProjectClientOptions.ServiceVersion |
The version of the service to use. |
AuthenticationType |
Authentication type used by Azure AI service to connect to another service. |
ConnectionType |
The Type (or category) of the connection. |
StreamingUpdateReason |
The collection of values associated with the event names of streaming update payloads. These correspond to the expected downcast data type of the StreamingUpdate as well as to the expected data present in the payload. |
VectorStoreDataSourceAssetType |
Type of vector storage asset. Asset type may be a uri_asset, in this case it should contain asset URI ID, in the case of id_asset it should contain the data ID. |
Azure SDK for .NET