---
title: Relevancy Evaluator
---

Relevancy measure if the response from a query engine matches any source nodes.

It is useful for measuring if the response was relevant to the query. The evaluator returns a score between 0 and 1, where 1 means the response is relevant to the query.

## Usage

Firstly, you need to install the package:

```package-install
npm i llamaindex @llamaindex/openai
```

Set the OpenAI API key:

```bash
export OPENAI_API_KEY=your-api-key
```

Import the required modules:

```ts
import { OpenAI } from "@llamaindex/openai";
import {
  Document,
  RelevancyEvaluator,
  Settings,
  VectorStoreIndex,
} from "llamaindex";
```

Let's setup gpt-4 for better results:

```ts
Settings.llm = new OpenAI({
  model: "gpt-4",
});
```

Now, let's create a vector index and query engine with documents and query engine respectively. Then, we can evaluate the response with the query and response from the query engine.:

```ts
const documents = [
  new Document({
    text: `The city came under British control in 1664 and was renamed New York after King Charles II of England granted the lands to his brother, the Duke of York. The city was regained by the Dutch in July 1673 and was renamed New Orange for one year and three months; the city has been continuously named New York since November 1674. New York City was the capital of the United States from 1785 until 1790, and has been the largest U.S. city since 1790. The Statue of Liberty greeted millions of immigrants as they came to the U.S. by ship in the late 19th and early 20th centuries, and is a symbol of the U.S. and its ideals of liberty and peace. In the 21st century, New York City has emerged as a global node of creativity, entrepreneurship, and as a symbol of freedom and cultural diversity. The New York Times has won the most Pulitzer Prizes for journalism and remains the U.S. media's "newspaper of record". In 2019, New York City was voted the greatest city in the world in a survey of over 30,000 p...	Pass`,
  }),
];

const vectorIndex = await VectorStoreIndex.fromDocuments(documents);

const queryEngine = vectorIndex.asQueryEngine();

const query = "How did New York City get its name?";

const response = await queryEngine.query({
  query,
});

const evaluator = new RelevancyEvaluator();

const result = await evaluator.evaluateResponse({
  query,
  response: response,
});

console.log(`the response is ${result.passing ? "relevant" : "not relevant"}`);
```

```bash
the response is relevant
```

## API Reference

- [RelevancyEvaluator](/docs/api/classes/RelevancyEvaluator)
