Description
Detect multiple recognized roles for an annotated agent.
Scholarly annotation can preserve term senses, agent roles and source frames using explicit labels. Literal agreement, a recognized marker or an unambiguous record key organizes those assertions without establishing their meaning, truth or scholarly authority.
Detect multiple recognized roles for an annotated agent.
When to use this tool
Use Annotated Agent Role Ambiguity when checking one explicit annotation, marker or source-identity convention.
How to use the tool and how it works
- Enter agent, roles, permittedRoles. Keep parallel arrays aligned. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read recognizedRoles, ambiguous. Inspect ambiguous before interpreting the associated values.
Detect multiple recognized roles for an annotated agent. Require nonempty agent; filter roles by permittedRoles, deduplicate in first-occurrence order and flag ambiguous when more than one remains.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| agent | Agent | Required. Text; maximum UTF-16 length 8192. |
| roles | Roles | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| permittedRoles | Permitted Roles | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| recognizedRoles | Recognized Roles | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| ambiguous | Ambiguous | Required. Boolean. |
{
"input": {
"agent": "A",
"roles": [
"speaker",
"narrator"
],
"permittedRoles": [
"speaker",
"narrator"
]
},
"output": {
"recognizedRoles": [
"speaker",
"narrator"
],
"ambiguous": true
}
}Limitations and assumptions
- Agent identity and role semantics are not resolved; unrecognized roles are excluded rather than validated.
- 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
Inspect the source text and interpretive framework for substantive analysis; use source-aware annotation and bibliographic tools for complete records.
References
Similar or alternative tools
- Agent Action Annotation Count
Count actions recorded for one literal agent label.
- Claim Negation Marker Count
Locate literal negation-marker tokens under a case policy.