SocialHub.AI
Nuevo · se está implementando por espacio de trabajo

Gobernanza de la IA: Introspección y aprobaciones

Flash coloca cada acción iniciada por IA detrás de un equipo de autorización por acción (auto, review o forbidden) configurado por espacio de trabajo en la consola Actividad y aprobaciones de IA. Para un cliente de IA superior a MCP, esto significa dos cosas: puede descubrir los objetos comerciales y las acciones que puede realizar antes de actuar, y sus llamadas de escritura arrojan resultados estructurados: ejecutados, pendientes de aprobación humana o rechazados con un motivo legible por máquina.

Esta guía cubre las herramientas de introspección, la semántica de escritura en un equipo de revisión y el ciclo de vida de aprobación. Se basa en el mismo servidor MCP gobernado documentado en la MCP guía de integración. Para obtener una descripción general del negocio, consulte la página del producto Gobernanza y aprobaciones de IA. El enrutamiento de engranajes se habilita progresivamente: el comportamiento siguiente se aplica a medida que las acciones gobernadas se implementan en su espacio de trabajo.

Introspección empresarial-object (alcance introspection:read)

Tres herramientas de lectura permiten a un cliente de IA comprender la estructura del negocio antes de interactuar con él: qué objetos existen (incluidos los campos y objetos personalizados del espacio de trabajo), qué significa cada atributo, cómo se relacionan los objetos y qué acciones se pueden ejecutar, con sus precondiciones y configuración actual. Un agente eficiente consulta estas herramientas primero y solo propone acciones que la configuración permite.

list_objectsLeer

Descubre los objetos de negocio disponibles para el espacio de trabajo de la clave: miembro, pedido, cupón, campaña, tienda, producto, segmento, etiqueta, además de cualquier objeto personalizado definido en el espacio de trabajo. Devuelve la clave, la etiqueta y una breve descripción de cada object. Llama primero para conocer la información existente antes de leer o actuar.

Parámetros: (none)
describe_objectLeer

La estructura completa de un object: sus atributos (incluidos los campos personalizados del espacio de trabajo) con su tipo y significado comercial, y sus relaciones con otros objetos (por ejemplo, un pedido pertenece a un miembro; se puede emitir un cupón a un miembro). Los campos de información personal identificable (PII) se devuelven únicamente como metadatos: nombre, tipo, semántica y un indicador PII; nunca sus valores.

Parámetros: object
list_actionsLeer

Las acciones que puede realizar un cliente de IA, con las condiciones previas de cada acción y su nivel de autorización actual (automático/revisión/prohibido), según la configuración del espacio de trabajo. Filtre por object para ver solo las acciones relacionadas con este parámetro. El resultado refleja exactamente lo que aplicará la capa de gobernanza; úselo para evitar proponer acciones que serán rechazadas.

Parámetros: object?

PII es solo metadatos, por diseño. La introspección describe campos que contienen información personal (su nombre, tipo, significado y una bandera pii) pero nunca devuelve sus valores. La lectura de datos reales de los miembros pasa por las herramientas de lectura de miembros y sus propios alcances.

Ejemplo: describe un object y luego comprueba los engranajes.

Ejemplos descriptivos de la estructura de solicitud/respuesta (abreviados; las respuestas reales enumeran todos los campos y acciones):

// describe_object { "object": "member" }
{
  "object": "member",
  "label": "Member",
  "meaning": "A loyalty program member owned by this workspace.",
  "fields": [
    { "name": "email",            "type": "string",  "pii": true,
      "meaning": "Contact email. PII: metadata only — values are never returned here." },
    { "name": "tier",             "type": "string",  "pii": false,
      "meaning": "Current loyalty tier." },
    { "name": "membership_no",    "type": "string",  "pii": false, "custom": true,
      "meaning": "Workspace-defined custom field." }
  ],
  "relationships": [
    { "to": "order",  "kind": "has_many",  "meaning": "Orders placed by this member." },
    { "to": "coupon", "kind": "has_many",  "meaning": "Coupons issued to this member." },
    { "to": "tag",    "kind": "has_many",  "meaning": "Tags currently applied to this member." }
  ]
}
// list_actions { "object": "member" }
{
  "actions": [
    { "action": "issue_coupon",     "gear": "review",
      "preconditions": ["member has consent", "coupon pool has stock"] },
    { "action": "earn_points",      "gear": "auto",
      "preconditions": ["amount within the workspace cap"] },
    { "action": "assign_tag",       "gear": "auto",
      "preconditions": ["tag exists and is active"] },
    { "action": "add_member_note",  "gear": "auto",
      "preconditions": ["note passes server-side sanitation"] },
    { "action": "send_campaign",    "gear": "review", "locked": true,
      "preconditions": ["sending can never be auto — a human always approves"] }
  ]
}

