Citations and Source Traceability for School Timetables and After-School Scheduling: Manage Authorized Access and External Services

School Timetables: review citations for authorized access. Check source versions, input mappings and the values received by downstream nodes.

What this category's data looks like

This page's material comes from primary and secondary school timetable and after-school service scheduling scenarios, including three types: the master timetable, the teacher assignment table, and the after-school service project table. The master timetable records class, period, week, and date; the teacher assignment table records the assigned teacher, subject, and class; the after-school service project table records the project name, number of participants, time slot, and signed receipt. When the three types of material enter the knowledge base retrieval node, each participates as an independent source in citation output, and the cited snippets retain the original paragraph and source identifier. The update cadence is weekly or per semester, and the version is based on the signature or receipt. The field characteristic is that the same record may appear in multiple materials, and names, quantities, and dates need to be checked item by item. When the material enters this feature, the master timetable provides the basis for class time slots, the teacher assignment table provides the basis for personnel and subjects, and the after-school service project table provides the basis for projects and participant counts; together, the three support the determination of the authorization scope of the external entry point.

Configuration and implementation checks

This link is executed by the citation output of the knowledge base retrieval node, which outputs an array of cited content, each item containing the original snippet and source identifier, and the length may be 0. The external entry points and authorization scope are then completed by subsequent AI nodes, code nodes, or manual work.

ObjectCheckVerification action
Master timetableThe class, period, week, and date fields are complete, and the signature or receipt is traceableIn the node, check the selected collections and their vector models, and open the citation superscript to compare against the source document
Teacher assignment tableThe assigned teacher, subject, and class fields match the master timetable item by item, and the dates line upRun a test with a question that has no matching material, and see that the output is empty while the chain continues
After-school service project tableThe project name, number of participants, time slot, and signed receipt are complete, and the version is in syncOpen the search parameter panel and check item by item, and check that the quoteMaxToken value is consistent with the knowledge base retrieval section
External entry points and authorization scopeThe visitor's identity matches the visible scope, and unauthorized access is not visibleAccess once with a restricted identity, and see whether the visible scope matches the setting

Three common errors

  • Symptom: the name, quantity, and date of the same record do not match between the master timetable and the teacher assignment table. Cause: the two materials are maintained separately and are not synchronized to the same version.
  • Symptom: the after-school service project table lacks a signature or receipt, but the external entry point is still visible. Cause: the signed receipt is not included in the determination of the visible scope, and the version is not synchronized.
  • Symptom: there is no citation superscript in the answer, or the cited snippet does not match the original text. Cause: first check whether this round hit anything and which material was hit, then look at trimming.

How to verify the setup

This feature's acceptance: ask a question with original-text support, and check whether the citation array and superscript can point back to the original text; then ask a question with no matching material, and confirm that the array is empty while the chain runs through. Check the number of citations in responseData (non-streaming module results returned with detailed output enabled) and the original snippets in quoteList; the number of citations is the array length, and quoteMaxToken is the citation content budget, and the two are not compared for equality.

Business test: access once with a restricted identity, and see whether the visible scope matches the setting.

  • In the node, check the selected collections and their vector models, and confirm that the associated knowledge base uses the same vector model.
  • Open the search parameter panel and check item by item, check that the quoteMaxToken value is consistent with the knowledge base retrieval section, and separately record the number of items in the citation array.

References