pantallas · fase 2 · v2.0 · septiembre 2026

Grok Bot · el ejecutor de búsqueda

Grok Bot busca. Una persona decide

Grok Bot es el segundo agente de Mogos: cuando Mogui deja creada una búsqueda, el API lo despierta con un webhook y Grok sale a buscar proveedores. Primero entre los que Mogos ya conoce, después en Alibaba, con criterios que el equipo escribe y edita sin deploy. Vuelve con candidatas, evidencia, preguntas y el primer mensaje a la fábrica ya redactado. No cotiza, no le escribe al cliente y no envía nada sin una persona. Esta pieza lo muestra pantalla a pantalla, en el orden en que ocurre.

Qué es
Un agente eve (agents/sourcing) con el modelo Grok de xAI y su búsqueda web · corre en Render, junto al API
Una corrida
Una sesión por búsqueda · dos despertares · 1 h 40 min · USD 0,82 en el ejemplo
Piezas hermanas
storyboard WhatsApp · admin · diseño · instrucciones
Datos
Ficticios · proveedores y precios de ejemplo
Página interna · datos ficticios

Proveedores, precios, MOQ y tiempos son escena de diseño. Lo real es la mecánica: el evento que despierta a Grok, lo que carga, lo que consulta, lo que redacta y cómo devuelve candidatas para que una persona valide.

Qué es

Un agente con oficio de sourcing, hermano de Mogui. Vive en agents/sourcing, corre en Render junto al API y usa el modelo Grok de xAI, que trae búsqueda web con navegación del lado del servidor. Una sesión por búsqueda, con memoria de lo que ya revisó.

Qué recibe

Un sobre firmado por el API: el pedido con las palabras del cliente, especificaciones, foto, la transcripción del audio, las pistas de proveedor que escribió el asesor, la referencia interna de precio y los límites (candidatas, origen, plazo, presupuesto). Nunca el teléfono ni el correo del cliente.

Qué entrega

Tres candidatas por producto con proveedor, precio, MOQ, tiempo, confianza y enlace; los descartes con motivo; dos o tres preguntas para el encargado; un resumen de tres líneas; y el primer mensaje a la candidata top, redactado y sin enviar.

Qué no hace

No cotiza ni marca recomendada. No le escribe al cliente. No envía nada a la fábrica por su cuenta. No mueve estados ni escribe en la base: todo vuelve por una llamada firmada al API, y una persona valida.

La corrida, en ocho pasos

01El despertar
un webhook del API · dos veces, con el mismo sobre

Grok Bot no vive en la conversación de Carlos ni en la de María: es otro agente, con su propia sesión por búsqueda. Lo despierta el API, no Mogui, con un webhook firmado. La primera vez, en cuanto Mogui deja creada la búsqueda y el aviso al cliente salió con el botón de pago: Grok hace la parte que no cuesta, revisar a quién conoce Mogos. La segunda, cuando María paga o la búsqueda se exonera: entonces sale a Alibaba. Es exactamente lo que el aviso le prometió a María: «apenas registremos tu pago, comenzamos».

Grok Bot, en su bitácoraMe despertó el API con COT-20260906-0031: 500 libretas A5 tapa dura con logo, para María F. Empiezo por lo que Mogos ya sabe y sigo en Alibaba con el Computer del bot: el pago de la tarifa es un cobro al cliente, no una compuerta mía.
POST {SOURCING_GROK_BOT_WEBHOOK_URL}bandeja de salida del API · reintenta hasta 202
X-Mogos-Eventsearch.created
X-Mogos-Delivery7d3c9a…
X-Mogos-Signaturet=1757160300,v1=hmac-sha256(secret, t + "." + body)
Idempotency-Keysearch:COT-20260906-0031:created:1
{
  "version": "2026-09-06",
  "event": "search.created",                 · después: search.sourcing_requested al pagar o exonerar
  "search": { "id": "sq_…", "code": "COT-20260906-0031", "status": "NEW",
               "companyCode": "MOGOS_VE", "language": "es",
               "originalRequest": "500 libretas A5 tapa dura, azul marino, logo dorado…" },
  "client": { "id": "usr_…", "displayName": "María F.", "country": "VE" },   · sin teléfono ni correo
  "encargado": { "id": "usr_…", "name": "Jesús Contreras" },
  "requestedProducts": [ { "id": "rp_…", "productName": "Libretas A5 tapa dura con logo",
      "quantity": 500, "isMoq": false, "isCustomized": true, "category": "OFFICE_SUPPLIES",
      "specifications": "azul marino · logo dorado en portada · 120 hojas · papel 80 g",
      "referenceImageUrls": [ "https://s3…/m3.jpg?…" ] } ],
  "hints": {
    "advisorSuppliers": [                       · lo que Carlos escribió al reenviar
      { "name": "Shenzhen Yitai Stationery", "supplierId": "sup_…", "note": "nos vendió libretas en marzo" },
      { "url": "https://www.alibaba.com/product-detail/A5-Hardcover-Notebook-Custom-Logo_1600…" } ],
    "referencePriceUsd": 3.80                   · última cotización interna de este producto
  },
  "constraints": { "maxOptionsPerProduct": 3, "origin": "CN", "currencies": ["USD","CNY"],
                   "deadlineAt": "2026-09-07T12:00:00Z", "budgetUsd": 5 },
  "attachments": [ { "kind": "audio", "transcript": "…tapa dura, azul marino…" } ],
  "callbacks": { "resultUrl": "https://api…/integrations/sourcing/results",
                 "statusUrl": "https://api…/integrations/sourcing/status" }
}

