Action Descriptor Tag

Tag Name	<action-descriptor>
Attributes	for, trigger, action, params, priority
Purpose	Provides intelligent agents with essential instructions on how to interact with web page elements effectively in the context of a specific task, without requiring any external instructions.

---

Protocol Specification

<action-descriptor> is an inline non-rendered tag that provides critical interaction information to intelligent agents. Human users will not see this data on the webpage, and it should be placed within the context of the relevant HTML elements.

Attribute	Description
for	The for attribute specifies the element that the intelligent agent should interact with. It should be the id of the element.
trigger	The trigger attribute specifies the event or condition that prompts the intelligent agent to perform a specific action. It can include events such as "mouseover", "click", "keypress", or "page-load". It can also include custom triggers based on application-specific logic.
action	The action attribute describes the action to be performed by the intelligent agent on the given element. This may include actions such as "submit", "navigate", "expand", or "filter". Custom actions specific to the application can also be included.
params	The params attribute contains any additional parameters required to perform the action. These parameters should be in a key-value format, with pairs separated by semicolons. For example: params="key1:value1;key2:value2".
priority	The priority attribute is an optional attribute that indicates the importance of the instruction relative to other <action-descriptor> tags on the same page. It can take integer values, with higher numbers indicating higher priority. If not specified, the default priority is 1. Intelligent agents should prioritize executing actions with higher priority values.

---

Example

Consider a web application that displays a list of items, with options to filter the items by category and sort them by price. The application also has a search bar to search for specific items. An intelligent agent needs to know how to perform these tasks effectively.

The following markup uses the <action-descriptor> tag to provide the required information:

<!-- Filter by category -->
<action-descriptor for="category-filter" trigger="change" action="filter" params="type:category" />
<label for="category-filter">Category:</label>
<select id="category-filter" >
  <option value="all">All</option>
  <option value="electronics">Electronics</option>
  <option value="clothing">Clothing</option>
</select>


<!-- Sort by price -->
<action-descriptor for="price-sort" trigger="change" action="sort" params="type:price"/>
<label for="price-sort">Sort by:</label>
<select id="price-sort">
  <option value="low-to-high">Low-to-High</option>
  <option value="high-to-low">High-to-Low</option>
</select>

<!-- Search bar -->
<action-descriptor for="search-form" trigger="submit" action="search" params="target:search-form" priority="2" />
<form id="search-form">
  <label for="search-bar">Search:</label>
  <input type="text" id="search-bar" />
  <button type="submit">Search</button>
</form>

The <action-descriptor> tags in the example above provide instructions for the intelligent agent to perform 3 actions: filter by category, sort by price, and search for items.

The following table provides a summary of the instructions:

Filter	To filter by category, the agent can perform the action "filter" by interacting with element id "category-filter". The type of filter should be "category".
Sort	To sort by price, the agent can perform the action "sort" by interacting with element id "price-sort". The type of sorting should be "price".
Search	To search using the search bar, the agent can perform the action "search" by interacting with element id "search-form". The priority of this action is set to 2, indicating that it has higher importance than the default priority actions.

In this example, the <action-descriptor> tags provide essential instructions for an intelligent agent to interact effectively with the web page elements without needing any external instructions. The tag's purpose is distinct from existing HTML attributes, as it specifically targets intelligent agents and provides a structured, machine-readable format for conveying interaction logic.

By providing essential context information directly within the HTML markup, the <action-descriptor> tag allows intelligent agents to understand and interact with web pages and web applications in a more effective and context-aware manner. This, in turn, enables them to better assist users and perform important tasks, without relying on human-readable content or external instruction sets.

---

Benefits of the <action-descriptor> Tag:

1	Simplify Interaction Logic: By providing a structured, machine-readable format for conveying interaction logic, the <action-descriptor> tag simplifies the process of understanding and interacting with web pages and web applications for intelligent agents.
2	Improve Context Awareness: By placing the <action-descriptor> tag inline with the relevant HTML elements, it provides essential context information directly within the HTML markup, enabling intelligent agents to better understand the purpose and functionality of those elements.
3	Increase Efficiency: By specifying triggers, actions, parameters, and priorities, the <action-descriptor> tag allows intelligent agents to prioritize executing actions that are most relevant or important, leading to improved efficiency and an overall better user experience.
4	Enhance Accessibility: The <action-descriptor> tag provides a standardized way to convey interaction instructions, which can help make web pages and web applications more accessible to intelligent agents, ultimately enhancing the overall accessibility of the internet.
5	Foster Innovation: By providing a standardized format for conveying interaction instructions, the <action-descriptor> tag encourages the development of new, innovative solutions that leverage the power of intelligent agents to enhance the user experience on web pages and web applications.

---

Summary

The <action-descriptor> tag was designed to promote the development of new, innovative solutions that leverage the power of intelligent agents to enhance the user experience on web pages and web applications. It provides a standardized way to convey interaction instructions, which can help make web pages and web applications more accessible to intelligent agents, ultimately enhancing the overall accessibility of the internet.

• With its unique focus on providing machine-readable interaction logic, the <action-descriptor> tag is distinct from existing HTML attributes and provides a standardized way to convey interaction instructions.

• By using the <action-descriptor> tag, developers can create more accessible and context-aware web pages and applications that are better suited for interaction with intelligent agents.

---