> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Prompts

> Conoce las herramientas de prompts disponibles a través de Profound MCP

Profound MCP ofrece a los asistentes de IA herramientas para ver qué prompts rastrea una categoría, leer las respuestas que los motores de IA dieron a esos prompts, crear nuevos prompts, actualizar los existentes y activarlos, desactivarlos o eliminarlos de forma masiva. Para conectar tu cliente MCP al servidor alojado, consulta las [guías de conexión](/es/mcp/common-mcp-clients).

## Cómo funcionan las herramientas en conjunto

<Steps>
  <Step title="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`](/es/mcp/capabilities/discovery-tools#list-categories).
  </Step>

  <Step title="Ver lo que rastreas">
    Pregunta qué prompts ejecuta la categoría. El asistente los enumera con [`list_prompts`](#list-prompts) y filtra por estado, tema o etiqueta cuando se lo pides.
  </Step>

  <Step title="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`](#get-prompt-answers).
  </Step>

  <Step title="Crear o revisar">
    Pide rastrear nuevos prompts y el asistente los redacta y te muestra una vista previa con [`create_prompts`](#create-prompts). Pide un cambio en prompts existentes y te muestra una vista previa de los cambios campo por campo con [`update_prompts`](#update-prompts).
  </Step>

  <Step title="Activar, desactivar o eliminar">
    Pide pausar prompts, reanudarlos o eliminarlos definitivamente. El asistente cambia su estado de forma masiva con [`update_prompts_status`](#update-prompts-status).
  </Step>
</Steps>

## 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 con `preview: false`.

### Comportamientos

| Comportamiento | Qué significa |
| - | - |
| Vista previa antes de aplicar | `create_prompts`, `update_prompts` y `update_prompts_status` devuelven primero un plan y no guardan nada hasta que se aplica el cambio |
| Las creaciones no son idempotentes | Cada llamada aplicada a `create_prompts` crea nuevos prompts, así que aplicarla dos veces con la misma entrada crea duplicados |
| Las colecciones se reemplazan | Al actualizar, `tags`, `regions`, `platforms` y `personas` reemplazan todo el conjunto en lugar de combinarse con él |
| La eliminación es permanente | `update_prompts_status` con `deleted` elimina los prompts y sus datos históricos |
| Referencias creadas automáticamente | Cuando un prompt menciona un tema o una etiqueta que aún no existe, la herramienta lo crea en lugar de devolver un error |
| Datos en vivo | Las herramientas leen de la API de Profound, por lo que los resultados reflejan tu acceso y tus datos actuales |

### 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:

| Herramienta | Indicaciones | Qué significa |
| - | - | - |
| `create_prompts` | `idempotentHint: false` | Reintentar una llamada aplicada crea más prompts |
| `update_prompts` | `destructiveHint: true`, `idempotentHint: true` | `tags`, `regions`, `platforms` y `personas` se reemplazan, y la misma entrada aplicada dos veces produce el mismo estado |
| `update_prompts_status` | `destructiveHint: true`, `idempotentHint: true` | `deleted` es permanente, y los prompts que ya tienen el estado de destino se omiten |

## Herramientas de prompts

| Herramienta | Uso |
| - | - |
| `list_prompts` | Enumera los prompts de una categoría, con filtros de estado, etiqueta y tema |
| `get_prompt_answers` | Lee las respuestas que los motores de IA dieron a los prompts de una categoría |
| `create_prompts` | Crea uno o más prompts en una categoría |
| `update_prompts` | Actualiza campos de prompts existentes |
| `update_prompts_status` | Activa, desactiva o elimina prompts de forma masiva |

<AccordionGroup>
  <Accordion title="list_prompts" id="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."

    **Entradas**

    | Entrada | Obligatoria | Valor predeterminado | Descripción |
    | - | - | - | - |
    | `category_id` | Sí | - | Categoría cuyos prompts se enumeran |
    | `status` | No | `all` | Uno de `active`, `disabled` o `all` |
    | `tag_ids` | No | `null` | Incluye solo los prompts que tienen estas etiquetas |
    | `topic_ids` | No | `null` | Incluye solo los prompts de estos temas |
    | `exclude_tag_ids` | No | `null` | Excluye los prompts que tienen estas etiquetas |
    | `exclude_topic_ids` | No | `null` | Excluye los prompts de estos temas |
    | `combine` | No | `AND` | Cómo se combinan `tag_ids` y `topic_ids` cuando ambos están definidos: `AND` u `OR` |
    | `limit` | No | `100` | Cantidad máxima de prompts que se devuelven |
    | `cursor` | No | `null` | Token de paginación del `next_cursor` de una respuesta anterior |
  </Accordion>

  <Accordion title="get_prompt_answers" id="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."

    **Entradas**

    | Entrada | Obligatoria | Valor predeterminado | Descripción |
    | - | - | - | - |
    | `category_id` | Sí | - | Categoría de la que se obtienen las respuestas a los prompts |
    | `start_date` | Sí | - | Inicio del intervalo (inclusive) en formato `YYYY-MM-DD` |
    | `end_date` | Sí | - | Fin del intervalo (inclusive) en formato `YYYY-MM-DD` |
    | `prompt_id` | No | `null` | Limita los resultados a un solo prompt |
    | `country` | No | `null` | Limita a uno o más países, por nombre o ID. No se puede combinar con `region` |
    | `region` | No | `null` | Limita a una o más regiones, por nombre o ID. No se puede combinar con `country` |
    | `topic_ids` | No | `null` | Limita a uno o más temas, por ID de `list_topics` |
    | `model_ids` | No | `null` | Limita a uno o más modelos de IA que respondieron, por ID de `list_models` |
    | `limit` | No | `100` | Cantidad de prompts devueltos por página de resultados |
    | `offset` | No | `0` | Desplazamiento para la paginación |

    **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.
  </Accordion>

  <Accordion title="create_prompts" id="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."

    **Entradas**

    | Entrada | Obligatoria | Valor predeterminado | Descripción |
    | - | - | - | - |
    | `category_id` | Sí | - | Categoría rastreada, de `list_categories` |
    | `prompts` | Sí | - | Los prompts que se crearán |
    | `preview` | No | `true` | Cuando es `true`, muestra lo que sucedería; cuando es `false`, crea |

    Cada entrada de `prompts` acepta:

    | Campo | Obligatorio | Valor predeterminado | Descripción |
    | - | - | - | - |
    | `prompt` | Sí | - | El texto del prompt |
    | `topic` | Sí | - | ID o nombre del tema. Si el nombre no existe, se crea |
    | `platforms` | Sí | - | ID o nombres de las plataformas en las que se ejecuta el prompt |
    | `regions` | Sí | - | ID o nombres de las regiones en las que se ejecuta el prompt |
    | `language` | No | `en-US` | Idioma del prompt |
    | `tags` | No | `[]` | ID o nombres de etiquetas. Si el nombre no existe, se crea |
    | `analysis_types` | No | `["visibility"]` | Tipos de análisis que se ejecutan: `visibility`, [`sentiment`](https://help.tryprofound.com/articles/3189907319-about-sentiment) o [`accuracy`](https://help.tryprofound.com/articles/5793584301-about-factcheck) |
    | `personas` | No | `[]` | ID o nombres de personas |
    | `asset` | No | `null` | Activo asociado al prompt |

    **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_created` y `tags_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.
  </Accordion>

  <Accordion title="update_prompts" id="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'."

    **Entradas**

    | Entrada | Obligatoria | Valor predeterminado | Descripción |
    | - | - | - | - |
    | `category_id` | Sí | - | Categoría rastreada a la que pertenecen los prompts |
    | `prompts` | Sí | - | Las actualizaciones de prompts que se aplicarán |
    | `preview` | No | `true` | Cuando es `true`, devuelve los cambios planificados; cuando es `false`, los aplica |

    Cada entrada de `prompts` acepta:

    | Campo | Obligatorio | Valor predeterminado | Descripción |
    | - | - | - | - |
    | `id` | Sí | - | El prompt que se actualizará, de `list_prompts` |
    | `prompt` | No | `null` | Nuevo texto del prompt |
    | `topic` | No | `null` | Nuevo tema |
    | `tags` | No | `null` | Nuevo conjunto de etiquetas |
    | `regions` | No | `null` | Nuevo conjunto de regiones |
    | `platforms` | No | `null` | Nuevo conjunto de plataformas |
    | `personas` | No | `null` | Nuevo conjunto de personas |
    | `analysis_types` | No | `null` | Nuevos tipos de análisis: `visibility`, [`sentiment`](https://help.tryprofound.com/articles/3189907319-about-sentiment) o [`accuracy`](https://help.tryprofound.com/articles/5793584301-about-factcheck) |
    | `language` | No | `null` | Nuevo idioma |
    | `asset` | No | `null` | Nuevo activo asociado |

    **Notas**:

    * En los campos `tags`, `regions`, `platforms` y `personas`, pasar `null` no 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.
  </Accordion>

  <Accordion title="update_prompts_status" id="update-prompts-status">
    Cambia el estado de los prompts:

    * `active`: reanuda las ejecuciones diarias
    * `disabled`: detiene las ejecuciones futuras y conserva el historial
    * `deleted`: elimina permanentemente los prompts y sus datos históricos

    <Warning>
      Usa el estado `deleted` con precaución: elimina permanentemente los prompts y sus datos históricos.
    </Warning>

    **Prompts de ejemplo**:

    * "Desactiva los prompts de temporada navideña, los volveremos a activar en noviembre."
    * "Elimina los prompts de prueba que creaste antes."

    **Entradas**

    | Entrada | Obligatoria | Valor predeterminado | Descripción |
    | - | - | - | - |
    | `category_id` | Sí | - | Categoría rastreada a la que pertenecen los prompts |
    | `prompt_ids` | Sí | - | ID de los prompts cuyo estado se cambiará |
    | `status` | Sí | - | `active`, `disabled` o `deleted` |
    | `preview` | No | `true` | Cuando es `true`, devuelve el plan; cuando es `false`, lo aplica |

    **Notas**:

    * Aplicar el estado a prompts que ya tienen ese mismo estado no cambia nada.
  </Accordion>
</AccordionGroup>

## Recursos

Profound MCP proporciona material de referencia sobre prompts como recursos MCP de solo lectura.

| URI del recurso | Descripción |
| - | - |
| `file:///profound/glossary/prompt` | La definición de un prompt, la consulta individual enviada a un motor de respuestas de IA |
| `file:///profound/glossary/prompt-generation-model` | La definición del Prompt Generation Model, que varía la redacción y el contexto de los prompts que ejecuta un tema |
| `file:///profound/glossary/responses` | La definición de las respuestas, las respuestas completas que los motores de IA dieron a un prompt |