← Back to library

Build a Prompt Learning Loop — SallyAnn DeLucia & Fuad Ali, Arize

AI Engineer52m 08sTranscript ✅Added May 29, 12:08 am GMT+8

Actionable Insights

  1. Build a failure dataset before optimizing prompts. Start with 30-100 failed or borderline agent traces and store them in evals/prompt_learning/failures.jsonl with input, agent_output, expected_behavior, pass_fail, human_feedback, and failure_reason. The workshop’s core claim is that plain scores are not enough; the useful signal is English feedback explaining why the output failed. First experiment: sample failures from your production traces or manual QA, ask a domain expert to label the reasons, then run a prompt revision only against a held-out train/test split.

  2. Optimize evaluator prompts before trusting prompt optimization. Arize repeatedly emphasizes that prompt learning only works if the eval/judge signal is reliable. Create evals/judges/<task>.md with rubric criteria, examples of correct and incorrect judgments, and required explanation format. Evaluate the judge against human labels using agreement, false-negative rate, and critical-failure recall. Tools to inspect: Arize Phoenix evals and prompt optimization docs (https://arize.com/docs/phoenix/) and Phoenix GitHub (https://github.com/Arize-ai/phoenix). Caution: a bad LLM judge will confidently optimize your agent toward the wrong behavior.

  3. Turn SME comments into reusable system rules. The speakers distinguish prompt learning from metaprompting by feeding the optimizer explanations such as “failed to use the right tool,” “missed this instruction,” or “called tools in the wrong order.” Convert repeated comments into explicit rules in SYSTEM_PROMPT.md, CLAUDE.md, or an agent policy file. Good rule shape: condition, action, example, anti-example, and verification check. Evaluate by whether the same failure class drops on the held-out set.

  4. Use a train/test split to avoid confusing expertise with overfitting. The workshop’s strongest nuance is that some “overfitting” is actually desired domain expertise, but only if the rule generalizes. Split examples by case, user, repo, or time period; never evaluate only on examples used to generate rules. Track per-failure-class performance, not just aggregate score. Practical gate: do not ship a new prompt if it improves known failures but regresses common happy paths.

  5. Start with system-prompt/rule optimization before fine-tuning or architecture changes. The case study claims a coding-agent prompt improved meaningfully by adding engineering rules without fine-tuning, tool changes, or architecture changes. Treat this as a low-cost first lever: add missing planning, tool-selection guidance, error-handling rules, test requirements, and context-use rules before changing models. Evaluate against baseline cost, latency, accuracy, and trace quality.

  6. Make prompt learning continuous, not a one-off workshop artifact. Add a monthly or release-based loop: collect failures → label with reasons → audit judge quality → propose prompt/rule changes → run experiments → publish a prompt changelog. Store prompt versions and experiment outputs. Caution from the comments: video audio was poor, so verify exact implementation details from code/docs rather than relying on the recording alone.

Core thesis

Prompt learning is a feedback loop for improving agent instructions using failed traces, human/SME explanations, and LLM-judge explanations. It sits between manual prompt editing and heavier fine-tuning: cheaper than model training, but more disciplined than “ask an LLM to make the prompt better.”

Big ideas / key insights

  • Many agent failures are environment/instruction/tool-guidance failures, not necessarily model weakness.
  • The valuable signal is not just pass/fail; it is why the output failed.
  • Domain experts and technical users both matter: engineers manage pipelines, cost, and automation; SMEs define product success and evaluation criteria.
  • Evals are part of the system being optimized; weak evals produce weak prompt learning.
  • GEPA/DSPy-style optimizers and Arize prompt learning are related but not identical; compare them on your own dataset rather than by brand.

Best timestamped moments with interpretation

  • 2:19–3:19 — Agent failures are attributed to weak instructions, missing planning, missing tools/tool guidance, and context engineering. Interpretation: fix the operating surface before blaming the model.
  • 3:50–4:20 — Responsibility is split between technical users and domain experts. Interpretation: prompt learning is cross-functional.
  • 5:53–6:55 — Metaprompting is contrasted with prompt learning. Interpretation: natural-language feedback and explanations are the differentiator.
  • 7:26–8:27 — Human and LLM-judge explanations are identified as valuable text-domain signals. Interpretation: do not throw away reviewer comments after labeling pass/fail.
  • 9:28–10:59 — Coding-agent system rules improve SWE-bench Lite-style performance in the case study. Interpretation: missing rules can be a first-order cause of failures.
  • 14:05–15:38 — GEPA comparison and judge-prompt quality discussion. Interpretation: optimizer choice matters less than reliable evaluation signal.
  • 40:16–43:48 — The workshop code generates JSON outputs, evaluates rows, and records experiment parameters. Interpretation: prompt learning needs experiment tracking, not just edited prose.
  1. Instrument traces with input, output, tools called, prompt version, model version, and cost.
  2. Label failures with both binary result and free-text explanation.
  3. Build/evaluate the LLM judge before using it as an optimizer signal.
  4. Generate prompt/rule candidates from repeated failure reasons.
  5. Test on a holdout set and publish a prompt changelog.
  6. Repeat after enough new failures accumulate.

Comment insights

The comments mostly discuss poor audio quality, which is operationally relevant: several viewers found the talk hard to understand and pointed to a dubbed/fixed-audio version. There is little technical pushback in the comments, so comments are weak evidence for or against the method. Practical takeaway: rely on transcript, code, and Arize/Phoenix docs for implementation details.

Deep research on the main claims

  • Arize Phoenix documentation supports LLM-as-a-judge prompt optimization, datasets, experiments, and eval workflows.
  • Phoenix GitHub tutorials include optimizing LLM-as-judge prompts, reinforcing the talk’s claim that evaluator prompts themselves need iteration.
  • GEPA/DSPy materials describe reflective prompt optimization and candidate selection; these support the comparison but do not prove Arize’s benchmark superiority.
  • General LLM evaluation literature supports using human-labeled holdout sets and meta-evaluation for judges because LLM judges can be biased or brittle.

My verdicts on the main claims

  1. “Agents often fail because instructions/environment are weak.” — Agree, high confidence. Transcript examples align with common agent failures: missing tool guidance, no planning, weak context, and vague rules.
  2. “English explanations are more useful than scores alone.” — Strong agree, high confidence. Explanations are needed to transform failures into actionable rules; scores only say that something broke.
  3. “Prompt learning can deliver large gains without fine-tuning.” — Mostly agree, medium confidence. Plausible and supported by the case study, but exact percentages are task/model/dataset-specific.
  4. “Overfitting can be reframed as expertise.” — Mixed, medium confidence. Good domain adaptation is valuable; however, without holdouts and regression tests, “expertise” can become brittle prompt memorization.
  5. “Prompt learning beats GEPA.” — Mixed, low-medium confidence. The workshop says it outperformed in their benchmark with fewer loops, but independent reproduction is needed.

Screen-level insights

  • 1:15 — Intro slide/workshop context shows the session is code-oriented, not just conceptual. This matters because the method is meant to become an experiment loop.
  • 2:49 — Slide lists missing planning, tools, tool guidance, and context engineering. It grounds the top Actionable Insights in visible failure categories.
  • 3:50 — Responsibilities slide splits technical and domain roles. It supports involving SMEs in labeling.
  • 5:53 / 6:55 — Diagrams compare metaprompting and prompt learning. The visual distinction is the extra explanation/feedback channel.
  • 9:28–10:59 — Case-study slides show old prompt vs added rules and benchmark lift. The important visual step is that rules are concrete behavioral constraints.
  • 40:16–43:48 — Code/experiment slides show JSON generation, evaluation, parameters, and experiment outputs. This connects prompt learning to reproducible evaluation rather than ad-hoc editing.

My read / why it matters

This is a practical bridge between “prompt engineering” and eval-driven agent engineering. The durable lesson is not that one optimizer wins; it is that failures should become labeled data, labeled data should become rules, and rules should be tested before deployment.

Verification notes

Checked transcript, comments, frame metadata, and external sources/search results for Arize Phoenix, LLM-as-judge prompt optimization, and GEPA/DSPy. Actionable Insights were audited for immediate workflow steps, file names, metrics, links, evaluation gates, and cautions. Residual uncertainty: exact benchmark numbers and GEPA comparison require access to the underlying dataset/code and cleaner audio or slides.