Saltar al contenido principal

Conectar un proveedor de IA

Objetivo​

Apuntar la plataforma a un modelo de IA, una sola vez y para toda la organización, de modo que el botón IA de cada diseñador genere un diseño a partir de una frase y el asistente de la pantalla de inicio pueda responder preguntas y construir cosas por usted.

Requisitos previos​

  • Ha iniciado sesión en el Centro de control de administración como administrador de la plataforma.
  • Tiene una cuenta con un proveedor de IA y una clave de API suya, o un modelo que se ejecuta en un servidor propio (Ollama, LM Studio) y que no necesita clave.

Pasos​

  1. Abra Configuración (el engranaje de la barra superior, en cualquier pantalla) y elija la pestaña IA. Si todavía no se ha configurado nada, la pestaña se abre con Anthropic y el modelo claude-opus-5 ya rellenado, así que conectarse a Claude consiste solo en los pasos 4 y 5.
  2. Elija el Proveedor:
    • Anthropic para Claude. Hay un único punto de conexión, así que no se pide ninguna raíz, y el modelo recomendado se rellena automáticamente.
    • Compatible con OpenAI para el propio OpenAI, OpenRouter, Ollama, LM Studio y cualquier otro que use el mismo contrato /chat/completions. Después, rellene la Raíz de la API: la raíz, no el punto de conexión completo: https://api.openai.com/v1 (se rellena automáticamente), https://openrouter.ai/api/v1 o http://localhost:11434/v1.
  3. Compruebe el Modelo: escríbalo exactamente como lo escribe el proveedor: claude-opus-5, gpt-4o, llama3.1. Al cambiar de proveedor se rellena el modelo predeterminado de ese proveedor, pero nunca se sustituye uno que haya escrito usted. Dejarlo en blanco desactiva la IA para su organización.
  4. Pegue la Clave de API. Déjela en blanco para un servidor local que no la necesite. Para Claude, consulte más abajo Obtener una clave de API de Anthropic.
  5. Seleccione Guardar y, después, Probar conexión. La prueba hace una pequeña llamada con lo que ha guardado y muestra la respuesta del propio modelo, así que un resultado en verde significa que el proveedor respondió de verdad.

Obtener una clave de API de Anthropic (Claude)​

Una clave de API no es lo mismo que una suscripción a claude.ai. Iniciar sesión en claude.ai da a una persona un chat; la plataforma necesita una clave de la Claude Console, que es una cuenta de desarrollador independiente, de pago por uso, que factura a la organización lo que generan sus usuarios.

  1. Vaya a platform.claude.com e inicie sesión, o cree una cuenta. Si su empresa ya tiene una organización en la Console, pida a su administrador que le invite a ella en lugar de crear una segunda: la clave debe pertenecer a la organización que paga.
  2. Añada la facturación en Settings → Billing. Una cuenta nueva tiene que tener un método de pago o créditos de prepago antes de que sus claves respondan; una clave sin crédito hace fallar la prueba de conexión con un error de facturación, no de autenticación.
  3. Abra Settings → API keys (platform.claude.com/settings/keys) y pulse Create key. Dele un nombre que indique dónde se usa (Parsware platform), elija una caducidad y establezca la Linked account: para una plataforma compartida, es preferible una clave de cuenta de servicio a una personal, porque una clave personal deja de funcionar el día que su propietario deja la organización.
  4. Copie la clave de inmediato. Empieza por sk-ant- y la Console la muestra completa una sola vez, al crearla; si se pierde, cree otra en lugar de buscarla.
  5. De vuelta en la plataforma, péguela en Clave de API, seleccione Guardar y después Probar conexión.

Guarde la clave en un solo sitio. La plataforma la guarda en el servidor y nunca la devuelve a un navegador; no la guarde además en un documento o en un chat. Si alguna vez se filtra, revóquela en la misma página de la Console y pegue aquí una nueva: no hay que cambiar nada más.

Qué ocurre entre bastidores​

La clave nunca vuelve al navegador. Después de guardar, la pestaña solo muestra que hay una clave guardada y sus cuatro últimos caracteres. Un cuadro de clave vacío en un guardado posterior significa conservar la que está guardada; para quitarla, use Quitar la clave guardada y guarde.

La configuración es de su organización, no de cada persona. Todos en la organización generan con el mismo modelo, y el coste va a la misma cuenta. Antes de que existiera esta pestaña, el proveedor lo establecía quien instalaba la plataforma, en su configuración; esos valores siguen siendo la alternativa de reserva y se muestran aquí como punto de partida hasta que guarde los suyos; la línea de la parte superior de la pestaña indica cuál está en vigor.

Los dos límites están ahí para las respuestas descontroladas. Respuesta más larga limita una respuesta en tokens; Abandonar tras es cuánto puede durar una llamada antes de que la plataforma deje de esperar. Los valores predeterminados sirven para generar un proceso o un informe; auméntelos solo si una prueba indica que una respuesta se cortó.

Dónde se usa​

  • El botón IA de los diseñadores de procesos, informes, paneles y Studio: describa lo que quiere y se genera un diseño, se comprueba con el esquema propio del diseño y se carga en el lienzo.
  • El asistente de la pantalla de inicio, que puede leer lo que hay en el entorno y, cuando usted lo permite, construir tablas, aplicaciones y soluciones completas.