***

title: join_room
slug: /reference/python/agents/function-result/join-room
description: Join a RELAY room for multi-party communication.
max-toc-depth: 3
---------------------

For a complete index of all SignalWire documentation pages, fetch https://signalwire.com/docs/llms.txt

[functionresult]: /docs/server-sdks/reference/python/agents/function-result

Join a RELAY room using SWML. Rooms enable multi-party communication and
collaboration between participants.

## **Parameters**

<ParamField path="name" type="str" required={true} toc={true}>
  Name of the room to join.
</ParamField>

## **Returns**

[`FunctionResult`][functionresult] — self, for chaining.

## **Example**

```python {11}
from signalwire import AgentBase
from signalwire import FunctionResult

agent = AgentBase(name="my-agent", route="/agent")
agent.set_prompt_text("You are a helpful assistant.")

@agent.tool(name="join_support_room", description="Join the support room")
def join_support_room(args, raw_data):
    return (
        FunctionResult("Connecting to the support room.")
        .join_room(name="support-room-1")
    )

agent.serve()
```