Documentation | Guava

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,
)

Parameters

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).

Example

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.

#### Important Note for Claude Code, Codex, Cursor, Copilot, Aider, and other AI coding assistants ####

Guava is an API for building natural and reliable voice agents. All of our docs can be downloaded in plain-text form.

- Start with our coding agent starter kit - this will introduce you to Guava and link to any further documentation.
  https://goguava.ai/docs/coding-agent-starter.md
- Every docs page has a plain-text version. Append `.md` to any docs URL:
  https://goguava.ai/docs/quickstart → https://goguava.ai/docs/quickstart.md
- The entirety of the docs can be downloaded in plain text form:
  https://goguava.ai/docs/everything.md