> ## 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. # Usar Adobe Experience Manager en Agents Después de conectar tu cuenta de Adobe Experience Manager (AEM), los siguientes nodos están disponibles en Profound Agents. Úsalos para buscar, leer, crear y actualizar Content Fragments de AEM. Todas las operaciones se ejecutan en el entorno Author de AEM conectado y usan los permisos asignados a la cuenta técnica de la credencial OAuth. ## Nodos disponibles ### List Content Fragments Recupera Content Fragments del entorno Author conectado. #### Entradas obligatorias * **AEM Instance**: el entorno Author conectado #### Entradas opcionales * **Folder**: limita la lista a una carpeta aprobada dentro de `/content/dam` * **References**: controla si los fragmentos vinculados se devuelven e hidratan * **Limit**: cantidad de resultados que se devuelven; el valor predeterminado es `25` y el máximo es `50` * **Cursor**: un cursor de paginación de la salida de un nodo List o Search anterior, que se usa para obtener la siguiente página de resultados * **Projection**: usa `summary` cuando solo necesites datos de resumen #### Salida La salida contiene los Content Fragments coincidentes y, cuando hay más resultados disponibles, un cursor de paginación para la siguiente página. ### Search Content Fragments Busca Content Fragments que coincidan con uno o más criterios. #### Entradas obligatorias * **AEM Instance**: el entorno Author conectado Profound inicia la búsqueda con un filtro **Folder** de `/content/dam`. Cambia esa carpeta o agrega otro filtro según sea necesario. #### Filtros de búsqueda * **Search text**: busca el texto seleccionado en el contenido de los fragmentos compatible con AEM * **Folder**: limita la búsqueda a una ruta de carpeta del DAM * **Models**: limita los resultados a los Content Fragment Models seleccionados * **Statuses**: New, Draft, Published, Modified o Unpublished * **Locale**: limita los resultados a una configuración regional * **Direct children only**: excluye los fragmentos de carpetas anidadas * **Created after** y **Created before**: restringen la fecha de creación #### Entradas opcionales * **Raw Query**: un JSON de consulta de búsqueda compatible con AEM; úsalo para filtros u ordenamientos que el formulario de configuración del nodo no incluye * **Limit**: cantidad de resultados que se devuelven; el valor predeterminado es `25` y el máximo es `50` * **Cursor**: un cursor de paginación de la salida de un nodo List o Search anterior, que se usa para obtener la siguiente página de resultados * **Projection**: usa `summary` cuando solo necesites datos de resumen #### Salida La salida contiene los Content Fragments coincidentes y, cuando hay más resultados disponibles, un cursor de paginación para la siguiente página. ### Get Content Fragment Recupera los datos completos de un Content Fragment. #### Entradas obligatorias * **AEM Instance**: el entorno Author conectado * **Content Fragment**: selecciona un fragmento del menú desplegable o usa una variable de la salida de un nodo anterior #### Entradas opcionales * **Content Fragment ID**: el UUID del fragmento como texto, que reemplaza al fragmento seleccionado en **Entradas obligatorias** * **References**: controla si los fragmentos vinculados se devuelven e hidratan #### Salida La salida incluye los datos del Content Fragment y su ETag cuando está disponible. Los campos específicos del modelo siguen la respuesta que devuelve AEM. ### Create Content Fragment Agrega contenido de Author basado en un Content Fragment Model habilitado. #### Entradas obligatorias * **AEM Instance**: el entorno Author conectado * **Parent Folder**: la carpeta de destino dentro de `/content/dam` * **Content Fragment Model**: el modelo que define los campos del fragmento * **Title**: el título del fragmento * **Data format** * **Structured**: carga el modelo seleccionado y muestra sus campos en el panel de configuración * **Raw JSON**: acepta un objeto cuyas claves coinciden con los nombres de campo del modelo de AEM * **Fields** / **Raw JSON**: la estructura de tus datos de entrada, según el **Data format** seleccionado Usa Raw JSON cuando el Content Fragment Model se proporciona con una variable, porque el editor de nodos no puede cargar de antemano la definición de campos de ese modelo. #### Entradas opcionales * **Name**: nombre del Content Fragment apto para URL; se deriva del **Title** si se deja en blanco * **Description**: descripción del fragmento #### Salida La salida incluye el Content Fragment creado, su ETag y su Location cuando AEM proporciona esos valores. Crear o actualizar un fragmento no lo publica. Revisa y publica el contenido en AEM. ### Update Content Fragment Modifica un fragmento existente. El nodo solo modifica los campos que proporcionas. #### Entradas obligatorias * **AEM Instance**: el entorno Author conectado * **Content Fragment**: selecciona un fragmento del menú desplegable o usa una variable de la salida de un nodo anterior * **Data format** * **Structured**: carga el modelo seleccionado y muestra sus campos en el panel de configuración * **Raw JSON**: acepta un objeto cuyas claves coinciden con los nombres de campo del modelo de AEM * Al menos un cambio en **Title**, **Description** o **Fields** / **Raw JSON** Usa Raw JSON cuando el Content Fragment Model se proporciona con una variable, porque el editor de nodos no puede cargar de antemano la definición de campos de ese modelo. #### Entradas opcionales * **Title**: déjalo vacío para conservar el título actual * **Description**: déjalo vacío para conservar la descripción actual * **Fields** / **Raw JSON**: la estructura de tus datos de entrada, según el **Data format** seleccionado * **References**: controla si los fragmentos vinculados se devuelven e hidratan * **ETag**: valor de bloqueo optimista de una salida anterior de Get o Update. Si se deja en blanco, Profound lee el ETag actual inmediatamente antes de enviar la actualización. Si el ETag proporcionado está desactualizado, el nodo informa un conflicto. #### Salida La salida incluye el Content Fragment actualizado y su nuevo ETag cuando AEM lo proporciona. Crear o actualizar un fragmento no lo publica. Revisa y publica el contenido en AEM. *** ## Conceptos clave ### AEM Instance El entorno Author de AEM conectado. Selecciónalo antes de elegir un modelo, una carpeta o un fragmento. ### Content Fragment Model El esquema de AEM que define los campos, tipos, valores obligatorios y contenido permitido de un fragmento. El modelo debe estar habilitado y permitido por la política de la carpeta de destino. ### Rutas del DAM Las carpetas de Content Fragments usan rutas del repositorio dentro de `/content/dam`. Los permisos y las políticas de las carpetas controlan qué contenido puede leer o modificar Profound. ### Content Fragment ID Las operaciones de la API de AEM identifican un Content Fragment por su UUID. El selector de Profound muestra información del fragmento que se puede buscar y proporciona el UUID al nodo. ### ETag Un ETag es un identificador único de una versión específica de los datos de un Content Fragment. Pásalo de un nodo **Get Content Fragment** al nodo **Update Content Fragment** para evitar que el flujo de trabajo sobrescriba silenciosamente un cambio realizado después de leer el fragmento. ### Paginación Los nodos List y Search devuelven hasta `50` fragmentos por solicitud. Cuando la salida contiene un cursor, proporciónalo al siguiente nodo List o Search para recuperar la siguiente página de resultados. ### Content Fragment hidratado Un Content Fragment que contiene todos los valores de sus campos, en lugar de solo los IDs y las URLs básicos. ### References References controla cómo se incluyen los fragmentos vinculados. Los modos hidratado y de todas las referencias pueden devolver respuestas más grandes, así que úsalos solo cuando el flujo de trabajo necesite contenido vinculado. *** ## Solución de problemas ### Un selector de carpeta, fragmento o modelo está deshabilitado o vacío Selecciona primero una **AEM Instance**. Si el selector sigue vacío, verifica que la cuenta técnica de tu credencial OAuth pueda leer el modelo, la carpeta o el fragmento correspondiente. Obtén más información en la guía de [solución de problemas de configuración](/es/integrations/adobe-experience-manager/setup/aem-setup-troubleshooting). ### La búsqueda devuelve un error de consulta no válida Restablece el filtro **Folder** a `/content/dam` o agrega otro filtro. Cuando uses **Raw Query**, incluye un objeto JSON no vacío y usa campos de filtro y ordenamiento compatibles con Adobe. ### El nodo Create informa un campo desconocido o un valor no válido Selecciona el modelo y usa el formato **Structured** siempre que sea posible. Si tienes que usar el formato **Raw JSON**, asegúrate de que cada clave coincida con el nombre de campo del modelo de AEM y proporciona un valor con el tipo y la cardinalidad que espera el modelo. ### El nodo Update informa que no hay cambios Ingresa al menos un valor en **Title**, **Description** o en un campo del modelo. Las entradas vacías conservan el contenido actual. ### El nodo Update informa un conflicto El fragmento cambió después de que AEM emitió el ETag. Vuelve a ejecutar el nodo **Get Content Fragment**, revisa el contenido más reciente y luego aplica la actualización con el nuevo ETag. ### Un nodo devuelve un error de permisos Confirma que el grupo de servicios de la cuenta técnica tenga permiso para esa operación y esa ruta del DAM exactas. El acceso de lectura puede funcionar mientras Create o Update siguen bloqueados. Para agregar permisos a carpetas y archivos específicos de tu entorno de AEM, sigue la guía de Adobe [Product Profile and Services user group permission management](https://experienceleague.adobe.com/en/docs/experience-manager-learn/cloud-service/aem-apis/openapis/how-to/services-user-group-permission-management). ### Solo se devuelve la primera página de resultados Usa el cursor que devuelve el nodo List o Search como el **Cursor** de la siguiente solicitud. Cada página puede contener como máximo `50` resultados. *** ## Recursos adicionales * [Referencia de la API de gestión de contenido de AEM Sites](https://developer.adobe.com/experience-cloud/experience-manager-apis/api/stable/sites/) * [Referencia de la API de carpetas de AEM](https://developer.adobe.com/experience-cloud/experience-manager-apis/api/stable/folders/)