Configurar IA

Configurar la IA del agente

Muestra o cambia el proveedor de IA (OpenAI, Anthropic Claude o Google Gemini), el modelo, el API token, la temperatura y los tokens máximos de un agente. Sin flags abre un menú interactivo; con flags funciona sin preguntas. Con --default vuelve a la IA por defecto de la plataforma.

01plazbot agent ai-config <agentId> [options]

Parámetros

Reglas de combinación:

• --default no se puede combinar con --provider, --model, --api-token, --temperature ni --max-tokens.
• --show no se puede combinar con flags que cambian la configuración.
• Si cambias solo --model, --temperature o --max-tokens, se mantienen el proveedor y el API token actuales.
• Si el agente usa la IA por defecto de la plataforma, --provider y --api-token son obligatorios.
• Si cambias de proveedor, debes pasar --api-token.

Ejemplos

01# Elegir proveedor, modelo y token de forma interactiva
02plazbot agent ai-config age_AbcDef123
03 
04# Ver la configuración actual en JSON (tokens enmascarados)
05plazbot agent ai-config age_AbcDef123 --show --json
06 
07# Cambiar a Claude sin preguntas
08plazbot agent ai-config age_AbcDef123 --provider anthropic --model claude-sonnet-4-6 --api-token sk-ant-xxx --temperature 0.5
09 
10# Volver a la IA por defecto de la plataforma
11plazbot agent ai-config age_AbcDef123 --default

Modo interactivo

Muestra la configuración actual y pregunta qué hacer: Set a custom AI provider, Use the platform default AI o Exit. Al elegir un proveedor pide el modelo (lista), el API token (si el proveedor no cambia, puedes dejarlo vacío para conservar el actual), la temperatura y los tokens máximos. Necesita una terminal interactiva.

Modelos disponibles

Un ID de modelo que no está en la lista se guarda igual, con el aviso Model "<id>" is not in the known <provider> list. It will be saved as is; make sure the provider accepts it.

Resultado

--show con un proveedor propio:

01  AI configuration - Sales Plazbot
02  ────────────────────────────────────────
03    Provider: claude
04    Model: claude-sonnet-4-6
05    API token: sk-a…x9Zq
06    Temperature: 0.5
07    Max tokens: 4096
08    Default: Yes

Si el agente usa la IA de la plataforma: Using the platform default AI (Plazbot).

Al guardar:

01✔ AI provider set: claude / claude-sonnet-4-6 (token sk-a…x9Zq)

Con --default:

01✔ Using the platform default AI (Plazbot)

Los API tokens nunca se imprimen completos: se muestran los 4 primeros y los 4 últimos caracteres (sk-a…x9Zq), o •••• si el token es corto.

Salida JSON

--show --json:

01{
02  "id": "age_AbcDef123",
03  "name": "Sales Plazbot",
04  "customAIConfig": true,
05  "providers": [
06    {
07      "provider": "claude",
08      "model": "claude-sonnet-4-6",
09      "apiToken": "sk-a…x9Zq",
10      "temperature": 0.5,
11      "maxTokens": 4096,
12      "isDefault": true
13    }
14  ]
15}

Al cambiar la configuración:

01{ "id": "age_AbcDef123", "provider": "claude", "model": "claude-sonnet-4-6", "updated": true }

Con --default:

01{ "id": "age_AbcDef123", "provider": "default", "model": null, "updated": true }

Errores comunes