BisonagentsDocs

MCP de Bison

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.

{
  "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. Campo overview en la respuesta de get_brand_profile.

CampoNivelQué va
aboutClaveQué hace la marca en un párrafo: qué vende, a quién y dónde.
industryClaveIndustria o rubro, por ejemplo «Seguros» o «Software B2B».
objectivesClaveObjetivos de negocio actuales, por ejemplo crecer en una región o lanzar una línea.
clientsClaveClientes destacados que se pueden nombrar en público, uno por elemento.
value_propositionOpcionalPor qué elegir a la marca frente a las alternativas, en una o dos frases.
missionOpcionalMisión de la marca.
visionOpcionalVisión de la marca.
current_focusOpcionalEn qué está enfocada hoy: campaña, temporada o producto prioritario.
founding_yearOpcionalAño de fundación, con cuatro cifras; null si no se sabe.
company_sizeOpcionalTamaño de la empresa, por ejemplo «11-50 personas».
revenue_rangeOpcionalRango de facturación anual.
partnersOpcionalPartners y alianzas, uno por elemento.
regulatory_frameworkOpcionalNormas o regulaciones que aplican a la marca, una por elemento.

Voz de la marca

Se edita con update_brand_profile. Campo voice en la respuesta de get_brand_profile.

CampoNivelQué va
voice_descriptionClaveCómo habla la marca: tono, registro y estilo.
author_personaClaveQuién firma el contenido (nombre y cargo, o un perfil) y su experiencia.
rulesClaveReglas de redacción, una por elemento, por ejemplo «Tutear» o «Sin anglicismos».
sensitive_topicsOpcionalTemas que la marca evita o trata con cuidado.
glossaryOpcionalTérminos propios y cómo usarlos.

Ficha de datos

Se edita con update_brand_profile. Campo facts en la respuesta de get_brand_profile.

CampoNivelQué va
regionsClavePaíses, regiones o ciudades donde opera.
policiesOpcionalPolíticas de cara al cliente: devoluciones, garantías, privacidad.
slasOpcionalTiempos de respuesta o de entrega comprometidos.
certificationsOpcionalCertificaciones, sellos o acreditaciones.

Operación

Se edita con update_brand_profile. Campo operations en la respuesta de get_brand_profile.

CampoNivelQué va
operating_hoursClaveHorario de atención.
coverage_areasOpcionalZonas de cobertura o despacho.
service_channelsOpcionalCanales de atención: web, teléfono, WhatsApp, tienda.
service_modelOpcionalCómo se entrega el servicio: en línea, presencial, a domicilio o mixto.

Productos y servicios

Se edita con save_product. Campo products en la respuesta de get_brand_profile.

CampoNivelQué va
nameObligatorio al crearNombre del producto o servicio.
typeOpcionalCómo se clasifica la solución. Una de las opciones de abajo.
main_categoryOpcionalCategoría principal; si no existe, se agrega a la lista de categorías.
descriptionOpcionalDescripción breve.
featuresOpcionalCaracterísticas principales.
differentiatorsOpcionalQué lo diferencia de las alternativas.
value_propositionOpcionalPor qué elegirlo, en una o dos frases.
price_rangeOpcionalRango de precio, por ejemplo «$10.000–$20.000».
delivery_timeOpcionalTiempo de entrega o de implementación.
warrantyOpcionalGarantía.
problems_solvedOpcionalProblemas que le resuelve al cliente.
urlOpcionalPá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.

ValorSignifica
physicalProducto físico
saasSoftware / SaaS
serviceServicio profesional
infoproductInfoproducto

Audiencias

Se edita con save_audience. Campo audiences en la respuesta de get_brand_profile.

CampoNivelQué va
nameObligatorio al crearNombre del segmento, por ejemplo «Jefes de RR. HH. en pymes».
roleOpcionalCargo o rol de quien decide la compra.
proof_typeClaveQué prueba necesita para creer en la promesa. Una de las opciones de abajo.
knowledge_levelOpcionalCuánto sabe de la categoría: 1 Inicial, 2 Básico, 3 Intermedio, 4 Avanzado, 5 Experto; 3 si no se indica.
painsOpcionalProblemas o dolores que tiene.
desireOpcionalQué quiere lograr.
triggerOpcionalPor qué te elige en lugar de otras alternativas. Una de las opciones de abajo.
barriersOpcionalQué lo frena para comprar.
objectionsOpcionalObjeciones típicas.
alternativesOpcionalQué usa hoy en lugar de la marca.
toneOpcionalTono con el que conviene hablarle. Una de las opciones de abajo.
ctaOpcionalLlamado 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.

ValorSignifica
CERTIFICATIONSCertificaciones técnicas
TESTIMONIALSTestimonios de pares
DATADatos científicos
GUARANTEESGarantías de satisfacción
NONENo 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.

ValorSignifica
PRICEPrecio
QUALITYCalidad / Durabilidad
INNOVATIONInnovación
TRUSTConfianza / Reputación
SPEEDRapidez
CONVENIENCEComodidad / Facilidad de uso
ROIRetorno de Inversión / Rentabilidad
SUPPORTSoporte / Atención al cliente
STATUSExclusividad / Estatus
ECOSostenibilidad / Impacto social
SECURITYSeguridad / Privacidad
CUSTOMIZATIONPersonalizació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.

ValorSignifica
EMPATHETICEmpático
PROFESSIONALProfesional
INSPIRATIONALInspiracional
DIRECTDirecto