10
Integración con IA
Marca BetterGuard para agentes de IA: una petición, un esquema, anclajes predecibles.
Pega esto en tu agente de IA
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.
Ejemplos de fetch
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"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:cyancurl -s https://brand.betterguard.net/brand.json | jq '.color.cyan'
Búsqueda por prefijo
Escribe un prefijo en cualquier campo de búsqueda del sitio para acotar el índice:
| Prefijo | Coincidencias |
|---|---|
| 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 parámetro de URL ?q= rellena el campo de búsqueda: prueba /colors?q=cyan.
Convención de anclajes
Cada valor de marca lleva un anclaje estable con espacio de nombres de la forma bg:CATEGORY:NAME. La misma ruta es accesible de tres formas:
| JSON path | brand.json#/color/cyan |
| HTML id | id="bg-color-cyan" |
| URL | https://brand.betterguard.net/colors#bg-color-cyan |