> ## 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 Framer en Agents
Esta página trata sobre la integración de **Framer CMS** en Profound.
Después de conectar tu proyecto de Framer, las siguientes acciones quedan disponibles como pasos de Agent para trabajar con colecciones y elementos de Framer CMS. Cada paso requiere que selecciones un **Framer Project** conectado en un menú desplegable.
#### **Create Item**
Crea un nuevo elemento del CMS en una colección de Framer.
**Entradas obligatorias**
* **Framer Project**: selecciona en el menú desplegable el proyecto de Framer que conectaste en Profound
* **Collection**: selecciona la colección en el menú desplegable
* **Field Data**: los campos disponibles se generan a partir del esquema de la colección seleccionada. Consulta [Entradas de Create Item](#entradas-de-create-item).
La salida incluye el `id`, el `slug`, el `draft` y el [`field_data`](#salida-de-los-elementos) del elemento creado.
**Consejo:** Usa primero **Get Collection** para inspeccionar el esquema de la colección y confirmar qué campos son obligatorios antes de crear un elemento.
#### **List Collections**
Obtén las colecciones del CMS disponibles en tu proyecto de Framer conectado.
**Entradas obligatorias**
* **Framer Project**: selecciona en el menú desplegable el proyecto de Framer que conectaste en Profound
La salida incluye una lista estructurada de colecciones con los valores `id`, `name` y `readonly` de cada colección.
#### **Get Collection**
Obtén una sola colección de Framer y su esquema.
**Entradas obligatorias**
* **Framer Project**: selecciona en el menú desplegable el proyecto de Framer que conectaste en Profound
* **Collection**: selecciona la colección en el menú desplegable
La salida incluye el `id`, `name`, `readonly`, `managed_by` y las [`field_definitions`](#esquemas-de-colecciones) de la colección, que describen el `id`, `name` y `type` de cada campo, y si es obligatorio.
#### **List Items**
Obtén elementos del CMS de una colección de Framer.
**Entradas obligatorias**
* **Framer Project**: selecciona en el menú desplegable el proyecto de Framer que conectaste en Profound
* **Collection**: selecciona la colección en el menú desplegable
La salida incluye el `id`, el `slug`, el `draft` y el [`field_data`](#salida-de-los-elementos) de cada elemento.
#### **Get Item**
Obtén un solo elemento del CMS por su ID.
**Entradas obligatorias**
* **Framer Project**: selecciona en el menú desplegable el proyecto de Framer que conectaste en Profound
* **Collection**: selecciona la colección en el menú desplegable
* **Item ID**: introduce directamente el ID del elemento
La salida incluye el `id`, el `slug`, el `draft` y el [`field_data`](#salida-de-los-elementos) del elemento para que puedas inspeccionarlo o pasarlo a pasos posteriores.
***
## Tipos de campo compatibles
El esquema dinámico de Framer hace que Profound se adapte a tu modelo de colección. Actualmente se admiten los siguientes tipos de campo de Framer CMS al crear elementos:
| Tipo de campo | Descripción | Compatible |
| - | - | - |
| **Plain Text** | Texto de una sola línea | Sí |
| **Formatted Text** | Contenido de texto enriquecido | Sí |
| **Date** | Campo de fecha | No |
| **Link** | Campo de URL | Sí |
| **Image** | Recurso de imagen | No |
| **Gallery** | Arreglo de imágenes | No |
| **Color** | Valor de color | No |
| **Toggle** | Valor verdadero/falso | Sí |
| **Number** | Valor numérico | Sí |
| **Option** | Opción de selección única | Sí |
| **File** | Recurso de archivo | No |
| **Reference** | Referencia a otro elemento | No |
| **Multi-Reference** | Referencia a varios elementos | No |
***
## Esquemas de colecciones
Usa **Get Collection** para inspeccionar el esquema de una colección antes de trabajar con sus elementos.
La salida incluye:
* **Collection ID** y **Collection Name**
* **readonly**: si la colección es de solo lectura
* **managed\_by**: cómo se gestiona la colección
* **field\_definitions**: los campos configurados en esa colección
Cada definición de campo incluye:
* **id**: el ID interno del campo en Framer
* **name**: la etiqueta que se muestra en Framer
* **type**: el tipo principal del campo en Framer, como `string`, `formattedText` o `number`
* **required**: si el campo es obligatorio
* **itemType**: información adicional del elemento para tipos de campo compuestos, cuando Framer la proporciona
Ejemplo de salida de una colección:
```json theme={null}
{
"collection": {
"field_definitions": [
{
"id": "slug",
"name": "Slug",
"required": true,
"type": "string",
"itemType": null
},
{
"id": "111111",
"name": "Title",
"required": true,
"type": "string",
"itemType": null
},
{
"id": "222222",
"name": "Content",
"required": true,
"type": "formattedText",
"itemType": null
}
],
"id": "333333",
"managed_by": "user",
"name": "Example Collection",
"readonly": false
}
}
```
***
## Entradas de Create Item
Cuando seleccionas una colección de Framer en **Create Item**, Profound genera las entradas de forma dinámica a partir del esquema de esa colección.
Para los tipos de campo compatibles, puedes completar los valores directamente en la interfaz del paso. Por ejemplo, una colección puede exponer campos como:
* **Slug**
* **Title**
* **Content**
* **Link**
* **Name**
* **Option**
* **Count**
* **Featured**
Si una colección incluye campos obligatorios con tipos no compatibles, la solicitud de **Create Item** fallará porque Profound no puede proporcionar valores para esos campos.
**Nota:** Usa **Get Collection** para confirmar las definiciones de campos antes de crear un elemento. Si necesitas compatibilidad con un tipo de campo de Framer que actualmente no se admite, contáctanos y podemos ayudarte a evaluar tu caso de uso.
***
## Salida de los elementos
Las respuestas de elementos de Framer incluyen campos de nivel superior como:
* **id**
* **slug**
* **draft**
* **field\_data**
El objeto `field_data` está indexado por el ID del campo. Cada entrada incluye el nombre legible, el tipo y el valor del campo.
Ejemplo de salida de un elemento:
```json theme={null}
{
"item": {
"draft": true,
"field_data": {
"111111": {
"name": "Title",
"type": "string",
"value": "Example title",
"valueByLocale": {}
},
"222222": {
"name": "Featured",
"type": "boolean",
"value": true
}
},
"id": "333333",
"slug": "example-title"
}
}
```
***
## Casos de uso comunes
* **Publicación de contenido**: crea nuevos elementos de Framer CMS a partir de textos generados por IA o datos estructurados
* **Recuperación de contenido**: extrae contenido estructurado de colecciones de Framer para revisarlo, resumirlo o usarlo en flujos de trabajo posteriores
* **Preparación de flujos de trabajo**: inspecciona los esquemas de colecciones antes de crear automatizaciones que dependan de campos específicos de Framer