Merge pull request #47 from Salomon-Mazatlan/patch-18

Update 6.2.-AI-Prompt-Library.md

Author: ccbogel

docs/doc/es/6.2.-AI-Prompt-Library.md

@@ -2,60 +2,83 @@
 path: 6.2.-AI-Prompt-Library
 ---
 
-# AI Prompt Library
+# Biblioteca de instrucciones (_prompts_) de IA
 
-- Prompts play an important role in any type of qualitative data analysis working with large language models. Prompts tell the AI how to analyze your data and respond to your queries. They are written in natural language and are easy for non-programmers to understand.
+- Las instrucciones (_prompts_) desempeñan un papel fundamental en cualquier tipo de análisis de datos cualitativos que utilice modelos de lenguaje de gran tamaño (LLM). Estas le indican a la IA cómo analizar tus datos y cómo responder a tus consultas. Están escritas en lenguaje natural, por lo que son fáciles de entender incluso para quienes no tienen conocimientos de programación.
 
-- In QualCoder, the prompts underlying the AI features are accessible in the user interface. They can be customized to fit your methodological approach and research questions. 
+- En _QualCoder_, las instrucciones (_prompts_) que sustentan las funciones de IA son accesibles desde la interfaz de usuario. Puedes personalizarlas para que se ajusten a tu enfoque metodológico y a tus preguntas de investigación. 
 
-- We have already included some interesting prompts from other qualitative researchers that have been published in various places. We hope that the growing use of AI in qualitative research will be accompanied by a culture of developing, sharing, and discussing sophisticated prompts in the scientific community, so that we can all learn from each other and improve the emerging new methods in the field.
+- Hemos incluido algunas instrucciones (_prompts_) interesantes de otros investigadores cualitativos que han sido publicadas en diversos medios. Esperamos que el uso creciente de la IA en la investigación cualitativa vaya acompañado de una cultura de desarrollo, intercambio y discusión de instrucciones (_prompts_) sofisticadas dentro de la comunidad científica; de este modo, podremos aprender unos de otros y mejorar los nuevos métodos emergentes en este campo.
 
-## The Structure of a Prompt
+## Estructura de una instrucción o _prompt_
 
-In a very basic sense, a "prompt" is like the question you type into the web interface of ChatGPT. But even in this case it's a bit more complex. In the background, ChatGPT will accompany your question with an invisible "system prompt" that instructs the AI to be a helpful and supportive assistant, not to give medical or legal advice, etc. 
+En un sentido muy básico, una instrucción (_prompt_) es como la pregunta que escribes en la interfaz web de ChatGPT. Sin embargo, incluso en ese caso, el proceso es un poco más complejo. En segundo plano, ChatGPT acompaña tu pregunta con un "_prompt_ de sistema" invisible que instruye a la IA para ser un asistente útil, no dar consejos médicos o legales, etc. 
 
-Similarly, the prompts in QualCoder are **modular** and consist of several different elements, some of which you can change and some of which you cannot. 
+De manera similar, los _prompts_ en _QualCoder_ son **modulares** y constan de varios elementos distintos; algunos los puedes modificar y otros no. 
 
-This is the basic structure:
+Esta es la estructura básica:
 
 <img src="https://github.com/user-attachments/assets/b77df95d-f5b3-4ffa-8d3a-a511c82ef9ab" width=500em>
 
-This structure consists of 
+Esta estructura se compone de:
 
-- **fixed elements** (shown here in white on blue) that are defined in the source code of the application,
-- **contextual information** (here in green) that you enter at various places in QualCoder's user interface, such as code names and memos, or the project memo with important information about your research,
-- **empirical data** (here in yellow), selected in various ways, and
-- the **analytic prompt** (shown in orange), which you can modify and adapt to your needs.
+- **Elementos fijos** (mostrados aquí en blanco sobre azul): están definidos en el código fuente de la aplicación.
+- **Información contextual** (en verde): es la información que introduces en varios apartados de la interfaz de _QualCoder_, como los nombres de los códigos y sus memos, o el memo del proyecto con datos relevantes sobre tu investigación.
+- **Datos empíricos** (en amarillo): seleccionados de diversas formas, y
+- El **_prompt_ (instrucción) analítico** (en naranja): es el que puedes modificar y adaptar a tus necesidades.
 
