Forma icon · Agents

Agent

A friendly robot face: an automated agent or assistant acting in the system.

Name
agent
Category
Agents
Introduced
Forma 0.5.0
Keywords
automation, assistant
Grid
24 × 24, 1.8 stroke, round caps and joins
Origin
Original Forma artwork
Construction view: the agent glyph on the 24-unit grid. The dashed square marks the one-unit safe margin that strokes stay inside.

Meaning and when to use it

A friendly robot face: an automated agent or assistant acting in the system.

Use it for

  • Marking work, messages or changes produced by an automated agent.
  • Entry points to an assistant panel.

Avoid it for

  • Human accounts; use user or users.
  • Settings for automation; use settings next to the text “Automation”.

Sizes

The default size is 1.25em, so the icon follows the surrounding text. These are the reviewed sizes; geometry keeps a one-unit safe margin at every size.

HTML · Set a size
<forma-icon class="forma-component-tag"><span class="forma-icon" style="--forma-icon-size:32px" data-forma-icon="agent"><svg xmlns="http://www.w3.org/2000/svg" class="forma-icon__svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><rect x="4" y="8" width="16" height="11" rx="3"/><path d="M12 8V5M9.8 5H14.2"/><circle cx="9" cy="13" r="0.8"/><circle cx="15" cy="13" r="0.8"/><path d="M9 16.3H15"/></svg></span></forma-icon>

Click or tap the code once to select all of it, then copy.

Colour and contrast modes

The icon has no colour of its own: its stroke is currentColor. These swatches set only the parent’s colour role. Brands and themes change the ink through the same roles.

Forced colours and high contrast

In Windows high-contrast and other forced-colour modes the icon is drawn in the system text colour (CanvasText), or the button text colour inside buttons. Meaning must therefore never depend on the icon’s colour.

Grayscale and print

The ink is a vector stroke, not a background, so it prints when browsers drop backgrounds and stays legible in grayscale. Status is always carried by the words next to the icon.

Configurations and how to use them

Every configuration below uses the same generated snippet. Only the surrounding HTML changes. Copy the example that matches your context.

Configuration

Button with a visible text label

The preferred configuration. The icon is decorative and the visible text names the control, so nothing else is needed.

HTML · Button with a visible text label Raw HTML for HTML · Button with a visible text label
<button type="button"><forma-icon class="forma-component-tag"><span class="forma-icon" data-forma-icon="agent"><svg xmlns="http://www.w3.org/2000/svg" class="forma-icon__svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><rect x="4" y="8" width="16" height="11" rx="3"/><path d="M12 8V5M9.8 5H14.2"/><circle cx="9" cy="13" r="0.8"/><circle cx="15" cy="13" r="0.8"/><path d="M9 16.3H15"/></svg></span></forma-icon> Open assistant</button>

Click or tap the code once to select all of it, then copy.

Configuration

Icon-only button

When space only allows the glyph, the button itself must carry the accessible name with aria-label. The SVG stays aria-hidden and the button keeps a touch target of about 44 by 44 CSS pixels.

HTML · Icon-only button Raw HTML for HTML · Icon-only button
<button type="button" aria-label="Open assistant" style="min-inline-size:2.75rem;min-block-size:2.75rem"><forma-icon class="forma-component-tag"><span class="forma-icon" data-forma-icon="agent"><svg xmlns="http://www.w3.org/2000/svg" class="forma-icon__svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><rect x="4" y="8" width="16" height="11" rx="3"/><path d="M12 8V5M9.8 5H14.2"/><circle cx="9" cy="13" r="0.8"/><circle cx="15" cy="13" r="0.8"/><path d="M9 16.3H15"/></svg></span></forma-icon></button>

Click or tap the code once to select all of it, then copy.

Configuration

Inline with status or body text

Placed before words, the icon repeats meaning the text already states. It scales with the surrounding font size because the default size is 1.25em.

Open assistant

HTML · Inline with status or body text Raw HTML for HTML · Inline with status or body text
<p><forma-icon class="forma-component-tag"><span class="forma-icon" data-forma-icon="agent"><svg xmlns="http://www.w3.org/2000/svg" class="forma-icon__svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><rect x="4" y="8" width="16" height="11" rx="3"/><path d="M12 8V5M9.8 5H14.2"/><circle cx="9" cy="13" r="0.8"/><circle cx="15" cy="13" r="0.8"/><path d="M9 16.3H15"/></svg></span></forma-icon> Open assistant</p>

Click or tap the code once to select all of it, then copy.

Configuration

Custom size

Set --forma-icon-size on the presentation span or any ancestor. Keep icons at 16px or larger.

2rem icon

HTML · Custom size Raw HTML for HTML · Custom size
<p style="--forma-icon-size:2rem"><forma-icon class="forma-component-tag"><span class="forma-icon" data-forma-icon="agent"><svg xmlns="http://www.w3.org/2000/svg" class="forma-icon__svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><rect x="4" y="8" width="16" height="11" rx="3"/><path d="M12 8V5M9.8 5H14.2"/><circle cx="9" cy="13" r="0.8"/><circle cx="15" cy="13" r="0.8"/><path d="M9 16.3H15"/></svg></span></forma-icon> 2rem icon</p>

Click or tap the code once to select all of it, then copy.

Configuration

Custom colour

The stroke is currentColor, so the parent’s colour role decides the ink. Never rewrite the SVG geometry or stroke to recolour it.

Accent ink, primary text

HTML · Custom colour Raw HTML for HTML · Custom colour
<p style="color:var(--forma-color-accent-primary)"><forma-icon class="forma-component-tag"><span class="forma-icon" data-forma-icon="agent"><svg xmlns="http://www.w3.org/2000/svg" class="forma-icon__svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><rect x="4" y="8" width="16" height="11" rx="3"/><path d="M12 8V5M9.8 5H14.2"/><circle cx="9" cy="13" r="0.8"/><circle cx="15" cy="13" r="0.8"/><path d="M9 16.3H15"/></svg></span></forma-icon> <span style="color:var(--forma-color-text-primary)">Accent ink, primary text</span></p>

Click or tap the code once to select all of it, then copy.

Configuration

Standalone meaningful image

Use the static SVG file with alt text when the icon stands alone and carries meaning, for example in a table cell with no other text.

Agent
HTML · Standalone meaningful image Raw HTML for HTML · Standalone meaningful image
<img src="agent.svg" alt="Agent" width="24" height="24">

Click or tap the code once to select all of it, then copy.

Configuration

Decorative image

When nearby text already says the same thing, give the image an empty alt so assistive technology skips it.

Agent

HTML · Decorative image Raw HTML for HTML · Decorative image
<p><img src="agent.svg" alt="" width="20" height="20"> Agent</p>

Click or tap the code once to select all of it, then copy.

Files and package paths

Copy the generated assets from the pinned package. Do not hand-copy path geometry: the compiled files are deterministic and verified against the digest below.

Agent assets in Forma 1.0.2
AssetPackage pathUse
Static SVG@echelon-foundry/design-system/icons/agent.svg<img>, CSS, print and offline documents
Decorative HTML@echelon-foundry/design-system/icons/html/agent.htmlInline markup inside a named control or next to text
Registry entry@echelon-foundry/design-system/icons/registry.jsonName, label, category, keywords and digest for tools

Download agent.svg · Decorative HTML as text

SVG · agent.svg
<svg xmlns="http://www.w3.org/2000/svg" class="forma-icon__svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><rect x="4" y="8" width="16" height="11" rx="3"/><path d="M12 8V5M9.8 5H14.2"/><circle cx="9" cy="13" r="0.8"/><circle cx="15" cy="13" r="0.8"/><path d="M9 16.3H15"/></svg>

Click or tap the code once to select all of it, then copy.

HTML · icons/html/agent.html
<forma-icon class="forma-component-tag"><span class="forma-icon" data-forma-icon="agent"><svg xmlns="http://www.w3.org/2000/svg" class="forma-icon__svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><rect x="4" y="8" width="16" height="11" rx="3"/><path d="M12 8V5M9.8 5H14.2"/><circle cx="9" cy="13" r="0.8"/><circle cx="15" cy="13" r="0.8"/><path d="M9 16.3H15"/></svg></span></forma-icon>

Click or tap the code once to select all of it, then copy.

Forma version
1.0.2
SVG sha256
db1e70fe28a32eccbd9c7e2f91860e4fb1de6118d541b97d899ff0dc7fb8ee62

Accessibility checklist