developers.raycast.com/ai/write-evals-for-your-ai-extension

Created by:
****ad@vlad.studio
Starting URLs:
https://developers.raycast.com/ai/write-evals-for-your-ai-extension
## Page: https://developers.raycast.com/ai/write-evals-for-your-ai-extension

1.  AI

## Write Evals for Your AI Extension

Make your AI Extension more reliable by writing evals.

We all know that AI is not always reliable. This is why it's important to write evals for your AI Extension. Evals allow you to test your AI Extension and make sure it behaves as expected.

The easiest way to add an eval is to first use your AI Extension. Then, once Raycast AI used your tools to finish its response, you can use the Copy Eval action to copy the eval to your clipboard.

![](https://developers.raycast.com/~gitbook/image?url=https%3A%2F%2F2922539984-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-Me_8A39tFhZg3UaVoSN%252Fuploads%252Fgit-blob-b91e1651293f819adc528349025ebe722373f66e%252Fcopy-eval.webp%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=5c784da9&sv=2)

Copy Eval

You can then paste the eval into the `evals` array in the `package.json` file.

    {
      "ai": {
        "evals": [
          {
            "input": "@todo-list what are my open todos",
            "mocks": {
              "get-todos": [
                {
                  "id": "Z5lF8F-lSvGCD6e3uZwkL",
                  "isCompleted": false,
                  "title": "Buy oat milk"
                },
                {
                  "id": "69Ag2mfaDakC3IP8XxpXU",
                  "isCompleted": false,
                  "title": "Play with my cat"
                }
              ]
            },
            "expected": [
              {
                "callsTool": "get-todos"
              }
            ]
          }
        ]
      }
    }

To run your evals, you can use the `npx ray evals` command. This will run the evals and print the results to the console. You get an overview of the evals that failed and the ones that passed. From here you can start improving the names and descriptions of your tools.

Visit Learn Core Concepts of AI Extensions to learn more about the different types of evals you can write.

Last updated 1 month ago