Guía de desarrollador · prospection-agent

prospection-agent: guía técnica

Cómo está construido el agente de prospección de empresas, qué hace cada habilidad, qué formatos entrega y cómo se mantiene.

3 nov 2026Guía de desarrolladorPerplexity16 min de lectura

Descripción general

Radar de Campus (prospection-agent) es el agente de prospección de empresas de Campuslands. Dado un criterio de búsqueda (sector, ciudad, tamaño…), recorre la web abierta, filtra las empresas que encajan con el perfil de cliente de Full Service, completa cada una con datos públicos verificables y entrega un listado en tabla y en CSV.

Esta guía explica cómo funciona por dentro: los archivos que lo gobiernan, el ciclo de trabajo en tres fases, las cuatro habilidades que lo componen, los formatos de entrada y salida, las reglas que no se negocian y cómo modificarlo sin romperlo. Está pensada para quien mantiene el agente. Si solo necesitas usarlo, la guía de usuario es más corta y no requiere conocimientos técnicos.

Qué hace y qué no hace

El agente cubre un hueco concreto del pipeline: el descubrimiento de cuentas fuera de LinkedIn. Todo lo que tenga que ver con personas, mensajes o LinkedIn pertenece a otro agente, Explorador de Campus (intelligence-commercial/). Mantener esa frontera limpia es una decisión fundacional: evita trabajo duplicado y protege la cuenta de LinkedIn del usuario.

Si el usuario pide «busca contactos», «escribe un mensaje» o «conéctate en LinkedIn» mientras está en este agente, la instrucción de Perplexity.md es señalar que ese trabajo corresponde a Explorador de Campus y ofrecer pasarle el listado ya generado.

Cómo corre: Perplexity y Perplexity.md

A diferencia de los otros agentes del repositorio, que corren en Claude Code y se gobiernan con un CLAUDE.md, Radar de Campus está pensado para ejecutarse como agente o Space en Perplexity. Su archivo de configuración se llama Perplexity.md y cumple exactamente el mismo rol que un CLAUDE.md: son las instrucciones que el agente lee al iniciar cada sesión y que se co-evolucionan con el usuario.

Perplexity.md contiene, en este orden:

1. Identidad: nombre (Radar de Campus), rol (prospección B2B a nivel empresa) y relación con los demás agentes.
2. Misión: pedir el formulario de 6 datos y entregar un listado enriquecido.
3. Decisiones fundacionales: una tabla con cada decisión y su porqué (se resume más abajo).
4. Deslinde con Explorador de Campus.
5. Estructura del CSV interno y de la tabla entregada.
6. Flujo de trabajo en tres fases.
7. Convenciones de mantenimiento y de la bitácora.

Estructura del repositorio

prospection-agent/
  Perplexity.md                   # identidad, decisiones, fases y formatos
  habilidades/                    # una carpeta por skill, cada una con su SKILL.md
    formulario-intake/
    busqueda-web-empresas/
    enriquecimiento-datos-empresa/
    generacion-listado-resultados/
  prospeccion/                    # un lote por búsqueda
    <slug-lote>/
      01-empresas-encontradas.csv  # resultado del lote (con columna Fuente)
  wiki/
    index.md                      # catálogo de la wiki
    log.md                        # bitácora cronológica (solo se añade)
    perfil-usuario.md             # quién es el usuario y el perfil de empresa objetivo (ICP)
    formulario-intake.md          # los 6 campos y su regla de obligatoriedad
    enlaces-utiles.md             # fuentes y directorios de partida

Hay tres convenciones que conviene tener presentes:

• Los recursos son de solo lectura. Las fuentes de marca (logos, brandbook, brief) están en resources/campuslands-resources/ y el agente las lee, nunca las edita.
• Un lote es una carpeta. Cada búsqueda guarda su CSV en prospeccion/<slug-lote>/, de modo que lotes de criterios distintos nunca se mezclan ni se pisan.
• El slug describe el criterio real. Por ejemplo constructoras-bogota-2026-07-23: debe poder identificarse meses después sin abrir el archivo.

El ciclo de trabajo

Cada búsqueda recorre tres fases. El ciclo se reinicia en la fase 1 con cada búsqueda nueva, incluso dentro de la misma conversación.

1. IntakeSkill formulario-intake. Pide o confirma los 6 datos y fija el criterio.
2. BúsquedaSkill busqueda-web-empresas. Construye consultas y reúne candidatas con fuente.
3. EnriquecimientoSkill enriquecimiento-datos-empresa. Completa cada ficha con cifras citables.
4. EntregaSkill generacion-listado-resultados. Tabla de 6 columnas, fuentes y CSV.

Fase 1 · Intake

Antes de ejecutar una sola consulta, el agente pide los seis datos del formulario (ver la sección «El formulario de entrada») y confirma el criterio completo con el usuario. Ninguna búsqueda corre sin haber pasado por esta fase al menos una vez en la conversación, aunque sea solo para confirmar datos que el usuario ya dio en su primer mensaje.

Fase 2 · Búsqueda y enriquecimiento

