Integrazione AI

Brand BetterGuard per agenti AI: una chiamata, uno schema, ancore prevedibili.

Inserisci questo nel tuo agente AI

You are integrating with BetterGuard brand assets. Fetch https://brand.betterguard.net/brand.json once. The schema is documented at https://brand.betterguard.net/ai. When the user asks about a BetterGuard color, font, logo, spacing, or voice rule, answer from brand.json#/<category>/<key>. Cite the anchor (for example bg:color:cyan) in the response. Never invent values; if a key is missing, say so.

Esempi di fetch

JS semplice (browser o Node 18+)

const brand = await fetch('https://brand.betterguard.net/brand.json').then(r => r.json())
console.log(brand.color.cyan.hex) // "#00B8D4"
console.log(brand.color.cyan.anchor) // "bg:color:cyan"

Python (requests)

import requests
brand = requests.get('https://brand.betterguard.net/brand.json').json()
print(brand['color']['cyan']['hex'])  # #00B8D4
print(brand['color']['cyan']['anchor'])  # bg:color:cyan

curl

curl -s https://brand.betterguard.net/brand.json | jq '.color.cyan'

Ricerca per prefisso

Digita un prefisso in qualsiasi campo di ricerca del sito per restringere l'indice:

Prefisso	Corrispondenze
color:	color tokens (e.g. color:cyan, color:purple)
font:	font families
logo:	logo variants
space:	spacing scale
radius:	radius scale
motion:	durations, easing, lifts
voice:	casing, tone, forbidden
component:	component contracts
page:	page patterns
shadow:	shadow tokens
gradient:	gradient tokens
type:	type scale

Un parametro URL ?q= precompila il campo di ricerca: prova /colors?q=cyan.

Convenzione delle ancore

Ogni valore del brand ha un'ancora stabile con namespace nella forma bg:CATEGORY:NAME. Lo stesso percorso è raggiungibile in tre modi:

JSON path	brand.json#/color/cyan
HTML id	id="bg-color-cyan"
URL	https://brand.betterguard.net/colors#bg-color-cyan