Skip to content
server

GitHub Action

Tonic Validate for PRs

v0.3.0 Latest version

Tonic Validate for PRs

server

Tonic Validate for PRs

A GitHub Action that uses Tonic Validate to evaluate your LLM application output

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Tonic Validate for PRs

uses: TonicAI/tonic_validate_pr_action@v0.3.0

Learn more about this action in TonicAI/tonic_validate_pr_action

Choose a version

Tonic Validate for pull requests (PRs)

Github action to run Tonic Validate evaluation on a PR. This Github action takes advantage of the open source Tonic Validate library.

image

Setup

To kick off a Tonic Validate evaluation on a PR, add the sample workflow to .github/workflows.

name: Tonic Validate
on: [pull_request]

jobs:
  tonic-validate:
    runs-on: ubuntu-latest
    name: Tonic Validate
    env:
      OPENAI_API_KEY:  ${{ secrets.OPENAI_API_KEY }}
      AZURE_OPENAI_KEY: ${{ secrets.AZURE_OPENAI_KEY}}
      AZURE_OPENAI_ENDPOINT: ${{ secrets.AZURE_OPENAI_ENDPOINT}}
    steps:
      - name: Checkout Repo
        uses: actions/checkout@v4      
      - name: Validate
        uses: TonicAI/tonic_validate_pr_action@v0.3.0
        with:
          llm_response_path: <Path to Q&A for Evaluation>

This workflow requires that you do one of the following:

  • Set an OpenAI API key
  • Set both an Azure API key and an Azure Endpoint URL

You also must provide a value for llm_response_path, which is the path (relative to the root of your repository) to a JSON file that contains the questions and optional context and reference answers for Tonic Validate to evaluate.

Here is a sample set of questions and answers:

[
    {"llm_answer":"Paris", "benchmark_item":{"question":"What is the capital of Paris", "answer":"Paris"}},
    {"llm_answer":"Berlin", "benchmark_item":{"question":"What is the capital of Germany", "answer":"Berlin"}},
    {"llm_answer":"Sam Altman is the CEO of OpenAI", "llm_context_list": ["Sam Altman has been the CEO of OpenAI since 2019."], "benchmark_item":{"question":"Who is the CEO of OpenAI?", "answer":"Sam Altman"}},
]