Chat de Assembly (Assembly Chat)
Abrir la aplicación: Conversa con un ensamblado .NET → (products.documentize.ai)
En una frase
Assembly Chat lee la API pública de un ensamblado de .NET (una DLL, un EXE o un paquete NuGet) y te permite escanearlo para obtener diagramas y tablas, hacerle preguntas en lenguaje llano, obtener estadísticas o comparar dos versiones para ver qué ha cambiado.
Qué lo hace único
La mayoría de las herramientas de «chat con el código» leen código fuente. Assembly Chat lee la biblioteca compilada, así que responde a partir de las firmas reales y los comentarios de documentación XML de la versión exacta que le das, y no a partir de una suposición sobre la biblioteca. Es además la única aplicación de esta familia que puede comparar dos versiones de un paquete antes de actualizar. Sus respuestas salen de un índice de búsqueda (RAG) construido a partir de tu ensamblado, y por eso las preguntas de seguimiento son rápidas: el escaneo se hace una vez y se reutiliza.
Cuándo usarlo y cuándo no
- Úsalo para aprender una dependencia que no conoces («¿cómo leo un documento y lo guardo como PDF con esta biblioteca?»), para obtener diagramas de clases para una revisión de diseño, o para ver qué eliminó o cambió una versión nueva de un paquete.
- Úsalo antes de actualizar: compara la versión que ejecutas con la que quieres.
- No sirve para tu propio código fuente → Code Graph mapea un repositorio, y Documentos del repositorio (Repo Docs) escribe su documentación.
- No sirve para bibliotecas que no sean de .NET. La página documenta solo ensamblados administrados de .NET.
Antes de empezar
- Un ensamblado administrado de .NET (
.dllo.exe), o el nombre de un paquete NuGet (y, opcionalmente, una versión). Las preguntas frecuentes de la página mencionan .NET Framework 4.6.2+, .NET Core 3.1+ y de .NET 5 a 8. - Lo que ve la IA: los tipos públicos y sus miembros públicos o protegidos. Los miembros internos y privados se omiten salvo que marques Include Internal.
- Para un Diff, o bien dos DLL, o bien el nombre y la versión del paquete para el «antes» y para el «después».
Paso a paso
- Abre Assembly Chat y elige un comando (Command; consulta la tabla de abajo). El valor por defecto es Scan.
- Indica la entrada: sube una DLL o escribe un paquete NuGet (y la versión de NuGet; déjala en blanco para la última).
- Para Chat, escribe tu pregunta en Query. Para Diff, rellena también el paquete y la versión del «después».
- Ejecútalo. En un chat, la respuesta aparece en un panel de chat.
- Haz preguntas de seguimiento en el mismo panel. El escaneo se reutiliza, así que las preguntas de seguimiento deberían responder mucho más rápido que la primera respuesta. New scan (o el botón de chat nuevo) empieza de nuevo.
Opciones explicadas
| Opción | Qué hace | Valor por defecto | Recomendado |
|---|---|---|---|
| Command: Scan (Escanear: generar UML y CSV) | Lee el ensamblado y produce fuentes de diagramas y tablas | seleccionado | Primer vistazo a una biblioteca |
| Command: Chat (hacer una pregunta) | Responde a tu pregunta a partir del ensamblado | – | Uso diario |
| Command: Stats (Estadísticas del ensamblado) | Cuenta y resume lo que contiene el ensamblado | – | Comprobación rápida del tamaño y la forma |
| Command: Diff (comparar dos versiones) | Compara un ensamblado «antes» y otro «después» e informa de los cambios en la API | – | Antes de actualizar |
| Query | Tu pregunta (solo Chat) | vacío | Nombra el tipo o la tarea: «¿cómo combino dos PDF?» |
| Paquete NuGet / Versión de NuGet | Descarga un paquete de nuget.org en lugar de una subida | en blanco | Deja la versión vacía para la última |
| Después del paquete NuGet / Después de la versión de NuGet | El segundo ensamblado de un Diff | en blanco | La versión a la que piensas pasar |
| Include Internal | Lee también los miembros internos | desactivado | Solo para bibliotecas que son tuyas |
| Comentarios de IA | Durante un escaneo, pide a la IA que escriba comentarios para los miembros | desactivado | Solo si la biblioteca tiene pocos comentarios de documentación (comprueba el efecto en la aplicación en funcionamiento) |
Una respuesta de chat puede venir con alternativas: otras respuestas candidatas en las que puedes hacer clic para volver a responder la misma pregunta con otra coincidencia principal.
Qué obtienes
- Scan: varios archivos, incluidas fuentes de diagramas UML (
.puml) y tablas CSV de tipos y miembros. Las representaciones SVG solo se generan cuando se le piden al proceso de trabajo (comprueba en la aplicación en funcionamiento si la página lo ofrece). - Chat: la respuesta como texto markdown en el panel de chat, con ejemplos de código y, cuando lo pides, diagramas.
- Stats: un informe de texto y un PDF del mismo.
- Diff: un informe markdown, un PDF del informe y archivos de diagramas con los cambios.
Calidad y límites
Generado por IA, pero basado en las firmas que realmente leyó. Aun así, puede juzgar mal a qué método te referías, así que trata los ejemplos de código como un buen primer borrador y compílalos. Solo se conoce la superficie pública: la IA no puede decirte qué hace un método por dentro más allá de sus comentarios de documentación. Qué se envía a un modelo: tu pregunta y los fragmentos de API coincidentes van al servicio de modelo de lenguaje que usa Documentize; el ensamblado en sí lo lee el escáner propio de la aplicación. La página dice que los metadatos extraídos se conservan solo temporalmente durante tu sesión y no se usan para entrenar modelos.
Funciona bien con
- Ejecuta antes de esta aplicación: Actualizador de NuGet (NuGet Updater) te dice qué está desactualizado; Assembly Chat te dice qué cambia la versión nueva.
- Ejecuta después de esta aplicación: Documentos del repositorio (Repo Docs) para documentar tu propio código.
- Relacionado: Confianza, verificación y límites de lo que produce la IA.
Errores frecuentes y soluciones
- «No se subió ninguna DLL y no se especificó ningún paquete NuGet» → indica una de las dos cosas.
- «Diff necesita una segunda DLL» → sube dos archivos o rellena el paquete del «después».
- Query está vacío → Chat necesita una pregunta.
- La respuesta menciona un tipo que no ves → puede que hayas escaneado otra versión; comprueba el campo de versión.
Lo mismo en otros canales
No verificado para esta aplicación. Consulta canales para ver qué existe para otras aplicaciones.
Pruébalo
Elige Scan, escribe Newtonsoft.Json como paquete NuGet y deja la versión vacía. Cuando termine el escaneo, cambia a Chat y pregunta: «¿Cómo serializo un objeto a una cadena JSON?». Después ejecuta Diff con dos versiones del mismo paquete y lee la lista de miembros modificados del informe.