# ¿Cómo se integra Hermes Agent con Atlas Cloud? > Conecta Hermes Agent a Atlas Cloud guardando la clave de Atlas Cloud en ~/.hermes/.env, seleccionando el proveedor: custom, configurando la URL base como https://api.atlascloud.ai/v1 y eligiendo un ID de modelo activo de /v1/models. Hermes Agent puede usar [Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud) como proveedor de inferencia personalizado compatible con OpenAI. La integración necesita tres cosas: una clave API de Atlas Cloud, la URL base `https://api.atlascloud.ai/v1` y un [ID de modelo de la lista de modelos de Atlas Cloud](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new). Una vez que estos están en la configuración actual de `model:` de Hermes Agent, el agente puede ejecutarse a través de Atlas Cloud sin un SDK específico del proveedor. > **Puntos clave** > > * Instala Hermes Agent con el instalador oficial, luego guarda la clave de Atlas Cloud en `~/.hermes/.env` en lugar de en el control de versiones. > * Configura Hermes Agent con `provider: custom` y `base_url: https://api.atlascloud.ai/v1`. > * Consulta `/v1/models` antes de elegir un modelo. Los nombres de los modelos cambian más rápido que el código de integración, por lo que la respuesta en vivo es más segura que copiar un ID antiguo de un tutorial. > * Ejecuta `hermes doctor` antes de iniciar un agente de larga duración, luego usa `hermes` para probar la primera conversación. > * La API unificada de Atlas Cloud permite cambiar el modelo de lenguaje más tarde sin reconstruir la integración de Hermes. ## ¿Qué son Hermes Agent y Atlas Cloud? [Hermes Agent](https://github.com/NousResearch/hermes-agent) es un agente de código abierto y auto-mejorable creado por Nous Research. Incluye una interfaz de terminal, memoria persistente, habilidades, automatizaciones programadas, pasarelas de mensajería y soporte para múltiples proveedores de inferencia. La documentación actual de Hermes Agent enfatiza que los modelos se pueden cambiar sin reescribir el agente. [La plataforma principal de Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud) expone cientos de modelos de lenguaje, imagen, video y audio a través de una API unificada. Para Hermes Agent, la parte importante es su superficie de inferencia compatible con OpenAI: Hermes puede tratar a Atlas Cloud como un proveedor personalizado y enviarle tráfico normal de chat-completion. Esta combinación es útil cuando deseas que Hermes Agent se mantenga independiente de un solo proveedor de modelos. La configuración del agente se mantiene estable, mientras que el modelo seleccionado de Atlas Cloud puede cambiar según los requisitos, el precio o la disponibilidad. ## Antes de empezar Necesitas: 1. Un entorno Linux, macOS, WSL2 o Windows compatible. 2. Una instalación funcional de Hermes Agent. 3. Una cuenta de Atlas Cloud y una clave API. 4. Suficiente saldo en Atlas Cloud o acceso a la cuenta para el modelo que selecciones. No pegues una clave API real en un repositorio público, incidencia, captura de pantalla o archivo de configuración compartido. Hermes Agent admite un archivo `.env` local precisamente para que los secretos puedan mantenerse separados de la configuración ordinaria. ## Paso 1: Instalar Hermes Agent En Linux, macOS o WSL2, usa el instalador publicado por Nous Research: ```bash curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash ``` Recarga tu shell después de la instalación: ```bash source ~/.zshrc ``` Si usas Bash, recarga `~/.bashrc` en su lugar. Luego confirma que la CLI está disponible: ```bash hermes --help ``` El proyecto oficial también admite Windows nativo a través de su instalador de PowerShell. Sigue la [documentación de instalación de Hermes Agent](https://hermes-agent.nousresearch.com/docs/) actual, en lugar de traducir tú mismo el comando Unix a PowerShell. ## Paso 2: Crear una clave API de Atlas Cloud Inicia sesión en la consola de Atlas Cloud y crea una clave API para esta implementación de Hermes Agent. Usa una clave dedicada cuando los controles de tu cuenta lo permitan; separar el tráfico del agente facilita la rotación posterior y la revisión del uso. Guarda la clave en el archivo de entorno local de Hermes Agent: ```bash printf '\nOPENAI_API_KEY=%s\n' 'reemplaza-con-tu-clave-de-atlas-cloud' >> ~/.hermes/.env ``` Reemplaza el marcador de posición localmente. No incluyas la clave real en `config.yaml` si ese archivo se va a respaldar, sincronizar o enviar a un repositorio. ¿Por qué usar `OPENAI_API_KEY`? La ruta de proveedor personalizado actual de Hermes Agent resuelve esa variable de entorno cuando se configura una URL base explícita compatible con OpenAI. Atlas Cloud usa autenticación de token portador en esa interfaz compatible. ## Paso 3: Obtener un ID de modelo vivo de Atlas Cloud No adivines el ID del modelo. Consulta la [lista de modelos de Atlas Cloud](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new), luego pregunta a la API por el catálogo actual: ```bash export ATLASCLOUD_API_KEY='reemplaza-con-tu-clave-de-atlas-cloud' curl https://api.atlascloud.ai/v1/models \ -H "Authorization: Bearer $ATLASCLOUD_API_KEY" ``` Elige un modelo de texto que admita el comportamiento que necesita tu implementación de Hermes, especialmente uso de herramientas, razonamiento, longitud de contexto y latencia esperada. Copia el `id` exacto devuelto por la API. Para un agente persistente, comienza con un modelo de propósito general con capacidad de herramientas en lugar de optimizar solo por el precio de token más bajo. Después de que la integración funcione, puedes probar modelos de menor costo para resúmenes u otras tareas rutinarias. ## Paso 4: Apuntar Hermes Agent a Atlas Cloud Abre `~/.hermes/config.yaml` y configura la sección `model:` de nivel superior actual: ```yaml model: default: "reemplaza-con-un-id-de-modelo-vivo-de-atlas-cloud" provider: "custom" base_url: "https://api.atlascloud.ai/v1" ``` Mantén la clave en `~/.hermes/.env`; el archivo YAML solo necesita el proveedor, el endpoint y el ID del modelo. Este detalle importa porque los ejemplos anteriores de Hermes Agent pueden usar un bloque `inference:`. La muestra de configuración oficial actual usa `model:`. Si tu versión instalada se comporta de manera diferente, ejecuta `hermes update` y consulta la documentación de configuración incluida con esa versión antes de cambiar más ajustes. ## Paso 5: Diagnosticar la configuración Ejecuta las comprobaciones integradas de Hermes Agent: ```bash hermes doctor ``` Luego inicia el agente: ```bash hermes ``` Envía una pequeña solicitud de prueba que no necesite herramientas externas, por ejemplo: ```text Responde con el nombre del modelo que estás usando, luego resume qué herramientas están disponibles en esta sesión de Hermes. ``` Una respuesta de flujo normal confirma que Hermes puede autenticarse, llegar al endpoint de Atlas Cloud y llamar al modelo configurado. ## Problemas comunes de integración ### Errores de autenticación Verifica que `OPENAI_API_KEY` exista en `~/.hermes/.env`, contenga la clave de Atlas Cloud sin comillas ni espacios adicionales, y que esté siendo cargada por la misma instalación de Hermes que estás ejecutando. Rota la clave si ha sido expuesta. ### Errores de modelo desconocido Llama a `https://api.atlascloud.ai/v1/models` nuevamente y copia el ID vivo exacto. No elimines un prefijo de proveedor ni acortes el identificador a menos que la propia respuesta de la API use la forma más corta. ### Hermes llama al proveedor incorrecto Confirma que la configuración activa contenga ambos: ```yaml provider: "custom" base_url: "https://api.atlascloud.ai/v1" ``` Seleccionar un proveedor integrado puede enrutar la solicitud al endpoint de ese proveedor en lugar de a Atlas Cloud. ### La configuración coincide con un tutorial antiguo pero falla Hermes Agent está evolucionando rápidamente. Compara tu archivo con la [referencia de configuración oficial](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) actual y usa `hermes config get` para inspeccionar el perfil activo. En particular, verifica si tu versión espera la estructura `model:` actual. ## Cómo cambiar modelos sin reconstruir la integración Una vez que Atlas Cloud está configurado como proveedor personalizado, cambiar de modelos solo requiere un nuevo ID del [catálogo de modelos en vivo](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new): 1. Consulta `/v1/models`. 2. Actualiza `model.default` en `~/.hermes/config.yaml`. 3. Ejecuta `hermes doctor`. 4. Inicia una nueva conversación de prueba. El endpoint y el manejo de credenciales siguen siendo los mismos. Este es el valor práctico de una API unificada para un agente: la evaluación de modelos se convierte en un cambio de configuración en lugar de una nueva integración de SDK. ## Cuándo esta configuración es adecuada La integración de Atlas Cloud es una buena opción cuando: * Quieres que Hermes Agent acceda a múltiples familias de modelos a través de una sola cuenta. * Esperas evaluar o reemplazar el modelo principal con el tiempo. * Deseas un endpoint compatible con OpenAI en lugar de código de cliente específico del proveedor. * Tus futuras habilidades de Hermes pueden necesitar acceso a modelos de imagen o video desde la misma plataforma. Una integración directa con el proveedor de modelos puede ser más simple si el agente va a usar permanentemente un solo proveedor y no necesitas el catálogo de modelos más amplio de Atlas Cloud. La elección correcta depende de si la flexibilidad y el acceso centralizado son más importantes que tener la configuración de un solo proveedor más corta posible. ## Lista de verificación final Antes de dejar a Hermes Agent funcionando sin supervisión, verifica los cinco puntos: - La clave de Atlas Cloud está almacenada fuera del control de versiones. - `provider` está configurado como `custom`. - `base_url` es exactamente `https://api.atlascloud.ai/v1`. - `model.default` coincide con un ID del endpoint de modelos en vivo. - `hermes doctor` y una conversación simple ambos tienen éxito. Con esas comprobaciones completas, Hermes Agent está integrado con Atlas Cloud. Ahora puedes evaluar diferentes modelos de lenguaje detrás del mismo agente sin cambiar sus herramientas, memoria, habilidades o interfaz de usuario. ## FAQ ### ¿Tiene Hermes Agent un proveedor integrado de Atlas Cloud? No se requiere un proveedor dedicado de Atlas Cloud. Hermes Agent puede conectarse a través de su proveedor personalizado compatible con OpenAI utilizando la URL base y la clave API de Atlas Cloud. ### ¿Cuál es la URL base de Atlas Cloud para Hermes Agent? Usa https://api.atlascloud.ai/v1 como la URL base compatible con OpenAI. ### ¿Dónde debo almacenar la clave de API de Atlas Cloud? Guárdalo en ~/.hermes/.env como OPENAI_API_KEY y mantén la clave real fuera de los archivos de configuración, capturas de pantalla y control de versiones. ### ¿Qué modelo de Atlas Cloud debería usar Hermes Agent? Consulta https://api.atlascloud.ai/v1/models y elige un modelo de texto actual que cumpla con tus requisitos de uso de herramientas, razonamiento, contexto, latencia y costo. ### ¿Cómo puedo verificar la integración? Ejecute hermes doctor, inicie Hermes con el comando hermes y envíe una pequeña prueba de solicitud. Los errores de autenticación o de modelo desconocido generalmente apuntan a la clave de API, la URL base o el ID del modelo.