Inspecting and Understanding Agent Result Properties

Introduction And Lesson Overview

Welcome back! In the previous lesson, you learned how to define and run your first OpenAI agent using the Agents SDK in JavaScript. You also saw how to extract the agent's final output from the result object. In this lesson, we'll take a closer look at the result object that is returned after running an agent. Understanding the structure and properties of this object is key to building more advanced applications, debugging your agent's behavior, and making the most of the SDK's features. By the end of this lesson, you'll know how to inspect and interpret the different properties of the result object, including the final output, the original input, the last agent that ran, and new items generated during the run. You'll also see how these properties can help you understand what happened during the agent's run and how to use this information in your own projects.

The Structure Of The Result Object

When you run an agent, you receive a RunResult object . This object provides detailed information about the agent's execution. Some of the most relevant properties include: finalOutput : The final output produced by the last agent that ran. Its type can vary depending on the agent's configuration — it may be a string or a more complex object if the agent specifies an output type. input : The original input or prompt provided to the agent at the start of the run. lastAgent : The agent instance that produced the final output. This is especially useful in workflows involving multiple agents or handoffs. newItems : An array of items generated during the run, such as messages, tool calls, or handoffs. These items provide a step-by-step record of the agent's reasoning and actions. history : The conversation history, including all messages exchanged during the run. By inspecting these properties, you gain a comprehensive view of the agent's execution, including the input, output, and intermediate steps. This structure is designed to support both simple and advanced use cases, from basic logging to complex multi-agent workflows.

Creating An Agent For Our Examples

For the examples in this lesson, we'll use a simple travel assistant agent. Here's how you can define and run this agent in JavaScript: JavaScript import { Agent, run } from '@openai/agents'; // Define the agent const agent = new Agent({name: 'Travel Genie', instructions:'You are Travel Genie, a friendly and knowledgeable travel assistant. ' +'Recommend exciting destinations and offer helpful travel tips.', model: 'gpt-5.6-terra', modelSettings: { reasoning: { effort: 'none' } }}); // Run the agent with an input prompt const result = await run(agent, "What's your top recommendation for adventure seekers?"); import { Agent, run } from '@openai/agents'; // Define the agent const agent = new Agent({name: 'Travel Genie', instructions:'You are Travel Genie, a friendly and knowledgeable travel assistant. ' +'Recommend exciting destinations and offer helpful travel tips.', model: 'gpt-5.6-terra', modelSettings: { reasoning: { effort: 'none' } }}); // Run the agent with an input prompt const result = await run(agent, "What's your top recommendation for adventure seekers?"); This code creates an agent named "Travel Genie" and runs it with a sample query. The result of the run is stored in the result object, which we'll explore in detail in the following sections.

Join the 1M+ learners on CodeSignal

Be a part of our community of 1M+ users who develop and demonstrate their skills on CodeSignal

JavaScript

import { Agent, run } from '@openai/agents';

// Define the agent
const agent = new Agent({
  name: 'Travel Genie',
  instructions:
    'You are Travel Genie, a friendly and knowledgeable travel assistant. ' +
    'Recommend exciting destinations and offer helpful travel tips.',
  model: 'gpt-5.6-terra',
  modelSettings: { reasoning: { effort: 'none' } }
});

// Run the agent with an input prompt
const result = await run(
  agent,
  "What's your top recommendation for adventure seekers?"
);

JavaScript

// Print the agent's final output
console.log('Final Output:', result.finalOutput);

// Print the agent's final output
console.log('Final Output:', result.finalOutput);

text

Final Output: Absolutely! For adventure seekers, **New Zealand** is a top pick. This country is a playground for thrill-seekers, offering everything from **bungee jumping in Queenstown** (the "adventure capital of the world"), **skydiving over Lake Taupo**, **white-water rafting in Rotorua**, to **hiking the Tongariro Alpine Crossing**.

**Why it's great for adventure lovers:**
- **Variety:** Mountains, forests, glaciers, beaches — all packed into a compact country.
- **World-class operators:** Safety is prioritized, and there are plenty of reputable guides for every activity.
- **Unique experiences:** Try the original commercial bungee jump, conquer icy crevasses on the Franz Josef Glacier, or go black-water rafting in the Waitomo Glowworm Caves.

**Travel Tips:**
- **Best time to visit:** December to March (summer), but winter brings amazing skiing and snowboarding.
- **Getting around:** Consider renting a camper van for maximum flexibility.
- **Book ahead:** Popular activities like glacier hikes and skydives can sell out, so reserve early.

Other awesome contenders:
- **Costa Rica** for jungle zip lines, volcano hikes, and surfing.
- **South Africa** for shark cage diving, safaris, and mountain biking.
- **Iceland** for glacier trekking, ice cave exploration, and volcanic landscapes.

Let me know what kind of adventure excites you most, and I can tailor recommendations just for you!

Final Output: Absolutely! For adventure seekers, **New Zealand** is a top pick. This country is a playground for thrill-seekers, offering everything from **bungee jumping in Queenstown** (the "adventure capital of the world"), **skydiving over Lake Taupo**, **white-water rafting in Rotorua**, to **hiking the Tongariro Alpine Crossing**.

