Quickstart

import decimalai
from myapp.agent import build_agent  # adjust to your agent factory

if __name__ == "__main__":
    decimalai.init()  # picks up DECIMAL_API_KEY + DECIMALAI_MODE from the environment

    agent = build_agent()  # DECIMALAI_MODE=manifest_only means no LLM calls

    # Registers the candidate manifest and writes its ID to $GITHUB_OUTPUT,
    # which the regression-check Action reads in the next step.
    result = decimalai.flush_manifest_for_ci(
        agent_name="support-agent",  # must match the Action's `agent-name` input
        chain=agent,                 # LangChain/LangGraph: introspects tools/prompts/models
    )
    print(f"Manifest registered: {result['manifest_id']} -> {result['output_path']}")

name: Agent Regression Check
on: [pull_request]

permissions:
  contents: read
  pull-requests: write  # required for the Action to post/update its PR comment

jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: '3.12'
      - name: Install dependencies
        run: pip install -e .
      - name: Manifest extraction
        id: manifest        # REQUIRED — see the note under the Agent Regression Check step
        env:
          DECIMALAI_MODE: manifest_only
          # `python scripts/x.py` puts scripts/ on sys.path, not the repo root,
          # so the import above cannot resolve without this.
          PYTHONPATH: .
          DECIMAL_API_KEY: ${{ secrets.DECIMAL_API_KEY }}
          OPENAI_API_KEY: dummy_for_init  # placeholder; NOT called in manifest_only mode
        run: python scripts/init_for_decimal.py
      - name: Agent Regression Check
        uses: decimal-labs/regression-check@v1
        with:
          api-key: ${{ secrets.DECIMAL_API_KEY }}
          agent-name: support-agent  # the same name you use in decimalai.init()
          # Pass the id through explicitly. $GITHUB_OUTPUT is PER-STEP, so the
          # value the previous step wrote is not visible in this step's own
          # $GITHUB_OUTPUT — it is only reachable as steps.<id>.outputs.*,
          # which is why that step needs `id: manifest` above.
          candidate-manifest-id: ${{ steps.manifest.outputs.decimal_manifest_id }}