Skip to content
DocsTry Aspire
DocsTry

AzureCognitiveServicesProjectResource

Handle
📦 Aspire.Hosting.Foundry v13.4.0-preview.1.26281.18
interface AzureCognitiveServicesProjectResource
extends IAzureResource,
IComputeEnvironmentResource,
IExpressionValue,
IManifestExpressionProvider,
IResource,
IResourceWithConnectionString,
IResourceWithParameters,
IResourceWithParent,
FoundryResource]],
IValueProvider,
IValueWithReferences,
IAzureComputeEnvironmentResource {
addAISearchTool(
name: string,
indexName?: string): AzureAISearchToolResource;
addAzureFunctionTool(
name: string,
functionName: string,
description: string,
parametersJson: string,
inputQueueEndpoint: string,
inputQueueName: string,
outputQueueEndpoint: string,
outputQueueName: string): AzureFunctionToolResource;
addBingGroundingConnection(
name: string,
bingResourceId: string): BingGroundingConnectionResource;
addBingGroundingConnectionFromParameter(
name: string,
bingResourceId: ParameterResource): BingGroundingConnectionResource;
addBingGroundingTool(name: string): BingGroundingToolResource;
addCapabilityHost(name: string): AzureCognitiveServicesProjectResource;
addCodeInterpreterTool(name: string): CodeInterpreterToolResource;
addComputerUseTool(
name: string,
displayWidth?: number,
displayHeight?: number,
environment?: string): ComputerToolResource;
addConnection(resource: AzureKeyVaultResource): AzureCognitiveServicesProjectConnectionResource;
addContainerRegistryConnection(registry: AzureContainerRegistryResource): AzureCognitiveServicesProjectConnectionResource;
addCosmosConnection(db: AzureCosmosDBResource): AzureCognitiveServicesProjectConnectionResource;
addFabricTool(
name: string,
projectConnectionIds: string[]): FabricToolResource;
addFileSearchTool(
name: string,
vectorStoreIds: string[]): FileSearchToolResource;
addFunctionTool(
name: string,
functionName: string,
parametersJson: string,
description?: string,
strictModeEnabled?: boolean): FunctionToolResource;
addImageGenerationTool(name: string): ImageGenerationToolResource;
addKeyVaultConnection(keyVault: AzureKeyVaultResource): AzureCognitiveServicesProjectConnectionResource;
addModelDeployment(
name: string,
model: FoundryModel|string,
modelVersion?: string,
format?: string): FoundryDeploymentResource;
addPromptAgent(
name: string,
model: FoundryDeploymentResource,
instructions?: string): AzurePromptAgentResource;
addSearchConnection(search: AzureSearchResource): AzureCognitiveServicesProjectConnectionResource;
addSharePointTool(
name: string,
projectConnectionIds: string[]): SharePointToolResource;
addStorageConnection(storage: AzureStorageResource): AzureCognitiveServicesProjectConnectionResource;
addWebSearchTool(name: string): WebSearchToolResource;
withAppInsights(appInsights: AzureApplicationInsightsResource): AzureCognitiveServicesProjectResource;
withCapabilityHost(resource: FoundryResource): AzureCognitiveServicesProjectResource;
withKeyVault(keyVault: AzureKeyVaultResource): AzureCognitiveServicesProjectResource;
}

Methods