-## Analytic prompts
+## Instrucciones analíticas
 
-Analytic prompts are the **core of QualCoder's AI features.** They instruct the AI on how to analyze your data. These instructions can be quite simple, but can also grow into complex guidelines with detailed descriptions of each step the AI should perform during the analysis, including methodological background, etc. (see Lieder & Schäffer, 2024).<sup>1</sup>
+Las instrucciones analíticas son el núcleo de las funciones de IA de _QualCoder_. Instruyen a la IA sobre cómo debe analizar tus datos. Estas instrucciones pueden ser bastante sencillas, pero también pueden convertirse en guías complejas con descripciones detalladas de cada paso que la IA debe realizar durante el análisis, incluyendo el trasfondo metodológico, entre otros aspectos (ver Lieder & Schäffer, 2024).<sup>1</sup>
 
-QualCoder comes with a set of predefined analytic prompts. But you can also define your own - either by clicking on the "Edit" button next to the prompt selection or by navigating to the "Prompt library" located in the "AI" menu. This will open the following window:
+_QualCoder_ incluye un conjunto de instrucciones analíticas predefinidas. Sin embargo, también puedes definir las tuyas, ya sea haciendo clic en el botón "Editar" junto a la selección de instrucción o navegando a la "Biblioteca de instrucciones (_prompts_)" ubicada en el menú "IA". Esto abrirá la siguiente ventana:
 
-<img src="https://github.com/user-attachments/assets/530f0c1e-f1c3-4827-9dad-1295ea70c18b" width=800em>
+<img width="872" height="581" alt="image" src="https://github.com/user-attachments/assets/e4305396-43de-4a1d-a998-aaf7280041c6" />
 
-The prompts are divided into several categories:
+Las instrucciones se dividen en varias categorías y subcategorías:
 
-1) **Type**
-    - **Search** prompts are used in the [AI assisted coding](https://qualcoder-org.github.io/doc/en/4.2.-AI-Assisted-Coding), 
-    - **Code, Topic and Text Analysis** prompts are used in the AI Chat window.
+1) **Tipo (Type)**
+    - Las instrucciones de **Búsqueda** (_Search_) se utilizan en la [codificación asistida por IA.](https://qualcoder-org.github.io/doc/es/4.2.-AI-Assisted-Coding).
+    - Las instrucciones de **Análisis** de código (_Code Analysis_), tema (_Topic Analysis_) y texto (_Text Analysis_) se utilizan en la pestaña del Chat IA.
 
-2) **Scope**
-    - **System** prompts are defined on the application level and cannot be altered directly. If you want to change a system prompt, you must duplicate it first. 
-    - **User** prompts are defined by the user and stored on their computer. They are available to any project opened on that computer.
-    - **Project** specific prompts are stored with the project files. If you or someone else opens the same project on a different computer, these prompts will be available there as well.
+Tabla detallada de tipo de instrucciones:
 
-3) **Prompt name and description**: These are displayed in several places in the user interface where you can select an analytic prompt. The names must be unique within each scope. 
 
