Skip to content

add evals -integrate with langfuse / oss eval tool? #698

Closed

Description

@JacobStephens2
No description provided.

Activity

  1. changed the title [-]add evals[/-] [+]add evals -integrate with langfuse / oss eval tool?[/+] on Oct 16, 2026
  2. JacobStephens2 commented on Oct 17, 2026

    @JacobStephens2
    OwnerAuthor

    This was generated by AI during triage.

    Triage Notes

    Maintainer direction:

    The goal is to know whether changes to the agents make them better or worse before those changes enter production, then analyze production traces to understand accuracy and quality. Efficiency and other useful evaluation dimensions matter too, with accuracy and quality the priority.

    The maintainer agreed to this ordering:

    1. Reusable, on-demand regression replays before changes to Factory skills, Session prompts, or Harness/Model/Effort defaults. Use past situations with known correct answers and an evaluation bar established in advance. Start from the prior replay work associated with Multi-family review: have another model family review a Run's work #429; Trial: the Security review's two modes #549 is another precedent to inspect.
    2. Production Run scores, initially limited to facts known when a Run ends. Outcomes and repair/CI friction alone are insufficient evidence of quality; accuracy and quality need explicit evaluation.
    3. Production trace analysis to understand successes and failures. Coordinate any dedicated trace viewer with Spec: Session traces, OTLP JSON Lines in place of Session logs #700 and Spec: see, follow and Stop a machine's Commands from the CLI #711 rather than silently absorbing them.

    Still to settle:

    • The first replay cases and authoritative catch/grading criteria, the comparison baseline, and the pass/regression bar.
    • Replay isolation and reproducibility, including reconstructing historical states without their later fixes and using the existing authenticated Harnesses.
    • Which production quality judgments are captured automatically, which require a human, and how judgments are retained and compared.
    • The storage/tool choice and import format, private Security evidence handling, and whether this work should be published as a Spec with separate Tickets.

    Langfuse is a candidate rather than an accepted dependency. Keep this in needs-triage: the purpose and rollout order are settled, while the implementation contract still needs shaping.

  3. JacobStephens2 commented on Oct 17, 2026

    @JacobStephens2
    OwnerAuthor

    Research is ready for review in #741.

    • Initial eval-tool research: Langfuse, Harness exports, deployment/auth constraints, and the initial alternatives.
    • Wider landscape and revised decision inputs: commercial and local platforms, replay runners, native skill evals, session tools, and trace standards. Conference notes informed the questions; private recordings and Session content are excluded.

    The maintainer also clarified that handrolling is acceptable. The research recommendation, rather than an accepted implementation decision, is:

    1. Pre-change replays: maintain the existing Multi-family review: have another model family review a Run's work #429 runner with reusable case/arm/trial definitions, explicit graders, versioned JSON results and a small comparison report. promptfoo is the leading packaged alternative around the same CLI/workspace setup; native Claude plugin eval is a narrower skill-testing option.
    2. Production Run quality: start with domain-specific outcome graders and calibrated CLI judges. Keep accuracy, incorrect findings, completion and efficiency separate. MLflow or Phoenix can provide richer score/dataset/trace workflows if needed.
    3. Trace viewing: add Raindrop Workshop to the local shortlist. Langfuse remains credible for an integrated workflow on suitable separate infrastructure or approved hosted storage; Braintrust and LangSmith are conditional hosted alternatives.

    On the format question: Session logs contain much of the evidence needed for traces, but require correlation and span mapping. OTel/OTLP, GenAI conventions, OpenInference, ATIF and code-attribution Agent Trace have different roles. Standardizing export does not guarantee identical rendering or recover missing source fields.

    The earlier categorical claims that only MLflow/Phoenix have native local options and that Harbor specifically requires Docker are qualified in the companion. Local deployment shape has been checked; memory use and actual thirdshift integrations have not been benchmarked.

    Still to settle: the initial cases and grading bar, reproducibility/isolation, the implementation boundary, and where non-Security data may live. The hosting question remains unanswered; Security sessions and derived eval evidence stay off third-party eval services. Coordinate a dedicated production viewer with #700/#711.

    Validation: 110 landscape-source URLs checked, local links checked in both notes, private transcript exclusions checked, and whitespace validation passed. This is a documentation-only PR; #698 remains open for the implementation decision.

  4. JacobStephens2 commented on Oct 18, 2026

    @JacobStephens2
    OwnerAuthor

    the implementation of the eval system isn't live yet.

  5. added 3 commits that reference this issue on Oct 21, 2026
  6. JacobStephens2 commented on Oct 21, 2026

    @JacobStephens2
    OwnerAuthor

    This was generated by AI after the #698 grilling.

    The grilling is done. Its decision record is .scratch/grill-with-docs/done/698-evals/, and it became four Specs:

    Each stays needs-triage until its Tickets and blocking links are published with to-tickets. #700 and #977 go first, since #978's Grader Ticket and #981's Session-trace Tickets wait on theirs.

  7. added 2 commits that reference this issue on Oct 21, 2026
  8. JacobStephens2 commented on Oct 25, 2026

    @JacobStephens2
    OwnerAuthor

    This was generated by AI during triage.

    Closing as done. The grilling (docs/grill-with-docs/done/698-evals/) produced four Specs, and all are closed: #700 Session traces, #977 Experiments, #978 Scoring run and #981 Run metrics. Anything still wanted for a Grafana-style viewer belongs in #914 or #813.

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions