openai-agents-agentphone 0.1.0

AgentPhone tools for OpenAI Agents SDK — telephony for AI agents

openai-agents-agentphone

AgentPhone tools for the OpenAI Agents SDK — let your AI agents send SMS messages, make phone calls, and manage phone numbers.

Installation

pip install openai-agents-agentphone

Setup

Get your API key from agentphone.to and set it as an environment variable:

export AGENTPHONE_API_KEY="your-api-key"

Quick Start

Use all tools

from agents import Agent
from openai_agents_agentphone import get_tools

agent = Agent(
    name="Phone Assistant",
    instructions="You help users manage phone numbers, send messages, and make calls.",
    tools=get_tools(),
)

Use specific tools

from openai_agents_agentphone import get_tools

tools = get_tools(selected=["send_sms", "list_numbers", "make_call"])

Use individual tools

from agents import Agent
from openai_agents_agentphone import agentphone_send_sms, agentphone_make_call

agent = Agent(
    name="Outbound Agent",
    instructions="You make calls and send messages on behalf of the user.",
    tools=[agentphone_send_sms, agentphone_make_call],
)

Configure API key in code

from openai_agents_agentphone import configure

configure(api_key="your-api-key")

Full example with Runner

import asyncio
from agents import Agent, Runner
from openai_agents_agentphone import configure, get_tools

configure(api_key="your-api-key")

agent = Agent(
    name="Phone Assistant",
    instructions="You help users with phone calls and messages via AgentPhone.",
    tools=get_tools(),
)

async def main():
    result = await Runner.run(agent, "List my phone numbers")
    print(result.final_output)

asyncio.run(main())

Available Tools

Tool	Name	Description
agentphone_send_sms	Send SMS	Send an SMS message from an agent's phone number
agentphone_make_call	Make Call	Make an AI-powered outbound phone call
agentphone_get_transcript	Get Transcript	Get the full transcript of a call
agentphone_list_calls	List Calls	List recent phone calls with filters
agentphone_list_conversations	List Conversations	List SMS conversation threads
agentphone_get_conversation	Get Conversation	Get a conversation with messages
agentphone_buy_number	Buy Number	Buy a new phone number
agentphone_list_numbers	List Numbers	List all phone numbers
agentphone_create_agent	Create Agent	Create a new AI phone agent
agentphone_list_agents	List Agents	List all AI phone agents
agentphone_create_contact	Create Contact	Create a new contact
agentphone_list_contacts	List Contacts	List contacts

API Reference

See the AgentPhone documentation for full API details.