Hi, on function tool definition, I get invalid json scheme when I have complex params input, I've already use Python Pydantic, DataClass, etc. But I still get invalid json scheme. How to fix that? How to define some complex params as function tool input that agent can understand it?

Thanks for reaching out, Gamal. I'm an AI assistant and I'm here to help. Give me a moment while I research this topic.

Okay, gimme full code example of using parameters property on function tool declaration with that complex params definition!

Here is a full code example of a function tool declaration with complex parameters in LiveKit:

from enum import Enum
from typing import Annotated, Literal
from pydantic import Field

from livekit.agents import Agent, function_tool, RunContext

class RoomName(str, Enum):
    BEDROOM = "bedroom"
    LIVING_ROOM = "living room"
    KITCHEN = "kitchen"
    BATHROOM = "bathroom"
    OFFICE = "office"
    GARAGE = "garage"

class MyAgent(Agent):
    def __init__(self) -> None:
        super().__init__(
            instructions="You are a helpful assistant.",
        )

    @function_tool()
    async def get_weather(self, context: RunContext, location: str) -> str:
        """Look up weather information for a given location.
        
        Args:
            location: The location to get the weather for
        """
        # You could make an API call here
        return f"The weather in {location} is sunny today."

    @function_tool()
    async def toggle_light(self, context: RunContext, room: RoomName, switch_to: Literal["on", "off"]) -> str:
        """Called when the user asks to turn on or off the light.
        
        Args:
            room: The room to turn the light in
            switch_to: The state to turn the light to
        """
        return f"The light in the {room.value} is now {switch_to}."

This example demonstrates: • Using the

@function_tool()

decorator to define tools • Including the special

context: RunContext

parameter for accessing session data • Using Enum types for structured parameter options (

RoomName

) • Using Literal types to restrict parameter values • Providing detailed docstrings that describe the tool and its parameters • Returning structured data from the tool function Sources: Tool definition and use | LiveKit Docs | Tree View: | dse-workbench

Okay, gimme full code example of using parameters property on function tool declaration with that complex params definition!

I'm sorry, but I don't have the information you need at the moment. If you would like a member of the LiveKit team to respond, please ask your question in one of the other channels.