La gear que ves es el engranaje que se aplicará: el espacio de trabajo lo configura por acción en la consola, y un disyuntor por acción puede degradar una acción a review en cualquier momento (solo se degrada automáticamente; solo un humano puede restaurarla). Vuelve a comprobar con list_actions en lugar de almacenar engranajes en caché para sesiones largas.

Herramientas de escritura bajo un engranaje de revisión: pendiente / rechazada

Cuando una herramienta de escritura MCP apunta a una acción cuyo engranaje es review, la llamada no ejecuta el efecto secundario. Devuelve un resultado estructurado: o bien la propuesta se puso en cola para su aprobación humana (pending), o bien se rechazó directamente (refused) con un reason_code y un suggested_action legibles por máquina.

// proposed — waiting for a human
{
  "status": "pending",
  "proposal_id": "prop_9f2c…",
  "action": "issue_coupon",
  "expires_at": "2026-07-10T00:00:00Z",  // 7 days
  "message": "Queued for human approval in
              AI Activity & Approvals."
}
// refused — with a reason and a next step
{
  "status": "refused",
  "action": "issue_coupon",
  "reason_code": "recently_rejected",
  "suggested_action": "A human rejected this
    proposal recently. Do not re-propose;
    consider a different action or ask the
    operator."
}
reason_codeSignificadoQué debe hacer su agente
gear_forbiddenLa acción está configurada como prohibida para este espacio de trabajo (o la acción nunca puede ser automática, por ejemplo, el envío, y se invocó de una manera que requiere la automatización).No lo vuelvas a intentar. Muestra el rechazo; sigue suggested_action (normalmente una acción alternativa o "pedirle a un humano que cambie la marcha").
recently_rejectedUn usuario rechazó recientemente la misma propuesta para el mismo objetivo; la plataforma no la volverá a poner en cola.Respeta la decisión humana. No la vuelvas a proponer ni la reformules; síguela. suggested_action.

Cada rechazo lleva un reason_code en esta forma más un suggested_action; trate los códigos anteriores como los que se deben ramificar y el campo como extensible. Un rechazo es una lectura estricta de los límites para usted, no un error que deba volver a intentar: nunca reformule una propuesta para eludir un rechazo.

Ciclo de aprobación

Una propuesta pending se resuelve de una sola manera: approved, rejected o expired. Los humanos actúan sobre ella en la consola de Actividad y Aprobaciones de IA (individualmente o por lotes según el tipo de acción); un correo electrónico de resumen diario muestra las tareas pendientes.

Estadocomo sucedeLuego
pendingSe llamó a una herramienta de escritura mientras se revisa el equipo de la acción: la propuesta está en cola para la aprobación humana.aprobado · rechazado · caducado
approvedUn humano lo aprobó. Antes de ejecutarlo, la plataforma revalida el razonamiento de la IA; si ya no es válido (por ejemplo, si el cliente ya volvió a comprar), la acción no se ejecuta.Terminal (resultado registrado en el registro de decisiones; revocable individualmente)
rejectedUn humano lo rechazó, opcionalmente con una nota. La misma propuesta es rechazada entonces con recently_rejected si se vuelve a enviar.Terminal
expiredSi no se toma una decisión en 7 días, la propuesta caduca automáticamente y no se ejecuta nada.Terminal