Es el trabajo pesado, y se divide en dos habilidades:

1. busqueda-web-empresas arma las consultas combinando sector y ubicación como base, y aplica tamaño, empleados y facturación como filtros adicionales. Recorre fuentes de la web abierta, registra por cada candidata su razón social, sitio web y la fuente donde apareció, descarta duplicados y aplica las exclusiones del ICP. Sigue hasta acercarse al número de empresas pedido o hasta agotar razonablemente las fuentes.
2. enriquecimiento-datos-empresa toma cada candidata y completa ubicación, número de empleados, facturación anual y utilidad neta, anotando la fuente y la fecha de consulta de cada dato.

El resultado se guarda en prospeccion/<slug-lote>/01-empresas-encontradas.csv.

Fase 3 · Entrega

generacion-listado-resultados consolida las fichas en una tabla de exactamente seis columnas, antepone un resumen (criterios usados, empresas encontradas frente a las solicitadas, fecha de ejecución) y añade al pie una sección de fuentes. Termina preguntando al usuario si quiere ampliar la búsqueda, repetirla con otros criterios o pasar el listado a Explorador de Campus.

Las cuatro habilidades

Cada habilidad es un SKILL.md con la misma anatomía: cuándo usarla, entradas, procedimiento, reglas obligatorias y salida. Se encadenan en orden: la salida de una es la entrada de la siguiente.

Detalles que no son obvios

formulario-intake. Si el usuario ya dio un dato claro, no se repite la pregunta: solo se confirma el resumen mapeado. Un «no sé», «cualquiera» o un campo sin respuesta tras preguntarlo una vez se marca como sin restricción y no se insiste. Si falta el número de empresas, se usa 10 por defecto y se avisa antes de buscar. Si tamaño y número de empleados son contradictorios (por ejemplo «Grande» con «+10 empleados»), el agente pregunta cuál priorizar en vez de asumir.

busqueda-web-empresas. Descarta de inmediato cualquier resultado que provenga de LinkedIn y busca la misma información en otra fuente. Cada candidata necesita al menos una fuente verificable antes de pasar al enriquecimiento. Si la búsqueda no alcanza el número solicitado, lo dice explícitamente en lugar de rellenar con empresas que no calzan.

enriquecimiento-datos-empresa. Prioriza el RUES o la Cámara de Comercio sobre el nombre comercial para fijar la razón social legal. La fuente primaria de facturación y utilidad es la Superintendencia de Sociedades (SIREM) y se anota el año fiscal de la cifra, que puede no ser el año en curso. Si el dato real contradice el criterio del formulario, la empresa se descarta en vez de listarla igual.

generacion-listado-resultados. La columna Fecha es la fecha de ejecución de la búsqueda, no la del dato financiero; esa distinción vive en la fuente interna. Los campos no encontrados van vacíos, nunca con «N/A» como si fuera un dato confirmado.

El formulario de entrada

El formulario es fijo y se pide siempre en este orden:

Obligatoriedad flexible

Se preguntan siempre los seis campos, pero ningún dato faltante bloquea la búsqueda. El único que conviene confirmar es el número de empresas, porque define el punto de parada. Esta decisión nace de que no todos los datos están disponibles desde el inicio y no se quiere frenar el flujo por eso.

Mapeo directo

Cuando el mensaje inicial ya trae todo, el agente no repite el formulario: confirma el resumen mapeado y avanza.

Perplexityprospection-agent

Necesito empresas constructoras en Bogotá, medianas, con más de 100 empleados y facturación de $5.000.000.000 o más. Dame 15.

Perplexity

Entendido. Busco 15 empresas con este criterio: sector Construcción, ubicación Bogotá, tamaño Mediana, +100 empleados, facturación $5.000.000.000 o más. ¿Confirmas?

Pregunta lo que quieras…

Formatos de salida

CSV interno

prospeccion/<slug-lote>/01-empresas-encontradas.csv guarda el lote completo, con una columna extra de trazabilidad:

Fecha, Razón Social, Ubicación, Número de Empleados, Facturación Anual, Utilidad Neta, Fuente

Tabla entregada al usuario

Tiene exactamente seis columnas, en este orden, y no se le agregan otras aunque se hayan usado como criterio de búsqueda (sector o sitio web viven solo en el resumen inicial).

La fuente de cada fila no va en la tabla: se publica debajo, en una sección «Fuentes» numerada o por empresa, para mantener trazabilidad sin ensuciar las seis columnas principales.

Qué antecede a la tabla

Un resumen breve con tres datos: los criterios del formulario que se usaron, cuántas empresas se encontraron frente a las solicitadas y la fecha real de ejecución.

Fuentes de datos

wiki/enlaces-utiles.md es un punto de partida, no una lista cerrada: el agente puede y debe encontrar fuentes adicionales relevantes al criterio. Antes de usar cualquier enlace conviene verificar que siga activo, porque directorios y gremios cambian de dominio.

