BisonagentsDocs

MCP de Bison

Crear o editar una audiencia

Edición

save_audience

Crea una audiencia del perfil de marca, o edita una existente por su id (de get_brand_profile). Para crear, name es obligatorio. Solo cambia los campos enviados. Sin confirm devuelve la vista previa.

Permiso: Edición. Requiere un token de «Lectura y edición».

Cambia datos

Modifica información de tu empresa en Bison. Tu agente debería pedirte confirmación antes de usarla.

Qué va en cada campo y cuáles son clave: Perfil de marca.

Parámetros

NombreTipoObligatorioDescripción
audience_idtextoNoid de la audiencia a editar; omítelo para crear una.
nametexto (hasta 200 caracteres)NoNombre del segmento, por ejemplo «Jefes de RR. HH. en pymes». Obligatorio al crear.
roletexto (hasta 200 caracteres)NoCargo o rol de quien decide la compra.
proof_typeuna de CERTIFICATIONS, TESTIMONIALS, DATA, GUARANTEES, NONENoQué prueba necesita para creer en la promesa. Una de: CERTIFICATIONS (Certificaciones técnicas), TESTIMONIALS (Testimonios de pares), DATA (Datos científicos), GUARANTEES (Garantías de satisfacción), NONE (No necesita pruebas). Clave: sin este dato Bison no puede dar algunas recomendaciones.
knowledge_levelentero (1 a 5)NoCuánto sabe de la categoría: 1 Inicial, 2 Básico, 3 Intermedio, 4 Avanzado, 5 Experto; 3 si no se indica.
painstexto (hasta 2000 caracteres)NoProblemas o dolores que tiene.
desiretexto (hasta 2000 caracteres)NoQué quiere lograr.
triggeruna de PRICE, QUALITY, INNOVATION, TRUST, SPEED, CONVENIENCE, ROI, SUPPORT, STATUS, ECO, SECURITY, CUSTOMIZATIONNoPor qué te elige en lugar de otras alternativas. Una de: 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).
barrierstexto (hasta 2000 caracteres)NoQué lo frena para comprar.
objectionstexto (hasta 2000 caracteres)NoObjeciones típicas.
alternativestexto (hasta 2000 caracteres)NoQué usa hoy en lugar de la marca.
toneuna de EMPATHETIC, PROFESSIONAL, INSPIRATIONAL, DIRECTNoTono con el que conviene hablarle. Uno de: EMPATHETIC (Empático), PROFESSIONAL (Profesional), INSPIRATIONAL (Inspiracional), DIRECT (Directo).
ctatexto (hasta 500 caracteres)NoLlamado 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».
confirmbooleanoNofalse u omitido: solo devuelve la vista previa (antes y después) sin guardar. true: guarda.

Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "save_audience",
    "arguments": {
      "name": "<name>"
    }
  }
}

Ejemplo de vista previa

Sin confirm, con {"name":"Familias con dos autos","tone":"EMPATHETIC","proof_type":"GUARANTEES","cta":"Cotizar en 2 minutos"}, no guarda nada y devuelve esto, para una marca ficticia («Altavista Seguros»). Para guardar, repite la llamada con confirm: true.

{
  "saved": false,
  "changed": true,
  "id": null,
  "created": true,
  "changes": {
    "name": {
      "before": null,
      "after": "Familias con dos autos"
    },
    "proof_type": {
      "before": null,
      "after": "GUARANTEES"
    },
    "tone": {
      "before": null,
      "after": "EMPATHETIC"
    },
    "cta": {
      "before": null,
      "after": "Cotizar en 2 minutos"
    }
  },
  "notes": "Vista previa: no se guardó nada. Muéstrale el cambio al usuario y repite la llamada con confirm: true para guardarlo."
}