Memoria de prospectos para agentes de IA

Los agentes conectados al servidor MCP de Kit pueden guardar la investigación sobre una empresa y leerla en tareas posteriores, en vez de repetir las mismas búsquedas.

Qué almacena

Hay una memoria por dominio de empresa y cuenta. [email protected], https://www.acme.dev/careers y acme.dev se resuelven todos como acme.dev.

Cada nota incluye:

• Un cuerpo en Markdown cifrado en reposo
• Una o varias URL de origen
• observed_at: la fecha en la que el dato era cierto
• Un título breve opcional, también cifrado, por ejemplo Funding o Hiring signals
• La atribución al miembro y, si llegó por MCP, al cliente OAuth

Kit envía el título y el cuerpo de cada nota (hasta los primeros 6 KB) a gemini-embedding-001 de Google, que devuelve el vector utilizado para detectar solapamientos y ordenar los recuerdos. Esto ocurre en todas las cuentas, con independencia del proveedor de IA configurado.

La memoria abarca toda la cuenta, no una campaña. Si te diriges a la misma empresa en tres campañas, existe un expediente, no tres. Una nota guardada durante una campaña de contratación sigue disponible cuando una campaña comercial llega al mismo dominio seis semanas después.

Las notas observadas hace más de 30 días se marcan como stale. La consulta también devuelve un stale para todo el expediente: es verdadero si la nota más reciente supera los 30 días y también cuando no hay nada guardado. Que esté obsoleto significa que debes volver a comprobar el dato antes de utilizarlo en un borrador, no que debas descartar el expediente.

El ciclo

Hay cuatro herramientas. Encontrarás todos sus parámetros y respuestas en la Referencia de herramientas MCP.

1. outreach_recall_prospect_context: primera llamada de cada ejecución, antes de buscar en la web. Devuelve las notas guardadas y la relación de la cuenta con la empresa: campañas donde aparece el prospecto, mensajes enviados, última respuesta y sentimiento, y si la dirección o el dominio están en la lista de supresión.
2. outreach_save_prospect_research: una llamada por hallazgo distinto, no por ejecución. Exige al menos una URL de origen y rechaza cualquier nota sin ella.
3. Lee data.overlap en la respuesta de guardado. Identifica notas similares y fuentes compartidas para ese dominio.
4. outreach_compact_prospect_context: fusiona las notas en un expediente. Solo cuando tú lo pidas.

outreach_get_writing_guide devuelve la guía de estilo sin basura de IA de Kit para en, de, fr, es o pl. Los agentes deben leerla antes de redactar, no después.

Cada consulta devuelve dos condiciones de parada: relationship.suppressed es verdadero o relationship.last_reply.sentiment vale negative o bounce. En cualquiera de los dos casos, no añadas al prospecto ni prepares un borrador.

Prompt para una tarea programada

Pega este texto en una tarea programada de Claude Cowork y sustituye <CAMPAIGN NAME> por tu campaña. Se incorpora al contexto del agente en cada ejecución, por eso funciona mejor que esperar que el agente recuerde el ciclo.

Run today's outreach research pass for the <CAMPAIGN NAME> campaign.

For every company on the list, in this order:

1. Call outreach_recall_prospect_context with the company domain FIRST, before any
   web search. Read data.known, data.stale, and data.relationship.
2. If data.relationship.suppressed is true, or data.relationship.last_reply.sentiment
   is "negative" or "bounce": skip the company entirely. Do not add a prospect, do not
   draft. Add it to a "skipped" list in your summary with the reason.
3. If data.known is true and data.stale is false, reuse the stored notes. Only search
   for facts that are genuinely missing from the dossier.
4. If data.stale is true, verify the stale facts against current primary sources.
5. After research, call outreach_save_prospect_research once per distinct finding,
   each with source_urls and observed_at. Do not bundle unrelated facts into one note.
6. Read data.overlap in every save response. Do not ignore it.
7. Before drafting, call outreach_get_writing_guide for the campaign locale and obey it.
8. Draft only. Do not approve or send messages.

Do NOT call outreach_compact_prospect_context. If data.compaction_suggested is true
for a company, list that company under "compaction suggested" in your summary and
stop there.

Finish with a summary containing four lists: researched, reused-from-memory, skipped
(with reasons), and compaction suggested.

