Crear plantilla
Crea una plantilla de IDP desde cero, con nombre y documento de referencia, o importa una plantilla exportada en JSON, revisando las conexiones del workspace.
Crear plantilla
Para crear una plantilla, ve a la pestaña Archivos del workspace, abre el menú Crear y elige Plantilla IDP — "Extrae datos de facturas, formularios y PDFs". Hay dos formas de empezar: Desde cero o Importar archivo.
Solo los desarrolladores y administradores del workspace pueden crear plantillas de IDP. Consulta Funciones y permisos.
Desde cero
Ponle un nombre a la plantilla, sube un documento de ejemplo y arma el pipeline en el editor.
| Campo | Obligatorio | Descripción |
|---|---|---|
| Nombre | Sí | De 3 a 80 caracteres. Aparece en el árbol de archivos y en todas las pantallas de la plantilla. |
| Descripción | No | Hasta 500 caracteres. Ayuda a tus compañeros a entender para qué sirve la plantilla. |
| Workspace y Crear en | Sí | El workspace y la carpeta donde se crea la plantilla. La carpeta por defecto es la raíz. |
| Documento de referencia | Recomendado | Un PDF, PNG o JPG de hasta 15 MB. Se usa en la identificación y como base del playground. |
El documento de referencia debe ser un ejemplo típico del documento que recibirá la plantilla. Sin él, la identificación compara el documento recibido solo con el tipo y los criterios que describas. Se puede subir o reemplazar después, en la etapa Documento del constructor. Consulta Documento y páginas.
Haz clic en Crear plantilla para terminar. La plantilla se abre en una nueva pestaña del editor. Si la plantilla se crea pero la subida del documento falla, súbelo desde la etapa Documento.
Importar una plantilla exportada
Usa esta opción para traer una plantilla exportada desde otro workspace, o una copia que guardaste. El archivo es el JSON generado por Exportar JSON en la configuración de la plantilla. Consulta General.
- Archivo — suelta o elige el JSON exportado. Un archivo que no sea la exportación de una plantilla de IDP se rechaza. El nombre de la plantilla viene rellenado con el nombre guardado en el archivo y se puede cambiar (mínimo de 3 caracteres). Elige también el workspace y la carpeta de destino.
- Verificación — antes de crear nada, Roberty comprueba si las conexiones usadas en el archivo existen en este workspace y muestra en qué etapas se usa cada una: Modelo predeterminado, Identificación, Extracción (LLM OCR) y Posprocesamiento. Para cada conexión que falta, elige una conexión de este workspace para reemplazarla.
- Haz clic en Importar.
Puedes importar sin resolverlo todo: las conexiones que no pertenecen a este workspace se eliminan y deben elegirse después en el editor. Si no se pueden verificar las conexiones, la importación sigue disponible igualmente.
La plantilla importada recibe la configuración del archivo: el pipeline completo, las validaciones y el modelo predeterminado. El documento de ejemplo se copia si tienes acceso a la plantilla de origen; si no, sube uno en la etapa Documento.
El archivo exportado puede contener credenciales usadas en las validaciones por API. Trátalo como un dato sensible.
Después de crearla
Una plantilla recién creada ya se puede probar, pero todavía no atiende llamadas de producción. Para llegar ahí:
- Arma el pipeline — páginas, filtros, identificación, extracción, posprocesamiento y validaciones. Consulta Constructor.
- Prueba el borrador en el Playground y en Simular API. Consulta Playground y Simular API.
- Publica una versión y déjala activa. Consulta Versiones.
- Llama a la plantilla por la API, desde un robot o desde un agente. Consulta Usar plantillas en automatizaciones.