methodaddAISearchToolbuilder
Adds an Azure AI Search tool to a Microsoft Foundry project, enabling agents to ground their responses using data from an Azure AI Search index.
addAISearchTool(
name: string,
indexName?: string): AzureAISearchToolResource
namestring
indexNamestringoptional
AzureAISearchToolResource
Adds an Azure Function tool to a Microsoft Foundry project, enabling agents to invoke a serverless Azure Function with queue-based input/output bindings.
addAzureFunctionTool(
name: string,
functionName: string,
description: string,
parametersJson: string,
inputQueueEndpoint: string,
inputQueueName: string,
outputQueueEndpoint: string,
outputQueueName: string): AzureFunctionToolResource
namestring
functionNamestring
descriptionstring
parametersJsonstring
inputQueueEndpointstring
inputQueueNamestring
outputQueueEndpointstring
outputQueueNamestring
AzureFunctionToolResource
Adds a Grounding with Bing Search connection to a Microsoft Foundry project.
addBingGroundingConnection(
name: string,
bingResourceId: string): BingGroundingConnectionResource
namestring
bingResourceIdstring
BingGroundingConnectionResource
Adds a Grounding with Bing Search connection to a Microsoft Foundry project using a parameter resource for the Bing resource ID.
addBingGroundingConnectionFromParameter(
name: string,
bingResourceId: ParameterResource): BingGroundingConnectionResource
namestring
bingResourceIdParameterResource
BingGroundingConnectionResource
Adds a Bing Grounding tool to a Microsoft Foundry project, enabling agents to ground their responses using Bing Search results.
addBingGroundingTool(name: string): BingGroundingToolResource
namestring
BingGroundingToolResource
methodaddCapabilityHostbuilder
Adds a capability host to the Microsoft Foundry project.
addCapabilityHost(name: string): AzureCognitiveServicesProjectResource
namestring
AzureCognitiveServicesProjectResource
Adds a Code Interpreter tool to a Microsoft Foundry project, enabling agents to write and run Python code in a sandboxed environment for data analysis, math, and chart generation.
addCodeInterpreterTool(name: string): CodeInterpreterToolResource
namestring
CodeInterpreterToolResource
methodaddComputerUseToolbuilder
Adds a Computer Use tool to a Microsoft Foundry project, enabling agents to interact with a computer desktop by taking screenshots, moving the mouse, clicking, and typing.
addComputerUseTool(
name: string,
displayWidth?: number,
displayHeight?: number,
environment?: string): ComputerToolResource
namestring
displayWidthnumberoptional= 1024
displayHeightnumberoptional= 768
environmentstringoptional= browser
ComputerToolResource
methodaddConnectionbuilder
Adds a connection to a Microsoft Foundry project.
addConnection(resource: AzureKeyVaultResource): AzureCognitiveServicesProjectConnectionResource
resourceAzureKeyVaultResource
AzureCognitiveServicesProjectConnectionResource
Adds a container registry connection to the Microsoft Foundry project.
addContainerRegistryConnection(registry: AzureContainerRegistryResource): AzureCognitiveServicesProjectConnectionResource
registryAzureContainerRegistryResource
AzureCognitiveServicesProjectConnectionResource
methodaddCosmosConnectionbuilder
Adds CosmosDB to a project as a connection
addCosmosConnection(db: AzureCosmosDBResource): AzureCognitiveServicesProjectConnectionResource
dbAzureCosmosDBResource
AzureCognitiveServicesProjectConnectionResource
methodaddFabricToolbuilder
Adds a Microsoft Fabric data agent tool to a Microsoft Foundry project, enabling agents to query data through Fabric data agents.
addFabricTool(
name: string,
projectConnectionIds: string[]): FabricToolResource
namestring
projectConnectionIdsstring[]
FabricToolResource
methodaddFileSearchToolbuilder
Adds a File Search tool to a Microsoft Foundry project, enabling agents to search uploaded files and proprietary documents using vector search.
addFileSearchTool(
name: string,
vectorStoreIds: string[]): FileSearchToolResource
namestring
vectorStoreIdsstring[]
FileSearchToolResource
methodaddFunctionToolbuilder
Adds a function calling tool to a Microsoft Foundry project, enabling agents to call application-defined functions with structured parameters.
addFunctionTool(
name: string,
functionName: string,
parametersJson: string,
description?: string,
strictModeEnabled?: boolean): FunctionToolResource
namestring
functionNamestring
parametersJsonstring
descriptionstringoptional
strictModeEnabledbooleanoptional
FunctionToolResource
Adds an Image Generation tool to a Microsoft Foundry project, enabling agents to generate and edit images.
addImageGenerationTool(name: string): ImageGenerationToolResource
namestring
ImageGenerationToolResource
Adds a Key Vault connection to the Microsoft Foundry project.
addKeyVaultConnection(keyVault: AzureKeyVaultResource): AzureCognitiveServicesProjectConnectionResource
keyVaultAzureKeyVaultResource
AzureCognitiveServicesProjectConnectionResource
methodaddModelDeploymentbuilder
Adds a model deployment to the parent Microsoft Foundry resource.
addModelDeployment(
name: string,
model: FoundryModel|string,
modelVersion?: string,
format?: string): FoundryDeploymentResource
namestring
modelFoundryModel|string
modelVersionstringoptional
formatstringoptional
FoundryDeploymentResource
methodaddPromptAgentbuilder
Adds a prompt agent to a Microsoft Foundry project with the specified tools.
addPromptAgent(
name: string,
model: FoundryDeploymentResource,
instructions?: string): AzurePromptAgentResource
namestring
modelFoundryDeploymentResource
instructionsstringoptional
AzurePromptAgentResource
methodaddSearchConnectionbuilder
Adds an Azure AI Search connection to a Microsoft Foundry project.
addSearchConnection(search: AzureSearchResource): AzureCognitiveServicesProjectConnectionResource
searchAzureSearchResource
AzureCognitiveServicesProjectConnectionResource
methodaddSharePointToolbuilder
Adds a SharePoint grounding tool to a Microsoft Foundry project, enabling agents to search data from SharePoint sites configured as Foundry project connections.
addSharePointTool(
name: string,
projectConnectionIds: string[]): SharePointToolResource
namestring
projectConnectionIdsstring[]
SharePointToolResource
Adds an Azure Storage account to a project as a connection.
addStorageConnection(storage: AzureStorageResource): AzureCognitiveServicesProjectConnectionResource
storageAzureStorageResource
AzureCognitiveServicesProjectConnectionResource
methodaddWebSearchToolbuilder
Adds a Web Search tool to a Microsoft Foundry project, enabling agents to retrieve real-time information from the public web and return answers with inline citations.
addWebSearchTool(name: string): WebSearchToolResource
namestring
WebSearchToolResource
methodwithAppInsightsbuilder
Adds an Application Insights resource to the Microsoft Foundry project, overriding the default (which is to create a new Application Insights resource).
withAppInsights(appInsights: AzureApplicationInsightsResource): AzureCognitiveServicesProjectResource
appInsightsAzureApplicationInsightsResource
AzureCognitiveServicesProjectResource
methodwithCapabilityHostbuilder
Associates a supported resource with a capability host on a Microsoft Foundry project.
withCapabilityHost(resource: FoundryResource): AzureCognitiveServicesProjectResource
resourceFoundryResource
AzureCognitiveServicesProjectResource
methodwithKeyVaultbuilder
Adds a Key Vault connection to the Microsoft Foundry project.
withKeyVault(keyVault: AzureKeyVaultResource): AzureCognitiveServicesProjectResource
keyVaultAzureKeyVaultResource
AzureCognitiveServicesProjectResource