[SDK Release] (Python) CQA inference 2025-05-15-preview (#42870)

* init and update by tsp generate tool

* update patch files to support old version, and fix tests and samples

* delete old question anwsering folder

* init

* update patch files to support old version, and fix tests and samples

* update tests

* update tests&recordings

* fix spell issue

* fix the  Azure Pipelines / python - pullrequest

* fix Unexpected indentation issue for sphinx-build

* fix the cspell issue

* fix verify whl stage

* fix Incompatible types in assignment

* fix pylint

* fix Inline strong start-string without end-string.

* fix overload issue

* update operation patch and re record

* fix(questionanswering): add missing type annotations to restore verifytypes score

The verifytypes pipeline failed because type completeness for azure-ai-language-questionanswering dropped from 100% (main) to 87.9%. Pyright reported missing / ambiguous types for:

QuestionAnsweringClient.question_answering (sync + async clients)
QuestionAnsweringOperations.init (sync + async)
Derived patch classes were then flagged as having partially unknown bases.
Changes:

Added explicit return/attribute annotation for question_answering in _client.py and _client.py.
Added *args: Any, **kwargs: Any plus explicit internal attribute types in _operations.py and _operations.py.
Result:

Eliminates Pyright errors about missing annotations and partially unknown base classes.
Restores type completeness score to parity with main (expected 100%).
No runtime or public API behavior changes; typing-only improvement.
Follow-up (optional):

Consider templating these annotations in the code generator to avoid future regeneration loss

* regenerate the code and update tests/samples/patch

* fix commit:
1. update readme, add sample for both flattened options and explicit AnswersOptions
2. add overloads for get_answers
3. other fix

* add back files

* update

* update version

* switch examples to DefaultAzureCredential and reorganize README

Make AAD the primary auth path; move API key to secondary section
Clarify custom subdomain requirement for token auth
Add rationale for DefaultAzureCredential
Unify example headings (options vs flattened vs async)
Fix internal anchors and markdown lint issues

* Update sdk/cognitivelanguage/azure-ai-language-questionanswering/azure/ai/language/questionanswering/models/_enums.py

Co-authored-by: Copilot <[email protected]>

* Update sdk/cognitivelanguage/azure-ai-language-questionanswering/samples/sample_query_knowledgebase.py

Co-authored-by: Copilot <[email protected]>

* Update sdk/cognitivelanguage/azure-ai-language-questionanswering/samples/README.md

Co-authored-by: Rajarshi Sarkar <[email protected]>

* add and update

* deleted generated files and restore patch file

* updated

* update the python version in sample readme

* update the python version in setup.py

* fix pylint, 4 of them not foxed, because them are generated code

* update patch file

* remove uesless _default_language

* update

* update parameter name of just "options"
update the class name

* fix pylint

* fix pylint

* update change log

* update

* Update sdk/cognitivelanguage/azure-ai-language-questionanswering/tsp-location.yaml

Co-authored-by: Rajarshi Sarkar <[email protected]>

* fix analyze issue

* update

* about default_language

* regenerate

* update

---------

Co-authored-by: Qi Yin <[email protected]>
Co-authored-by: Copilot <[email protected]>
Co-authored-by: Rajarshi Sarkar <[email protected]>

Author: 4 people

.vscode/cspell.json

@@ -912,7 +912,7 @@
     },
     {
       "filename": "sdk/cognitivelanguage/azure-ai-language-questionanswering/**",
-      "words": [ "qnas", "qnamaker", "ADTO" ],
+      "words": [ "qnas", "qnamaker", "ADTO", "tfidf", "ngram" ],
       "caseSensitive": false
     },
     {

sdk/cognitivelanguage/azure-ai-language-questionanswering/CHANGELOG.md

@@ -1,15 +1,28 @@
 # Release History
 
-## 1.1.1 (Unreleased)
-
-### Features Added
+## 2.0.0b1 (2025-10-27)
 
 ### Breaking Changes
 
-### Bugs Fixed
+* Authoring functionality (project creation, knowledge source management, deployment operations) has been removed from this package and moved to a separate dedicated authoring package / namespace. All references to `AuthoringClient`, and related authoring operations have been eliminated from the runtime client distribution.
+* Dropped support for Python versions earlier than 3.9 (aligns with Azure SDK Python support policy going forward).
+* Model base class change: all public model types now inherit from `MutableMapping[str, Any]` (dict-like) instead of the previous `Model` base class. As a result they now support standard mutable mapping behavior (key iteration, item assignment, etc.) and any code depending on methods/properties inherited from the old base class should be reviewed/updated.
+* Removed client constructor keyword argument `default_language`. Per-call language control is now done explicitly via the `language` property on `AnswersFromTextOptions` (and related options models). The service default remains `"en"` if a language is not supplied. To change the effective language:
+  * Pass `language="<bcp-47-code>"` when constructing `AnswersFromTextOptions` (e.g. `"es"`, `"zh-Hans"`).
+  * Or create / select a project in the desired language in [Language Studio](https://language.azure.com) when authoring knowledge bases.
+
+  The previous implicit fallback (client-level `default_language`) has been removed to avoid hidden state and to encourage explicit specification or project-level configuration.
+* Removed support for passing metadata as `Dict[str,str]` to `MetadataFilter`. Tuple form `[("key","value"), ...]` and `List[MetadataRecord]` remain supported.
+
+### Features Added
+
+* Documentation improvements: expanded README with authentication guidance, AAD usage, async examples, and troubleshooting section.
 
 ### Other Changes
 
+* Internal refactoring and dependency grooming in preparation for the authoring/runtime split.
+* Changed samples and README examples to use explicit `AnswersOptions` / `AnswersFromTextOptions` objects as the first argument when calling `get_answers` and `get_answers_from_text`.
+
 ## 1.1.0 (2022-10-13)
 
 ### Breaking Changes
@@ -102,4 +115,4 @@
 ## 1.0.0b1 (2021-07-27)
 
 ### Features Added
-* Initial release - supports querying from text records and knowledge bases.
+* Initial release - supports querying from text records and knowledge bases.

sdk/cognitivelanguage/azure-ai-language-questionanswering/MANIFEST.in

@@ -1,8 +1,8 @@
 include *.md
 include LICENSE
+include azure/ai/language/questionanswering/py.typed
+recursive-include tests *.py
+recursive-include samples *.py *.md
 include azure/__init__.py
 include azure/ai/__init__.py
 include azure/ai/language/__init__.py
-recursive-include tests *.py
-recursive-include samples *.py *.md
-include azure/ai/language/questionanswering/py.typed

sdk/cognitivelanguage/azure-ai-language-questionanswering/README.md

@@ -0,0 +1,3 @@
+{
+  "apiVersion": "2025-05-15-preview"
+}

sdk/cognitivelanguage/azure-ai-language-questionanswering/_metadata.json

@@ -0,0 +1,38 @@
+{
+    "CrossLanguagePackageId": "Language.QuestionAnswering",
+    "CrossLanguageDefinitionId": {
+        "azure.ai.language.questionanswering.models.AnswersFromTextOptions": "Language.QuestionAnswering.AnswersFromTextOptions",
+        "azure.ai.language.questionanswering.models.AnswersFromTextResult": "Language.QuestionAnswering.AnswersFromTextResult",
+        "azure.ai.language.questionanswering.models.AnswersOptions": "Language.QuestionAnswering.AnswersOptions",
+        "azure.ai.language.questionanswering.models.AnswerSpan": "Language.QuestionAnswering.AnswerSpan",
+        "azure.ai.language.questionanswering.models.AnswersResult": "Language.QuestionAnswering.AnswersResult",
+        "azure.ai.language.questionanswering.models.Error": "Language.QuestionAnswering.Error",
+        "azure.ai.language.questionanswering.models.ErrorResponse": "Language.QuestionAnswering.ErrorResponse",
+        "azure.ai.language.questionanswering.models.InnerErrorModel": "Language.QuestionAnswering.InnerErrorModel",
+        "azure.ai.language.questionanswering.models.KnowledgeBaseAnswer": "Language.QuestionAnswering.KnowledgeBaseAnswer",
+        "azure.ai.language.questionanswering.models.KnowledgeBaseAnswerContext": "Language.QuestionAnswering.KnowledgeBaseAnswerContext",
+        "azure.ai.language.questionanswering.models.KnowledgeBaseAnswerDialog": "Language.QuestionAnswering.KnowledgeBaseAnswerDialog",
+        "azure.ai.language.questionanswering.models.KnowledgeBaseAnswerPrompt": "Language.QuestionAnswering.KnowledgeBaseAnswerPrompt",
+        "azure.ai.language.questionanswering.models.MatchingPolicy": "Language.QuestionAnswering.MatchingPolicy",
+        "azure.ai.language.questionanswering.models.MetadataFilter": "Language.QuestionAnswering.MetadataFilter",
+        "azure.ai.language.questionanswering.models.MetadataRecord": "Language.QuestionAnswering.MetadataRecord",
+        "azure.ai.language.questionanswering.models.PrebuiltQueryMatchingPolicy": "Language.QuestionAnswering.PrebuiltQueryMatchingPolicy",
+        "azure.ai.language.questionanswering.models.QueryFilters": "Language.QuestionAnswering.QueryFilters",
+        "azure.ai.language.questionanswering.models.QueryPreferences": "Language.QuestionAnswering.QueryPreferences",
+        "azure.ai.language.questionanswering.models.ShortAnswerOptions": "Language.QuestionAnswering.ShortAnswerOptions",
+        "azure.ai.language.questionanswering.models.TextAnswer": "Language.QuestionAnswering.TextAnswer",
+        "azure.ai.language.questionanswering.models.TextDocument": "Language.QuestionAnswering.TextDocument",
+        "azure.ai.language.questionanswering.models.ErrorCode": "Language.QuestionAnswering.ErrorCode",
+        "azure.ai.language.questionanswering.models.InnerErrorCode": "Language.QuestionAnswering.InnerErrorCode",
+        "azure.ai.language.questionanswering.models.RankerKind": "Language.QuestionAnswering.RankerKind",
+        "azure.ai.language.questionanswering.models.LogicalOperationKind": "Language.QuestionAnswering.LogicalOperationKind",
+        "azure.ai.language.questionanswering.models.Scorer": "Language.QuestionAnswering.Scorer",
+        "azure.ai.language.questionanswering.models.MatchingPolicyKind": "Language.QuestionAnswering.MatchingPolicyKind",
+        "azure.ai.language.questionanswering.models.MatchingPolicyFieldsType": "Language.QuestionAnswering.MatchingPolicyFieldsType",
+        "azure.ai.language.questionanswering.models.StringIndexType": "Language.QuestionAnswering.StringIndexType",
+        "azure.ai.language.questionanswering.QuestionAnsweringClient.get_answers": "Language.QuestionAnsweringClientCustomizations.QuestionAnsweringClientOperations.getAnswers",
+        "azure.ai.language.questionanswering.aio.QuestionAnsweringClient.get_answers": "Language.QuestionAnsweringClientCustomizations.QuestionAnsweringClientOperations.getAnswers",
+        "azure.ai.language.questionanswering.QuestionAnsweringClient.get_answers_from_text": "Language.QuestionAnsweringClientCustomizations.QuestionAnsweringClientOperations.getAnswersFromText",
+        "azure.ai.language.questionanswering.aio.QuestionAnsweringClient.get_answers_from_text": "Language.QuestionAnsweringClientCustomizations.QuestionAnsweringClientOperations.getAnswersFromText"
+    }
+}

sdk/cognitivelanguage/azure-ai-language-questionanswering/apiview-properties.json

@@ -2,5 +2,5 @@
   "AssetsRepo": "Azure/azure-sdk-assets",
   "AssetsRepoPrefixPath": "python",
   "TagPrefix": "python/cognitivelanguage/azure-ai-language-questionanswering",
-  "Tag": "python/cognitivelanguage/azure-ai-language-questionanswering_1f7e05ddea"
+  "Tag": "python/cognitivelanguage/azure-ai-language-questionanswering_4cf6afbd99"
 }

sdk/cognitivelanguage/azure-ai-language-questionanswering/assets.json

@@ -1 +1 @@
-__path__ = __import__("pkgutil").extend_path(__path__, __name__)
+__path__ = __import__("pkgutil").extend_path(__path__, __name__)  # type: ignore

sdk/cognitivelanguage/azure-ai-language-questionanswering/azure/__init__.py

@@ -1 +1 @@
-__path__ = __import__("pkgutil").extend_path(__path__, __name__)
+__path__ = __import__("pkgutil").extend_path(__path__, __name__)  # type: ignore

sdk/cognitivelanguage/azure-ai-language-questionanswering/azure/ai/__init__.py

@@ -1 +1 @@
-__path__ = __import__("pkgutil").extend_path(__path__, __name__)
+__path__ = __import__("pkgutil").extend_path(__path__, __name__)  # type: ignore