10:14 · search.created api

Mogui acaba de crear la búsqueda y María ya tiene el aviso con el botón de pago. El API escribe el evento en su bandeja de salida y lo entrega firmado. Grok arranca la etapa 1: proveedores de Mogos y pistas del asesor. Sin coste externo.

12:05 · search.sourcing_requested api

Gaby registró el pago de María (Zelle, USD 100) y la búsqueda pasó sola a «En búsqueda». Mismo sobre, misma sesión de Grok: ahora sí, Alibaba. Si Carlos la exonera, el evento sale igual.

Lo que ve el equipo bitácora

En el detalle de la búsqueda: «Evento search.created entregado a Grok Bot · 200 OK» y, a las 12:05, el segundo. En WhatsApp, Mogui le dice a Carlos que arrancó. Si el webhook falla, el API reintenta y lo deja escrito; nadie tiene que mirar un log.

Lo disparaEl API, desde su bandeja de salida: al crearse la búsqueda y al registrarse el pago o la exoneración. Nunca Mogui, nunca una persona a mano.
Grok haceAbre (o retoma) la sesión de esa búsqueda, verifica la firma, lee el sobre y decide la etapa: interna o Alibaba.
El equipo veDos líneas en la bitácora de la búsqueda y un aviso de Mogui en WhatsApp. En «Corridas de Grok», una corrida nueva en curso.

Por qué dos veces y no una: la etapa interna no cuesta nada y deja un pre-informe listo antes de que el cliente pague; la búsqueda en Alibaba cuesta créditos y tiempo, y arranca cuando el pago lo justifica. Un solo sobre, con event distinto y la misma clave de idempotencia por etapa.

02La carga: instrucciones y skill vivo
repo · supabase · al arrancar la sesión

Antes de leer el pedido, Grok carga con qué criterio va a trabajar. Lo estable viene del repositorio: quién es y cómo se busca. Lo que cambia cada semana viene de una tabla de Supabase que el equipo edita desde el admin: con quién trabajar, a qué precio, qué evitar. Grok toma la versión publicada al arrancar la sesión, y esa versión queda escrita en la corrida.

Grok Bot, en su bitácoraCargué el skill vivo v12, publicado por Pedro hoy a las 09:40: Yitai y Jinhao de confianza, Dongguan Lux vetado, MOQ máximo 1.000 en papelería, referencia USD 3,80 para libretas A5. Con eso leo el pedido.

Instrucciones fijas repo

Quién es, para quién trabaja, qué no hace nunca: no cotiza, no escribe al cliente, no inventa precios. Corto y estable; cambia con un deploy porque casi nunca cambia.

Skill base · «Sourcing en Alibaba» repo

El oficio: cómo formular las consultas, qué filtros aplicar (MOQ, Trade Assurance, años), cómo leer una ficha, cómo citar evidencia, cómo descartar. Se carga a demanda con load_skill.

Skill vivo · «Proveedores y criterios de Mogos» supabase · v12

Lo que sabe el equipo y cambia cada semana: proveedores de confianza y vetados, precios de referencia, MOQ máximos por rubro, cómo escribirle a una fábrica. Se edita en el admin y Grok lo carga al arrancar cada sesión, con su versión.

El briefing de esta búsqueda api instrucción de usuario

El sobre de la izquierda, convertido en la orden de trabajo de abajo. Entra a la sesión como contexto durable (rol usuario), así que sobrevive a compactaciones y a reintentos.

