Function calling

This example demonstrates the function-calling pattern using an OpenAI GPT model in JavaScript. In this pattern, the model can call external functions to get information. The loop is in the smallest useful form: the model decides when it needs external data, calls a function, and then uses the function result to answer.

Requirements

• Node.js 18+
• An OpenAI API key

Steps for running this example in the shell

1. Install dependencies:

npm install

2. Export your OpenAI API key as an environment variable:

export OPENAI_API_KEY="sk-..." # Windows cmd: set OPENAI_API_KEY="sk-..." # Windows PowerShell: $env:OPENAI_API_KEY="sk-..."

3. Run the script:

npm start

Output

When you run the script, it will send a fixed user prompt (What is the weather in San Francisco?) to a GPT model (gpt-4o-mini). The model will determine that it needs to call the get_weather function to answer the question, and it will do so with the requested location. The application will execute the function, get the weather, and inject it back into the conversation as a function_call_output item. Finally, the model will produce a user-facing answer grounded in the tool result.

User: What is the weather in San Francisco?
        Tool requested: get_weather({"location":"San Francisco"})
Assistant: The current weather in San Francisco is sunny with a temperature of 18°C and a humidity level of 63%.