title:

"Integracion de adjuntos: adjuntar capturas de pantalla y documentacion",

summary:

"Como DevSpeak procesa archivos subidos, cuando usa procesamiento inline o flujos documentales y que metadatos de adjuntos conserva.",

category: "advanced-configuration",

tags: [

"attachments",

"uploaded-files",

"document-translation",

"attachment-manifest",

"file-context",

],

lastReviewed: "2026-04-08",

};

Integracion de adjuntos: adjuntar capturas de pantalla y documentacion

Los adjuntos aportan mas contexto que el texto plano por si solo. Son especialmente utiles cuando una solicitud depende de estructura UI, markdown existente, diagramas, capturas o documentos fuente que deben influir en la salida.

Que cubre esta pagina

  • Que tipos de archivo funcionan bien como adjuntos.

  • Como DevSpeak decide entre procesamiento inline y flujos documentales.
  • Que metadatos se conservan al guardar una traduccion con adjuntos.

    • Por que usar adjuntos?

    Los adjuntos son una herramienta potente para aportar contexto visual e informacion complementaria que puede resultar dificil de transmitir solo con texto. Por ejemplo, una captura de pantalla de una interfaz de usuario puede ayudar al LLM a comprender la disposicion y la funcionalidad de una solicitud de funcionalidad.

    Como adjuntar archivos

    Para adjuntar un archivo, arrastralo al workspace de traduccion o usa el control de carga antes de generar salida. DevSpeak admite formatos comunes de imagen, markdown, texto plano y flujos documentales mas grandes como PDF.

    Rutas de procesamiento

    DevSpeak no trata todos los archivos de la misma manera.

  • Imagenes, PDFs y activos de texto: Pueden enviarse inline cuando la ruta de generacion lo permite.
  • Documentos completos: Traducir un archivo PDF, Markdown o TXT completo desde Translate Files se procesa mediante document jobs asincronos.
  • Uploads con historial: Los metadatos de adjuntos se guardan junto a la traduccion para reabrirla despues sin perder contexto.

    • Impacto en la salida

    Los adjuntos no se tratan como elementos decorativos. Pasan a formar parte del contexto que moldea la especificacion, el prompt o la salida refinada.

  • Una captura puede fijar detalles de UI e interacciones.
  • Un archivo markdown o de texto puede preservar terminologia que debe pasar a la salida.
  • Un document job puede extraer material grande y recomponer la salida traducida por chunks.

    • Metadatos guardados

    Cuando una traduccion se persiste, DevSpeak guarda referencias con campos como uploadedFiles y attachmentManifest. Esto permite hidratar registros historicos y reabrir sesiones con el mismo contexto de apoyo.

    Buenas practicas

    Al adjuntar archivos, ten en cuenta las siguientes buenas practicas:

  • Proporciona imagenes claras y de alta calidad: Asegurate de que las capturas de pantalla y los diagramas sean legibles y relevantes para la solicitud de traduccion.
  • Usa nombres de archivo descriptivos: Pon a tus archivos nombres significativos que indiquen claramente su contenido y proposito.
  • Mantén el set intencional: Agrega solo los archivos que mejoren el contexto; los uploads irrelevantes ralentizan el flujo y diluyen el prompt.