Evaluation node#

The Evaluation node performs various operations related to evaluations to validate your AI workflow reliability. You can use the Evaluation node to conditionally execute logic based on whether the workflow is under evaluation, to write evaluation outcomes back to a Google Sheet dataset, or to log scoring metrics for your evaluation performance to n8n's evaluations tab.

Credentials

The Evaluation node's Set Outputs operation uses Google Sheets to record evaluation outcomes. To use that operation, you must configure a Google Sheets credential.

Operations#

The Evaluation node offers the following operations:

Set Outputs: Write the results of an evaluation back to a Google Sheet dataset.
Set Metrics: Record metrics scoring the evaluation performance to n8n's Evaluations tab.
Check If Evaluating: Branches the workflow execution logic depending on whether the current execution is an evaluation.

The parameters and options available depend on the operation you select.

Set Outputs#

The Set Outputs operation has the following parameters:

Credential to connect with: Create or select an existing Google Sheets credentials.
Document Containing Dataset: Choose the spreadsheet document you want to write the evaluation results to. Usually this is the same document you select in the Evaluation Trigger node.
- Select From list to choose the spreadsheet title from the dropdown list, By URL to enter the url of the spreadsheet, or By ID to enter the spreadsheetId.
- You can find the spreadsheetId in a Google Sheets URL: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
Sheet Containing Dataset: Choose the sheet you want to write the evaluation results to. Usually this is the same sheet you select in the Evaluation Trigger node.
- Select From list to choose the sheet title from the dropdown list, By URL to enter the url of the sheet, By ID to enter the sheetId, or By Name to enter the sheet title.
- You can find the sheetId in a Google Sheets URL: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.

You define the items to write to the Google Sheet in the Outputs section. For each output, you set the following:

Name: The Google Sheet column name to write the evaluation results to.
Value: The value to write to the Google Sheet.

Set Metrics#

The Set Metrics operation includes a Metrics to Return section where you define the metrics to record and track for your evaluations. You can see the metric results in your workflow's Evaluations tab.

For each metric you wish to record, you set the following details:

Name: The name to use for the metric.
Value: The numeric value to record. Once you run your evaluation, you can drag and drop values from previous nodes here. Metric values must be numeric.

Check If Evaluating#

The Check If Evaluating operation does not have any parameters. This operation provides branching output connectors so that you can conditionally execute logic depending on whether the current execution is an evaluation or not.

Templates and examples#

To learn more about n8n evaluations, check out the evaluations documentation

n8n provides a trigger node for evaluations. You can find the node docs here.

For common questions or issues and suggested solutions, refer to the evaluations tips and common issues page.