Skip to content

cookbook(evaluation): revamp eval-correction-loop notebook to playbook - #8

Open
SuhaniNagpal7 wants to merge 1 commit into
cookbook/falcon-ai-pagefrom
cookbook/eval-correction-loop-revamp
Open

cookbook(evaluation): revamp eval-correction-loop notebook to playbook#8
SuhaniNagpal7 wants to merge 1 commit into
cookbook/falcon-ai-pagefrom
cookbook/eval-correction-loop-revamp

Conversation

@SuhaniNagpal7

Copy link
Copy Markdown
Contributor

Summary

Notebook companion to future-agi/docs#660. Brings evaluation/eval-correction-loop.ipynb to the playbook's 8-cell structure: pinned install, getpass + raise env setup, smoke-test FutureAGI auth, dashboard URL print after the agreement measurement, troubleshooting table, technical-ladder Next steps with Colab/GitHub badges, and a version-printout cell.

Also adds the playbook frame-of-mind to the markdown intro: "What you'll build", "Prerequisites" (with structured Last tested with), and "Why this matters" anchored in a real production-incident shape.

Test plan

  • Open in Colab from the README link; "Run all" prompts for FI_API_KEY and FI_SECRET_KEY via getpass (no hardcoded placeholders).
  • The smoke-test cell returns within ~5s and prints fi.evals auth ok | probe result: ....
  • Step 4 prints agreement: 4 / 4 (100%) followed by the dashboard URL.
  • The final version-printout cell emits python, requests, and ai-evaluation versions.
  • Notebook outputs are cleared on commit.

Scope

  • Only evaluation/eval-correction-loop.ipynb. Other modified notebooks (e.g. command-center/semantic-caching.ipynb) are intentionally not in this PR.

Mirrors the docs MDX revamp (future-agi/docs PR #660) and aligns with
the playbook's 8-cell notebook structure:

- Cell 0 split: title + Colab/GitHub badges + meta table + TL;DR only.
- New cells: "What you'll build", "Prerequisites" (with structured
  Last tested with), "Why this matters" (concrete production-incident
  lead).
- Pinned install: `ai-evaluation>=2.0,<3` + `requests>=2.31`.
- Env setup replaced with `getpass` + `RuntimeError` on missing keys.
- Smoke-test FutureAGI auth cell: one fi.evals `is_helpful` probe
  that asserts results came back before the rest of the notebook runs.
- Step 4 code cell prints the dashboard URL alongside expected output.
- Troubleshooting markdown table with symptom / cause / fix / verify
  columns.
- Explore further -> Next steps technical ladder + Colab/GitHub badges.
- Version printout code cell at the end for reproducible bug reports.
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