Worked Examples
Research Librarian: End-to-End Sample Workflow
Complete an all-feature retrofit demonstration in Research Librarian.
Research Librarian · How-to Guide
Site-scoped research guidance that routes questions across knowledge, products, sources, and saved journeys.
Purpose
This end-to-end workflow demonstrates every documented Research Librarian capability through one fictional resilient-community-retrofit case. The objective is not to prove a real-world conclusion; it is to verify the complete product workflow with controlled data.
Prerequisites
- The current product release
- A new synthetic workspace
- The all-feature CSV and JSON
- No production or private information
- Time to review every checkpoint
Sample data
This article uses a fictional Resilient Community Retrofit Program. The files contain one demonstration row for every documented feature, so each capability can be tested without private or production data.
Download CSV feature examples · Download JSON workspace example
Preview
| # | Feature | Sample action | Expected result | Classification |
|---|---|---|---|---|
| 1 | Question Intake | ask how a city should compare retrofit options | a normalized research request | synthetic-demo |
| 2 | Scope Gate | keep the request within Sustainable Catalyst research and products | an in-scope route or clear boundary | synthetic-demo |
| 3 | Intent Classification | classify the request as sourcing, calculation, analysis, or decision support | a transparent intent record | synthetic-demo |
| 4 | Knowledge Library Retrieval | retrieve energy-efficiency and decision-method documents | ranked library records | synthetic-demo |
| 5 | Product Routing | route calculation to Workbench and synthesis to Decision Studio | a product sequence with reasons | synthetic-demo |
The downloadable files include all 15 feature rows.
Procedure
Scenario
A community center is assessing energy, comfort, financing, implementation, evidence, and monitoring needs. Use only the supplied fictional records.
- 1. Question Intake: ask how a city should compare retrofit options. Confirm a normalized research request.
- 2. Scope Gate: keep the request within Sustainable Catalyst research and products. Confirm an in-scope route or clear boundary.
- 3. Intent Classification: classify the request as sourcing, calculation, analysis, or decision support. Confirm a transparent intent record.
- 4. Knowledge Library Retrieval: retrieve energy-efficiency and decision-method documents. Confirm ranked library records.
- 5. Product Routing: route calculation to Workbench and synthesis to Decision Studio. Confirm a product sequence with reasons.
- 6. Source Discovery: identify utility, building, climate, and finance source types. Confirm a source shortlist with provenance expectations.
- 7. Research Path Assembly: build a six-stage retrofit research path. Confirm an ordered journey.
- 8. Follow-up Questions: ask only for geography and decision deadline. Confirm a narrower query.
- 9. Evidence Cards: show source, relevance, confidence, and limitations. Confirm compact evidence records.
- 10. Citation Handoffs: send selected sources to Knowledge Library or Decision Studio. Confirm structured source handoffs.
- 11. Saved Journeys: save the community retrofit journey. Confirm persistent route and state.
- 12. Feedback and Ratings: record that the route helped but lacked procurement guidance. Confirm a bounded quality signal.
- 13. Index Health: confirm indexed record count and timestamp. Confirm a visible index status.
- 14. Endpoint Diagnostics: distinguish UI, network, backend, and index failures. Confirm an actionable diagnostic state.
- 15. Human Review Boundary: review suggested citations before relying on them. Confirm an advisory route rather than authority.
Save and review
- Save the final workspace under the sample workspace ID.
- Close and reopen it in a clean session.
- Compare every feature result with the sample expected_result field.
- Document unresolved differences and do not hide warnings.
- Export one complete artifact bundle.
- Send one supported handoff to an integration and verify its receipt.
Supported integrations
- Knowledge Library
- Workbench
- Decision Studio
- Site Intelligence
- Research Lab
- Product Support Platform
Expected output
- a normalized research request
- an in-scope route or clear boundary
- a transparent intent record
- ranked library records
- a product sequence with reasons
- a source shortlist with provenance expectations
- an ordered journey
- a narrower query
- compact evidence records
- structured source handoffs
- persistent route and state
- a bounded quality signal
- a visible index status
- an actionable diagnostic state
- an advisory route rather than authority
- A complete saved workspace
- A portable export
- A validated cross-product handoff receipt
Verification
- Every CSV feature row has a corresponding saved result.
- The JSON workspace ID and product version are preserved.
- The export can be inspected without temporary browser state.
- The receiving product identifies source, destination, schema, artifact, and review state.
- A human reviewer can reproduce or audit the demonstration.
Responsible use
This is a routing and discovery aid, not a general chatbot or final authority; inspect original sources and apply domain judgment.
Replace synthetic data only with information you are authorized to use, after reassessing licensing, privacy, uncertainty, and review obligations.
