Building Voice Agents with OpenAI

Workshop at AI Engineer World's Fair 2025

Requirements

• Node.js 22 or newer with npm installed.

  We will use Node.js for a consistent experience for all attendees but bun and deno are supported by the SDK.

• An OpenAI account with an OpenAI API key stored as OPENAI_API_KEY environment variable

Setup

Clone this repository to have access to the boilerplate code for our workshop

git clone git@github.com:dkundel-openai/aie-voice-agents-workshop.git
cd aie-voice-agents-workshop
npm install

This will automatically install the OpenAI Agents SDK, zod and TypeScript for you.

Project structure

During the workshop we will use two projects.

We will start off in 01-basic where we will create a basic text-based agent to familiarize yourself with the OpenAI Agents SDK for TypeScript.

Afterwards we will use the Next.js app in 02-voice to build our voice agent using the same SDK. We'll be using Next.js to have a framework where we can have both server-side code and client-code easily accessible but the SDK is compatible with any frontend framework.

Running your code

01-basic

The following command will execute your index.ts file:

npm run start:01

02-voice

The following command will start up the development server for your Next.js app:

npm run start:02

Resources

• Agents SDK Quickstart
• Agents SDK Voice Quickstart
• Agents SDK Examples
• Details about Voice Agent Features
• Voice Agents Guide on the OpenAI Docs