IA (Claude / OpenAI / Gemini)
La IA de AppArch se configura una sola vez para toda la instalación, por el operador de la instalación. Los espacios de trabajo no pueden añadir su propia clave y no hay ninguna entrada de IA en Integrations.
Configuración
Sección titulada «Configuración»Abre Administration → Settings → Assistant (/management/settings/assistant) y define:
- Provider - Anthropic (Claude), OpenAI o Google (Gemini). Un proveedor cada vez.
- API key - la clave propia del operador; el proveedor factura el uso a esa cuenta.
- Models on offer - todos los modelos que esta instalación puede usar. El primero es el predeterminado. Si hay más de uno, los usuarios eligen por pregunta en la pestaña Ask de Archito.
- Offer the assistant to users - activa la pestaña Ask de Archito.
- Allow fix suggestions on findings - un interruptor aparte, porque cada propuesta envía un hallazgo al proveedor.
- Token budgets - topes diarios y semanales opcionales, por espacio de trabajo y para toda la instalación.
Todo está desactivado por defecto. Ni el asistente ni las propuestas de corrección pueden activarse hasta que el operador acepte, en la misma página, el acuerdo de tratamiento por IA.
La clave de API se cifra con la clave maestra de la instalación. Tras guardarla no vuelve a mostrarse; solo se ven sus cuatro últimos caracteres.
Qué la usa
Sección titulada «Qué la usa»| Función | La activa | Qué se envía al proveedor |
|---|---|---|
| Propuesta de corrección en hallazgos de ArchPilot y ArchScan | Operador: Allow fix suggestions | Clave de la regla, severidad, ruta del archivo y línea, mensaje del hallazgo y la sugerencia propia del analizador |
| Pestaña Archito → Ask | Operador: Offer the assistant | La pregunta y las cifras usadas para responderla (nombres de proyectos, recuentos de hallazgos, totales de análisis) |
| Veredictos de IA sobre comentarios de revisión de MR | Espacio de trabajo: ajustes de ArchPilot, opcional; requiere uno de los dos interruptores del operador | Los comentarios de revisión pendientes que se clasifican |
| Generador MD, modo IA | Operador: Allow fix suggestions | Los datos del proyecto, el borrador de la plantilla y una porción superficial del repositorio: descripción, topics, listado raíz, algunos archivos de manifiesto (p. ej. package.json, *.csproj, go.mod, truncados) y el README existente |
Ninguna envía el repositorio completo. Cómo lo ven los usuarios: Archito, el asistente.
Propuestas de corrección
Sección titulada «Propuestas de corrección»- La respuesta se escribe en el idioma del panel del lector (turco, inglés, alemán, francés, español, ruso, árabe, azerí; cualquier otro recurre al inglés), con el modelo predeterminado.
- Cada respuesta se guarda con el hallazgo, junto con proveedor, modelo, tokens de entrada y salida e idioma. La siguiente persona que abre el mismo hallazgo ve la respuesta guardada y no se gastan tokens otra vez. Regenerarla es una acción deliberada.
Generador MD
Sección titulada «Generador MD»Sin IA, el generador MD funciona en modo plantilla (solo inglés). Consulta Generador MD.
Límites
Sección titulada «Límites»- Límite de frecuencia: como máximo 30 llamadas de IA por espacio de trabajo y minuto, sumando todas las funciones. El contador está en Redis; si Redis no responde, el límite no se aplica.
- Presupuestos de tokens: por espacio de trabajo por día y por semana, y para la instalación por día y por semana.
0significa sin límite. El día se reinicia a medianoche UTC y la semana el lunes. El tope de la instalación siempre prevalece. Los presupuestos cuentan la pestaña Ask y la clasificación de comentarios de revisión.
La Api llama directamente al proveedor:
https://api.anthropic.comhttps://api.openai.comhttps://generativelanguage.googleapis.com
No hay ningún relé alojado por AppArch. En una red aislada, deja la IA desactivada: no tiene nada a lo que llegar.