Documentation | Guava

set_task()

call.set_task() directs the agent toward a new goal mid-call. It accepts an objective, an ordered checklist of steps, and a task ID for binding completion handlers.

Python

TypeScript

signature

call.set_task(
    task_id: str,
    objective: str = "",
    checklist: list[Field | Say | str] | None = None,
    completion_criteria: str = "",
)

Full reference: See the Task page for parameter details, checklist item types, and a complete example.

Questions? hi@goguava.ai

#### 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 futher 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