Configurar Pi Agent

Dónde está el archivo

Pi Agent permite añadir proveedores personalizados desde este archivo:

~/.pi/agent/models.json

Si el archivo no existe, puedes crearlo. Pi recarga este archivo al abrir /model.

Añadir DevExpert como proveedor

Usa el endpoint compatible con OpenAI y la variable de entorno DEVEXPERT_API_KEY que configuraste en la guía inicial.

{
  "providers": {
    "devexpert": {
      "baseUrl": "https://inference.devexpert.io/v1",
      "api": "openai-completions",
      "apiKey": "DEVEXPERT_API_KEY",
      "authHeader": true,
      "models": [
        {
          "id": "chat",
          "name": "DevExpert Chat",
          "reasoning": true
        },
        {
          "id": "chat-pro",
          "name": "DevExpert Chat Pro",
          "reasoning": true
        }
      ]
    }
  }
}

El campo reasoning indica a Pi que el modelo soporta pensamiento extendido. Déjalo activado para los modelos de Inference.

Usar el modelo

Después de guardar el archivo, abre Pi Agent y selecciona el proveedor desde /model.

/model

Elige chat como modelo por defecto para el día a día. Usa chat-pro cuando necesites más calidad, sabiendo que el panel los marcará con una intensidad de uso más alta.

Comprobar que la clave está disponible

Pi lee el valor de DEVEXPERT_API_KEY desde el entorno. Antes de arrancarlo, puedes comprobarlo:

echo $DEVEXPERT_API_KEY

Si no aparece nada, crea la variable de entorno y abre una terminal nueva antes de ejecutar Pi Agent.

Solución de problemas

No aparece el proveedor DevExpert

• Comprueba que el archivo está en ~/.pi/agent/models.json.
• Valida que el JSON no tiene comas de más ni comentarios.
• Abre de nuevo /model para forzar la recarga.

La petición falla con autenticación

• Comprueba que DEVEXPERT_API_KEY existe en la misma terminal donde ejecutas Pi.
• Revisa que la clave empieza por sk- y que no has copiado espacios.
• Verifica que la URL base termina en /v1.