xpander-sdk 2.0.108__tar.gz → 2.0.157__tar.gz

{xpander_sdk-2.0.108 → xpander_sdk-2.0.157}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xpander-sdk
-Version: 2.0.108
+Version: 2.0.157
 Summary: xpander.ai Backend-as-a-service for AI Agents - SDK
 Home-page: https://www.xpander.ai
 Author: xpanderAI
@@ -18,6 +18,8 @@ Requires-Dist: loguru
 Requires-Dist: httpx
 Requires-Dist: httpx_sse
 Requires-Dist: nest-asyncio
+Requires-Dist: strands-agents
+Requires-Dist: openai-agents
 Provides-Extra: agno
 Requires-Dist: agno; extra == "agno"
 Requires-Dist: sqlalchemy; extra == "agno"
@@ -31,6 +33,8 @@ Requires-Dist: anthropic; extra == "dev"
 Requires-Dist: mcp; extra == "dev"
 Requires-Dist: openai; extra == "dev"
 Requires-Dist: fireworks-ai; extra == "dev"
+Requires-Dist: aioboto3; extra == "dev"
+Requires-Dist: google-genai; extra == "dev"
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -47,7 +51,6 @@ Dynamic: summary
 
 [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Documentation](https://img.shields.io/badge/docs-available-brightgreen.svg)](https://docs.xpander.ai) [![PyPI Version](https://img.shields.io/pypi/v/xpander-sdk?label=PyPI)](https://pypi.org/project/xpander-sdk/) [![Downloads](https://pepy.tech/badge/xpander-sdk)](https://pepy.tech/project/xpander-sdk)
 
-
 The official Python SDK for xpander.ai - a powerful Backend-as-a-Service (BaaS) platform for building, deploying, and managing AI agents at scale.
 
 ## 🚀 Overview
@@ -128,6 +131,11 @@ tasks = Tasks(configuration=config)
 task = await tasks.aget("task-id")
 await task.aset_status(AgentExecutionStatus.Running)
 await task.asave()
+
+# Retrieve task activity log
+activity_log = await task.aget_activity_log()
+for message in activity_log.messages:
+    print(f"{message.role}: {message.content.text}")
 ```
 
 ### 4. Tools Integration
@@ -284,6 +292,40 @@ async for event in task.aevents():
     print(f"Event Data: {event.data}")
 ```
 
+### Task Activity Monitoring
+
+```python
+from xpander_sdk import Task
+from xpander_sdk.models.activity import (
+    AgentActivityThreadMessage,
+    AgentActivityThreadToolCall,
+    AgentActivityThreadReasoning
+)
+
+# Load a completed task
+task = await Task.aload("task-id")
+
+# Get detailed activity log
+activity_log = await task.aget_activity_log()
+
+# Analyze messages between user and agent
+for message in activity_log.messages:
+    if isinstance(message, AgentActivityThreadMessage):
+        print(f"{message.role}: {message.content.text}")
+    elif isinstance(message, AgentActivityThreadToolCall):
+        # Tool call
+        print(f"Tool: {message.tool_name}")
+        print(f"Payload: {message.payload}")
+        print(f"Result: {message.result}")
+    elif isinstance(message, AgentActivityThreadReasoning):
+        # Reasoning step
+        print(f"Reasoning ({message.type}): {message.thought}")
+
+# Synchronous version
+task = Task.load("task-id")
+activity_log = task.get_activity_log()
+```
+
 ### Local Task Testing
 
 ```python
@@ -304,7 +346,7 @@ async def handle_test_task(task):
     task.result = {
         "capabilities": [
             "Data analysis",
-            "Text processing", 
+            "Text processing",
             "API integration"
         ]
     }
@@ -375,6 +417,93 @@ load_dotenv()
 config = Configuration()
 ```
 
+## 🏢 Self-Hosted Deployment
+
+If you're using a self-hosted xpander.ai deployment, configure the SDK to point to your Agent Controller endpoint.
+
+**Important**: Use the **Agent Controller API key** generated during Helm installation, not your xpander.ai cloud API key.
+
+### Configuration
+
+```bash
+# Set environment variables
+export XPANDER_API_KEY="your-agent-controller-api-key"  # From Helm installation
+export XPANDER_ORGANIZATION_ID="your-org-id"
+export XPANDER_BASE_URL="https://agent-controller.my-company.com"
+```
+
+Or configure explicitly:
+
+```python
+from xpander_sdk import Configuration
+
+config = Configuration(
+    api_key="your-agent-controller-api-key",  # From Helm installation
+    organization_id="your-org-id",
+    base_url="https://agent-controller.my-company.com"
+)
+```
+
+### Using with Agno Framework
+
+```python
+from xpander_sdk import Backend, Configuration
+from agno.agent import Agent
+
+# Configure for self-hosted
+config = Configuration(
+    api_key="your-agent-controller-api-key",  # From Helm installation
+    organization_id="your-org-id",
+    base_url="https://agent-controller.my-company.com"
+)
+
+# Initialize Backend with self-hosted config
+backend = Backend(configuration=config)
+
+# Create agent - it will use your self-hosted infrastructure
+agno_agent = Agent(**backend.get_args(agent_id="agent-123"))
+
+# Run agent
+result = await agno_agent.arun(
+    input="What can you help me with?",
+    stream=True
+)
+```
+
+### Complete Self-Hosted Example
+
+```python
+import asyncio
+from xpander_sdk import Configuration, Agent
+
+async def main():
+    # Configure for self-hosted deployment
+    config = Configuration(
+        api_key="your-agent-controller-api-key",  # From Helm installation
+        organization_id="your-org-id",
+        base_url="https://agent-controller.my-company.com"
+    )
+    
+    # Load agent from self-hosted deployment
+    agent = await Agent.aload("agent-123", configuration=config)
+    print(f"Agent: {agent.name}")
+    
+    # Create and execute task
+    task = await agent.acreate_task(
+        prompt="Analyze Q4 sales data",
+        file_urls=["https://example.com/sales-q4.csv"]
+    )
+    print(f"Task created: {task.id}")
+    print(f"Status: {task.status}")
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+**Important**: Make sure your `base_url` points to the Agent Controller endpoint (e.g., `https://agent-controller.{your-domain}`), not the root domain.
+
+📖 **Full Guide**: [Self-Hosted Configuration Documentation](https://docs.xpander.ai/api-reference/configuration/self-hosted)
+
 ## 🔄 Error Handling
 
 ```python
@@ -389,9 +518,9 @@ except ModuleException as e:
 ## 🤝 Contributing
 
 1. Fork the repository
-2. Create a feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit your changes (`git commit -m 'Add amazing feature'`)
-4. Push to the branch (`git push origin feature/amazing-feature`)
+2. Create a feature branch (`git checkout -b feature/{base_branch}/amazing-feature`)
+3. Commit your changes (`git commit -m 'feat/chore/fix: Add amazing feature'`)
+4. Push to the branch (`git push origin feature/{base_branch}/amazing-feature`)
 5. Open a Pull Request
 
 ## 📄 License
@@ -402,7 +531,7 @@ This project is licensed under the MIT License - see the LICENSE file for detail
 
 - **Documentation**: [https://docs.xpander.ai](https://docs.xpander.ai)
 - **Issues**: [GitHub Issues](https://github.com/xpander-ai/xpander-sdk/issues)
-- **Email**: dev@xpander.ai
+- **Email**: support@xpander.ai
 
 ---
 

{xpander_sdk-2.0.108 → xpander_sdk-2.0.157}/README.md

@@ -2,7 +2,6 @@
 
 [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Documentation](https://img.shields.io/badge/docs-available-brightgreen.svg)](https://docs.xpander.ai) [![PyPI Version](https://img.shields.io/pypi/v/xpander-sdk?label=PyPI)](https://pypi.org/project/xpander-sdk/) [![Downloads](https://pepy.tech/badge/xpander-sdk)](https://pepy.tech/project/xpander-sdk)
 
-
 The official Python SDK for xpander.ai - a powerful Backend-as-a-Service (BaaS) platform for building, deploying, and managing AI agents at scale.
 
 ## 🚀 Overview
@@ -83,6 +82,11 @@ tasks = Tasks(configuration=config)
 task = await tasks.aget("task-id")
 await task.aset_status(AgentExecutionStatus.Running)
 await task.asave()
+
+# Retrieve task activity log
+activity_log = await task.aget_activity_log()
+for message in activity_log.messages:
+    print(f"{message.role}: {message.content.text}")
 ```
 
 ### 4. Tools Integration
@@ -239,6 +243,40 @@ async for event in task.aevents():
     print(f"Event Data: {event.data}")
 ```
 
+### Task Activity Monitoring
+
+```python
+from xpander_sdk import Task
+from xpander_sdk.models.activity import (
+    AgentActivityThreadMessage,
+    AgentActivityThreadToolCall,
+    AgentActivityThreadReasoning
+)
+
+# Load a completed task
+task = await Task.aload("task-id")
+
+# Get detailed activity log
+activity_log = await task.aget_activity_log()
+
+# Analyze messages between user and agent
+for message in activity_log.messages:
+    if isinstance(message, AgentActivityThreadMessage):
+        print(f"{message.role}: {message.content.text}")
+    elif isinstance(message, AgentActivityThreadToolCall):
+        # Tool call
+        print(f"Tool: {message.tool_name}")
+        print(f"Payload: {message.payload}")
+        print(f"Result: {message.result}")
+    elif isinstance(message, AgentActivityThreadReasoning):
+        # Reasoning step
+        print(f"Reasoning ({message.type}): {message.thought}")
+
+# Synchronous version
+task = Task.load("task-id")
+activity_log = task.get_activity_log()
+```
+
 ### Local Task Testing
 
 ```python
@@ -259,7 +297,7 @@ async def handle_test_task(task):
     task.result = {
         "capabilities": [
             "Data analysis",
-            "Text processing", 
+            "Text processing",
             "API integration"
         ]
     }
@@ -330,6 +368,93 @@ load_dotenv()
 config = Configuration()
 ```
 
+## 🏢 Self-Hosted Deployment
+
+If you're using a self-hosted xpander.ai deployment, configure the SDK to point to your Agent Controller endpoint.
+
+**Important**: Use the **Agent Controller API key** generated during Helm installation, not your xpander.ai cloud API key.
+
+### Configuration
+
+```bash
+# Set environment variables
+export XPANDER_API_KEY="your-agent-controller-api-key"  # From Helm installation
+export XPANDER_ORGANIZATION_ID="your-org-id"
+export XPANDER_BASE_URL="https://agent-controller.my-company.com"
+```
+
+Or configure explicitly:
+
+```python
+from xpander_sdk import Configuration
+
+config = Configuration(
+    api_key="your-agent-controller-api-key",  # From Helm installation
+    organization_id="your-org-id",
+    base_url="https://agent-controller.my-company.com"
+)
+```
+
+### Using with Agno Framework
+
+```python
+from xpander_sdk import Backend, Configuration
+from agno.agent import Agent
+
+# Configure for self-hosted
+config = Configuration(
+    api_key="your-agent-controller-api-key",  # From Helm installation
+    organization_id="your-org-id",
+    base_url="https://agent-controller.my-company.com"
+)
+
+# Initialize Backend with self-hosted config
+backend = Backend(configuration=config)
+
+# Create agent - it will use your self-hosted infrastructure
+agno_agent = Agent(**backend.get_args(agent_id="agent-123"))
+
+# Run agent
+result = await agno_agent.arun(
+    input="What can you help me with?",
+    stream=True
+)
+```
+
+### Complete Self-Hosted Example
+
+```python
+import asyncio
+from xpander_sdk import Configuration, Agent
+
+async def main():
+    # Configure for self-hosted deployment
+    config = Configuration(
+        api_key="your-agent-controller-api-key",  # From Helm installation
+        organization_id="your-org-id",
+        base_url="https://agent-controller.my-company.com"
+    )
+    
+    # Load agent from self-hosted deployment
+    agent = await Agent.aload("agent-123", configuration=config)
+    print(f"Agent: {agent.name}")
+    
+    # Create and execute task
+    task = await agent.acreate_task(
+        prompt="Analyze Q4 sales data",
+        file_urls=["https://example.com/sales-q4.csv"]
+    )
+    print(f"Task created: {task.id}")
+    print(f"Status: {task.status}")
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+**Important**: Make sure your `base_url` points to the Agent Controller endpoint (e.g., `https://agent-controller.{your-domain}`), not the root domain.
+
+📖 **Full Guide**: [Self-Hosted Configuration Documentation](https://docs.xpander.ai/api-reference/configuration/self-hosted)
+
 ## 🔄 Error Handling
 
 ```python
@@ -344,9 +469,9 @@ except ModuleException as e:
 ## 🤝 Contributing
 
 1. Fork the repository
-2. Create a feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit your changes (`git commit -m 'Add amazing feature'`)
-4. Push to the branch (`git push origin feature/amazing-feature`)
+2. Create a feature branch (`git checkout -b feature/{base_branch}/amazing-feature`)
+3. Commit your changes (`git commit -m 'feat/chore/fix: Add amazing feature'`)
+4. Push to the branch (`git push origin feature/{base_branch}/amazing-feature`)
 5. Open a Pull Request
 
 ## 📄 License
@@ -357,7 +482,7 @@ This project is licensed under the MIT License - see the LICENSE file for detail
 
 - **Documentation**: [https://docs.xpander.ai](https://docs.xpander.ai)
 - **Issues**: [GitHub Issues](https://github.com/xpander-ai/xpander-sdk/issues)
-- **Email**: dev@xpander.ai
+- **Email**: support@xpander.ai
 
 ---
 

{xpander_sdk-2.0.108 → xpander_sdk-2.0.157}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setup(
     name="xpander-sdk",
-    version="2.0.108",
+    version="2.0.157",
     author="xpanderAI",
     author_email="dev@xpander.ai",
     description="xpander.ai Backend-as-a-service for AI Agents - SDK",
@@ -22,10 +22,12 @@ setup(
         "httpx",
         "httpx_sse",
         "nest-asyncio",
+        "strands-agents",
+        "openai-agents",
     ],
     extras_require={
         "agno": ["agno", "sqlalchemy" ,"psycopg[binary,pool]", "greenlet"],
-        "dev": ["black", "pre-commit", "pytest", "anthropic", "mcp", "openai", "fireworks-ai"],
+        "dev": ["black", "pre-commit", "pytest", "anthropic", "mcp", "openai", "fireworks-ai", "aioboto3", "google-genai"],
     },
     classifiers=[
         "Programming Language :: Python :: 3",

{xpander_sdk-2.0.108 → xpander_sdk-2.0.157}/src/xpander_sdk/consts/api_routes.py

@@ -35,10 +35,12 @@ and deleting resources.
     ListTasks = "/agent-execution/executions/history/{agent_id}"
     ListUserTasks = "/agent-execution/executions/history/user/{user_id}"
     GetTask = "/agent-execution/{task_id}/status"
+    GetTaskActivityLog = "/activity/{agent_id}/{task_id}"
     TaskCrud = "/agent-execution/{agent_or_task_id}"
     UpdateTask = "/agent-execution/{task_id}/update"
     ReportExternalTask = "/agent-execution/{agent_id}/report_task"
     ReportExecutionMetrics = "/agents-metrics/{agent_id}/execution"
+    PushExecutionEventToQueue = "/agent-execution/{task_id}/events/push"
     
     # Knowledge Bases Endpoints
     ListKnowledgeBases = "/knowledge_bases"
@@ -48,6 +50,9 @@ and deleting resources.
     KnowledgeBaseDocumentsCrud = "/knowledge_bases/{knowledge_base_id}"
     GetKnowledgeBaseDetails = "/knowledge_bases/{knowledge_base_id}/details"
     
+    # MCP Auth
+    GetUserMCPAuthToken = "/mcp_auth/{agent_id}/{user_id}/get_token"
+    
     # Tools
     GetOrInvokeToolById = "/tools/{tool_id}"
 

{xpander_sdk-2.0.108 → xpander_sdk-2.0.157}/src/xpander_sdk/core/xpander_api_client.py

@@ -8,6 +8,7 @@ requests to the xpander.ai Backend-as-a-Service platform.
 from abc import ABC
 from typing import Optional, Any, Literal, Dict
 import httpx
+from pydantic import BaseModel
 
 from xpander_sdk.models.configuration import Configuration
 
@@ -67,6 +68,7 @@ class APIClient(ABC):
         query: Optional[Dict[str, Any]] = None,
         headers: Optional[Dict[str, Any]] = None,
         configuration: Optional[Configuration] = None,
+        model: Optional[BaseModel] = None,
     ) -> Any:
         """
         Make an authenticated HTTP request to the xpander.ai API.
@@ -78,6 +80,7 @@ class APIClient(ABC):
             query (Optional[Dict[str, Any]]): Query string parameters.
             headers (Optional[Dict[str, Any]]): Extra headers.
             configuration (Optional[Configuration]): Overrides self.configuration.
+            model (Optional[BaseModel]): pydantic model to use when constructing the result.
         
         Returns:
             Any: Parsed response body (JSON or text).
@@ -110,7 +113,7 @@ class APIClient(ABC):
             content_type = response.headers.get("Content-Type", "")
             if "application/json" in content_type:
                 try:
-                    return response.json()
+                    return response.json() if not model else model(**response.json())
                 except Exception:
                     return response.text
             return response.text

xpander_sdk-2.0.157/src/xpander_sdk/models/activity.py

@@ -0,0 +1,65 @@
+from datetime import datetime
+from enum import Enum
+from typing import Any, List, Literal, Optional, Union
+
+from xpander_sdk.models.events import ToolCallRequestReasoning
+from xpander_sdk.models.shared import XPanderSharedModel
+from xpander_sdk.models.user import User
+from xpander_sdk.modules.tools_repository.models.mcp import MCPOAuthGetTokenResponse
+
+class AgentActivityThreadMessageContent(XPanderSharedModel):
+    text: Optional[str] = None
+    files: Optional[List[str]] = []
+
+class AgentActivityThreadMessage(XPanderSharedModel):
+    id: str
+    created_at: datetime
+    role: Literal["user","agent"]
+    content: AgentActivityThreadMessageContent
+
+class AgentActivityThreadToolCall(XPanderSharedModel):
+    id: str
+    created_at: datetime
+    tool_name: str
+    payload: Any
+    is_error: Optional[bool] = False
+    reasoning: Optional[ToolCallRequestReasoning] = None
+    result: Optional[Any] = None
+
+class AgentActivityThreadReasoningType(str, Enum):
+    Think = "think"
+    Analyze = "analyze"
+
+class AgentActivityThreadReasoning(XPanderSharedModel):
+    id: str
+    created_at: datetime
+    type: AgentActivityThreadReasoningType
+    title: str
+    confidence: float
+    thought: Optional[str] = None
+    action: Optional[str] = None
+    result: Optional[str] = None
+    analysis: Optional[str] = None
+
+class AgentActivityThreadSubAgentTrigger(XPanderSharedModel):
+    id: str
+    created_at: datetime
+    agent_id: str
+    query: Optional[str] = None
+    files: Optional[List[str]] = []
+    reasoning: ToolCallRequestReasoning
+
+class AgentActivityThreadAuth(MCPOAuthGetTokenResponse):
+    id: str
+    created_at: datetime
+
+AgentActivityThreadMessageType = Union[AgentActivityThreadMessage, AgentActivityThreadToolCall, AgentActivityThreadReasoning, AgentActivityThreadSubAgentTrigger, AgentActivityThreadAuth]
+class AgentActivityThread(XPanderSharedModel):
+    id: str
+    created_at: datetime
+    messages: List[AgentActivityThreadMessageType]
+    user: Optional[User] = None
+
+class AgentActivityThreadListItem(XPanderSharedModel):
+    id: str
+    created_at: datetime

{xpander_sdk-2.0.108 → xpander_sdk-2.0.157}/src/xpander_sdk/models/configuration.py

@@ -47,6 +47,11 @@ class Configuration(BaseModel):
         description="Base URL for xpander.ai API endpoints"
     )
     
+    agent_id: Optional[str] = Field(
+        default= None, 
+        description="Agent ID To work on"
+    )
+    
     organization_id: Optional[str] = Field(
         default_factory=lambda: getenv(key="XPANDER_ORGANIZATION_ID"),
         description="Organization identifier for xpander.ai account",

{xpander_sdk-2.0.108 → xpander_sdk-2.0.157}/src/xpander_sdk/models/events.py

@@ -54,6 +54,9 @@ class TaskUpdateEventType(str, Enum):
     
     # streaming
     Chunk = "chunk"
+    
+    # MCP Auth
+    AuthEvent = "auth_event"
 
     # tool calls
     ToolCallRequest = "tool_call_request"

{xpander_sdk-2.0.108 → xpander_sdk-2.0.157}/src/xpander_sdk/models/frameworks.py

@@ -12,7 +12,15 @@ class Framework(str, Enum):
     """
 
     Agno = "agno"
+    GoogleADK = "google-adk"
+    LangChain = "langchain"
+    OpenAIAgents = "open-ai-agents"
+    Strands = "strands-agents"
 
+class AgnoToolCallsCompressionSettings(BaseModel):
+    enabled: Optional[bool] = False
+    threshold: Optional[int] = 3
+    instructions: Optional[str] = ""
 
 class AgnoSettings(BaseModel):
     """
@@ -34,7 +42,13 @@ class AgnoSettings(BaseModel):
     """
 
     session_storage: Optional[bool] = True
-    user_memories: Optional[bool] = True
+    
+    user_memories: Optional[bool] = False
+    agentic_memory: Optional[bool] = False
+    
+    agent_memories: Optional[bool] = False
+    agentic_culture: Optional[bool] = False
+    
     session_summaries: Optional[bool] = False
     num_history_runs: Optional[int] = 3
     max_tool_calls_from_history: Optional[int] = 0
@@ -46,3 +60,5 @@ class AgnoSettings(BaseModel):
     openai_moderation_enabled: Optional[bool] = False
     openai_moderation_categories: Optional[List[str]] = None
     reasoning_tools_enabled: Optional[bool] = False
+    
+    tool_calls_compression: Optional[AgnoToolCallsCompressionSettings] = None

{xpander_sdk-2.0.108 → xpander_sdk-2.0.157}/src/xpander_sdk/models/shared.py

@@ -96,3 +96,7 @@ class Tokens(BaseModel):
 class ExecutionTokens(BaseModel):
     inner: Optional[Tokens] = Tokens()
     worker: Optional[Tokens] = Tokens()
+
+class ThinkMode(str, Enum):
+    Default = "default"
+    Harder = "harder"

{xpander_sdk-2.0.108 → xpander_sdk-2.0.157}/src/xpander_sdk/modules/agents/agents_module.py

@@ -6,7 +6,7 @@ within the xpander.ai Backend-as-a-Service platform.
 """
 
 from typing import List, Optional
-
+from os import getenv
 from httpx import HTTPStatusError
 
 from xpander_sdk.consts.api_routes import APIRoute
@@ -99,7 +99,7 @@ class Agents(ModuleBase):
         """
         return run_sync(self.alist())
 
-    async def aget(self, agent_id: str, version: Optional[int] = None) -> Agent:
+    async def aget(self, agent_id: Optional[str] = None, version: Optional[int] = None) -> Agent:
         """
         Asynchronously retrieve a specific agent by ID.
         
@@ -108,7 +108,7 @@ class Agents(ModuleBase):
         a specific version of the agent.
         
         Args:
-            agent_id (str): Unique identifier of the agent to retrieve.
+            agent_id (Optional[str]): Unique identifier of the agent to retrieve, Fallback to XPANDER_AGENT_ID.
             version (Optional[int]): Specific version number to load. If None,
                 loads the latest version.
                 
@@ -127,9 +127,12 @@ class Agents(ModuleBase):
             >>> # Load specific version
             >>> agent_v2 = await agents.aget("agent-123", version=2)
         """
-        return await Agent.aload(agent_id=agent_id, configuration=self.configuration, version=version)
+        return await Agent.aload(
+            agent_id=agent_id or self.configuration.agent_id or getenv("XPANDER_AGENT_ID"),
+            configuration=self.configuration, version=version
+        )
 
-    def get(self, agent_id: str, version: Optional[int] = None) -> Agent:
+    def get(self, agent_id: Optional[str] = None, version: Optional[int] = None) -> Agent:
         """
         Synchronously retrieve a specific agent by ID.
         
@@ -137,7 +140,7 @@ class Agents(ModuleBase):
         asynchronous method and waits for completion.
         
         Args:
-            agent_id (str): Unique identifier of the agent to retrieve.
+            agent_id (Optional[str]): Unique identifier of the agent to retrieve, Fallback to XPANDER_AGENT_ID.
             version (Optional[int]): Specific version number to load. If None,
                 loads the latest version.
                 
@@ -153,4 +156,9 @@ class Agents(ModuleBase):
             >>> agent = agents.get("agent-123")
             >>> result = agent.execute("What is the weather today?")
         """
-        return run_sync(self.aget(agent_id=agent_id, version=version))
+        return run_sync(
+            self.aget(
+            agent_id=agent_id,
+            version=version
+            )
+        )