Lo disparaEl arranque de la sesión (session.started), en cada despertar. Si Supabase no responde, usa la última versión conocida y lo deja escrito.
Grok haceCarga instrucciones fijas y skills base del repo, el skill vivo publicado desde Supabase, y el briefing como contexto durable.
El equipo veEn la corrida: «skill vivo v12 · Pedro · 09:40». En el admin, el editor de instrucciones con la lista, el borrador y el historial (pantalla 09).

La partición: el oficio (cómo se busca) en el repo, porque cambia poco y se revisa por PR; el conocimiento del equipo (con quién, a qué precio, qué evitar) en Supabase, porque cambia cada semana y lo edita quien lo sabe. Es la misma disciplina que el diseño «Mogui sobre eve» fijó para el bot de clientes.

03El briefing: lo que recibió
la orden de trabajo · sin datos de contacto

El sobre del webhook se convierte en una orden de trabajo que Grok lee como contexto durable de la sesión: sobrevive a compactaciones y a reintentos. Trae las palabras del cliente, no un resumen; la foto; lo que dijo por audio; las dos pistas que Carlos escribió al reenviar; la referencia interna de precio; y los límites. Lo que no trae, a propósito: el teléfono, el correo o la cédula de María.

Grok Bot, en su bitácoraTengo el pedido con las palabras de María, la foto, lo que dijo por audio, dos pistas de Carlos y una referencia interna de USD 3,80. No tengo su teléfono ni su correo, y no los necesito.
Lo disparaEl API, al armar el sobre: toma la búsqueda recién creada, sus productos, los adjuntos anclados por Mogui y las pistas del asesor.
Grok haceConvierte el sobre en orden de trabajo y fija qué devolver: 3 candidatas por producto, origen China, USD o CNY, antes del plazo, dentro del presupuesto.
El equipo veEl mismo briefing, en el detalle de la búsqueda, bajo «Lo que Grok recibió»: quien valide sabe exactamente con qué contexto se buscó.

Sin datos de contacto, por diseño. El modelo de xAI recibe «María F.» y el país. Todo lo demás se queda en la plataforma. Si Grok necesita preguntarle algo al cliente, lo deja como pregunta para el encargado.

04Los proveedores de Mogos
con o sin pistas del asesor · directorio · historial

Antes de abrir Alibaba, Grok pregunta lo que Pedro y Jesús se preguntan por WhatsApp: ¿quién nos ha vendido esto?. El directorio de proveedores ya tiene rubro, plataforma, contacto y métricas de uso; el catálogo de buscados guarda el historial de precios por producto. Grok cruza las dos cosas con lo que dijo el asesor y emite un veredicto por proveedor, con motivo.

Grok Bot, en su bitácoraYitai nos vendió esto en marzo a USD 3,80 y Carlos la sugirió: sirve. Meixin hace imprenta con logo, no tapa dura: consultar. Yiwu Todo no es del rubro: descartado, con motivo. Referencia para Alibaba: USD 3,80.
Sin pistas del asesor, el paso es el mismo. Si Carlos reenvía sin sugerir a nadie, Grok igual cruza el directorio con el historial del producto y propone a quien ya nos vendió algo parecido. Las pistas suben la prioridad de un proveedor; no las necesita para empezar.
Lo disparaLa etapa 1, al crearse la búsqueda. Sin coste externo: son dos endpoints internos y el skill vivo.
Grok haceBusca en el directorio por rubro y nombre, lee el historial de precios del producto, resuelve las pistas del asesor contra el directorio y escribe un veredicto por proveedor.
El equipo veLa corrida en curso con la tabla de veredictos y el precio de referencia. Nada llega todavía al centro de acciones.

Lo que ya existe: GET /suppliers con búsqueda por nombre, rubro y plataforma y métricas de uso (conteos y fechas, nunca dólares); GET /sourced-products/:id/history con el costo por proveedor y fecha. Lo nuevo: que un agente los consulte con un token de servicio y que el veredicto quede escrito en la corrida.

05Alibaba
consultas · filtros · candidatas y descartes con motivo

Alibaba no ofrece una API pública de búsqueda para compradores; lo que sí existe es la búsqueda web con navegación del lado del servidor de xAI, acotada a un dominio, y proveedores de resultados estructurados como respaldo. Grok formula consultas en inglés, aplica los filtros del skill (MOQ, Trade Assurance, años, valoración), lee las fichas que pasan el corte y escribe por qué descarta cada una. La evidencia son enlaces, no recuerdos.

