aiqr:action

Agent action · 可调用动作

https://aiqr.cc/voc/action

One action with business meaning that an agent may perform on this entity.

一个对该实体有业务含义的可调用动作。

Definition

Type	RFC 9264 extension relation type
Used on	The link context (the anchor).
Target	An endpoint or a document describing how to perform the action.

Required attributes

Attribute	Meaning
`actionId`	A stable identifier for the action, unique within the anchor. This is an identifier, not display text — the same action carries the same id across every interface and runtime.
`title`	The name an agent shows the user when asking for confirmation. Required because §7.2 makes confirmation mandatory, and an unnamed action cannot be confirmed.

Note. Executing an action MUST require explicit user authorisation for the origin — see spec §7.2.

Example

{
  "linkset": [
    {
      "anchor": "https://id.gs1.org/01/06901010101010",
      "description": "Midea air conditioner KFR-35GW",
      "https://aiqr.cc/voc/action": [
        {
          "href": "https://example.com/ac/diagnose",
          "title": "Diagnose a fault",
          "https://aiqr.cc/voc/actionId": [
            "diagnose"
          ]
        }
      ]
    }
  ]
}

See the specification for normative requirements. Machine-readable: action.jsonld.