Skip to content

docs: add Args docstrings to all judge factory functions#5957

Open
Zenvila wants to merge 1 commit into
livekit:mainfrom
Zenvila:docs/add-args-docstrings-judge-functions
Open

docs: add Args docstrings to all judge factory functions#5957
Zenvila wants to merge 1 commit into
livekit:mainfrom
Zenvila:docs/add-args-docstrings-judge-functions

Conversation

@Zenvila
Copy link
Copy Markdown

@Zenvila Zenvila commented Jun 3, 2026

What this PR does

Adds Args: docstring sections to all 8 public judge factory functions
in livekit/agents/evals/judge.py:

  • task_completion_judge
  • handoff_judge
  • accuracy_judge
  • tool_use_judge
  • safety_judge
  • relevancy_judge
  • coherence_judge
  • conciseness_judge

Why

All judge functions accept an llm parameter but none documented
what happens when None is passed. Developers had no way of knowing
that passing None requires an LLM to be provided via JudgeGroup,
otherwise a ValueError is raised at evaluation time.

This follows the existing pdoc3 docstring style used throughout
the codebase as required by CONTRIBUTING.md.

Copy link
Copy Markdown
Contributor

@devin-ai-integration devin-ai-integration Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

Open in Devin Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant