ai.Role

A typed chat-role marker produced by `${role("system")}` in a prompt.

Reference version

Signature

class ai.Role

A typed chat-role marker produced by ${role("system")} in a prompt.

Source:<builtin>/ai/context.bamlbytes 1576–1816

Fields

name

string

metadata

map<string, baml.json.json>

Provider-specific per-message metadata such as cache control, set with ${role("system", metadata = { "cache_control": { "type": "ephemeral" } })}.