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

# Knowledge Bases

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

Profound MCP ofrece a los asistentes de IA herramientas para listar tus Knowledge Bases, buscar en su contenido y agregarles nuevos documentos. Para conectar tu cliente MCP al servidor alojado, consulta las [guías de conexión](/es/mcp/common-mcp-clients).

<Tip>
  Obtén más información sobre las Knowledge Bases en el [Centro de ayuda de Profound](https://help.tryprofound.com/articles/5775538586-knowledge-bases-overview).
</Tip>

## Cómo funcionan las herramientas en conjunto

<Steps>
  <Step title="Encuentra una Knowledge Base">
    Pregunta qué Knowledge Bases tienes. El asistente las lista con [`list_knowledge_bases`](#list-knowledge-bases) y muestra el nombre y la descripción de cada una.
  </Step>

  <Step title="Busca en una Knowledge Base">
    Haz una pregunta que tu Knowledge Base pueda responder. El asistente busca en su contenido con [`search_knowledge_base`](#search-knowledge-base) y devuelve los pasajes que mejor coinciden.
  </Step>

  <Step title="Agrega un documento">
    Pide que se guarde contenido nuevo en la Knowledge Base. El asistente redacta el documento, muestra una vista previa del plan con [`add_knowledge_base_document`](#add-knowledge-base-document) y lo agrega una vez que lo confirmas.
  </Step>
</Steps>

## Comportamiento y seguridad

### Comportamientos

| Comportamiento | Qué significa |
| - | - |
| Vista previa antes de aplicar | `add_knowledge_base_document` usa el modo de vista previa de forma predeterminada y no agrega nada hasta que el asistente aplica el plan con `preview: false` |
| Escrituras solo de adición | MCP solo puede agregar documentos. Para revisar o eliminar uno, usa la plataforma de Profound |
| Se rechazan los nombres duplicados | Agregar un documento con un nombre que ya existe falla, y la respuesta sugiere reintentar con un nombre con versión |
| Los reintentos crean copias | Cada adición aplicada crea un documento nuevo, por lo que un reintento crea otra copia, a menos que su nombre se rechace por estar duplicado |
| Datos en vivo | Las herramientas leen de la API de Profound, por lo que los resultados reflejan tu acceso y tus datos actuales |

## Herramientas de Knowledge Base

<Note>
  No es posible crear una Knowledge Base a través de MCP. Para agregar una, [usa la plataforma de Profound](https://help.tryprofound.com/articles/5090178560-add-and-manage-knowledge-bases).
</Note>

| Herramienta | Uso |
| - | - |
| `list_knowledge_bases` | Lista las Knowledge Bases a las que tienes acceso |
| `search_knowledge_base` | Busca en el contenido de una Knowledge Base |
| `add_knowledge_base_document` | Agrega un nuevo documento markdown a una Knowledge Base |

<AccordionGroup>
  <Accordion title="list_knowledge_bases" id="list-knowledge-bases">
    Lista las Knowledge Bases disponibles para ti.

    **Ejemplos de prompts**:

    * "¿Qué Knowledge Bases tenemos?"
    * "¿Tenemos una Knowledge Base para las pautas de marca?"

    **Entradas**

    | Entrada | Obligatoria | Valor predeterminado | Descripción |
    | - | - | - | - |
    | `organization_id` | Sí, cuando tienes acceso a más de una | `null` | La organización cuyas Knowledge Bases se listan. El asistente la resuelve con [`list_organizations`](/es/mcp/capabilities/discovery-tools#list-organizations) |
  </Accordion>

  <Accordion title="search_knowledge_base" id="search-knowledge-base">
    Ejecuta una búsqueda semántica dentro de una sola Knowledge Base. Cada resultado devuelve `id`, `score`, `content` y `metadata`, que incluye `folder_path`, `source_filename` y `filetype`.

    **Ejemplos de prompts**:

    * "¿Qué dicen nuestras pautas de marca sobre el tono de voz para los lanzamientos de productos?"
    * "Busca las preguntas frecuentes sobre precios en la Knowledge Base de producto."

    **Entradas**

    | Entrada | Obligatoria | Valor predeterminado | Descripción |
    | - | - | - | - |
    | `knowledge_base` | Sí | - | La Knowledge Base en la que se busca, por ID, nombre o slug |
    | `query` | Sí | - | Qué buscar, en lenguaje natural |
    | `top_k` | No | `10` | Número máximo de resultados que se devuelven |
    | `organization_id` | Sí, cuando tienes acceso a más de una | `null` | La organización a la que pertenece la Knowledge Base. El asistente la resuelve con [`list_organizations`](/es/mcp/capabilities/discovery-tools#list-organizations) |
  </Accordion>

  <Accordion title="add_knowledge_base_document" id="add-knowledge-base-document">
    Agrega un nuevo documento a una Knowledge Base como texto markdown.

    **Ejemplos de prompts**:

    * "Guarda este resumen de campaña en la Knowledge Base de marketing."
    * "Agrega el nuevo documento de posicionamiento a la Knowledge Base de pautas de marca, en la carpeta de mensajes."

    **Entradas**

    | Entrada | Obligatoria | Valor predeterminado | Descripción |
    | - | - | - | - |
    | `knowledge_base` | Sí | - | La Knowledge Base a la que se agrega, por ID, nombre o slug |
    | `name` | Sí | - | Nombre del documento: en minúsculas, con guiones y descriptivo, como `brand-guidelines` |
    | `text` | Sí | - | El contenido completo del documento en markdown, con frontmatter YAML al principio |
    | `folder` | No | `null` | Carpeta en la que se guarda el documento. Si se omite, el documento se guarda en la carpeta raíz de la Knowledge Base |
    | `preview` | No | `true` | Si es `true`, devuelve el plan sin agregar el documento; si es `false`, lo agrega |
    | `create_missing_parents` | No | `false` | Establécelo en `true` solo para confirmar la creación de varios niveles de carpetas anidadas a la vez, después de que la herramienta pida confirmar una ruta con mucho anidamiento |
    | `organization_id` | Sí, cuando tienes acceso a más de una | `null` | La organización a la que pertenece la Knowledge Base. El asistente la resuelve con [`list_organizations`](/es/mcp/capabilities/discovery-tools#list-organizations) |

    **Notas**:

    * La herramienta solo acepta texto. Si tu fuente es una URL, el asistente primero lee la página y luego envía su contenido como markdown.
    * Para el scraping de sitios completos, las conexiones con Notion y la vinculación con Google Drive, usa la [plataforma de Profound](https://help.tryprofound.com/articles/5090178560-add-and-manage-knowledge-bases).
    * Carpetas nuevas: guardar en una carpeta nueva dentro de una existente funciona automáticamente, y la respuesta informa `folder_created`. Guardar en varios niveles de carpetas inexistentes a la vez falla primero, y el asistente lo reintenta con `create_missing_parents: true` después de que confirmes que el anidamiento es intencional.
    * Los documentos de una Knowledge Base se identifican por su nombre, por lo que agregar un segundo documento con un nombre que ya existe falla.
    * El contenido recién agregado puede tardar un momento en aparecer en los resultados de búsqueda. Es una buena práctica confirmar con el asistente que el documento se agregó antes de realizar otras acciones con él.
  </Accordion>
</AccordionGroup>

## Recursos

Profound MCP proporciona material de referencia sobre las Knowledge Bases como recursos MCP de solo lectura.

| URI del recurso | Úsalo para |
| - | - |
| `file:///profound/knowledge-base-guide` | La guía de redacción: intenciones de los documentos, el nivel mínimo de calidad, las reglas de nomenclatura y la ubicación de las carpetas |
| `file:///profound/knowledge-base-guide/templates` | Una colección de plantillas de documentos en markdown y YAML |
| `file:///profound/glossary/knowledge-base` | La definición de una Knowledge Base |