# Claves de IA

Los módulos que usan inteligencia artificial funcionan con la cuenta propia
del negocio, no con una de la plataforma. Acá se cargan esas claves, una sola
vez, y todos los módulos las comparten.

La pantalla tiene **solo las dos keys** (OpenAI y Google): no se elige acá ni
proveedor ni modelo. Con qué modelo trabaja cada módulo se decide en la
pantalla de ese módulo (ver "Qué modelo usa cada módulo").

## Qué usa cada clave

**OpenAI** — es la principal:

- El **Agente IA**: responder por WhatsApp, transcribir notas de voz y leer
  las imágenes que manda el cliente.
- La **búsqueda semántica** del catálogo (encontrar por significado y no solo
  por texto exacto).
- La redacción de fichas de producto al publicar en **WooCommerce** y
  **Shopify**.
- La clasificación de productos para el feed de Meta, en **Integraciones →
  Catálogo (público y Meta)**.

**Google (Gemini)** — opcional, solo para el reconocimiento de productos por
foto del Agente IA. Sin ella el resto sigue funcionando igual.

## Qué modelo usa cada módulo

El modelo **no se elige acá**: cada módulo tiene su propio selector, porque
cada uso pide algo distinto (publicar le manda las fotos del producto al
modelo; conversar exige que sepa llamar herramientas para mirar stock o
pedidos). Una key no sabe para qué se la va a usar.

- **Agente IA** → `/agente/configuracion`, sección "Inteligencia artificial".
- **Catálogo (público y Meta)** → `/integraciones/meta-catalog`.
- **Tienda WooCommerce** → `/integraciones/woocommerce`.
- **Tienda Shopify** → `/integraciones/shopify`.

En todos es un desplegable de lista cerrada (no se escribe el nombre a mano) y
la lista ya viene filtrada por lo que ese módulo necesita. Hoy se ofrecen
`gpt-5.4-mini` (recomendado: rápido y barato), `gpt-4o-mini` (alternativa
económica de la generación anterior) y `gpt-4o` (más caro, para redacción
larga o casos complejos).

Dejar la opción **"Recomendado"** guarda el módulo sin modelo fijo: sigue al
recomendado del momento aunque cambie, sin volver a esa pantalla. Elegir el
recomendado por su nombre no es lo mismo — eso lo fija.

## Notas

- Las claves se guardan cifradas y nunca se vuelven a mostrar. Al editarlas,
  dejar el campo en blanco significa "no cambiar la que ya está".
- Para quitar una clave hay que marcar **Quitar la key guardada**: dejar el
  campo vacío no la borra.
- El consumo se factura en la cuenta de OpenAI o Google del negocio, según lo
  que cada módulo gaste.
- No hace falta tener contratado el Agente IA para cargar la clave: publicar
  el catálogo en una tienda también la necesita.

## Errores comunes

- **"Falta tu clave de IA" en Catálogo, WooCommerce o Shopify**: todavía
  no hay una API key de OpenAI cargada. La integración se puede configurar
  igual, pero publicar un producto va a fallar hasta cargarla.
- **El agente no responde**: si la clave está vencida o sin saldo en OpenAI,
  las conversaciones pasan a atención humana. Revisar el saldo de la cuenta.