await session.say(message) How do I prevent this message from getting added to the context?

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

How do I manually add a message to chat context

If you want to manually add a message to the chat context in LiveKit, you can easily do that using the

add_message

method from the

ChatContext

class. Here’s a quick example to get you started:

from livekit.agents import ChatContext

# Initialize the chat context
chat_ctx = ChatContext()

# Add a message with role and content
chat_ctx.add_message(
    role="user",
    content=["Hello, how can I assist you today?"]
)

This lets you specify who’s sending the message (like "user" or "assistant") and what the message says. If you’re working with JavaScript, you can do something similar using the

append

method:

const chatContext = new ChatContext();

// Create a message
const message = {
    role: 'user',
    text: 'Hello, how can I assist you today?'
};

// Append the message to the context
chatContext.append(message);

Feel free to reach out if you want a hand with anything else! Sources: ChatContext | LiveKit Agents | Testing and evaluation | LiveKit Docs | examples/drive-thru/test_agent.py

Will that message get added to the session history:?

Just a quick heads-up: when you add a message to the chat context using

add_message

or

append

, it doesn’t automatically get saved in the session history. To make sure your message sticks around beyond the current turn, you’ll want to call

update_chat_ctx

right after adding it. That way, your message is safely saved for later! Sources: Pipeline nodes and hooks | LiveKit Docs

Could you give python code for that?

Here’s a friendly Python code example showing how you can keep manually added messages saved in the session history using `update_chat_ctx`:

from livekit.agents import ChatContext
from livekit.agents import Agent

async def on_user_turn_completed(self, turn_ctx: ChatContext, new_message: ChatMessage):
    # Add a new message to the context
    turn_ctx.add_message(
        role="assistant", 
        content="This message will be persisted in the chat history."
    )
    
    # Persist the message by updating the chat context
    await self.update_chat_ctx(turn_ctx)

Explanation: •

turn_ctx.add_message()

temporarily adds a message to the current context. •

await self.update_chat_ctx(turn_ctx)

makes sure the message is saved permanently in the session history. If you have any questions or want me to walk you through it more, just let me know—I’m here to help!