Uso de Sanity en Agents

​

Conceptos clave

​

Documentos y tipos

​

Datasets

​

Borradores frente a publicados

• Los documentos publicados tienen un ID simple (por ejemplo, abc123)
• Los documentos en borrador tienen el mismo ID con el prefijo drafts. (por ejemplo, drafts.abc123)

​

Trabajar con Portable Text (texto enriquecido)

​

Proporcionar contenido de texto enriquecido

{
  "body": "<h1>Welcome</h1><p>This is a <strong>blog post</strong> with <em>formatting</em>.</p><ul><li>First item</li><li>Second item</li></ul>"
}

{
  "_type": "post",
  "title": "My Post",
  "body": [
    {
      "_type": "block",
      "_key": "abc123",
      "style": "normal",
      "markDefs": [],
      "children": [
        {
          "_type": "span",
          "_key": "def456",
          "marks": [],
          "text": "Hello world"
        }
      ]
    }
  ]
}

​

Asignar esquemas de Sanity a pasos de Agent

​

Ejemplo: esquema de entrada de blog

// In your Sanity Studio schema
defineType({
  name: 'post',
  title: 'Post',
  type: 'document',
  fields: [
    defineField({ name: 'title', type: 'string' }),
    defineField({ name: 'slug', type: 'slug' }),
    defineField({ name: 'author', type: 'reference', to: [{ type: 'author' }] }),
    defineField({ name: 'body', type: 'blockContent' }),
    defineField({ name: 'publishedAt', type: 'datetime' }),
    defineField({ name: 'categories', type: 'array', of: [{ type: 'reference', to: [{ type: 'category' }] }] }),
  ],
})

​

Configuración paso a paso

1. Agrega un paso Create Resource a tu Agent y selecciona tu proyecto de Sanity conectado en el menú desplegable Sanity Project.
2. Selecciona el Dataset en el menú desplegable (por ejemplo, production).
3. Completa Document Details con los campos de tu documento en formato JSON. Aquí es donde proporcionas valores simples como títulos, slugs, referencias y categorías:
   {
     "_type": "post",
     "title": "My Post Title",
     "slug": {
       "_type": "slug",
       "current": "my-post-title"
     },
     "author": {
       "_type": "reference",
       "_ref": "author-id-123"
     },
     "publishedAt": "2025-01-15T10:30:00Z",
     "categories": [
       {
         "_type": "reference",
         "_ref": "category-id-456"
       }
     ]
   }
   
   Para usar valores dinámicos de pasos anteriores, escribe / dentro del campo para abrir el menú de variables y selecciona una variable. Aparecerá como una insignia en línea con tu JSON. Por ejemplo, podrías reemplazar "My Post Title" con una variable de un paso de LLM anterior.
4. Completa Rich Text Content para cualquier campo de Portable Text (como el cuerpo de un blog). Asigna el nombre del campo a una cadena HTML. Profound la convierte automáticamente al formato de Sanity:
   {
     "body": "<h1>Welcome</h1><p>This is my post content.</p>"
   }
   
   También puedes insertar aquí una variable para pasar HTML generado por un paso anterior. Escribe / para abrir el menú de variables y selecciona como valor la salida de un LLM u otro paso anterior.
5. Marca o desmarca Publish Resource — márcalo para publicar de inmediato, o déjalo sin marcar para crear un borrador y revisarlo en Sanity Studio.

​

Referencia de tipos de campo

​

Flujos de trabajo comunes

​

Generar y publicar una entrada de blog

1. Paso de LLM — Genera un título, un slug y un cuerpo HTML a partir de un prompt
2. Create Resource — Crea un documento post de Sanity con el contenido generado
3. Publish Resource — Publica el borrador (o establece publish_resource: true en el paso 2)

​

Actualizar contenido existente

1. Get Resource — Obtén el documento actual por su ID
2. Paso de LLM — Genera contenido actualizado basado en el documento existente
3. Update Resource — Modifica solo los campos que cambiaron

​

Migración de contenido

1. List Resources — Obtén documentos de un dataset
2. Loop — Itera sobre la lista
3. Create Resource — Crea cada documento en un dataset diferente

​

Flujo de revisión de borradores

1. Create Resource — Crea contenido como borrador (comportamiento predeterminado)
2. Revisión humana — Paso de revisión manual en Sanity Studio
3. Publish Resource — Publica los borradores aprobados mediante el Agent

​

Permisos y roles

​

Solución de problemas

​

Recursos adicionales

• Sanity Content Lake — Comprender los datasets y los documentos
• Portable Text — Especificación del formato de texto enriquecido de Sanity
• GROQ Query Language — Consultar contenido en Sanity
• HTTP API Reference — Documentación completa de la API de Sanity
• Mutations API — Crear, actualizar y eliminar documentos