Grok Bot, en su bitácoraTres consultas en inglés, 60 fichas, 5 pasan el corte. Descarté 57 por MOQ, tapa blanda o precio fuera de rango; cada descarte lleva su motivo y su enlace. El enlace que mandó Carlos era bueno: Yiwu Jinhao, candidata.
Lo disparaLa etapa 2, cuando el API registra el pago o la exoneración y la búsqueda pasa a «En búsqueda».
Grok haceFormula consultas con el skill base, aplica los filtros (MOQ, Trade Assurance, años, valoración), lee las fichas que pasan el corte y escribe por qué descarta cada una. Con tope de gasto y de tiempo.
El equipo veLa corrida en curso: consultas, filtros, fichas con veredicto y lo gastado contra el límite. Si pasa del presupuesto o del plazo, el API la cierra y lo dice.

La regla que manda: un resultado sin enlace no existe, y un descarte sin motivo tampoco. El skill base dice cómo formular y filtrar; el skill vivo dice qué precio de referencia y qué MOQ máximo usar; el briefing dice qué pidió el cliente. Grok combina los tres y escribe.

06El primer contacto
grok redacta · una persona aprueba y envía

Carlos preguntó si Grok Bot puede iniciar el contacto con la candidata más importante. Redactarlo, sí, y lo hace al cerrar la corrida: un mensaje con el brief, la cantidad, la pregunta por el MOQ y los tramos de precio, el logo, la muestra y el puerto, sin datos de la clienta y sin promesas. Enviarlo, todavía no: el encargado lo aprueba después de validar la candidata y lo manda por el canal de ese proveedor. La respuesta vuelve a la búsqueda y Grok la convierte en una opción con precio.

Grok Bot, en su bitácoraDejé escrito el mensaje para Yitai: brief, MOQ, tramos de precio, logo, muestra, FOB Shenzhen. Sin el nombre de María y sin promesas. Sale cuando Jesús lo apruebe; yo no lo envío.
Lo disparaEl cierre de la corrida: Grok redacta para la candidata con mayor confianza y lo entrega junto con el informe. El envío lo dispara una persona, después de validar.
Grok haceEscribe el mensaje con el brief y la lista de lo que deja fuera a propósito. Cuando llega la respuesta, la convierte en una opción con precio, que sigue siendo candidata.
El equipo veEl panel de contacto en el detalle: el mensaje, el canal sugerido, «Aprobar y copiar», y el rastro (redactado, aprobado, enviado, respondió).

Antes o después de validar: Grok redacta antes, con el contexto fresco; la persona envía después de validar. Validar y enviar caben en un gesto, pero el orden no se invierte: nunca sale un mensaje a una candidata que nadie validó. Autonomía solo en fase 3, para proveedores de confianza, por correo y con tope diario.

07El informe y la tarea
candidatas · «validar candidatas» · nota · avisos

Grok cierra su turno con una llamada al API: submit_candidates. El API valida, guarda las candidatas con su origen y crea la tarea en la plataforma: una acción «Validar candidatas» para Jesús en el centro de acciones, una nota interna con el informe completo en la búsqueda, una notificación, y el aviso a Carlos por Mogui. Nada cambia de estado hasta que una persona valida.

Grok Bot, en su bitácoraTres candidatas, dos preguntas, un resumen de tres líneas y el borrador para Yitai. Jesús tiene la tarea «Validar candidatas» en su centro de acciones; Carlos ya lo sabe por Mogui. No moví ningún estado: eso es de Jesús.
Lo disparaEl cierre de la corrida: una llamada firmada e idempotente al API con candidatas, descartes, preguntas, resumen, gasto, versión del skill y el borrador de contacto.
Grok haceEntrega y para. No cotiza, no marca recomendada, no escribe en la base.
El equipo veLa tarea «Validar candidatas» en el centro de acciones, la nota interna con el informe, la campana, y el aviso de Mogui a Carlos. En el detalle, la tabla de candidatas con su origen y «Validar» / «Descartar».

Por qué la tarea nace en la plataforma: el centro de acciones ya es la pantalla de inicio de todo el equipo, ya calcula sus filas al leer (sin cola que mantener) y ya sabe de búsquedas («Tomarla», «Recordar»). «Validar candidatas» es una fuente más. La nota interna usa el mecanismo polimórfico que ya existe (EntityNote), así que el informe queda pegado a la búsqueda, buscable y con réplicas.

