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.

Crear entrada
Actualizar entrada
Obtener entrada
Listar entradas

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.

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 <h1> a <h6>
Párrafos <p>
Formato <strong>, <em>, <u>
Listas <ul>, <ol>, <li>
Citas en bloque <blockquote>
Bloques de código <code>, <pre>
Enlaces <a>

JSON nativo de texto enriquecido: Si ya tienes documentos de texto enriquecido de Contentful, puedes pasarlos directamente:

{
  "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

Cómo funciona el envoltorio por configuración regional

Cuando proporcionas un valor de campo simple como:

{
  "title": "My Blog Post"
}

Profound lo envuelve automáticamente para la API de Contentful:

{
  "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:

Formato simple
Formato JSON sin procesar

El formato simple es fácil de leer y gestiona automáticamente el envoltorio por configuración regional:

{
  "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:

{
  "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 - Comprender los espacios, entornos y tipos de contenido
Localización en Contentful - Cómo funcionan las configuraciones regionales en Contentful
Tipo de campo Rich Text - Comprender el formato de texto enriquecido de Contentful
Content Management API - Referencia completa de la API

Adobe Experience Manager

Contentful

Drupal

Framer

G2

Gamma

Gong

Google Drive

Looker

Microsoft 365

Salsify

Sanity

Slack

Wordpress

Usar Contentful en Agents

Create Entry

Update Entry

Get Entry

List Entries

Tipos de campo compatibles

Trabajar con texto enriquecido

Trabajar con referencias

Comprender las configuraciones regionales

Formatos de entrada

Casos de uso comunes

Recursos adicionales

​Create Entry

​Update Entry

​Get Entry

​List Entries

​Tipos de campo compatibles

​Trabajar con texto enriquecido

​Trabajar con referencias

​Comprender las configuraciones regionales

​Formatos de entrada

​Casos de uso comunes

​Recursos adicionales

Create Entry

Update Entry

Get Entry

List Entries

Tipos de campo compatibles

Trabajar con texto enriquecido

Trabajar con referencias

Comprender las configuraciones regionales

Formatos de entrada

Casos de uso comunes

Recursos adicionales