Merge branch 'main' into hotfix/azure-ai-evaluation/1.13.3

Author: slister1001

eng/.docsettings.yml

@@ -22,7 +22,7 @@ omitted_paths:
 language: python
 root_check_enabled: True
 required_readme_sections:
-  - ^Azure (.+ client library for Python|Smoke Test for Python)
+  - ^Azure (.+ client library for Python|Smoke Test for Python|AI Agent Server Adapter for .*Python)
   - ^Getting started$
   - ^Key concepts$
   - ^Examples$

eng/common/tsp-client/package-lock.json

@@ -1,5 +1,5 @@
 {
   "dependencies": {
-    "@azure-tools/typespec-client-generator-cli": "0.29.0"
+    "@azure-tools/typespec-client-generator-cli": "0.30.0"
   }
 }

eng/common/tsp-client/package.json

@@ -64,6 +64,9 @@ parameters:
   - name: EnvVars
     type: object
     default: {}
+  - name: PythonVersionForAnalyze
+    type: string
+    default: ''
 
 jobs:
   - job: 'Build_Linux'
@@ -217,11 +220,10 @@ jobs:
 
     steps:
     - task: UsePythonVersion@0
-      displayName: 'Use Python $(PythonVersion)'
+      displayName: "Use Python ${{ coalesce(parameters.PythonVersionForAnalyze, '$(PythonVersion)') }}"
       condition: succeededOrFailed()
       inputs:
-        versionSpec: '$(PythonVersion)'
-
+        versionSpec: ${{ coalesce(parameters.PythonVersionForAnalyze, '$(PythonVersion)') }}
     - template: /eng/pipelines/templates/steps/use-venv.yml
 
     - template: /eng/common/pipelines/templates/steps/check-spelling.yml

eng/pipelines/templates/jobs/ci.yml

@@ -84,6 +84,9 @@ parameters:
   - name: EnvVars
     type: object
     default: {}
+  - name: PythonVersionForAnalyze
+    type: string
+    default: ''
 
 extends:
   template: /eng/pipelines/templates/stages/1es-redirect.yml
@@ -120,6 +123,7 @@ extends:
               VerifyAutorest: ${{ parameters.VerifyAutorest }}
               TestProxy: ${{ parameters.TestProxy }}
               GenerateApiReviewForManualOnly: ${{ parameters.GenerateApiReviewForManualOnly }}
+              PythonVersionForAnalyze: ${{ parameters.PythonVersionForAnalyze }}
 
         variables:
           - template: /eng/pipelines/templates/variables/globals.yml

eng/pipelines/templates/stages/archetype-sdk-client.yml

@@ -0,0 +1,7 @@
+# Release History
+
+## 1.0.0b1 (2025-11-07)
+
+### Features Added
+
+First version

sdk/agentserver/azure-ai-agentserver-agentframework/CHANGELOG.md

@@ -0,0 +1,21 @@
+Copyright (c) Microsoft Corporation.
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sdk/agentserver/azure-ai-agentserver-agentframework/LICENSE

@@ -0,0 +1,9 @@
+include *.md
+include LICENSE
+recursive-include tests *.py
+recursive-include samples *.py *.md
+recursive-include doc *.rst *.md
+include azure/__init__.py
+include azure/ai/__init__.py
+include azure/ai/agentserver/__init__.py
+include azure/ai/agentserver/agentframework/py.typed

sdk/agentserver/azure-ai-agentserver-agentframework/MANIFEST.in

@@ -0,0 +1,59 @@
+# Azure AI Agent Server Adapter for Agent-framework Python
+
+
+
+## Getting started
+
+```bash
+pip install azure-ai-agentserver-agentframework
+```
+
+
+## Key concepts
+
+Azure AI Agent Server wraps your Agent-framework agent, and host it on the cloud.
+
+
+## Examples
+
+```python
+# your existing agent
+from my_framework_agent import my_awesome_agent
+
+# agent framework utils
+from azure.ai.agentserver.agentframework import from_agent_framework
+
+if __name__ == "__main__":
+    # with this simple line, your agent will be hosted on http://localhost:8088
+    from_agent_framework(my_awesome_agent).run()
+
+```
+
+## Troubleshooting
+
+First run your agent with azure-ai-agentserver-agentframework locally.
+
+If it works on local but failed on cloud. Check your logs in the application insight connected to your Azure AI Foundry Project.
+
+
+## Next steps
+
+Please visit [Samples](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/agentserver/azure-ai-agentserver-agentframework/samples) folder. There are several samples for you to build your agent with azure-ai-agentserver
+
+
+## Contributing
+
+This project welcomes contributions and suggestions. Most contributions require
+you to agree to a Contributor License Agreement (CLA) declaring that you have
+the right to, and actually do, grant us the rights to use your contribution.
+For details, visit https://cla.microsoft.com.
+
+When you submit a pull request, a CLA-bot will automatically determine whether
+you need to provide a CLA and decorate the PR appropriately (e.g., label,
+comment). Simply follow the instructions provided by the bot. You will only
+need to do this once across all repos using our CLA.
+
+This project has adopted the
+[Microsoft Open Source Code of Conduct][code_of_conduct]. For more information,
+see the Code of Conduct FAQ or contact [email protected] with any
+additional questions or comments.

sdk/agentserver/azure-ai-agentserver-agentframework/README.md

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