Puerta de clave API de IA y disponibilidad del asistente
La puerta de clave API es la pantalla que muestra cualquier asistente de Senzoukria cuando la máquina no tiene nada capaz de responder: recoge una clave de Claude o de Groq, la guarda en el llavero del sistema operativo y se abre en cuanto hay un motor disponible.
Senzoukria · Documentación · Actualizado en septiembre de 2026
Dónde encontrarlo
- Dónde
- Página del agente de IA, y los asistentes de Gráfico, Backtest, Script, Informe y Conexión, hasta que haya un motor disponible
- Claves aceptadas
- Clave de Claude (empieza por sk-ant-) o clave de Groq (empieza por gsk_)
- Almacenamiento
- Llavero del sistema operativo; la aplicación nunca la escribe en disco
- Motor por defecto
- claude (valor por defecto del store de motores); guardar una clave de Groq cambia el motor a groq
Qué hace
La puerta es una sola tarjeta titulada «Despierta a Sen». Tiene un único trabajo: recoger una clave API para que el asistente pueda responder. El formulario de Claude admite una clave que empieza por sk-ant-; el texto bajo el título indica que la clave se guarda en el llavero de tu sistema operativo, nunca se escribe en disco y no se envía a ninguna parte salvo a api.anthropic.com. Un segundo formulario, presentado con «o empieza gratis con Groq», admite una clave que empieza por gsk_ y, si funciona, cambia el motor a Groq. Los dos formularios mantienen su botón desactivado hasta que se han escrito al menos 8 caracteres y muestran «Guardando…» mientras se guarda la clave.
La puerta no es el único camino. El hook de disponibilidad (useAssistantReady) pregunta primero si existe una clave de Claude; si existe, el asistente está listo. Si no, sondea el motor local en la URL base configurada y declara el asistente listo cuando el motor es accesible y lista al menos un modelo. Una máquina con un modelo local que funciona no ve nunca la puerta, ni siquiera sin ninguna clave.
La elección de motor no se hace aquí. La tarjeta no contiene ningún selector de modelo a propósito: una versión anterior tenía uno, pero nada leía esa elección, así que se quitó. El motor se elige en el selector de modelo de la cabecera del chat, una vez pasada la puerta.
Ajustes
| Ajuste | Por defecto | Qué cambia |
|---|---|---|
| Campo de clave de Claude | vacío, marcador sk-ant-… | Guarda la clave en el llavero y marca el asistente como disponible |
| Campo de clave de Groq | vacío, marcador gsk_… | Guarda la clave de Groq y fija el motor en groq |
| Envío activado | a partir de 8 caracteres sin espacios | Evita guardar una clave visiblemente truncada |
| Atajo por motor local | sondeo solo cuando no hay clave de Claude | Abre la puerta cuando un motor local accesible lista al menos un modelo |
| Nueva medición de disponibilidad | al cambiar de motor o de URL base | Cambiar a un modelo local repite el sondeo en vez de conservar un veredicto antiguo |
Cómo usarlo
- Consigue una clave de Claude en console.anthropic.com (enlace en la tarjeta), pégala y pulsa «Despierta a Sen».
- O consigue una clave gratuita en console.groq.com, pégala en el segundo formulario y pulsa «Usar Groq (gratis)». El motor responde entonces con modelos abiertos como Llama 3.3 70B.
- Si prefieres ejecutar un modelo local, configúralo en el selector de modelo: cuando el sondeo encuentra un modelo, la puerta desaparece sin ninguna clave.
- La misma puerta aparece en los cinco asistentes secundarios (scripting, backtest, gráfico, informe, conexión). Pasarla una vez la pasa en todos, porque todos usan la misma regla de disponibilidad.
Límites y trampas
- La clave es tuya y el proveedor le factura cada mensaje. La tarjeta indica que la clave de Claude no se envía a ninguna parte salvo a api.anthropic.com; la aplicación no añade ninguna cuota propia.
- La puerta no prueba una clave guardada. Usa la acción «Probar este motor» en los ajustes del motor para medir si el proveedor responde de verdad.
- Un error al guardar se muestra bajo el formulario como la cadena de error en bruto; el botón se reactiva para que puedas reintentar.
- La vía de Groq no lee capturas y el proveedor la limita por minuto; el selector de modelo lo indica.
Páginas relacionadas
Esta página en otros idiomas
Preguntas frecuentes
- ¿Dónde se guarda mi clave API?
- En el llavero del sistema operativo. La aplicación no la escribe en disco y solo la usa desde esta máquina, como indica el texto de ajustes «Clave guardada en el llavero».
- ¿Puedo usar el asistente sin ninguna clave API?
- Sí, con un modelo local. La comprobación de disponibilidad sondea el motor local cuando no hay clave de Claude y abre la puerta en cuanto el motor es accesible y lista al menos un modelo.
- ¿Por qué la puerta no me deja elegir un modelo?
- El selector de modelo vive en la cabecera del chat, una vez pasada la puerta. La puerta solo recoge una clave; el selector anterior de esa tarjeta se quitó porque no controlaba nada.