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 }}"
}'
;