-4) **Prompt text**: These are the actual instructions that will be sent to the AI (the orange box in the image above). If you want to share your prompt with someone else, this is the most important information you will need to send over.
+| Tipo de instrucción | Instrucciones analíticas | Resumen de funciones |
+|---------------------|--------------------------|----------------------|
+| **Búsqueda (Search)** | Focused Search (Búsqueda Enfocada) | Busca datos precisos sobre un tema bien definido. |
+|                     | Open Search (Búsqueda Abierta) | Recopila datos amplios y variados relacionados con un código. |
+|                     | Content Analysis with Coding Rules (Análisis de Contenido con Reglas de Codificación) | Sigue estrictamente las reglas del código definidas en el memo para analizar datos. |
+| **Análisis de Código (Code Analysis)** | Code Summary (Resumen de Código) | Resume los datos codificados con un código. |
+|                     | Code Critic (Crítica de Código) | Evalúa fortalezas y limitaciones de analizar los datos con un código; identifica puntos ciegos y posibles interpretaciones alternativas. |
+|                     | Analyze Unexpected (Analizar lo Inesperado) | Compara expectativas comunes con los datos reales y resalta resultados sorprendentes e inesperados. |
+|                     | Analyze Differences (Analizar Diferencias) | Busca y señala diferencias relevantes entre casos o documentos dentro de los datos codificados. |
+|                     | Question of Life (Pregunta de la Vida) | “La respuesta a la pregunta última de la vida, el universo y todo es 42.” |
+| **Análisis de temas (Topic Analysis)** | Topic Summary (Resumen Temático) | Resume los datos relacionados con un tema específico. |
+|                     | Analyze Unexpected (Analizar lo Inesperado) | Compara expectativas con hallazgos sorprendentes en los datos. |
+|                     | Analyze Differences (Analizar Diferencias) | Enfocado en diferencias entre casos o documentos respecto a un tema. |
+| **Análisis de Texto (Text Analysis)** | Interactive brainstorming with AI (Lluvia de Ideas Interactiva con IA) | Sesión de reflexión socrática con la IA para explorar datos y temas relevantes. |
+|                     | Paraphrase and summarize (Parafrasear y Resumir) | Parafrasea y resume los datos de forma condensada, sin interpretaciones ni conclusiones. |
+|                     | Themes generation (Generación de Temas) *(Friese 2024)* | Extrae y describe entre 2 y 10 temas recurrentes y distintos en los datos cualitativos. |
+|                     | Analyze the Unexpected (Analizar lo Inesperado) | Identifica temas interesantes, plantea expectativas y señala insights inesperados en los datos. |
+|                     | Reconstructive SRP *(Lieder/Schäffer 2024)* | Método documental para interpretación doble: **formulativa** (resumen claro sin conclusiones) y **reflexiva** (hipótesis sobre marcos implícitos, con citas textuales). |
 
 
-## A Note About Languages
+2) **Alcance (Scope)**
+    - **Las instrucciones de Sistema** están definidas a nivel de aplicación y no pueden modificarse directamente. Si deseas cambiar una instrucción de sistema, primero debes duplicarla. 
+    - **Las instrucciones de Usuario** son definidas por ti y se almacenan en tu computadora. Estarán disponibles para cualquier proyecto que abras en ese equipo.
+    - **Las instrucciones del Proyecto** se guardan junto con los archivos del proyecto. Si tú u otra persona abren el mismo proyecto en una computadora diferente, estas instrucciones también estarán disponibles allí.
 
-All predefined prompts in QualCoder are written in English. However, they can be applied to data in other languages as well. 
+3) **Nombre y descripción de la instrucción**: Estos se muestran en varios lugares de la interfaz donde puedes seleccionar una instrucción analítica. Los nombres deben ser únicos dentro de cada alcance. 
 
-It is also no problem to write analytic prompts in languages other than English and use them with QualCoder. Most large language models are quite flexible when it comes to mixing different languages. 
+4) **Texto de la instrucción**: Estas son las instrucciones reales que se enviarán a la IA (el recuadro naranja en la imagen anterior). Si deseas compartir tu instrucción (_prompt_) con alguien más, esta es la información más importante que deberás enviarle.
+
+
+## Una nota sobre los idiomas
+
+Todas las instrucciones predefinidas en _QualCoder_ están escritas en inglés. No obstante, pueden aplicarse a datos en otros idiomas sin inconvenientes. 
+
+Tampoco hay problema en que redactes tus propias instrucciones analíticas en idiomas distintos al inglés para usarlas en _QualCoder_. La mayoría de los modelos de lenguaje de gran tamaño son bastante flexibles al combinar diferentes lenguas. 
 
 
 &nbsp;