Garantías de idempotencia

  • Una aprobación, una ejecución. Aprobar una propuesta ejecuta su acción exactamente una vez; una aprobación repetida reproduce el resultado almacenado sin efectos secundarios.
  • El reenvío no genera duplicados. Al volver a ejecutar la herramienta de escritura para la misma propuesta mientras está pendiente, se obtiene el mismo resultado pending y proposal_id; no se agrega una segunda tarjeta a la cola.
  • La aprobación se revalida; la ejecución es condicional. Al aprobar, la plataforma vuelve a comprobar si el razonamiento de la IA sigue siendo válido; si ya no lo es (por ejemplo, si el cliente ya ha vuelto a comprar), no se ejecuta nada: se registra el resultado en lugar de la acción.
  • Todo se audita y se puede revocar individualmente. La propuesta, la decisión, la ruta de autorización (auto o una persona designada), la ejecución y el resultado se registran en el historial de decisiones, donde se puede deshacer una sola entrada.

El servidor es el límite. Los engranajes, la revalidación, la caducidad y el disyuntor por acción se aplican del lado de Flash, sin depender nunca del razonamiento del agente ni de la confirmación del cliente. Las acciones de envío nunca se ejecutan automáticamente, independientemente de lo que solicite el cliente.

Principalidades de transparencia y el modelo de inventario de caja de cristal

La misma disciplina de control total —cada decisión automatizada se registra y explica, los datos personales se mantienen fuera del contexto del modelo— se extiende más allá de las acciones controladas: a la optimización experimental del tráfico, a las solicitudes LLM salientes y al inventario de modelos de aprendizaje automático clásico que impulsa la clasificación, la predicción y la detección en todo el producto.

Optimización automática del tráfico A/B: el registro de decisiones

Las campañas recurrentes (automatizaciones y recorridos) pueden optar por Optimizar automáticamente el tráfico con el tiempo, lo que reasigna los pesos de entrega entre las variantes del experimento en función del rendimiento de clics observado. Cada reasignación es auditable:

  • Registro de decisiones de solo anexión. Cada recálculo horario escribe un registro con las ponderaciones aplicadas y una explicación legible. Los registros nunca se sobrescriben: el registro contiene el historial completo de por qué el tráfico se ve como se ve.
  • La división configurada nunca cambia. La división configurada de su experimento permanece intacta como línea base; los pesos optimizados se calculan y registran junto con él.
  • Nivel mínimo de exploración: 10 %. El peso de ninguna variante cae por debajo del 10 %, por lo que todas siguen recibiendo tráfico y se puede detectar cualquier cambio.
  • Reparto equitativo hasta alcanzar ≥100 entregas por variante. Los pesos se mantienen en el reparto configurado hasta que cada variante tenga al menos ~100 entregas; no se reasignan datos en conjuntos de datos reducidos y este mecanismo nunca declara un "ganador" estadístico.

Enmascaramiento LLM PII en la costura del proveedor

Antes de que cualquier solicitud salga de Flash para un proveedor externo de LLM, los identificadores personales de los miembros se enmascaran (se aplica en la interfaz del proveedor), de modo que todas las funciones de IA pasan por ella:

  • Pseudonimos deterministas. Las direcciones de correo electrónico, los números de teléfono y las secuencias de dígitos similares a las de las tarjetas se reemplazan por tokens estables. El mismo identificador siempre se corresponde con el mismo seudónimo, por lo que el razonamiento del modelo se mantiene coherente en cada solicitud.
  • El enmascaramiento se aplica a todos los mensajes salientes de todas las funciones de IA; no hay nada que habilitar y no se puede desactivar desde el producto.
  • Solo enmascarado, nunca revelado. El mapeo es unidireccional en el límite de salida: la salida del modelo nunca se reescribe para restablecer los identificadores reales, por lo que la información personal identificable (PII) sin procesar no puede circular a través de una respuesta LLM.

Por qué esto importa hoy. Las indicaciones de IA de Flash se basan en datos agregados y de campañas, en lugar de registros personales. La capa de enmascaramiento es la garantía que se mantiene a medida que las funciones de IA evolucionan, no un parche para una fuga.

Inventario del modelo de caja de cristal

