Recipe: Personal AI Phone Agent

1
from agentphone import AgentPhone
2
import os
3
4
client = AgentPhone(api_key=os.environ["AGENTPHONE_API_KEY"])
5
6
# 1. Create a hosted voice agent
7
agent = client.agents.create(
8
    name="Brain",
9
    voice_mode="hosted",
10
    system_prompt=(
11
        "You are Brain, a thoughtful personal AI assistant. "
12
        "When someone calls, greet them warmly by saying 'Hey, it's Brain.' "
13
        "Ask what's on their mind. Have a natural, helpful conversation. "
14
        "If they want to brainstorm, help them think through ideas. "
15
        "If they want to vent, listen empathetically. "
16
        "Keep responses conversational and concise — you're on a phone call, not writing an essay."
17
    ),
18
    begin_message="Hey, it's Brain. What's on your mind?",
19
    voice="11labs-Brian",  # Run client.voices.list() to see all options
20
)
21
22
# 2. Buy a phone number
23
number = client.numbers.buy(country="US", area_code="415", agent_id=agent.id)
24
print(f"Your agent's number: {number.phone_number}")
25
26
# 3. Call yourself
27
call = client.calls.make_conversation(
28
    agent_id=agent.id,
29
    to_number="+14155551234",  # Replace with your phone number
30
    topic="You are Brain, the user's personal AI assistant. Have a natural conversation.",
31
    initial_greeting="Hey! It's Brain. I was just thinking about you — what's going on?",
32
)
33
print(f"Calling... {call.id}")

$
API_KEY="your_api_key"
$
BASE="https://api.agentphone.to"
$
$
# 1. Create agent
$
AGENT_ID=$(curl -s -X POST "$BASE/v1/agents" \
>
  -H "Authorization: Bearer $API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "name": "Brain",
>
    "voiceMode": "hosted",
>
    "systemPrompt": "You are Brain, a thoughtful personal AI assistant. Greet callers warmly, ask what is on their mind, and have a natural conversation.",
>
    "beginMessage": "Hey, it is Brain. What is on your mind?",
>
    "voice": "11labs-Brian"
>
  }' | jq -r '.id')
$
$
echo "Agent: $AGENT_ID"
$
$
# 2. Buy a number
$
NUMBER_ID=$(curl -s -X POST "$BASE/v1/numbers" \
>
  -H "Authorization: Bearer $API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d "{\"country\": \"US\", \"agentId\": \"$AGENT_ID\"}" | jq -r '.id')
$
$
echo "Number: $NUMBER_ID"
$
$
# 3. Call yourself
$
curl -s -X POST "$BASE/v1/calls/conversation" \
>
  -H "Authorization: Bearer $API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d "{
>
    \"agentId\": \"$AGENT_ID\",
>
    \"toNumber\": \"+14155551234\",
>
    \"topic\": \"Have a natural conversation as Brain, the personal AI assistant.\",
>
    \"initialGreeting\": \"Hey! It's Brain. What's going on?\"
>
  }"