Skip to content

Main content

Agent Action Annotation Count Tool

Calculate agent action annotation count from explicit caller-supplied inputs.

Loading tool…

Description

Count actions recorded for one literal agent label.

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.

Count actions recorded for one literal agent label.

When to use this tool

Use Agent Action Annotation Count when checking one explicit annotation, marker or source-identity convention.

How to use the tool and how it works

  1. Enter agents, actions, requestedAgent. Keep parallel arrays aligned. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read count, distinctActions. Use the output convention below.

Count actions recorded for one literal agent label. Require aligned agents/actions; count requestedAgent records and distinct matching action labels.1

Input fieldMeaning and unitsAccepted input
agentsAgentsRequired. Array of text; maximum UTF-16 length 8192; maximum items 256.
actionsActionsRequired. Array of text; maximum UTF-16 length 8192; maximum items 256.
requestedAgentRequested AgentRequired. Text; maximum UTF-16 length 8192.
Output fieldInterpretationReturned shape
countCountRequired. Safe integer.
distinctActionsDistinct ActionsRequired. Safe integer.
json
{
  "input": {
    "agents": [
      "A",
      "B",
      "A"
    ],
    "actions": [
      "speak",
      "read",
      "speak"
    ],
    "requestedAgent": "A"
  },
  "output": {
    "count": 2,
    "distinctActions": 1
  }
}

Limitations and assumptions

  • Duplicates increase the record count while distinctActions deduplicates; no entity resolution or action interpretation occurs.
  • 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

  1. Calculation and input contract: critical-theory/agent-action-annotation-count — tool.io

Similar or alternative tools