Cada capacidad predictiva o estadística del producto es un modelo clásico y determinista: sin puntuación de caja negra ni muestreo, por lo que los mismos datos siempre producen el mismo modelo. Cada uno lleva una puerta de honestidad explícita: debajo de la puerta no emite nada en lugar de una suposición, y cada puntuación se envía con los números necesarios para volver a calcularla. El inventario actual:

ModeloPotestadesControles de confianza
Levantamiento de dos modelos (dos ajustes logísticos deterministas)SoClaw clasificación de la lista de trabajo de recuperación: valor en riesgo × aumento, entrenado en el propio ECA permanente del programaActiva solo más allá de ≥200 filas tratadas maduras, ≥50 filas reservadas y ≥20 conversiones, con ambos ajustes convergidos; por debajo de eso, la clasificación vuelve al valor en riesgo puro. Los miembros de elevación negativa (no molestar) se hunden; cada tarea almacena su instantánea de puntuación.
Gamma entre compras por miembro (método de momentos)Fecha prevista de la próxima compra en el perfil + condición del segmento "Días hasta la próxima compra prevista" (negativo = vencido)Requiere ≥3 intervalos observados (es decir, ≥4 compras) y un coeficiente de variación (≤1,5) en la regularidad del ritmo: un comprador irregular recibe NULL, nunca una fecha inventada. Una fecha prevista pasada se emite como una señal de retraso real.
Regresión logística regularizada L2 por equipoPropensión a hacer clic (0–100), reajustar cada noche en los últimos 90 días de envíos del equipoEtiqueta de solo clics (nunca se abre; Apple MPP las infla); función de clic previo protegida contra fugas; descenso determinista de gradiente de lote completo en un horario fijo. Puertas de ajuste ≥500 envíos / ≥30 clics / ≥50 miembros; un miembro necesita ≥3 envíos recientes para ser puntuado.
Elemento-kNN normalizado por cosenoEmparejamiento de productos "También comprados" en las superficies de recomendaciónco_count / √(compradores(A) × compradores(B)) corrige el sesgo de popularidad; los pares necesitan ≥2 compradores compartidos para materializarse; el recuento bruto de compras conjuntas se almacena junto con la puntuación como evidencia verificable.
Reglas de asociación (soporte / confianza / impulso)Sugerencias de venta cruzada, extraídas todas las noches de las propias líneas de pedido del comerciante.Una regla requiere al menos 3 pedidos simultáneos y un nivel de confianza de al menos el 5 %; cada regla almacena el recuento de pedidos original, por lo que cualquier cifra se puede recalcular manualmente. El perfil de usuario excluye los productos que ya posee y solo se muestra a los compradores activos.
Valor atípico en estadísticas robustas (mediana / MAD)El behavior_outlier detector de fraude de puntosz robusto ≥ 6 más límites mínimos absolutos (≥10 transacciones de ganancias; equipos con menos de 50 miembros activos omitidos); deduplicación por miembro con cupo mensual; solo congelación: abre una revisión y nunca se anula por sí solo.
Riesgos proporcionales de Kaplan-Meier + Cox (probabilidad parcial de Nelder-Mead)Retención por cohorte de registro mensual + el panel "con qué se correlaciona la retención"Definición impresa en la vista: abandono = 90 días sin compra, excluyendo a quienes nunca compraron, cohortes con menos de 30 miembros ocultas y mostradas. El ajuste de Cox requiere ≥30 eventos de abandono observados y está limitado a 3 covariables; las correlaciones se etiquetan como correlación, no causalidad.
Holt-Winters (estacionalidad semanal, constantes fijas)Las perspectivas de ingresos para los próximos 14 días en el panelConstantes de suavizado fijas: sin superficie de ajuste por equipo; lee la misma métrica de ingresos certificada que todas las demás pantallas; línea discontinua + banda de error con su base en dólares impresa; completamente oculta bajo 4 semanas de historial; etiquetada como una proyección, no como un compromiso.

Ninguno de estos modelos actúa por sí solo: clasifican, puntúan y marcan, y todo lo que mueve dinero o contacta a un miembro pasa por los mecanismos de control mencionados anteriormente.

Para obtener información técnica detallada sobre cada modelo (método, entradas, columnas de salida, criterios de confianza y superficies de consumo), consulte la Referencia de modelos predictivos.