Description
Record a supplied query-document relevance judgment.
Information records distinguish identifiers, controlled vocabularies, language fallbacks, assertion times and valid times. A supplied inverse predicate differs from an inferred semantic relation. Text offsets require an explicit code-point or code-unit basis, and a metadata count check does not validate field content or an entire schema.
Record a supplied query-document relevance judgment.
When to use this tool
Use Search Result Relevance Grade Token when you already have queryId, documentId, recordedGrade and need to record a supplied query-document relevance judgment.
How to use the tool and how it works
- Enter queryId, documentId, recordedGrade. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read token. Use the output convention below.
Enter queryId, documentId, recordedGrade using the field constraints below. Encode these values, in exactly that order, as a JSON array and return the serialized array as text in token. String values are preserved without trimming or external terminology lookup.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| queryId | Query Id | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| documentId | Document Id | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| recordedGrade | Recorded Grade | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| token | Token | Required. Text; maximum UTF-16 length 8192. |
{
"input": {
"queryId": "Q17",
"documentId": "D3",
"recordedGrade": "high"
},
"output": {
"token": "[\"Q17\",\"D3\",\"high\"]"
}
}Limitations and assumptions
- The result records supplied values without computing relevance or enforcing a grading scale. Sources and asserted relationships are not independently authenticated.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
Alternative or Complementary methods
Use the actual record, vocabulary authority and complete metadata schema for semantic or conformance questions. Apply the identifier scheme's real comparison rules and the intended language/offset policy rather than inferring them from a local string operation.
References
Similar or alternative tools
- Collection Provenance Agent Role Token
Preserve an explicit collection provenance agent-role assertion.
- Metadata Language Script Pair
Preserve explicit metadata language and script tags.