Agent overview

import { Agent, tool, type Stages } from "@pinecall/agents";
/**
 * You answer the phone for the business. Short sentences: everything you say is read aloud.
 * You answer what the business's documents say. For anything else you take a message: who is calling
 * and what it is about. You never promise when they will hear back.
 */
export default class FrontDesk extends Agent {
  stage: Stages<"ask" | "done"> = "ask";
  message?: { name: string; about: string } | undefined;
  /**
   * Writes down the caller's message. Call it as soon as the caller has said their name and what the call is
   * about, in that same turn and without reading it back first; never with a blank or a guess.
   */
  @tool({ stage: "ask", pii: ["name"] })
  async takeMessage(name: string, about: string): Promise<{ name: string; about: string }> {
    this.message = { name, about };
    this.stage = "done";
    return this.message;
  }
  override render() {
    return (
      <>
        {this.stage === "ask" && <p>Greet the caller. Ask for their name and what the call is about.</p>}
        {this.message && <p>The message is written down. Say goodbye and hang up.</p>}
      </>
    );
  }
}

from typing import Literal
from pinecall import Agent, tool
class FrontDesk(Agent):
    """You answer the phone for the business. Short sentences: everything you say is read aloud.
    You answer what the business's documents say. For anything else you take a message: who is calling
    and what it is about. You never promise when they will hear back.
    """
    stage: Literal["ask", "done"] = "ask"
    message: dict[str, str] | None = None
    @tool(stage="ask", pii=("name",))
    def take_message(self, name: str, about: str) -> dict[str, str]:
        """Writes down the caller's message. Call it as soon as the caller has said their name and what the call is
        about, in that same turn and without reading it back first; never with a blank or a guess.
        """
        self.message = {"name": name, "about": about}
        self.stage = "done"
        return self.message

The view is a Jinja template beside the class, agents/front-desk/views/front-desk.jinja:

{% if stage == "ask" %}
Greet the caller. Ask for their name and what the call is about.
{% endif %}
{% if message %}
The message is written down. Say goodbye and hang up.
{% endif %}

require "pinecall"
# You answer the phone for the business. Short sentences: everything you say is read aloud.
# You answer what the business's documents say. For anything else you take a message: who is calling
# and what it is about. You never promise when they will hear back.
class FrontDesk < Pinecall::Agent
  stage :ask, :done
  state :message
  # Writes down the caller's message. Call it as soon as the caller has said their name and what
  # the call is about, in that same turn and without reading it back first; never with a blank or a guess.
  tool stage: :ask, pii: %i[name]
  def take_message(name:, about:)
    self.message = { name:, about: }
    self.stage = :done
    message
  end
end

The view is an ERB template beside the class, agents/front-desk/views/front-desk.erb:

<% if stage == :ask -%>
Greet the caller. Ask for their name and what the call is about.
<% end -%>
<% if message -%>
The message is written down. Say goodbye and hang up.
<% end -%>