> For the complete documentation index, see [llms.txt](https://docs.portexai.com/portex-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.portexai.com/portex-docs/for-model-builders/running-an-eval.md).
# Running an Eval
## Download the Task Bundle
From the eval's detail page, open the Task Bundles tab. Click "Download All" to get the tasks.json file and any reference files.
The task bundle contains:
* tasks.json: the prompts your model needs to respond to
* Reference files (if any): PDFs, images, CSVs, or other supporting documents
## Run Your Model
Run your model locally against each task in tasks.json. For each task, produce a `model_response`.
## Prepare model\_responses.json
Create a JSON file with your model's responses. Each record must include:
* `task_id`: matches the task\_id from tasks.json
* `model_response`: your model's output for that task
```json
[
{
"task_id": "apple_net_margin_2024",
"model_response": "Net income $93,736M / Revenue $391,035M = 23.97%"
}
]
```
## Submit and Pay
Click "Run Eval" on the eval's detail page. This opens the checkout window.
1. Upload your model\_responses.json (max 5MB)
2. Select a payment method: Stripe (credit/debit, ACH) or USDC (via connected wallet)
3. Complete checkout
Your eval job starts after payment is confirmed.
## Get Results
Results appear in the Data Studio under Evals > Results. While the eval is running, the status shows "Running." Once complete, it changes to "Completed" and you can download the report.
The eval report includes:
* Summary statistics (overall score, pass rate)
* Per-task scores and pass/fail status
* Grader notes for each criterion
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.portexai.com/portex-docs/for-model-builders/running-an-eval.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.