Call Control

1
from smallestai.atoms.agent.nodes import OutputAgentNode
2
from smallestai.atoms.agent.events import SDKAgentEndCallEvent
3
from smallestai.atoms.agent.tools import function_tool
4
5
class MyAgent(OutputAgentNode):
6
    @function_tool()
7
    async def end_call(self) -> None:
8
        """End the call gracefully."""
9
        await self.send_event(SDKAgentEndCallEvent())
10
        return None

1
from smallestai.atoms.agent.events import (
2
    SDKAgentTransferConversationEvent,
3
    TransferOption,
4
    TransferOptionType
5
)
6
from smallestai.atoms.agent.tools import function_tool
7
8
class MyAgent(OutputAgentNode):
9
    @function_tool()
10
    async def transfer_to_human(self) -> None:
11
        """Transfer to a human agent."""
12
        await self.send_event(
13
            SDKAgentTransferConversationEvent(
14
            transfer_call_number="+14155551234",
15
            transfer_options=TransferOption(
16
                type=TransferOptionType.COLD_TRANSFER
17
            ),
18
            on_hold_music="relaxing_sound"
19
        )
20
        )
21
        return None

1
from smallestai.atoms.agent.events import (
2
    TransferOption,
3
    TransferOptionType,
4
    WarmTransferPrivateHandoffOption,
5
    WarmTransferHandoffOptionType,
6
)
7
8
# Cold transfer (immediate handoff)
9
cold = TransferOption(type=TransferOptionType.COLD_TRANSFER)
10
11
# Warm transfer (agent briefs human first)
12
warm = TransferOption(
13
    type=TransferOptionType.WARM_TRANSFER,
14
    private_handoff_option=WarmTransferPrivateHandoffOption(
15
        type=WarmTransferHandoffOptionType.PROMPT,
16
        prompt="Customer calling about billing"
17
    )
18
)