AgentsPrefabs

ConciergeAgent

View as MarkdownOpen in Claude

A virtual concierge that provides venue information, answers questions about amenities and services, helps with bookings, and gives directions.

1from signalwire.prefabs import ConciergeAgent
venue_name
strRequired

Name of the venue or business.

services
list[str]Required

List of services offered (e.g., ["room service", "spa bookings"]).

amenities
dict[str, dict[str, str]]Required

Dictionary of amenities. Each key is an amenity name, and the value is a dict of details (typically hours and location, but any key-value pairs are accepted).

hours_of_operation
dict[str, str]

Dictionary of operating hours by department or service. Defaults to {"default": "9 AM - 5 PM"}.

special_instructions
list[str]

Additional instructions appended to the agent’s prompt (e.g., ["Mention the daily happy hour."]).

welcome_message
str

Custom greeting spoken when the call begins. When set, configures static_greeting with no-barge mode.

name
strDefaults to concierge

Agent name for identification and logging.

route
strDefaults to /concierge

HTTP route for this agent.

Built-in Tools

ToolDescriptionParameters
check_availabilityCheck service availability for a date and timeservice (str), date (str, YYYY-MM-DD), time (str, HH:MM)
get_directionsGet directions to an amenity or locationlocation (str)

Example

1from signalwire.prefabs import ConciergeAgent
2
3agent = ConciergeAgent(
4 venue_name="The Riverside Resort",
5 services=["room service", "spa treatments", "restaurant reservations", "tours"],
6 amenities={
7 "pool": {"hours": "6 AM - 10 PM", "location": "Ground Floor, East Wing"},
8 "spa": {"hours": "9 AM - 9 PM", "location": "Level 3, East Wing"},
9 "restaurant": {"hours": "7 AM - 10 PM", "location": "Lobby Level"}
10 },
11 hours_of_operation={
12 "front desk": "24 hours",
13 "concierge": "7 AM - 11 PM"
14 },
15 special_instructions=["Mention the daily happy hour at the pool bar (4-6 PM)."],
16 welcome_message="Welcome to The Riverside Resort! How may I assist you today?"
17)
18
19if __name__ == "__main__":
20 agent.run()