Todo lo que puedes hacer con TICdoc

Nuevo en TICdoc 1.2

Documentación asistida por IA a partir de tu código

TICdoc puede construir un primer documento completo mediante el proveedor de IA que elijas. Admite OpenAI, Anthropic Claude, Google Gemini y servicios con una API compatible con OpenAI, incluidos servidores locales compatibles. Aunque la acción conserva el nombre «Rellena desde OpenAI», siempre utiliza el proveedor marcado como predeterminado en los ajustes.

La diferencia de la versión 1.2 es de dónde sale el contexto. Hasta ahora el modelo solo recibía el título y las notas del proyecto. Ahora puedes asociarle carpetas de código y TICdoc construye un índice local de lo que declaran, que pasa a formar parte de cada petición.

Al modelo se le indica explícitamente que el código es la fuente de verdad y que no invente unidades, clases ni métodos que no aparezcan en el índice. Solo se envían declaraciones y firmas: nunca el cuerpo de las rutinas.

Secciones con estructura: requisitos, casos de uso y glosario

Un requisito no es un párrafo. TICdoc lo guarda como registro, con su código, su título y su descripción, igual que los casos de uso —con sus pasos, actores y excepciones— y los términos del glosario. Por eso, en esas secciones la IA no escribe texto corrido: rellena las fichas.

En el menú contextual de una sección de requisitos funcionales, no funcionales, casos de uso o glosario aparece «Generar … con IA». El modelo responde en un formato estructurado, TICdoc crea los registros y después reconstruye el documento desde ellos, exactamente igual que si los hubieras escrito a mano. A partir de ahí se editan, reordenan y numeran con las herramientas de siempre.

• Los códigos (RF-001, RNF-001, CU-001…) los asigna TICdoc con el formato configurado en el proyecto, no el modelo.
• Los actores de los casos de uso se reutilizan: si «Usuario» ya existe en el proyecto, no se duplica.
• Lo generado se añade detrás de lo que ya hubiera, sin borrar ni modificar nada existente.
• Al generar el documento completo, estas secciones se rellenan también en una segunda pasada. Combinado con las plantillas de proyecto, un proyecto nuevo sale con su índice, su contenido, sus requisitos, sus casos de uso y su glosario.

Documentar una unidad concreta

Además de generar el documento completo, «Documentar una unidad con IA» permite elegir un archivo del índice y crear una sección que explique para qué sirve, de qué se ocupa cada tipo y cómo se usa. En este caso se envía el detalle completo de esa unidad, incluida su parte privada, porque lo que se pide es precisamente describir cómo está hecha por dentro.

Generaciones largas

• Reanudar. Si la generación se interrumpe, vuelve a lanzar la misma opción: detecta las secciones que quedaron vacías y continúa por ellas, sin rehacer el índice ni pisar lo ya escrito.
• Reintentos. Los errores pasajeros del proveedor —sin conexión, límite de peticiones por minuto o una caída momentánea— se reintentan automáticamente. Quedarse sin saldo no se reintenta, porque la respuesta sería la misma.
• Progreso y cancelación. Una ventana muestra la sección en curso y el avance, y permite cancelar. La cancelación surte efecto al terminar la sección que se esté generando; lo hecho hasta entonces queda guardado.
• Optimizar peticiones. Activando esta opción en Ajustes, cada sección recibe solo las unidades del proyecto y las declaraciones relacionadas con su título, en lugar de toda la estructura del código en cada petición. Reduce mucho el consumo por documento a cambio de un contexto más estrecho.

1. 1
   Configura el proveedorEn Ajustes → Proveedor IA, introduce tu clave, revisa la URL y elige el modelo. El botón «Modelos» consulta los disponibles.
2. 2
   Asocia el códigoCuanto mejor represente la carpeta el proyecto real, más concreta será la documentación. Se puede volver a leer en cualquier momento.
3. 3
   Describe bien el proyectoEl índice de código dice qué hay; el título y las notas dicen para qué. Los dos juntos producen el mejor resultado.
4. 4
   Revisa siempreComprueba exactitud, fuentes, privacidad y posibles costes. La IA crea un borrador, no una validación técnica.

Las claves API se guardan cifradas con la protección de datos de Windows y quedan vinculadas a tu cuenta y equipo. TICdoc también migra y cifra las claves guardadas por versiones anteriores.

Al generar el documento se envían al proveedor elegido el título, las notas, los nombres de sección, los prompts y —si has asociado carpetas de código— la estructura de tu código: nombres de unidades, tipos y firmas. Al modificar una sección también se envían su HTML actual y tu instrucción. Para código confidencial, configura un modelo local o un servidor compatible en tu red: en ese caso nada sale del equipo.