Evaluation node

The Evaluation node performs various operations related to evaluations to validate your AI workflow reliability.

Use the Evaluation node in these scenarios:

• To conditionally execute logic based on whether the workflow is under evaluation
• To write evaluation outcomes back to a Google Sheet datasetor
• To log scoring metrics for your evaluation performance to n8n's evaluations tab

Operations

The Evaluation node offers the following operations:

• Set Outputs: Write the results of an evaluation back to a data table or 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:

• Source: Select the location to which you want to output the evaluation results. Default value is Data table.

  Source settings differ depending on Source selection.

  • When Source is Data table:
    • Data table: Select a data table by name or ID
  • When Source is Google Sheets:
    • 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 data table or 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 doesn't 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

Related resources

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.