# Perfil de marca

El perfil de marca es lo que Bison sabe de tu empresa: qué vende, a quién, cómo habla y cómo opera. Con un token de «Lectura y edición», tu agente puede completarlo y corregirlo.

## Cómo completarlo

1. Llama a `get_brand_profile`. El campo `missing` lista los datos clave que faltan.
2. Envía a `update_brand_profile`, `save_product` o `save_audience` solo los campos que cambian. Lo que no envías queda igual.
3. Sin `confirm`, la herramienta devuelve una vista previa con el antes y el después, y no guarda nada.
4. Revisa la vista previa y repite la llamada con `confirm: true` para guardar.

> **Niveles:** **Obligatorio al crear**: sin él no se puede crear el producto o la audiencia. **Clave**: sin ese dato Bison no puede darte algunas recomendaciones, y aparece en `missing`. **Opcional**: mejora el contenido que escribe tu agente, pero no bloquea nada.

## Reglas que conviene saber

- **Las listas reemplazan.** Un campo de lista, como `clients`, `partners` o `rules`, se guarda tal como lo envías: manda la lista completa, no solo el elemento nuevo.
- **Editar o crear.** Para editar un producto o una audiencia, pasa su `id` (lo devuelve `get_brand_profile`). Sin `id` se crea uno nuevo y `name` es obligatorio.
- **Opciones fijas.** `type`, `tone`, `proof_type` y `trigger` solo aceptan los valores de las tablas de abajo, los mismos que ofrece la pantalla Conocimiento. Con otro valor la herramienta responde con un error que nombra el campo y no guarda nada.
- **Campo desconocido.** Si envías un campo que no existe, responde con la lista de campos permitidos y no guarda nada.
- **Categorías de producto.** Si `main_category` es nueva, se agrega a la lista de categorías; las otras categorías y productos quedan intactos.

## Ejemplo