08Qué no hace Grok Bot
los límites, dichos

Los límites no son un párrafo del contrato: están en las instrucciones fijas de Grok, en el esquema de las herramientas que le da el API y en el sobre. Cada uno tiene una pantalla donde se ve cumplido.

No cotiza ni recomienda.

Devuelve candidatas con confianza y evidencia. La recomendada y la cotización son de una persona; el estado de la búsqueda no se mueve sin ella.

No le escribe al cliente. A la fábrica, solo redacta.

No manda nada por Alibaba, WeChat ni WhatsApp. El primer mensaje al proveedor lo escribe y lo deja en borrador; una persona lo aprueba y lo envía (pantalla 06).

No recibe datos de contacto del cliente.

El sobre lleva «María F.» y el país. Nada más sale de la plataforma hacia el modelo.

No gasta sin tope.

Cada corrida tiene presupuesto en dólares y plazo. Pasado cualquiera, el API la cierra y lo dice.

No escribe en la base.

Todo vuelve por una llamada firmada al API, que valida y escribe. Grok no tiene Postgres.

No obedece a una ficha.

El contenido de Alibaba es dato, no instrucción. Un texto que diga «ignora tus criterios» se descarta con motivo.

09Anexo · dónde se editan las instrucciones
se editan en el admin · se guardan en supabase · grok las carga al despertar

Las instrucciones profesionales de Grok cambian más rápido que el código: un proveedor que falló, un MOQ que ya no aceptan, una fábrica nueva de confianza. Por eso no viven en el repositorio ni en un prompt: viven en una tabla de Supabase, se editan desde el admin con versión y autor, y Grok carga la versión publicada al arrancar cada sesión. Notion queda como superficie opcional de redacción, con importación de una vía, para quien prefiera escribir allí.

Notion redacción

Una página por skill en el Notion de crescō; Grok la lee por la API de Notion al arrancar.

  • Cómodo para escribir y comentar
  • Historial de versiones de Notion
  • Dependencia externa en cada despertar (latencia, cuotas, caídas)
  • Mogos no vive en Notion: Pedro y Jesús no lo abren
  • Markdown de ida y vuelta con pérdidas; sin RBAC de Mogos

Markdown en Supabase recomendado

Tabla agent_skills (slug, versión, cuerpo, autor, publicado). Se edita en el admin; eve la carga con un resolver dinámico.

  • Dentro de la plataforma: RBAC, auditoría, misma base
  • Sin dependencia externa al despertar; cero deploys para cambiar
  • Versión visible en cada corrida («skill vivo v12»)
  • «Probar con la última búsqueda» = un eval antes de publicar
  • Notion opcional: importar de una vía al guardar

Repositorio código

Archivos SKILL.md en agents/sourcing, con PR y deploy.

  • Revisión por PR; evals en CI
  • Ideal para el oficio estable (el skill base)
  • Un deploy para cambiar un MOQ: lo mismo que el diseño de Mogui vino a matar
  • Solo desarrolladores editan

La partición: el skill base (cómo se busca) en el repo, porque es oficio y cambia poco; el skill vivo (con quién, a qué precio, qué evitar) en Supabase, porque es conocimiento del equipo y cambia cada semana; Notion como bloc opcional para redactar. Es la misma disciplina que el diseño «Mogui sobre eve» fijó para el conocimiento del bot: el conocimiento no es un prompt ni un deploy.

La partición: el skill base (cómo se busca) en el repo, porque es oficio y cambia poco; el skill vivo (con quién, a qué precio, qué evitar) en Supabase, porque es conocimiento del equipo y cambia cada semana; Notion como bloc opcional para redactar. Es la misma disciplina que el diseño «Mogui sobre eve» fijó para el conocimiento del bot: el conocimiento no es un prompt ni un deploy.

Buscar es ir estructurando

De un reenvío a tres candidatas con evidencia, y la decisión donde siempre estuvo

Lo que hace Grok

Lee lo que Mogos ya sabe, sigue las pistas del asesor, sale a Alibaba con criterios escritos por el equipo y vuelve con candidatas, descartes y preguntas.

Lo que hace la plataforma

Lo despierta, le pasa el briefing, valida lo que devuelve, crea la tarea y avisa. Es la única que escribe.

Lo que decide Carlos

Cuándo despertar a Grok, cómo entra a Alibaba, dónde viven las instrucciones, si Grok redacta el primer contacto y por qué canal sale. Filas 13 a 22 de la sección J de DISENO-MOGUI-FLUJO.md.