Tool Decorators

from conversimple import tool

class MyAgent(ConversimpleAgent):
    @tool("Get current weather for a location")
    def get_weather(self, location: str) -> dict:
        """
        Get weather information for a specified location.
        
        Args:
            location: City name or location string
            
        Returns:
            Dictionary with weather information
        """
        return {"location": location, "temperature": 72, "condition": "sunny"}

from conversimple import tool_async

class MyAgent(ConversimpleAgent):
    @tool_async("Fetch user data from an external API")
    async def fetch_user_data(self, user_id: str) -> dict:
        """
        Fetches user data from an external API.
        
        Args:
            user_id: The ID of the user to fetch.
            
        Returns:
            A dictionary containing user data.
        """
        await asyncio.sleep(0.05) # Simulate an async API call
        return {"user_id": user_id, "name": "John Doe", "email": "john.doe@example.com"}