Add agent ID generation and assignment logic

Introduces a method to generate unique assistant IDs in MCPEnabledBase and adds get_agent_id to retrieve or create agent IDs. Updates FoundryAgentTemplate to assign agent IDs when initializing ChatAgent instances, ensuring consistent agent identification.

Author: Fr4nc3

src/backend/v4/magentic_agents/common/lifecycle.py

@@ -3,6 +3,8 @@
 import logging
 import os
 from contextlib import AsyncExitStack
+import secrets
+import string
 from typing import Any, Optional
 
 from agent_framework import (
@@ -155,6 +157,33 @@ def get_chat_client(self, chat_client) -> AzureAIAgentClient:
             extra={"agent_id": chat_client.agent_id},
         )
         return chat_client
+    def generate_assistant_id(self, prefix: str = "asst_", length: int = 24) -> str:
+        """
+        Generate a unique ID like 'asst_jRgR5t2U7o8nUPkNGv5HWOgV'.
+
+        - prefix: leading string (defaults to 'asst_')
+        - length: number of random characters after the prefix
+        """
+        # URL-safe characters similar to what OpenAI-style IDs use
+        alphabet = string.ascii_letters + string.digits  # a-zA-Z0-9
+
+        # cryptographically strong randomness
+        random_part = "".join(secrets.choice(alphabet) for _ in range(length))
+        return f"{prefix}{random_part}"
+
+    def get_agent_id(self, chat_client) -> str:
+        """Return the underlying agent ID."""
+        if chat_client and chat_client.agent_id is not None:
+            return chat_client.agent_id
+        if (
+            self._agent
+            and self._agent.chat_client
+            and self._agent.chat_client.agent_id is not None
+        ):
+            return self._agent.chat_client.agent_id  # type: ignore
+        id = self.generate_assistant_id()
+        self.logger.info("Generated new agent ID: %s", id)
+        return id
 
     async def get_database_team_agent(self) -> Optional[AzureAIAgentClient]:
         """Retrieve existing team agent from database, if any."""

src/backend/v4/magentic_agents/foundry_agent.py

@@ -235,7 +235,8 @@ async def _after_open(self) -> None:
 
                 # In Azure Search raw tool path, tools/tool_choice are handled server-side.
                 self._agent = ChatAgent(
-                    chat_client=self.get_chat_client(chatClient),
+                    id=self.get_agent_id(chat_client),
+                    chat_client=self.get_chat_client(chat_client),
                     instructions=self.agent_instructions,
                     name=self.agent_name,
                     description=self.agent_description,
@@ -248,6 +249,7 @@ async def _after_open(self) -> None:
                 self.logger.info("Initializing agent in MCP mode.")
                 tools = await self._collect_tools()
                 self._agent = ChatAgent(
+                    id=self.get_agent_id(chatClient),
                     chat_client=self.get_chat_client(chatClient),
                     instructions=self.agent_instructions,
                     name=self.agent_name,