La cifra que debes vigilar en ese resumen es reused-from-memory. Si una ejecución lo ha vuelto a investigar todo, comprueba si consultó la memoria y si los datos guardados estaban actualizados.

Qué se le indica al agente sobre los solapamientos

Cada respuesta de guardado contiene tres grupos. Las notas se comparan mediante la distancia coseno entre sus embeddings.

Grupo	Activador	Qué debe hacer el agente
near_duplicates	distancia ≤ 0,10: la nota casi repite otra. Se devuelve el cuerpo completo de la nota existente.	Comparar ambas. Si la nueva no aporta nada, eliminarla y conservar la anterior. Si actualiza el dato, marcarla para compactación.
overlaps	0,10 < distancia ≤ 0,30: un tema similar, con detalle posiblemente distinto. Se devuelve un extracto de 300 caracteres.	Conservar ambas y anotarlo para la próxima compactación.
shared_sources	Una nota guardada ya cita una de las nuevas URL de origen.	Comprobar si el agente volvió a visitar la página y si contenía información nueva.

Si los tres están vacíos, no se ha detectado similitud ni fuente compartida. Eso no demuestra que el contenido sea nuevo: la comparación semántica omite las notas sin embeddings.

Por separado, data.compaction_suggested pasa a verdadero cuando un dominio supera las 8 notas. Aparece tanto al consultar como al guardar. Es un aviso, no una instrucción: se pide a los agentes que lo comuniquen y te dejen decidir la fusión.

La consulta añade overlap_pairs: pares de notas guardadas cuya distancia coseno ya es igual o inferior a 0,30, calculados entre las 20 notas más recientes. Esa es la lista de partida para solicitar una compactación.

Compactación

outreach_compact_prospect_context escribe un expediente fusionado y sustituye las notas incluidas. La nota superviviente hereda todas las URL de origen y el observed_at más antiguo de sus fuentes.

Las notas sustituidas se archivan, no se eliminan. Conservan un enlace a la nota que las reemplazó, así que una fusión incorrecta se puede recuperar.

La herramienta recibe expected_note_count, el note_count de la consulta en que se basó la fusión. Si alguien guarda una nota mientras tanto, la cifra deja de coincidir y la operación se cancela para no tragársela.

Límites

Límite	Valor
Cuerpo de la nota	10 KB. Si es mayor, se rechaza.
Título de la nota	Se reduce a una línea y se recorta a 120 caracteres.
URL de origen	Entre una y 20. Cada una debe ser una cadena http o https de menos de 2 KB.
observed_at	La herramienta de guardado lo exige y nunca asigna un valor predeterminado. Indica cuándo era cierto el dato, porque eso es lo que mide la antigüedad.
Notas guardadas al día	200 por cuenta. A partir de ahí, la herramienta devuelve un error hasta el día siguiente.
Notas por dominio	50. Al superar el límite se rechaza el guardado; la compactación sigue disponible para volver a quedar por debajo.
Se considera obsoleta después de	30 días
Se sugiere compactar después de	Más de 8 notas en un dominio
Carga de la consulta	100 KB. Por encima, las notas se ordenan por similitud semántica en vez de devolverse completas y truncated vale verdadero.

La consulta necesita el ámbito outreach_read. Guardar y compactar necesitan outreach_write y ser administrador del módulo Outreach. Todo requiere el complemento Outreach y una suscripción activa.

Dónde aparecen las notas en Kit

La página del prospecto muestra las tres notas más recientes de la empresa por fecha de observación, con un enlace Ver todas a la lista completa.

La lista permite leer y eliminar. Al eliminar una nota desaparece del expediente y de todas las consultas futuras. No se puede escribir ni editar una nota desde el navegador: las herramientas son el único canal de escritura.

Lo que no es

• No es un CRM. Guarda investigación sobre una empresa, no contactos, acuerdos ni un pipeline.
• No es memoria general del agente. La clave es el dominio de la empresa y solo se puede consultar mediante las cuatro herramientas de Outreach. No recuerda tareas, estado ni conversaciones.
• No es un canal de envío. Guardar investigación no añade un prospecto, no redacta y no envía nada.
• No es un sustituto de las fuentes. Cada nota conserva sus URL precisamente para que puedas volver a comprobarla.

Y ahora qué

• Referencia de herramientas MCP: parámetros y datos devueltos por las cuatro herramientas de memoria
• Servidores MCP remotos en campañas: cómo dar al agente de Kit acceso a herramientas de servidores externos