Los documentos de Profound Docs no son documentos de la Knowledge Base. Para añadir contenido que los asistentes de IA y los Agents busquen y recuperen, usa en su lugar la herramienta
add_knowledge_base_document. Consulta Knowledge Base.Cómo funcionan las herramientas en conjunto
1
Encuentra un documento
Pregunta si existe un documento o cuáles han cambiado recientemente. El asistente busca en los nombres de los documentos con
list_docs y te enlaza cada resultado.2
Léelo
Pide un resumen o el texto completo. El asistente lee el documento con
get_doc, revisando el inicio de forma predeterminada y cargando el cuerpo completo cuando la tarea lo requiere.3
Crea o revisa
Pide un documento nuevo y el asistente lo redacta y lo guarda con
create_doc. Pide un cambio en uno existente y reescribe el documento con replace_doc_content.4
Cambia el nombre, vuelve a compartir o elimina
Pide cambiar el nombre de un documento o quién lo ve (
update_doc), o eliminar uno que el asistente creó anteriormente (delete_doc).Comportamiento y seguridad
Las herramientas de escritura usan el modo de vista previa de forma predeterminada: el asistente recibe primero un plan del cambio y nada cambia hasta que aplica ese plan. La excepción esdelete_doc, que no tiene vista previa y elimina en la primera llamada.
Comportamientos
Indicaciones de MCP
Las siguientes indicaciones de MCP están definidas en las herramientas de escritura.
Todas las herramientas de escritura también definen
openWorldHint: true, que indica a tu cliente MCP que las escrituras se realizan en el entorno compartido y en vivo, por lo que el cliente puede pedirte confirmación antes de ejecutarlas.
Herramientas de Profound Docs
list_docs
list_docs
Busca documentos y sus detalles, como el nombre, el propietario, la visibilidad y el enlace (
url). Los resultados se ordenan del modificado más recientemente al más antiguo y nunca incluyen el cuerpo del documento.Ejemplos de prompts:- “¿Ya tenemos un documento sobre nuestra estrategia de AEO?”
- “¿Qué documentos de Profound cambiaron más recientemente?”
Limitaciones:
- La herramienta no filtra por autor ni por propietario del documento. Para encontrar los documentos de una persona, el asistente lista todos los documentos y lee el propietario de cada fila, lo que puede tardar un poco.
- La herramienta no devuelve un recuento total de documentos.
get_doc
get_doc
Lee un documento. La vista previa predeterminada devuelve solo el inicio del cuerpo. Cuando la tarea necesita el texto completo o la discusión sobre él, el asistente carga el cuerpo completo o los comentarios.Ejemplos de prompts:
- “Resume el memorando de estrategia de AEO.”
- “Lee la retrospectiva del Q3 completa, incluidos los comentarios que dejaron las personas.”
create_doc
create_doc
Crea un documento nuevo a partir del contenido que redactó el asistente. La herramienta recibe el cuerpo completo en una sola llamada.Ejemplos de prompts:
- “Escribe una retrospectiva de AEO del Q3 basada en los datos de visibilidad de este trimestre y guárdala como documento de Profound.”
- “Redacta un brief de competidores y guárdalo en Profound para poder compartirlo más tarde.”
Notas:
- Los títulos de los documentos son únicos dentro de una organización: crear un documento con un título que ya existe devuelve el documento existente y descarta el cuerpo nuevo.
- Los documentos nuevos solo son visibles para su creador.
- Cuando la llamada falla entre la creación del documento y el almacenamiento de su cuerpo, el documento existe pero está vacío, y la respuesta informa
content_written: false. Un reintento devuelve el mismo documento vacío en lugar de rellenarlo.
replace_doc_content
replace_doc_content
Reemplaza el contenido de un documento con texto nuevo. Cualquier cambio en un documento existente, desde marcar una casilla hasta reescribir una sección, pasa por esta herramienta.Ejemplos de prompts:
- “Añade una sección sobre prompts de compras al memorando de estrategia de AEO.”
- “Corrige las erratas de la retrospectiva del Q3.”
Notas:
- Cuando se reemplaza el contenido del documento, el título se actualiza para coincidir con el primer encabezado del contenido nuevo, a menos que
skip_title_syncseatrue.
update_doc
update_doc
Cambia el nombre de un documento, quién puede verlo, o ambos en una sola llamada.Ejemplos de prompts:
- “Cambia el nombre del memorando de estrategia a ‘AEO strategy H2’.”
- “Haz que la retrospectiva del Q3 sea visible para toda la organización.”
Notas:
- Se requiere al menos uno de
nameovisibility. Una llamada sin ninguno devuelve un error. - Cambiar el nombre de un documento no cambia su primer encabezado e impide de forma permanente que el título lo siga. Por ejemplo, si cambias el nombre de “AEO strategy” a “AEO strategy H2”, el primer encabezado del documento sigue diciendo “AEO strategy”.
- Solo lectura es el único nivel de acceso que
update_docpuede conceder a todos los miembros de una organización. Si todos los miembros de una organización ya tienen acceso de edición, establecervisibilityenorganizationa través de MCP reduce ese acceso a solo lectura. - La herramienta solo funciona con documentos creados a través de MCP o que tú mismo creaste en la plataforma Profound. Un documento compartido contigo, incluso con acceso de edición, no se puede renombrar ni volver a compartir, y solo su creador puede cambiar su visibilidad.
delete_doc
delete_doc
Elimina un documento que el asistente creó anteriormente a través de una conexión MCP, como un borrador que resultó incorrecto o un duplicado. Es la única herramienta de escritura sin modo de vista previa.Ejemplos de prompts:
- “Elimina el borrador que creaste antes, nos quedamos con la versión final.”
- “Ese brief resultó ser un duplicado, elimínalo.”
Notas:
- La eliminación solo funciona con documentos creados a través de MCP y solo por parte de su creador.
- Las eliminaciones son definitivas: no puedes deshacerlas.