Proveedores y Cuotas

Almirant necesita un proveedor de inteligencia artificial para alimentar las funcionalidades de AI Planning y Agentes IA. Esta seccion explica como configurar tu proveedor, seleccionar modelos y gestionar el sistema de cuotas de tu organizacion.

Proveedores soportados

Actualmente Almirant soporta los siguientes proveedores:

Proveedor	Modelos disponibles	Caso de uso recomendado
OpenAI	GPT-4o, GPT-4o-mini, o1, o1-mini	Uso general, planificacion, generacion de codigo
Anthropic	Claude Sonnet 4, Claude Haiku	Analisis de codigo, razonamiento complejo, Q&A

Elegir proveedor

Ambos proveedores ofrecen resultados de alta calidad. Si no tienes preferencia, OpenAI GPT-4o es una buena opcion por defecto para uso general. Para tareas que requieren analisis profundo de codigo, Anthropic Claude suele dar mejores resultados.

Configurar un proveedor

Para conectar un proveedor de IA a tu organizacion:

1. Accede a Configuracion en el menu lateral.
2. Ve a la seccion Proveedores de IA (o AI Providers).
3. Selecciona el proveedor que quieres configurar (OpenAI o Anthropic).
4. Introduce tu API key del proveedor.
5. Selecciona el modelo que quieres utilizar por defecto.
6. Guarda la configuracion.

Obtener una API key

Proveedor	Donde obtenerla	URL
OpenAI	Dashboard de OpenAI, seccion API Keys	https://platform.openai.com/api-keys
Anthropic	Console de Anthropic, seccion API Keys	https://console.anthropic.com/settings/keys

aviso

La API key se almacena de forma segura en Almirant, pero solo se muestra una vez en el proveedor al momento de crearla. Asegurate de copiarla antes de cerrar la ventana del proveedor.

Cambiar de modelo

Puedes cambiar el modelo por defecto en cualquier momento desde la configuracion del proveedor. El cambio aplica a todas las nuevas ejecuciones de AI Planning y agentes. Los jobs que ya estan en ejecucion no se ven afectados.

Sistema de cuotas

Almirant implementa un sistema de cuotas por organizacion para controlar el consumo de tokens y evitar gastos inesperados.

Como funciona

• Cada organizacion tiene una cuota asignada que define el limite de tokens disponibles.
• Cada ejecucion de AI Planning o agente consume tokens que se descuentan de la cuota.
• El consumo se registra y es visible desde la configuracion de la organizacion.

Ver el uso de cuota

Para consultar el estado de tu cuota:

1. Accede a Configuracion > Organizacion.
2. Revisa la seccion Uso de IA o AI Usage.
3. Veras un resumen con:

Metrica	Descripcion
Cuota total	Limite de tokens disponible para la organizacion
Tokens consumidos	Total de tokens utilizados en el periodo actual
Cuota restante	Tokens disponibles antes de alcanzar el limite
Porcentaje de uso	Indicador visual del consumo relativo

Que sucede al agotar la cuota

Cuando la cuota se agota:

• AI Planning: No podras iniciar nuevas conversaciones de planificacion. Las conversaciones existentes mostraran un mensaje indicando que no hay cuota disponible.
• Agentes IA: Los nuevos jobs se encolan en estado pending y no se procesaran hasta que haya cuota disponible.
• Notificacion: Almirant notifica a los administradores de la organizacion cuando la cuota esta cerca de agotarse y cuando se agota.

aviso

Si tienes trabajo urgente que requiere IA y tu cuota esta agotada, contacta al administrador de tu organizacion para ampliar la cuota o espera a la renovacion del periodo.

Renovacion de cuota

La cuota se renueva segun el plan de la organizacion. Consulta con el administrador de la organizacion para conocer el ciclo de renovacion y los limites aplicables.

Buenas practicas

• Monitoriza el consumo regularmente -- Revisa el uso de cuota semanalmente para evitar sorpresas.
• Elige modelos eficientes para tareas simples -- Usa modelos mas ligeros (GPT-4o-mini, Claude Haiku) para tareas de Q&A o planificacion basica, y reserva los modelos premium para implementacion y review de codigo.
• Optimiza los prompts -- Prompts claros y concisos consumen menos tokens y producen mejores resultados.
• Configura alertas -- Activa las notificaciones de cuota para recibir avisos antes de quedarte sin tokens.

Para Developers

Herramientas MCP

Los siguientes tools estan disponibles via MCP para consultar el estado de cuotas:

Tool	Descripcion	Parametros principales
check_quota	Verifica si la organizacion tiene cuota disponible para una operacion	organizationId, estimatedTokens
get_quota_usage	Obtiene el detalle de consumo de cuota de la organizacion	organizationId, period

Ejemplo: Verificar cuota antes de ejecutar

Tool: check_quota
Parametros:
  organizationId: "uuid-de-la-organizacion"
  estimatedTokens: 5000

Devuelve { available: true, remainingTokens: 45000 } si hay cuota suficiente, o { available: false, remainingTokens: 200 } si no la hay.

Ejemplo: Consultar uso de cuota

Tool: get_quota_usage
Parametros:
  organizationId: "uuid-de-la-organizacion"
  period: "current"

Devuelve el detalle de consumo del periodo actual con desglose por tipo de operacion (planning, agents) y por proyecto.