Skip to main content

conversation_projects

Creates, updates, deletes, gets or lists a conversation_projects resource.

Overview

Nameconversation_projects
TypeResource
Idazure.ai_language.conversation_projects

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
createdDateTimestring (date-time)Represents the project creation datetime. Required.
descriptionstringThe project description.
languagestringThe project language. This is BCP-47 representation of a language. For example, use "en" for English, "en-gb" for English (UK), "es" for Spanish etc. Required.
lastDeployedDateTimestring (date-time)Represents the project last deployed datetime.
lastModifiedDateTimestring (date-time)Represents the project creation datetime. Required.
lastTrainedDateTimestring (date-time)Represents the project last trained datetime.
multilingualbooleanWhether the project would be used for multiple languages or not.
projectKindstringRepresents the project kind. Required. Known values are: "Conversation", "Orchestration", and "CustomConversationSummarization". (Conversation, Orchestration, CustomConversationSummarization)
projectNamestringThe new project name. Required.
settingsobjectThe project settings.
storageInputContainerNamestringThe storage container name in case of conversation summarization.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_projectsselectendpointtop, skip, maxpagesizeLists the existing projects.
delete_projectdeleteproject_name, endpointDeletes a project.
create_projectexecproject_name, endpoint, projectKind, projectName, languageCreates a new project or updates an existing one.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
endpointstringThe service endpoint host (no scheme), e.g. myaccount.table.cosmos.azure.com:443 - value of the client Endpoint parameter. (default: )
project_namestringThe new project name. Required.
maxpagesizeinteger
skipintegerThe number of result items to skip. Default value is None.
topintegerThe number of result items to return. Default value is None.

SELECT examples

Lists the existing projects.

SELECT
createdDateTime,
description,
language,
lastDeployedDateTime,
lastModifiedDateTime,
lastTrainedDateTime,
multilingual,
projectKind,
projectName,
settings,
storageInputContainerName
FROM azure.ai_language.conversation_projects
WHERE endpoint = '{{ endpoint }}' -- required
AND top = '{{ top }}'
AND skip = '{{ skip }}'
AND maxpagesize = '{{ maxpagesize }}'
;

DELETE examples

Deletes a project.

DELETE FROM azure.ai_language.conversation_projects
WHERE project_name = '{{ project_name }}' --required
AND endpoint = '{{ endpoint }}' --required
;

Lifecycle Methods

Creates a new project or updates an existing one.

EXEC azure.ai_language.conversation_projects.create_project 
@project_name='{{ project_name }}' --required,
@endpoint='{{ endpoint }}' --required
@@json=
'{
"projectKind": "{{ projectKind }}",
"settings": "{{ settings }}",
"storageInputContainerName": "{{ storageInputContainerName }}",
"projectName": "{{ projectName }}",
"multilingual": {{ multilingual }},
"description": "{{ description }}",
"language": "{{ language }}"
}'
;