> ## 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 Contentful en Agents
Después de conectar tu cuenta de Contentful, las siguientes acciones están disponibles como pasos de Agent. Cada paso requiere que selecciones una **Contentful Account** conectada en un menú desplegable.
#### **Create Entry**
Crea una nueva entrada en tu espacio de Contentful.
**Entradas obligatorias**
* **Contentful Account**
* **Space**
* **Environment**
* **Content Type**
* **Fields** (dinámicos según el esquema del tipo de contenido)
**Entradas opcionales**
* **Locale** (de forma predeterminada, la configuración regional predeterminada del espacio)
* **Publish** (publicar de inmediato o guardar como borrador)
La entrada se crea según el esquema de tu tipo de contenido. Los campos de texto enriquecido aceptan Markdown, que se convierte automáticamente al formato de texto enriquecido de Contentful.
**Consejo:** deja **Publish** sin marcar para crear borradores que puedas revisar antes de publicarlos.
#### **Update Entry**
Actualiza una entrada existente en tu espacio de Contentful.
**Entradas obligatorias**
* **Contentful Account**
* **Space**
* **Environment**
* **Entry ID**
**Entradas opcionales**
* **Fields** (solo los campos que quieras actualizar)
* **Locale** (de forma predeterminada, la configuración regional predeterminada del espacio)
* **Publish** (publicar los cambios de inmediato)
**Importante:** solo se modificarán los campos que proporciones; todos los demás campos permanecen sin cambios.
#### **Get Entry**
Recupera una sola entrada por su ID.
**Entradas obligatorias**
* **Contentful Account**
* **Space**
* **Environment**
* **Entry ID**
La salida incluye el contenido completo de la entrada con todos sus campos y metadatos.
#### **List Entries**
Recupera una lista de entradas de tu espacio de Contentful.
**Entradas obligatorias**
* **Contentful Account**
* **Space**
* **Environment**
**Entradas opcionales**
* **Content Type** (filtrar por tipo de contenido)
* **Limit** (número de entradas que se devolverán)
* **Skip** (desplazamiento de paginación)
La salida es una lista estructurada de entradas que puede usarse en pasos posteriores del Agent.
***
## Tipos de campo compatibles
Gracias al esquema dinámico de Contentful, Profound se adapta automáticamente a tu modelo de contenido. Se admiten todos los tipos de campo:
| Tipo de campo | Descripción | Formato de entrada |
| - | - | - |
| **Short text** | Texto de una sola línea | Texto sin formato |
| **Long text** | Texto de varias líneas | Texto sin formato |
| **Rich text** | Contenido con formato | Markdown (convertido automáticamente) |
| **Number** | Números decimales | Número |
| **Integer** | Números enteros | Entero |
| **Boolean** | Verdadero/falso | Booleano |
| **Date & time** | Fechas ISO 8601 | Cadena de fecha |
| **Location** | Coordenadas geográficas | Objeto `{lat, lon}` |
| **JSON object** | JSON arbitrario | Objeto JSON |
| **Media** | Referencias a activos | ID del activo |
| **Reference** | Referencias a entradas | ID de entrada o array de IDs |
***
## Trabajar con texto enriquecido
Los campos de texto enriquecido de Contentful usan un formato de documento estructurado (AST). Profound acepta **Markdown**, **HTML** o el **formato JSON nativo de texto enriquecido de Contentful**.
**Markdown compatible:**
* Encabezados (de `# H1` a `###### H6`)
* Párrafos
* **Negrita**, *cursiva* y otros formatos
* Listas con viñetas y numeradas
* Citas en bloque
* Bloques de código
* Enlaces
**HTML compatible:**
* Encabezados de `` a ``
* Párrafos `
`
* Formato ``, ``, ``
* Listas ``, ``, `- `
* Citas en bloque `
`
* Bloques de código ``, ``
* Enlaces ``
**JSON nativo de texto enriquecido:**
Si ya tienes documentos de texto enriquecido de Contentful, puedes pasarlos directamente:
```json theme={null}
{
"nodeType": "document",
"data": {},
"content": [
{
"nodeType": "paragraph",
"data": {},
"content": [
{ "nodeType": "text", "value": "Hello world", "marks": [] }
]
}
]
}
```
**Consejo:** usa el formato que te resulte más cómodo para tu flujo de trabajo. Markdown, HTML y el JSON nativo de texto enriquecido funcionan sin problemas.
***
## Trabajar con referencias
Los campos de referencia vinculan entradas entre sí. Puedes proporcionar:
* **Una sola referencia**: solo el ID de la entrada como cadena
* **Varias referencias**: un array de IDs de entrada
Profound las convierte automáticamente al formato de enlace que requiere Contentful.
***
## Comprender las configuraciones regionales
Contentful usa un modelo de contenido basado en configuraciones regionales, en el que cada valor de campo está asociado a una configuración regional (por ejemplo, `en-US`, `fr-FR`). Profound lo gestiona automáticamente:
* **Comportamiento predeterminado**: si no especificas una configuración regional, Profound usa la configuración regional predeterminada de tu espacio
* **Una sola configuración regional**: especifica una configuración regional para escribir contenido en ese idioma
* **Varias configuraciones regionales**: usa el formato JSON sin procesar para escribir varias configuraciones regionales a la vez
Cuando proporcionas un valor de campo simple como:
```json theme={null}
{
"title": "My Blog Post"
}
```
Profound lo envuelve automáticamente para la API de Contentful:
```json theme={null}
{
"title": {
"en-US": "My Blog Post"
}
}
```
Este envoltorio por configuración regional se aplica a todos los campos antes de enviarlos a Contentful.
***
## Formatos de entrada
Profound acepta dos formatos de entrada para crear y actualizar entradas:
El formato simple es fácil de leer y gestiona automáticamente el envoltorio por configuración regional:
```json theme={null}
{
"space": "your-space-id",
"environment": "master",
"content_type_id": "blogPost",
"locale": "en-US",
"fields": {
"title": "My Blog Post",
"body": "# Hello\n\nThis is **markdown**.",
"heroImage": "asset-123",
"relatedPosts": ["post-1", "post-2"]
},
"publish": false
}
```
**Características:**
* Estructura de campos plana (sin anidamiento por configuración regional)
* IDs simples como cadenas para las referencias
* Markdown para los campos de texto enriquecido
* Envoltorio automático por configuración regional
El formato sin procesar te da control total sobre el contenido específico de cada configuración regional:
```json theme={null}
{
"space": "your-space-id",
"environment": "master",
"content_type_id": "blogPost",
"fields": {
"title": {
"en-US": "My Blog Post",
"fr-FR": "Mon Article de Blog"
},
"body": {
"en-US": "# Hello\n\nEnglish content.",
"fr-FR": "# Bonjour\n\nContenu français."
}
},
"publish": false
}
```
**Usa este formato cuando:**
* Escribas contenido en varias configuraciones regionales simultáneamente
* Necesites un control preciso sobre los valores específicos de cada configuración regional
* Migres contenido desde otro sistema
***
## Casos de uso comunes
* **Publicación de contenido**: genera y publica entradas de blog, artículos o descripciones de productos
* **Actualizaciones de contenido**: actualiza de forma masiva entradas existentes con información nueva
* **Migración de contenido**: mueve contenido entre entornos o espacios
* **Flujos de trabajo automatizados**: crea entradas a partir de disparadores o fuentes de datos externos
***
## Recursos adicionales
Obtén más información sobre el modelo de contenido y la API de Contentful:
* [Conceptos del modelo de contenido de Contentful](https://www.contentful.com/developers/docs/concepts/data-model/) - Comprender los espacios, entornos y tipos de contenido
* [Localización en Contentful](https://www.contentful.com/developers/docs/concepts/locales/) - Cómo funcionan las configuraciones regionales en Contentful
* [Tipo de campo Rich Text](https://www.contentful.com/developers/docs/concepts/rich-text/) - Comprender el formato de texto enriquecido de Contentful
* [Content Management API](https://www.contentful.com/developers/docs/references/content-management-api/) - Referencia completa de la API