Las cifras de SIREM suelen corresponder al último año fiscal reportado. Se anota el año del estado financiero como parte de la fuente. Si la empresa no reporta a Supersociedades o la cifra no es pública, facturación y utilidad quedan vacías: nunca se estiman.

El perfil de empresa objetivo (ICP)

wiki/perfil-usuario.md define qué empresa vale la pena listar. Es la referencia por defecto cuando el usuario deja un campo «sin restricción».

• Sector: desarrollo de software, servicios o consultoría IT, tecnología, información e internet y, en general, cualquier empresa que necesite equipo técnico propio (fintech, healthtech, e-commerce, SaaS).
• Tamaño: preferentemente 50–500 empleados, con esta segmentación: pequeña (50–100), mediana (101–250), grande (251–500). Por debajo de 50 suele faltar presupuesto o estructura recurrente para staffing.
• Tipo: empresa privada.
• Señales de calificación (mientras más, mejor prospecto): crecimiento de plantilla, vacantes abiertas para desarrolladores, ronda de inversión reciente, noticias de expansión o transformación digital.

Exclusiones estrictas: gobierno, ONGs, colegios y universidades, y agencias de staffing o reclutamiento (competencia directa de Campuslands). Solo se levantan si el usuario lo indica de forma explícita.

Reglas duras

Cómo se verifica un lote

No hay un script automático: la verificación es una lista que el agente aplica en cada entrega.

• Cantidad. El resumen inicial dice cuántas empresas se encontraron frente a las solicitadas.
• Trazabilidad. Cada cifra tiene fuente y fecha en el CSV. Sin fuente, no hay dato.
• Encaje con el criterio. Sector, ciudad, tamaño y exclusiones coinciden con el formulario confirmado.
• Contradicciones resueltas. Si tamaño y empleados chocan, se preguntó cuál priorizar.
• Formato. Exactamente seis columnas y la fecha en YYYY-MM-DD.
• Sin duplicados. Una empresa aparece una sola vez por lote, deduplicada por dominio o razón social normalizada.
• Sin LinkedIn. Ninguna fila ni fuente proviene de allí.

Comandos «!»

Los comandos son órdenes cortas del usuario (!optimize, !notime…) que el agente debe ejecutar de forma obligatoria, siempre dentro de sus reglas duras. Hay un solo catálogo para todos los agentes y de él salen las instrucciones de cada uno, las bitácoras y las tablas de las guías.

Dónde vive cada cosa

La regla común

1. Un comando es una palabra precedida de ! al inicio de un mensaje o de una línea; el texto que sigue es su objeto.
2. Es obligatorio: el agente no pide permiso ni lo reinterpreta. Solo lo limita una regla dura (veracidad, marca, confidencialidad, puertas de aprobación y de verificación); entonces hace lo que la regla permite y dice qué no pudo.
3. Se combinan. Si dos modos chocan, el orden es: reglas duras > !strict-mode y !no-assumptions > !think-deep, !critical-mode y !double-check > !notime.
4. Rige la tarea en curso, no las siguientes.
5. La primera línea de la respuesta nombra los comandos recibidos.
6. Un comando desconocido no se adivina: se propone el más parecido y se pregunta. !help lista los disponibles.
7. Si un comando cambió un entregable o la wiki, se anota en wiki/log.md.

Cómo añadir o cambiar un comando

1. Edita CMDS (definición), AGENTES (a quién aplica y su nota) o ALIAS en resources/comandos/comandos.py.
2. Corre python -X utf8 resources/comandos/comandos.py: reescribe la sección de cada agente, el catálogo y, la primera vez, añade la entrada a su bitácora.
3. Recompila las guías (python guides/_src/build.py).
4. python resources/comandos/comandos.py --verificar falla si algo quedó desfasado.

Comandos de este agente

General

Modos

Técnico y seguridad

UX/UI y diseño

Gestión de proyecto

Mantenimiento y cambios

La wiki

La wiki es el conocimiento que el agente acumula. index.md es el catálogo y log.md la bitácora, que solo se añade, nunca se reescribe. Cada entrada empieza con un prefijo consistente para que se pueda buscar:

## [YYYY-MM-DD] <tipo> | <descripción>

Los tipos válidos son setup, busqueda, enriquecimiento, entrega y lint.

Lint periódico

De vez en cuando conviene revisar: campos del formulario desactualizados frente al ICP vigente, enlaces rotos o gremios que ya no existen en enlaces-utiles.md, y páginas huérfanas de la wiki.

Si quieres cambiar algo, toca esto

Problemas frecuentes

Relación con el resto del pipeline

Radar de Campus es el primer eslabón. Su listado alimenta a Explorador de Campus, que enriquece, clasifica y contacta a las personas de cada empresa. El ICP es el mismo en ambos agentes; lo que cambia es el nivel: aquí se califica la empresa, allá la persona dentro de la empresa ya calificada.

1. Radar de CampusDescubre y enriquece empresas en la web abierta
2. Explorador de CampusEncuentra contactos y envía conexiones en LinkedIn
3. Estudio de PresentacionesPrepara la presentación comercial al contacto interesado

Referencia rápida de archivos