To help you retrieve conversation context or messages within the function tool of an

AgentTask

, you can easily access the session's

chat_ctx

property. This holds the full conversation history as a list of

ChatItem

objects, which includes messages, function calls, and outputs. Here’s a simple example to guide you:

from livekit.agents import Agent, function_tool
from livekit.agents.llm import ChatContext

class MyAgent(Agent):
    @function_tool
    async def analyze_conversation(self) -> str:
        # Access the full conversation history
        chat_ctx: ChatContext = self.session.chat_ctx
        messages = [item for item in chat_ctx.items if item.type == "message"]
        
        # Example: Return the last user message
        last_user_message = next(
            (msg for msg in reversed(messages) if msg.role == "user"),
            None
        )
        
        if last_user_message:
            return f"Last user message was: {last_user_message.text_content}"
        return "No prior user message found."

To break it down: •

self.session.chat_ctx.items

gives you all the conversation items. • You can filter these by

type

(like "message") and

role

(such as "user"). • The

text_content

property contains the actual text of a message. If anything is unclear or you’d like me to walk you through it step-by-step, please don’t hesitate to ask. I’m here to help! Sources: Workflows | LiveKit Docs | livekit-agents/livekit/agents/llm/tool_context.py | External data and RAG | LiveKit Docs

Just to share a helpful tip: the

chat_ctx.items

in LiveKit are automatically sorted by their

created_at

timestamp. This means your conversation history is already organized in chronological order, so you don’t have to worry about sorting it yourself. When new items come in, LiveKit smartly uses methods like

find_insertion_index

to place them exactly where they belong based on their

created_at

value. This way, the conversation between the user and assistant stays smooth and in the right sequence. If you have any more questions or want me to explain anything further, please don’t hesitate to ask—I’m here to help!