Tu agente decide cuándo llamar a la herramienta; no tienes que escribir esto. Es la llamada MCP equivalente a «agrega la audiencia Jefes de RR. HH. en pymes, con tono profesional, que se convence con testimonios y cuyo siguiente paso es agendar una demo». Sin `confirm` devuelve la vista previa; para guardar, agrega `"confirm": true` en `arguments`.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "save_audience",
    "arguments": {
      "name": "Jefes de RR. HH. en pymes",
      "tone": "PROFESSIONAL",
      "proof_type": "TESTIMONIALS",
      "cta": "Agendar demo"
    }
  }
}
```

## Qué significan algunos campos

- **`cta` (llamado a la acción).** El siguiente paso concreto que quieres que dé esa audiencia, escrito como el texto de un botón o enlace: «Agendar demo», «Pedir cotización». No tiene que ser un botón que ya exista en tu web: Bison lo usa para que el contenido que escribe para esa audiencia cierre con la acción correcta.
- **`proof_type` (prueba requerida).** Qué evidencia necesita esa audiencia para creer en tu promesa: certificaciones, testimonios de otros clientes, datos, garantías, o ninguna.
- **`trigger` (motivo de elección).** La razón principal por la que esa audiencia te elige frente a otras alternativas, por ejemplo el precio o la confianza.
- **`knowledge_level`.** Cuánto sabe esa audiencia de tu categoría, de 1 (inicial) a 5 (experto).

## Resumen de la marca

Se edita con [`update_brand_profile`](https://docs.bisonagents.com/mcp/herramientas/update_brand_profile/). Campo `overview` en la respuesta de `get_brand_profile`.

| Campo | Nivel | Qué va |
| --- | --- | --- |
| `about` | Clave | Qué hace la marca en un párrafo: qué vende, a quién y dónde. |
| `industry` | Clave | Industria o rubro, por ejemplo «Seguros» o «Software B2B». |
| `objectives` | Clave | Objetivos de negocio actuales, por ejemplo crecer en una región o lanzar una línea. |
| `clients` | Clave | Clientes destacados que se pueden nombrar en público, uno por elemento. |
| `value_proposition` | Opcional | Por qué elegir a la marca frente a las alternativas, en una o dos frases. |
| `mission` | Opcional | Misión de la marca. |
| `vision` | Opcional | Visión de la marca. |
| `current_focus` | Opcional | En qué está enfocada hoy: campaña, temporada o producto prioritario. |
| `founding_year` | Opcional | Año de fundación, con cuatro cifras; null si no se sabe. |
| `company_size` | Opcional | Tamaño de la empresa, por ejemplo «11-50 personas». |
| `revenue_range` | Opcional | Rango de facturación anual. |
| `partners` | Opcional | Partners y alianzas, uno por elemento. |
| `regulatory_framework` | Opcional | Normas o regulaciones que aplican a la marca, una por elemento. |

## Voz de la marca

Se edita con [`update_brand_profile`](https://docs.bisonagents.com/mcp/herramientas/update_brand_profile/). Campo `voice` en la respuesta de `get_brand_profile`.

| Campo | Nivel | Qué va |
| --- | --- | --- |
| `voice_description` | Clave | Cómo habla la marca: tono, registro y estilo. |
| `author_persona` | Clave | Quién firma el contenido (nombre y cargo, o un perfil) y su experiencia. |
| `rules` | Clave | Reglas de redacción, una por elemento, por ejemplo «Tutear» o «Sin anglicismos». |
| `sensitive_topics` | Opcional | Temas que la marca evita o trata con cuidado. |
| `glossary` | Opcional | Términos propios y cómo usarlos. |

## Ficha de datos

Se edita con [`update_brand_profile`](https://docs.bisonagents.com/mcp/herramientas/update_brand_profile/). Campo `facts` en la respuesta de `get_brand_profile`.

| Campo | Nivel | Qué va |
| --- | --- | --- |
| `regions` | Clave | Países, regiones o ciudades donde opera. |
| `policies` | Opcional | Políticas de cara al cliente: devoluciones, garantías, privacidad. |
| `slas` | Opcional | Tiempos de respuesta o de entrega comprometidos. |
| `certifications` | Opcional | Certificaciones, sellos o acreditaciones. |

## Operación

Se edita con [`update_brand_profile`](https://docs.bisonagents.com/mcp/herramientas/update_brand_profile/). Campo `operations` en la respuesta de `get_brand_profile`.

| Campo | Nivel | Qué va |
| --- | --- | --- |
| `operating_hours` | Clave | Horario de atención. |
| `coverage_areas` | Opcional | Zonas de cobertura o despacho. |
| `service_channels` | Opcional | Canales de atención: web, teléfono, WhatsApp, tienda. |
| `service_model` | Opcional | Cómo se entrega el servicio: en línea, presencial, a domicilio o mixto. |

## Productos y servicios

Se edita con [`save_product`](https://docs.bisonagents.com/mcp/herramientas/save_product/). Campo `products` en la respuesta de `get_brand_profile`.

| Campo | Nivel | Qué va |
| --- | --- | --- |
| `name` | Obligatorio al crear | Nombre del producto o servicio. |
| `type` | Opcional | Cómo se clasifica la solución. Una de las opciones de abajo. |
| `main_category` | Opcional | Categoría principal; si no existe, se agrega a la lista de categorías. |
| `description` | Opcional | Descripción breve. |
| `features` | Opcional | Características principales. |
| `differentiators` | Opcional | Qué lo diferencia de las alternativas. |
| `value_proposition` | Opcional | Por qué elegirlo, en una o dos frases. |
| `price_range` | Opcional | Rango de precio, por ejemplo «$10.000–$20.000». |
| `delivery_time` | Opcional | Tiempo de entrega o de implementación. |
| `warranty` | Opcional | Garantía. |
| `problems_solved` | Opcional | Problemas que le resuelve al cliente. |
| `url` | Opcional | Página del producto en el sitio de la marca. |

### Valores de `type`

Envía el valor de la primera columna tal cual aparece, respetando las mayúsculas. Un valor distinto se rechaza y no se guarda nada.

| Valor | Significa |
| --- | --- |
| `physical` | Producto físico |
| `saas` | Software / SaaS |
| `service` | Servicio profesional |
| `infoproduct` | Infoproducto |

## Audiencias

Se edita con [`save_audience`](https://docs.bisonagents.com/mcp/herramientas/save_audience/). Campo `audiences` en la respuesta de `get_brand_profile`.

| Campo | Nivel | Qué va |
| --- | --- | --- |
| `name` | Obligatorio al crear | Nombre del segmento, por ejemplo «Jefes de RR. HH. en pymes». |
| `role` | Opcional | Cargo o rol de quien decide la compra. |
| `proof_type` | Clave | Qué prueba necesita para creer en la promesa. Una de las opciones de abajo. |
| `knowledge_level` | Opcional | Cuánto sabe de la categoría: 1 Inicial, 2 Básico, 3 Intermedio, 4 Avanzado, 5 Experto; 3 si no se indica. |
| `pains` | Opcional | Problemas o dolores que tiene. |
| `desire` | Opcional | Qué quiere lograr. |
| `trigger` | Opcional | Por qué te elige en lugar de otras alternativas. Una de las opciones de abajo. |
| `barriers` | Opcional | Qué lo frena para comprar. |
| `objections` | Opcional | Objeciones típicas. |
| `alternatives` | Opcional | Qué usa hoy en lugar de la marca. |
| `tone` | Opcional | Tono con el que conviene hablarle. Una de las opciones de abajo. |
| `cta` | Opcional | Llamado a la acción: el siguiente paso concreto que quieres que dé esta audiencia, escrito como lo dirías en un botón o enlace, por ejemplo «Agendar demo». |

### Valores de `proof_type`

Envía el valor de la primera columna tal cual aparece, respetando las mayúsculas. Un valor distinto se rechaza y no se guarda nada.

| Valor | Significa |
| --- | --- |
| `CERTIFICATIONS` | Certificaciones técnicas |
| `TESTIMONIALS` | Testimonios de pares |
| `DATA` | Datos científicos |
| `GUARANTEES` | Garantías de satisfacción |
| `NONE` | No necesita pruebas |

### Valores de `trigger`

Envía el valor de la primera columna tal cual aparece, respetando las mayúsculas. Un valor distinto se rechaza y no se guarda nada.

| Valor | Significa |
| --- | --- |
| `PRICE` | Precio |
| `QUALITY` | Calidad / Durabilidad |
| `INNOVATION` | Innovación |
| `TRUST` | Confianza / Reputación |
| `SPEED` | Rapidez |
| `CONVENIENCE` | Comodidad / Facilidad de uso |
| `ROI` | Retorno de Inversión / Rentabilidad |
| `SUPPORT` | Soporte / Atención al cliente |
| `STATUS` | Exclusividad / Estatus |
| `ECO` | Sostenibilidad / Impacto social |
| `SECURITY` | Seguridad / Privacidad |
| `CUSTOMIZATION` | Personalización / Flexibilidad |

### Valores de `tone`

Envía el valor de la primera columna tal cual aparece, respetando las mayúsculas. Un valor distinto se rechaza y no se guarda nada.

| Valor | Significa |
| --- | --- |
| `EMPATHETIC` | Empático |
| `PROFESSIONAL` | Profesional |
| `INSPIRATIONAL` | Inspiracional |
| `DIRECT` | Directo |
