Trae tu propio proveedor de IA

Archyl incluye funciones de IA para descubrimiento de arquitectura, análisis de ADR, chat, insights y agentes gestionados. Por defecto, todo esto corre en un modelo gestionado por Archyl. Las organizaciones que tienen una relación existente con un proveedor de IA — por razones de cumplimiento, contractuales o de residencia de datos — pueden enrutar cada petición de IA a través de su propio proveedor con sus propias credenciales.

Cuando BYO Provider está activado:

  • Cada función de IA se enruta a través del proveedor que configures
  • La aplicación de cuotas de Archyl (consultas de chat, descubrimiento de IA, ejecuciones de agentes) se omite — tu proveedor te factura directamente el uso de tokens
  • La selección de modelo por función te permite mezclar modelos (p. ej. Claude Sonnet para chat, Claude Opus para descubrimiento)

Es una configuración a nivel de organización; solo los administradores de la organización pueden configurarla.

Proveedores soportados

Proveedor Descripción Modelo por defecto
OpenAI API directa de OpenAI en api.openai.com gpt-5.6-luna
Anthropic API directa de Mensajes de Anthropic (Claude) claude-sonnet-4-6
Google API Generative Language de Google (Gemini) gemini-2.0-flash
AWS Bedrock API Bedrock Converse — cubre Anthropic Claude, Mistral, Llama, Titan, Cohere anthropic.claude-sonnet-4-20250514-v1:0
Compatible con OpenAI Cualquier endpoint que hable el formato OpenAI Chat Completions — Azure OpenAI, GitHub Models, OpenRouter, Mistral La Plateforme, Groq, Together AI, Fireworks, DeepInfra, vLLM, llama.cpp, etc. (específico del proveedor)

El adaptador compatible con OpenAI es una sola configuración que cubre una larga lista de proveedores. Proporcionas una URL base y una clave de API, y Archyl habla con el endpoint como si fuera OpenAI.

Configuración

Paso 1 — Abre la pestaña IA

Ve a Configuración de la organización → IA. La pestaña solo es visible para administradores.

Paso 2 — Elige un proveedor

