Cómo funcionan las herramientas en conjunto
1
Resolver la categoría
Los prompts pertenecen a una categoría, así que antes de hacer cualquier cosa con ellos, el asistente resuelve la categoría con
list_categories.2
Ver lo que rastreas
Pregunta qué prompts ejecuta la categoría. El asistente los enumera con
list_prompts y filtra por estado, tema o etiqueta cuando se lo pides.3
Leer las respuestas
Pregunta qué dicen los motores de IA. El asistente obtiene las respuestas sin procesar detrás de las métricas con
get_prompt_answers.4
Crear o revisar
Pide rastrear nuevos prompts y el asistente los redacta y te muestra una vista previa con
create_prompts. Pide un cambio en prompts existentes y te muestra una vista previa de los cambios campo por campo con update_prompts.5
Activar, desactivar o eliminar
Pide pausar prompts, reanudarlos o eliminarlos definitivamente. El asistente cambia su estado de forma masiva con
update_prompts_status.Comportamiento y seguridad
Las herramientas de escritura usan el modo de vista previa por defecto: el asistente recibe primero un plan del cambio y nada se guarda hasta que aplica ese plan conpreview: false.
Comportamientos
Indicaciones de MCP
Las herramientas de lectura (list_prompts y get_prompt_answers) solo obtienen datos y no cambian nada en Profound. Las siguientes indicaciones de MCP están configuradas en las herramientas de escritura:
Herramientas de prompts
list_prompts
list_prompts
Enumera los prompts configurados en una categoría, con sus ID y detalles. Las demás herramientas de prompts toman los ID de prompts de esta lista.Prompts de ejemplo:
- “¿Qué prompts estamos rastreando en la categoría Banca?”
- “Muéstrame los prompts desactivados del tema cuentas de ahorro.”
get_prompt_answers
get_prompt_answers
Obtiene las respuestas que los motores de IA dieron a los prompts de una categoría durante un rango de fechas: el texto sin procesar detrás de las métricas de visibilidad.Prompts de ejemplo:
- “¿Qué respondieron los motores de IA a nuestros prompts de ahorro la semana pasada?”
- “Trae las respuestas detrás de la caída de visibilidad del mes pasado.”
Notas:
- Varios ID en una misma lista coinciden con cualquiera de esos ID. Cuando ambas entradas están definidas, una respuesta debe coincidir con las dos.
- Los filtros se aplican antes de la paginación, por lo que una llamada filtrada solo recorre las respuestas que coinciden.
create_prompts
create_prompts
Crea uno o más prompts en una categoría. Cada prompt indica la pregunta que se debe hacer, el tema al que pertenece y las plataformas y regiones en las que se ejecuta.Prompts de ejemplo:
- “Empieza a rastrear ‘¿Cuáles son las mejores zapatillas para correr para pies planos?’ en ChatGPT en EE. UU.”
- “Crea prompts para estas preguntas en el tema cuentas de ahorro.”
Cada entrada de
prompts acepta:Notas:
- Los nombres de temas y etiquetas deben coincidir exactamente: un nombre mal escrito crea un nuevo tema o etiqueta en lugar de unirse al existente, lo que divide tus datos entre ambos. La vista previa los cuenta en
topics_createdytags_created, así que revísala para detectar temas o etiquetas nuevos no deseados antes de confirmar. - Las creaciones no son idempotentes: aplicar la misma llamada dos veces crea prompts duplicados.
update_prompts
update_prompts
Actualiza uno o más prompts existentes. La vista previa devuelve una comparación campo por campo para cada prompt: valores anteriores y nuevos para los campos individuales, y valores agregados y eliminados para las colecciones.Prompts de ejemplo:
- “Mueve los prompts de precios al tema ‘Comisiones’.”
- “Etiqueta los prompts de ahorro con ‘alta prioridad’.”
Cada entrada de
prompts acepta:Notas:
- En los campos
tags,regions,platformsypersonas, pasarnullno cambia el valor,[]lo borra y una lista no vacía reemplaza todo el conjunto. Para agregar una etiqueta, el asistente envía el conjunto completo de etiquetas, incluidas las existentes.
update_prompts_status
update_prompts_status
Cambia el estado de los prompts:
active: reanuda las ejecuciones diariasdisabled: detiene las ejecuciones futuras y conserva el historialdeleted: elimina permanentemente los prompts y sus datos históricos
- “Desactiva los prompts de temporada navideña, los volveremos a activar en noviembre.”
- “Elimina los prompts de prueba que creaste antes.”
Notas:
- Aplicar el estado a prompts que ya tienen ese mismo estado no cambia nada.