Documentation

set_persona()

call.set_persona() is deliberately minimal. Give it the organization name and let the agent figure out the tone. You don't need to specify a voice style, a greeting template, or a list of prohibited phrases — Guava's defaults are professional and natural.

signature

call.set_persona(
    organization_name: str | None = None,
    agent_name: str | None = None,
    agent_purpose: str | None = None,
    voice: str | None = None,
)

Parameter	Type	Default	Description
organization_name	str \| None	—	The organization the agent represents. Used in introductions.
agent_name	str \| None	—	The agent's first name. Defaults to a generic 'assistant' style.
agent_purpose	str \| None	—	A sentence describing why the agent is calling. Sets the LLM's operating context.
voice	str \| None	"grace"	The TTS voice to use. Options: "grace" (southern female) or "jack" (British male). For languages outside of English, only the "grace" voice is supported.

Example

example.py

call.set_persona(
    organization_name="Bright Smile Dental",
    agent_name="Alex",
    agent_purpose="You are calling patients to help them schedule and confirm dental appointments",
    voice="grace",
)

Tip: Include the contact's name in agent_purpose to help the agent personalize the conversation naturally.

→ Next: Field

Questions? hi@goguava.ai

call.set_persona(
    organization_name: str | None = None,
    agent_name: str | None = None,
    agent_purpose: str | None = None,
    voice: str | None = None,
)

call.set_persona(
    organization_name="Bright Smile Dental",
    agent_name="Alex",
    agent_purpose="You are calling patients to help them schedule and confirm dental appointments",
    voice="grace",
)