Clave de IA (tu proveedor de inteligencia artificial)

Tu agente "piensa" con un modelo de lenguaje de un proveedor de IA. Orkestal no incluye ese consumo: usas tu propia cuenta con el proveedor, y él te cobra directamente según el uso. A esa credencial se le llama clave de API (API key).

Proveedores disponibles#

Conectar tu clave#

1. Abre Configuración (solo administradores).
2. En Proveedor de IA, elige OpenAI o Google Gemini.
3. Pega tu clave.
4. Pulsa Guardar Credenciales. Orkestal confirma con «Proveedor de IA configurado con éxito».

También puedes pedirle a Orki que la solicite: abre un campo seguro y enmascarado, y Orki nunca ve el valor.

Cuánto cuesta#

El costo depende de cuántas conversaciones atiendas y del modelo que uses. Orkestal no cobra ese consumo: lo cobra tu proveedor. Para controlar el gasto:

• Pon un límite de gasto en la cuenta de tu proveedor (OpenAI y Google lo permiten).
• Revisa el consumo en el panel de tu proveedor, no en Orkestal. Orkestal verifica que haya una clave configurada, no su saldo.

Seguridad de tu clave#

Las claves que configuras se almacenan cifradas y se usan únicamente para procesar los mensajes de tu propia cuenta. Mira Seguridad y privacidad.

Qué pasa si falta la clave#

• El panel muestra el aviso «Tu agente de IA no está activo» con un botón Configurar API Key.
• El agente no contesta a tus clientes; en el chat solo queda un aviso interno.
• Los documentos que subas a la base de conocimiento quedan en estado «Falta clave de IA» hasta que la configures; al guardar la clave, Orkestal reprocesa la base de conocimiento pendiente.

Si cambias de clave o de proveedor#

Basta con guardar la nueva en Configuración. Si rotaste o revocaste la clave anterior en tu proveedor, el agente deja de contestar hasta que guardes la nueva.

Problemas comunes#