> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# CodeBuddy / WorkBuddy

> Conecta CodeBuddy y WorkBuddy a EvoLink.AI

## Descripción general

CodeBuddy y WorkBuddy son herramientas de IA lanzadas por Tencent Cloud que admiten la integración de modelos de IA personalizados a través de archivos de configuración `models.json`.
Al integrarlos con la **API de EvoLink**, puede utilizar directamente varias capacidades de modelos de IA proporcionadas por EvoLink.

<Note>
  CodeBuddy y WorkBuddy utilizan el mismo método de configuración. Esta documentación se aplica a ambos.
</Note>

## Requisitos previos

### Obtener la clave API de EvoLink

* Inicie sesión en la [Consola de EvoLink](https://evolink.ai/dashboard)
* Encuentre las claves API en la consola, haga clic en el botón "Crear nueva clave" y copie la clave generada
* La clave API generalmente comienza con `sk-`, guárdela de forma segura

## Pasos de configuración

### 1. Abrir el archivo de configuración

**CodeBuddy:** `~/.codebuddy/models.json`

**WorkBuddy:** `~/.workbuddy/models.json`

### 2. Agregar configuración del modelo Evolink

Edite el archivo `models.json` y agregue la siguiente configuración:

<Note>
  Actualmente solo se admite la integración de API en formato OpenAI SDK.
</Note>

```json theme={null}
{
  "models": [
    {
      "id": "evolink/auto",
      "name": "Evolink Auto (Enrutamiento Inteligente)",
      "vendor": "Evolink",
      "apiKey": "sk-your-api-key-here",
      "url": "https://direct.evolink.ai/v1/chat/completions",
      "supportsToolCall": true,
      "supportsImages": true
    },
    {
      "id": "gpt-5.4",
      "name": "Evolink GPT-5.4",
      "vendor": "OpenAI",
      "apiKey": "sk-your-api-key-here",
      "url": "https://direct.evolink.ai/v1/chat/completions",
      "supportsToolCall": true,
      "supportsImages": true
    },
    {
      "id": "doubao-seed-2.0-mini",
      "name": "Evolink Doubao Seed 2.0 Mini",
      "vendor": "ByteDance",
      "apiKey": "sk-your-api-key-here",
      "url": "https://direct.evolink.ai/v1/chat/completions",
      "supportsToolCall": true,
      "supportsImages": true
    }
  ]
}
```

<Warning>
  Reemplace `sk-your-api-key-here` con su clave API de EvoLink real.
</Warning>

### Más modelos disponibles

Además de los ejemplos anteriores, puede agregar los siguientes modelos (mismo formato de configuración, agregue el prefijo "Evolink " al campo name):

**Serie GPT:**

* `gpt-5.2` - Evolink GPT-5.2
* `gpt-5.1` - Evolink GPT-5.1
* `gpt-5.1-chat` - Evolink GPT-5.1 Chat
* `gpt-5.1-thinking` - Evolink GPT-5.1 Thinking

**Serie Gemini:**

* `gemini-2.5-pro` - Evolink Gemini 2.5 Pro
* `gemini-2.5-flash` - Evolink Gemini 2.5 Flash
* `gemini-3-pro-preview` - Evolink Gemini 3.0 Pro
* `gemini-3-flash-preview` - Evolink Gemini 3.0 Flash

**Serie Doubao Seed 2.0:**

* `doubao-seed-2.0-pro` - Evolink Doubao Seed 2.0 Pro
* `doubao-seed-2.0-lite` - Evolink Doubao Seed 2.0 Lite
* `doubao-seed-2.0-code` - Evolink Doubao Seed 2.0 Code

**Serie Kimi K2:**

* `kimi-k2-thinking` - Evolink Kimi K2 Thinking
* `kimi-k2-thinking-turbo` - Evolink Kimi K2 Thinking Turbo

### 3. Guardar y reiniciar

Después de guardar el archivo de configuración, la herramienta detectará automáticamente los cambios de configuración y se recargará (retraso de rebote de 1 segundo).

Una vez completada la configuración, puede ver todos los modelos Evolink configurados en el menú desplegable de selección de modelo:

<img src="https://mintcdn.com/muyutechnology/Ibsxv__oZ58z38Zo/images/integration-guide/codebuddy-workbuddy-switch-model.png?fit=max&auto=format&n=Ibsxv__oZ58z38Zo&q=85&s=322e21d805183bc4cecfc72eafd6e3c8" alt="Cambiar modelo" width="1799" height="1196" data-path="images/integration-guide/codebuddy-workbuddy-switch-model.png" />

## Usar el enrutamiento inteligente Evolink Auto

### ¿Qué es Evolink Auto?

Evolink Auto es una función de enrutamiento de modelo inteligente que selecciona automáticamente el modelo de IA más adecuado según el contenido de su solicitud.

### Ventajas principales

* **Coincidencia inteligente**: Analiza automáticamente el contenido de la solicitud y selecciona el modelo más adecuado
* **Optimización de costos**: Prioriza modelos rentables mientras garantiza la calidad
* **Equilibrio de carga**: Distribuye automáticamente las solicitudes entre múltiples modelos para mejorar la estabilidad del sistema
* **Transparente**: Devuelve el nombre del modelo realmente utilizado en la respuesta

### Uso

Seleccione "Evolink Auto (Enrutamiento Inteligente)" en el menú desplegable de selección de modelo.

## Limitar la lista de modelos disponibles

Si solo desea mostrar modelos específicos en el menú desplegable, puede usar el campo `availableModels`:

```json theme={null}
{
  "models": [
    // ... configuración del modelo
  ],
  "availableModels": [
    "evolink/auto",
    "gpt-5.4",
    "doubao-seed-2.0-mini"
  ]
}
```

## Preguntas frecuentes

### 1. ¿Dónde está el archivo de configuración?

**CodeBuddy:**

* macOS/Linux: `~/.codebuddy/models.json`
* Windows: `C:\Users\<nombre_usuario>\.codebuddy\models.json`

**WorkBuddy:**

* macOS/Linux: `~/.workbuddy/models.json`
* Windows: `C:\Users\<nombre_usuario>\.workbuddy\models.json`

### 2. ¿Se admite la configuración a nivel de proyecto?

Sí. Además de la configuración a nivel de usuario, puede crear archivos de configuración en el directorio raíz del proyecto:

**CodeBuddy:** `<directorio_raíz_proyecto>/.codebuddy/models.json`

**WorkBuddy:** `<directorio_raíz_proyecto>/.workbuddy/models.json`

<Note>
  La configuración a nivel de proyecto tiene mayor prioridad que la configuración a nivel de usuario. Se recomienda configurar modelos globales a nivel de usuario y modelos específicos del proyecto a nivel de proyecto.
</Note>

### 3. ¿Qué hacer si la configuración no funciona?

1. Verifique si el formato JSON es correcto (use un validador JSON)
2. Confirme que la clave API sea correcta
3. Intente reiniciar la aplicación

### 4. ¿Qué modelos son compatibles?

EvoLink admite modelos de OpenAI, Anthropic, Google y otros proveedores. Consulte la [Lista de modelos](https://evolink.ai/models) para obtener más detalles.

### 5. ¿Es segura la clave API?

La clave API se almacena en el archivo de configuración local y no se cargará en la nube. Se recomienda establecer permisos de archivo para evitar el acceso no autorizado.

## Enlaces relacionados

* [Consola de EvoLink](https://evolink.ai/dashboard)
* [Documentación oficial de CodeBuddy](https://www.codebuddy.cn/docs)
* [Documentación de la API de EvoLink](/docs/es/api-manual)
