Merge branch 'lusu/agentserver-core' into lusu/agentserver-af

Author: lusu-msft

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

@@ -1,6 +1,6 @@
 # Release History
 
-## 1.0.0
+## 1.0.0a1 (2025-11-06)
 
 ### Features Added
 

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

@@ -6,3 +6,4 @@ recursive-include doc *.rst *.md
 include azure/__init__.py
 include azure/ai/__init__.py
 include azure/ai/agentserver/__init__.py
+include azure/ai/agentserver/core/py.typed

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

@@ -1,13 +1,20 @@
 # Azure AI Agent Server Adapter 
 
-## Install
 
-In current folder, run:
+## Getting started
+
 ```bash
-pip install -e .
+pip install azure-ai-agentserver-core
 ```
 
-## Usage
+## Key concepts
+
+This is the core package for Azure AI Agent server. It hosts your agent as a container on the cloud.
+
+You can talk to your agent using azure-ai-project sdk
+
+
+## Examples
 
 If your agent is not built using a supported framework such as LangGraph and Agent-framework, you can still make it compatible with Microsoft AI Foundry by manually implementing the predefined interface.
 
@@ -76,3 +83,37 @@ if __name__ == "__main__":
     my_agent.run()
 
 ```
+
+## Troubleshooting
+
+First run your agent with azure-ai-agentserver-core locally.
+
+If it works on local by failed on cloud. Check your logs in the application insight connected to your Azure AI Foundry Project.
+
+
+### Reporting issues
+
+To report an issue with the client library, or request additional features, please open a GitHub issue [here](https://github.com/Azure/azure-sdk-for-python/issues). Mention the package name "azure-ai-agents" in the title or content.
+
+
+## Next steps
+
+Please visit [Samples](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/ai/azure-ai-agentserver-core/samples) folder. There are several cases 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/ai/azure-ai-agentserver-core/azure/ai/agentserver/core/models/_create_response.py

@@ -1,11 +1,12 @@
 # ---------------------------------------------------------
 # Copyright (c) Microsoft Corporation. All rights reserved.
 # ---------------------------------------------------------
+# pylint: disable=no-name-in-module
 from typing import Optional
 
-from .openai import response_create_params #pylint: disable=no-name-in-module
+from .openai import response_create_params   # type: ignore
 from . import projects as _azure_ai_projects_models
 
-class CreateResponse(response_create_params.ResponseCreateParamsBase, total=False):
+class CreateResponse(response_create_params.ResponseCreateParamsBase, total=False): # type: ignore
     agent: Optional[_azure_ai_projects_models.AgentReference]
     stream: Optional[bool]

sdk/ai/azure-ai-agentserver-core/azure/ai/agentserver/core/models/projects/_models.py

@@ -47,7 +47,7 @@
 )
 
 if TYPE_CHECKING:
-    from .. import _types, models as _models
+    from .. import _types, models as _models   # type: ignore
 
 
 class Tool(_Model):

sdk/ai/azure-ai-agentserver-core/azure/ai/agentserver/core/models/projects/py.typed

@@ -60,10 +60,20 @@ def set_request_id_to_context_var(self, request):
             request_context.set(ctx)
 
     def set_run_context_to_context_var(self, run_context):
+        agent_id = ""
+        agent_obj = run_context.get_agent_id_object()
+        if agent_obj:
+            agent_name = getattr(agent_obj, "name", "")
+            agent_version = getattr(agent_obj, "version", "")
+            agent_id = f"{agent_name}:{agent_version}"
+
         res = {
             "azure.ai.agentshosting.response_id": run_context.response_id or "",
             "azure.ai.agentshosting.conversation_id": run_context.conversation_id or "",
             "azure.ai.agentshosting.streaming": str(run_context.stream or False),
+            "gen_ai.agent.id": agent_id,
+            "gen_ai.provider.name": "AzureAI Hosted Agents",
+            "gen_ai.response.id": run_context.response_id or "",
         }
         ctx = request_context.get() or {}
         ctx.update(res)

sdk/ai/azure-ai-agentserver-core/azure/ai/agentserver/core/py.typed

@@ -46,7 +46,7 @@ def stream(self) -> bool:
     def get_agent_id_object(self) -> AgentId:
         agent = self.request.get("agent")
         if not agent:
-            return None
+            return None   # type: ignore
         return AgentId(
             {
                 "type": agent.type,
@@ -57,7 +57,7 @@ def get_agent_id_object(self) -> AgentId:
 
     def get_conversation_object(self) -> ResponseConversation1:
         if not self._conversation_id:
-            return None
+            return None   # type: ignore
         return ResponseConversation1(id=self._conversation_id)
 
 
@@ -72,5 +72,5 @@ def _deserialize_create_response(payload: dict) -> CreateResponse:
 
 def _deserialize_agent_reference(payload: dict) -> AgentReference:
     if not payload:
-        return None
+        return None   # type: ignore
     return AgentReference(**payload)

sdk/ai/azure-ai-agentserver-core/azure/ai/agentserver/core/server/base.py

@@ -0,0 +1,27 @@
+{
+    "ignoreWords": [
+      "Agentic",
+      "UPIA",
+      "ANSII",
+      "inpainting",
+      "CSDL",
+      "azureai",
+      "GLEU",
+      "fstring",
+      "alnum",
+      "GENAI",
+      "Prereqs",
+      "mslearn",
+      "PYTHONIOENCODING",
+      "GETFL",
+      "DETFL",
+      "SETFL",
+      "Planifica"
+    ],
+    "ignorePaths": [
+      "*.csv",
+      "*.json",
+      "*.rst",
+      "samples/**"
+    ]
+  }