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

# Uso de Drupal en Agents

Después de conectar tu cuenta de Drupal, los siguientes nodos estarán disponibles en los Agents de Profound.

Los nodos funcionan con el módulo [JSON:API](https://www.drupal.org/docs/core-modules-and-themes/core-modules/jsonapi-module) de Drupal. Se accede al contenido mediante un **tipo de recurso** (el tipo de entidad, como Basic, Image o Article) y un **UUID de recurso**.

## Nodos disponibles

<Tabs>
  <Tab title="Create Item" icon="file-plus">
    ### Create Item

    Crea un nuevo elemento de un tipo de recurso.

    #### Entradas obligatorias

    * **Drupal Site**: selecciona un sitio en el menú desplegable
    * **Resource type**: el tipo de recurso de JSON:API, como `node--article`
    * **Attributes** o **Relationships** (o ambos): un objeto JSON con valores de campos o referencias a otros recursos.

    <Warning>
      Una solicitud sin Attributes ni Relationships se rechaza; incluye al menos uno.
    </Warning>
  </Tab>

  <Tab title="Update Item" icon="pencil">
    ### Update Item

    Actualiza un elemento existente.

    #### Entradas obligatorias

    * **Drupal Site**: selecciona un sitio en el menú desplegable
    * **Resource type**: el tipo de recurso de JSON:API, como `node--article`
    * **Resource UUID**
    * **Attributes** o **Relationships** (o ambos): un objeto JSON con valores de campos o referencias que se actualizarán. Se requiere al menos uno.

    <Note>
      Solo se modifican los atributos y las relaciones que proporcionas.
    </Note>
  </Tab>

  <Tab title="Get Item" icon="file">
    ### Get Item

    Obtiene un solo elemento.

    #### Entradas obligatorias

    * **Drupal Site**: selecciona un sitio en el menú desplegable
    * **Resource type**: el tipo de recurso de JSON:API, como `node--article`
    * **Resource UUID**

    La salida incluye el contenido completo del elemento con los atributos, las relaciones y los metadatos de la respuesta de JSON:API.
  </Tab>

  <Tab title="List Items" icon="list">
    ### List Items

    Enumera los elementos de un tipo de recurso determinado.

    #### Entradas obligatorias

    * **Drupal Site**: selecciona un sitio en el menú desplegable
    * **Resource type**: el tipo de recurso de JSON:API, como `node--article`

    #### Entradas opcionales: opciones de consulta

    * **Filter**: un objeto JSON que usa la sintaxis de filtros de JSON:API de Drupal
    * **Fields**: los campos que se devuelven por objeto en la salida del nodo; si no se especifica nada, se devuelven todos los campos
    * **Include**: una lista de las entidades relacionadas que se incluirán en la salida (obtén más información en la [documentación de JSON:API](https://www.drupal.org/docs/core-modules-and-themes/core-modules/jsonapi-module/includes))
    * **Sort**: expresión de ordenamiento para el conjunto de resultados
    * **Limit**: cantidad de elementos que se devuelven (25 de forma predeterminada, hasta 50)
    * **Offset**: desplazamiento de paginación (0 de forma predeterminada)

    La salida es una lista estructurada de elementos que se puede usar en pasos posteriores del flujo de trabajo.
  </Tab>
</Tabs>

***

## Conceptos clave

### Tipos de recurso

Los tipos de recurso siguen la convención de nomenclatura de JSON:API de Drupal: el tipo de entidad y el bundle unidos por dos guiones.

| Tipo de recurso | Descripción |
| - | - |
| `node--article` | Nodos del tipo de contenido Article |
| `node--page` | Nodos de página básica |
| `taxonomy_term--tags` | Términos de la taxonomía Tags |

<Tip>
  Usa **List Items** para descubrir los tipos de recurso disponibles e inspeccionar la estructura de los elementos devueltos para tu sitio de Drupal.
</Tip>

### UUID de recurso

Los elementos se referencian por **UUID**. Cuando crees o enumeres elementos, usa el UUID de la respuesta de JSON:API como **Resource UUID** en los pasos posteriores.

### Atributos y relaciones

**Create Item** y **Update Item** requieren al menos uno de **Attributes** o **Relationships**.

* **Attributes**: valores de los campos del elemento, como el título, el cuerpo o el estado. Ejemplo de atributos para un `node--article`:
  ```json theme={null}
  {
    "title": "My new article",
    "body": {
      "value": "<p>Article content here.</p>",
      "format": "basic_html"
    },
    "status": true
  }
  ```
* **Relationships**: referencias a otros recursos, como términos de taxonomía, autores o nodos relacionados.

  Ejemplo de relaciones que vinculan etiquetas a un artículo:

  ```json theme={null}
  {
    "field_tags": {
      "data": [
        { "type": "taxonomy_term--tags",
          "id": "9b2c3d4e-5f6a-7b8c-9d0e-1f2a3b4c5d6e"
        }
      ]
    }
  }
  ```

***

## Recursos adicionales

* [Documentación del módulo JSON:API de Drupal](https://www.drupal.org/docs/core-modules-and-themes/core-modules/jsonapi-module)
* [Especificación de JSON:API](https://jsonapi.org/format/)