|
1 | 1 | --- |
2 | 2 | title: Azure Conversation Authoring client library for Python |
3 | 3 | keywords: Azure, python, SDK, API, azure-ai-language-conversations-authoring, cognitivelanguage |
4 | | -ms.date: 11/15/2025 |
| 4 | +ms.date: 12/15/2025 |
5 | 5 | ms.topic: reference |
6 | 6 | ms.devlang: python |
7 | 7 | ms.service: cognitivelanguage |
8 | 8 | --- |
9 | 9 | [](https://dev.azure.com/azure-sdk/public/_build/latest?definitionId=46?branchName=main) |
10 | 10 |
|
11 | | -# Azure Conversation Authoring client library for Python - version 1.0.0b2 |
| 11 | +# Azure Conversation Authoring client library for Python - version 1.0.0b3 |
12 | 12 |
|
13 | 13 |
|
14 | 14 | **Conversation Authoring** is part of the Conversational Language Understanding (CLU) service. It provides APIs and SDKs to **create, manage, train, evaluate, and deploy** conversation projects and models. With the `ConversationAuthoringClient`, you can script everything you’d otherwise do in Language Studio, including: |
@@ -45,6 +45,14 @@ pip install azure-ai-language-conversations-authoring |
45 | 45 |
|
46 | 46 | > Note: This version of the client library defaults to the 2025-11-15-preview version of the service |
47 | 47 |
|
| 48 | +This table shows the relationship between SDK versions and supported API versions of the service |
| 49 | + |
| 50 | +| SDK version | Supported API version of service | |
| 51 | +| ------------ | --------------------------------- | |
| 52 | +| 1.0.0b3 - Latest preview release | 2023-04-01, 2025-11-01, 2025-05-15-preview, 2025-11-15-preview (default) | |
| 53 | +| 1.0.0b2 | 2023-04-01, 2025-05-15-preview, 2025-11-15-preview (default) | |
| 54 | +| 1.0.0b1 | 2023-04-01, 2024-11-15-preview, 2025-05-15-preview (default) | |
| 55 | + |
48 | 56 | ### Authenticate the client |
49 | 57 |
|
50 | 58 | To interact with the Conversation Authoring service, you'll need to create an instance of the `ConversationAuthoringClient`. You will need an **endpoint** and an **API key** to instantiate a client object. For more information regarding authenticating with Cognitive Services, see [Authenticate requests to Azure Cognitive Services][cognitive_auth]. |
@@ -436,23 +444,23 @@ For more information, see the [Code of Conduct FAQ][coc_faq] or contact [opencod |
436 | 444 | [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ |
437 | 445 | [code_of_conduct]: https://opensource.microsoft.com/codeofconduct/ |
438 | 446 | [cognitive_auth]: https://learn.microsoft.com/azure/cognitive-services/authentication/ |
439 | | -[contributing]: https://github.com/Azure/azure-sdk-for-python/blob/azure-ai-language-conversations-authoring_1.0.0b2/CONTRIBUTING.md |
| 447 | +[contributing]: https://github.com/Azure/azure-sdk-for-python/blob/azure-ai-language-conversations-authoring_1.0.0b3/CONTRIBUTING.md |
440 | 448 | [python_logging]: https://docs.python.org/3/library/logging.html |
441 | 449 | [sdk_logging_docs]: https://learn.microsoft.com/azure/developer/python/azure-sdk-logging |
442 | 450 | [azure_core_ref_docs]: https://azuresdkdocs.z19.web.core.windows.net/python/azure-core/latest/azure.core.html |
443 | | -[azure_core_exceptions]: https://github.com/Azure/azure-sdk-for-python/blob/azure-ai-language-conversations-authoring_1.0.0b2/sdk/core/azure-core/README.md |
| 451 | +[azure_core_exceptions]: https://github.com/Azure/azure-sdk-for-python/blob/azure-ai-language-conversations-authoring_1.0.0b3/sdk/core/azure-core/README.md |
444 | 452 | [pip_link]: https://pypi.org/project/pip/ |
445 | | -[conversation_authoring_client_src]: https://github.com/Azure/azure-sdk-for-python/tree/azure-ai-language-conversations-authoring_1.0.0b2/sdk/cognitivelanguage/azure-ai-language-conversations-authoring |
| 453 | +[conversation_authoring_client_src]: https://github.com/Azure/azure-sdk-for-python/tree/azure-ai-language-conversations-authoring_1.0.0b3/sdk/cognitivelanguage/azure-ai-language-conversations-authoring |
446 | 454 | [conversation_authoring_pypi_package]: https://pypi.org/project/azure-ai-language-conversations-authoring/ |
447 | | -[conversation_authoring_samples]: https://github.com/Azure/azure-sdk-for-python/tree/azure-ai-language-conversations-authoring_1.0.0b2/sdk/cognitivelanguage/azure-ai-language-conversations-authoring/samples/README.md |
| 455 | +[conversation_authoring_samples]: https://github.com/Azure/azure-sdk-for-python/tree/azure-ai-language-conversations-authoring_1.0.0b3/sdk/cognitivelanguage/azure-ai-language-conversations-authoring/samples/README.md |
448 | 456 | [conversation_authoring_docs]: https://learn.microsoft.com/azure/ai-services/language-service/conversational-language-understanding/overview |
449 | 457 | [api_reference_authoring]: https://azuresdkdocs.z19.web.core.windows.net/python/azure-ai-language-conversations-authoring/latest/azure.ai.language.conversations.authoring.html |
450 | 458 | [conversation_authoring_restdocs]: https://learn.microsoft.com/rest/api/language/analyze-conversations-authoring/conversation-authoring-project?view=rest-language-analyze-conversations-authoring-2025-11-01 |
451 | 459 | [azure_language_portal]: https://language.cognitive.azure.com/home |
452 | 460 | [cognitive_authentication_aad]: https://learn.microsoft.com/azure/cognitive-services/authentication#authenticate-with-azure-active-directory |
453 | | -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-python/tree/azure-ai-language-conversations-authoring_1.0.0b2/sdk/identity/azure-identity#credentials |
| 461 | +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-python/tree/azure-ai-language-conversations-authoring_1.0.0b3/sdk/identity/azure-identity#credentials |
454 | 462 | [custom_subdomain]: https://learn.microsoft.com/azure/cognitive-services/authentication#create-a-resource-with-a-custom-subdomain |
455 | | -[install_azure_identity]: https://github.com/Azure/azure-sdk-for-python/tree/azure-ai-language-conversations-authoring_1.0.0b2/sdk/identity/azure-identity#install-the-package |
| 463 | +[install_azure_identity]: https://github.com/Azure/azure-sdk-for-python/tree/azure-ai-language-conversations-authoring_1.0.0b3/sdk/identity/azure-identity#install-the-package |
456 | 464 | [register_aad_app]: https://learn.microsoft.com/azure/cognitive-services/authentication#assign-a-role-to-a-service-principal |
457 | 465 | [grant_role_access]: https://learn.microsoft.com/azure/cognitive-services/authentication#assign-a-role-to-a-service-principal |
458 | | -[default_azure_credential]: https://github.com/Azure/azure-sdk-for-python/tree/azure-ai-language-conversations-authoring_1.0.0b2/sdk/identity/azure-identity#defaultazurecredential |
| 466 | +[default_azure_credential]: https://github.com/Azure/azure-sdk-for-python/tree/azure-ai-language-conversations-authoring_1.0.0b3/sdk/identity/azure-identity#defaultazurecredential |
0 commit comments