The Tree of Widsdom

智慧の樹

Utility notes in agent $DisplayExpression


When you make a new agent inside the Agents container note, it receives a special display expression that shows its status. All BoxPress agents show at least two things:

  • Their “priority” or run-status (i.e., if they’re running or not). Running agents begin with a @; dormant ones begin with .
  • Second, they show their $ChildCount (i.e., how many aliases have met the query and been collected).

This is true because every note added to Agents is assigned a special display expression, which you can find inside the /UTILITY/Code/DE for agents note.

  • c_agent_DE—Shows $AgentPriority and $ChildCount.
  • c_agentText_DE—Certain agents use their text as part of their query. For these, use c_agentText_DE. It displays the value of the agent’s $Text in its display name.
  • c_agentFind_DE—This expression shows both the string to find and the container in which it will search.
  • c_agentTag_DE—Shows the $searchTag and the count of matches.
  • c_agentDateRange_DE—This expression shows a date range.

BoxPress has already made convenience agents that do these tasks for you.