Selecciona una de las cinco tarjetas de proveedor. Cada tarjeta tiene sus propios requisitos de credenciales:

  • OpenAI / Anthropic / Google — solo clave de API
  • Compatible con OpenAI — clave de API + URL base (p. ej. https://api.openrouter.ai/api/v1, https://api.mistral.ai/v1, https://models.github.ai/inference)
  • AWS Bedrock — credenciales en formato <access_key_id>:<secret_access_key> (con sufijo opcional :<session_token> para credenciales STS), más una región AWS (p. ej. us-east-1)

Paso 3 — Configura modelos por función (opcional)

Cada función de IA puede usar un modelo diferente. Deja cualquier campo en blanco para volver al default del proveedor.

Función Descripción
Chat Asistente de chat en streaming
Descubrimiento Descubrimiento de IA en todo el repositorio — requiere salida JSON fiable
Análisis de estructura Fase 1 del descubrimiento (sistema + contenedores)
Refinamiento de relaciones Fase 3 del descubrimiento (enlaces entre contenedores)
Análisis de ADR Extrae campos estructurados del markdown de ADR
Análisis de archivos Pasada de detalle por archivo
Generación de títulos de docs Generación por lotes de títulos para la documentación
Insights Insights de arquitectura generados por IA
Agentes gestionados Modelo usado por las ejecuciones de agentes gestionados (ver Agentes gestionados)

Usa el identificador exacto de modelo según lo publica el proveedor (claude-opus-4-5, gpt-4o, mistral-large-latest, anthropic.claude-sonnet-4-20250514-v1:0, etc.). Archyl lo pasa directo.

Paso 4 — Prueba la conexión

Pulsa Probar conexión. Archyl emite una completion mínima contra el proveedor configurado con tus credenciales. Una marca verde confirma que las credenciales funcionan; un error muestra la respuesta del proveedor para que puedas corregir la configuración antes de guardar.

Paso 5 — Habilita y guarda

Marca Habilitar proveedor BYO para esta organización y pulsa Guardar ajustes. La siguiente petición de IA de cualquiera en la organización — chat, descubrimiento, ejecución de agente, importación de ADR — se enrutará a través de tu proveedor.

Comportamiento de cuotas

Cuando BYO Provider está desactivado (por defecto), el uso de IA cuenta contra la cuota mensual de tu suscripción:

  • Operaciones de descubrimiento de IA
  • Consultas de chat
  • Ejecuciones de agentes gestionados

Cuando BYO Provider está activado, las tres cuotas se omiten para la organización. Pagas a tu proveedor directamente por los tokens usados; Archyl ya no aplica límites a estas funciones. Tu suscripción por asiento sigue aplicando para todo lo demás (funciones de colaboración, límites de equipo, etc.).

La omisión surte efecto inmediatamente al activar el interruptor y se revierte inmediatamente al desactivarlo.

Seguridad

Las claves de API se cifran en reposo usando AES-256-GCM con la clave de cifrado de la plataforma. Nunca se devuelven en respuestas de API — una vez almacenadas, la UI muestra •••••••• junto con un indicador "clave guardada", y la clave solo se descifra en proceso cuando se necesita hacer una petición de IA.

Para reemplazar una clave existente, escribe el nuevo valor y guarda. Para borrarla por completo, pulsa Eliminar configuración, lo que elimina la entrada y revierte la organización a la IA gestionada por la plataforma.

Solo los administradores de la organización pueden leer o modificar estos ajustes. Los miembros siguen usando las funciones de IA de forma transparente — el enrutamiento es invisible para ellos.

Agentes gestionados

Cuando BYO Provider está activado, las ejecuciones de agentes gestionados se ejecutan íntegramente en tu proveedor, con tus credenciales. El modelo propio de Archyl nunca se usa como alternativa.

Proveedor Agentes gestionados Modelo
Anthropic Soportado Modelo de Agentes gestionados, o claude-sonnet-4-6
AWS Bedrock Soportado (modelos Anthropic Claude) Modelo de Agentes gestionados, o anthropic.claude-sonnet-4-20250514-v1:0; también funcionan los perfiles cross-región como eu.anthropic.claude-sonnet-4-5-20250929-v1:0
OpenAI Soportado Modelo de Agentes gestionados, o gpt-5.6-luna
Compatible con OpenAI Soportado si el endpoint implementa la OpenAI Responses API Modelo de Agentes gestionados — obligatorio, no hay valor por defecto
Google Aún no soportado —

Si el proveedor no puede ejecutar agentes, o no hay ningún modelo definido para un endpoint compatible con OpenAI, iniciar una ejecución falla con un mensaje explícito en lugar de ejecutarse con un modelo que no elegiste.

Solución de problemas

"Probar conexión" falla con 401 / 403. Vuelve a comprobar que la clave está pegada correctamente sin espacios alrededor. Para Bedrock, asegúrate de que el formato sea <access_key_id>:<secret_access_key> (separados por dos puntos) y que la región coincida con una región donde el modelo se haya habilitado en tu cuenta de AWS.

"baseUrl is required for openai_compatible provider". El campo URL base es obligatorio para el adaptador compatible con OpenAI. Debe apuntar a la raíz de la API, p. ej. https://api.openrouter.ai/api/v1 — sin /chat/completions al final.

El descubrimiento devuelve JSON inválido. Los prompts de Archyl están afinados para el modo JSON estricto de OpenAI. Algunos proveedores/modelos devuelven JSON dentro de bloques de código markdown o añaden comentarios. Cambia a un modelo con fiabilidad fuerte de modo JSON (p. ej. gpt-4o, claude-sonnet-4-6, gemini-2.0-flash) específicamente para las funciones Descubrimiento, Análisis de estructura y Refinamiento de relaciones — el chat y otras funciones son más permisivas.

El chat funciona pero el descubrimiento falla en Bedrock. Algunos IDs de modelos de Bedrock requieren Provisioned Throughput o perfiles de inferencia cross-región específicos. Comprueba que el modelo esté habilitado para tu cuenta en la consola de Bedrock y que la región elegida coincida con la disponibilidad del modelo.

Funciones relacionadas