**Why it's great for adventure lovers:**
- **Variety:** Mountains, forests, glaciers, beaches — all packed into a compact country.
- **World-class operators:** Safety is prioritized, and there are plenty of reputable guides for every activity.
- **Unique experiences:** Try the original commercial bungee jump, conquer icy crevasses on the Franz Josef Glacier, or go black-water rafting in the Waitomo Glowworm Caves.

**Travel Tips:**
- **Best time to visit:** December to March (summer), but winter brings amazing skiing and snowboarding.
- **Getting around:** Consider renting a camper van for maximum flexibility.
- **Book ahead:** Popular activities like glacier hikes and skydives can sell out, so reserve early.

Other awesome contenders:
- **Costa Rica** for jungle zip lines, volcano hikes, and surfing.
- **South Africa** for shark cage diving, safaris, and mountain biking.
- **Iceland** for glacier trekking, ice cave exploration, and volcanic landscapes.

Let me know what kind of adventure excites you most, and I can tailor recommendations just for you!

JavaScript

// Print the original input provided to the agent
console.log('Original Input:', result.input);

// Print the original input provided to the agent
console.log('Original Input:', result.input);

text

Original Input: What's your top recommendation for adventure seekers?

Original Input: What's your top recommendation for adventure seekers?

JavaScript

// Print the last agent's name
console.log('Last Agent Name:', result.lastAgent.name);

// Print the last agent's name
console.log('Last Agent Name:', result.lastAgent.name);

text

Last Agent Name: Travel Genie

Last Agent Name: Travel Genie

JavaScript

// Print new items generated during the run
console.log('New Items:');
for (const item of result.newItems) {
  console.log(`  - Type: ${item.type}`);
  if (item.type === 'run_message_output') {
    console.log(`    Content: ${item.rawItem.content}`);
  }
}

// Print new items generated during the run
console.log('New Items:');
for (const item of result.newItems) {
  console.log(`  - Type: ${item.type}`);
  if (item.type === 'run_message_output') {
    console.log(`    Content: ${item.rawItem.content}`);
  }
}

text

New Items:
  - Type: run_message_output
    Content: Absolutely! For adventure seekers, **New Zealand** is a top pick. ...

New Items:
  - Type: run_message_output
    Content: Absolutely! For adventure seekers, **New Zealand** is a top pick. ...

JavaScript

// Print the conversation history
console.log('History:');
for (const historyItem of result.history) {
  console.log(`  - Role: ${historyItem.role}, Content: ${historyItem.content}`);
}

text

History:
  - Role: user, Content: What's your top recommendation for adventure seekers?
  - Role: assistant, Content: Absolutely! For adventure seekers, **New Zealand** is a top pick. ...

JavaScript

// Print the agent's final output
console.log('Final Output:', result.finalOutput);

text

Final Output: Absolutely! For adventure seekers, **New Zealand** is a top pick. This country is a playground for thrill-seekers, offering everything from **bungee jumping in Queenstown** (the "adventure capital of the world"), **skydiving over Lake Taupo**, **white-water rafting in Rotorua**, to **hiking the Tongariro Alpine Crossing**.

**Why it's great for adventure lovers:**
- **Variety:** Mountains, forests, glaciers, beaches — all packed into a compact country.
- **World-class operators:** Safety is prioritized, and there are plenty of reputable guides for every activity.
- **Unique experiences:** Try the original commercial bungee jump, conquer icy crevasses on the Franz Josef Glacier, or go black-water rafting in the Waitomo Glowworm Caves.

**Travel Tips:**
- **Best time to visit:** December to March (summer), but winter brings amazing skiing and snowboarding.
- **Getting around:** Consider renting a camper van for maximum flexibility.
- **Book ahead:** Popular activities like glacier hikes and skydives can sell out, so reserve early.

Other awesome contenders:
- **Costa Rica** for jungle zip lines, volcano hikes, and surfing.
- **South Africa** for shark cage diving, safaris, and mountain biking.
- **Iceland** for glacier trekking, ice cave exploration, and volcanic landscapes.

Let me know what kind of adventure excites you most, and I can tailor recommendations just for you!

JavaScript

// Print the original input provided to the agent
console.log('Original Input:', result.input);

text

Original Input: What's your top recommendation for adventure seekers?

JavaScript

// Print the last agent's name
console.log('Last Agent Name:', result.lastAgent.name);

text

Last Agent Name: Travel Genie

JavaScript

// Print new items generated during the run
console.log('New Items:');
for (const item of result.newItems) {
  console.log(`  - Type: ${item.type}`);
  if (item.type === 'run_message_output') {
    console.log(`    Content: ${item.rawItem.content}`);
  }
}

text

New Items:
  - Type: run_message_output
    Content: Absolutely! For adventure seekers, **New Zealand** is a top pick. ...

JavaScript

// Print the conversation history
console.log('History:');
for (const historyItem of result.history) {
  console.log(`  - Role: ${historyItem.role}, Content: ${historyItem.content}`);
}

text

History:
  - Role: user, Content: What's your top recommendation for adventure seekers?
  - Role: assistant, Content: Absolutely! For adventure seekers, **New Zealand** is a top pick. ...

Introduction And Lesson Overview

The Structure Of The Result Object

Creating An Agent For Our Examples

Join the 1M+ learners on CodeSignal

Inspecting The Final Output Property

Inspecting the Original Input Property

Inspecting the Last Agent Property

Inspecting the New Items Property

Inspecting the Conversation History

Lesson Summary And Next Steps