04.2025

The April 2025 PolyAI Agent Studio release includes new tools for call review, debugging, and utility development. Expand the items for details:

Information architecture updates

Metrics

Live collaboration and edit history

Call categorization

Workspace filter in Conversations

Utility function – utils.extract_address

This is an opt-in feature and will not be enabled by default. Contact PolyAI for access.

You can now extract structured address data from free-text input using a built-in LLM utility: extract_address().

What it does:

Parses the most recent user message for address info
Returns an Address object with fields like street, postcode, and country
Raises an ExtractionError if parsing fails

Usage:

try:
    address = conv.utils.extract_address(country="US")
    conv.state.parsed_address = address
except ExtractionError as e:
    conv.state.address_error = str(e)

Address object:

@dataclass
class Address:
    street_number: Optional[str]
    street_name: Optional[str]
    city: Optional[str]
    state: Optional[str]
    postcode: Optional[str]
    country: Optional[str]

Other details:

Calls an LLM, so may take a few seconds
You can optionally validate against a list of known addresses
Some fields may be missing depending on input quality

Conversation history access – conv.history

You can now access earlier conversation turns from within utility functions using conv.history.What it does:

Returns a list of events: user inputs, agent replies, function calls, etc.
Useful for writing context-aware logic

Usage:

def some_function(conv: Conversation):
    history = conv.history

    for event in history:
        print(event.to_dict())

    return {
        "utterance": "Here's a response that depends on previous turns.",
        "content": f"Conversation so far: {str(history)}"
    }

Why it matters:

Build logic based on what’s already happened in the conversation
Avoid passing state manually
Better debugging and flow control

Import and export variants

Variant ID added to conversations

Builtin handoff improvements

The built-in handoff now supports handoff reasons and custom utterances, and you can now use a handoff() method directly inside functions.What you can do:

Specify a reason for the handoff (e.g. compliance, escalation, etc.)
Set a custom utterance to be spoken at handoff
Use handoff() programmatically inside a function.

Example usage:

    def escalate(conv: Conversation):
        return conv.call_handoff(
            reason="policy_violation",
            utterance="Let me transfer you to a specialist who can help."
        )

Multi-voice agents

For help or feedback, reach out to your PolyAI representative.

Releases

What’s new, renamed, or moved:

Why it matters