Producto
CLI

Eliminar agente

Elimina un agente de IA del workspace activo.

Eliminar agente

Elimina un agente de forma permanente. Antes de borrar, el CLI carga el agente, muestra su ID, nombre y descripción, y pide confirmación mostrando su nombre.

bash
01plazbot agent delete <agentId> [options]

Parámetros

ParámetroFlagRequeridoDescripción
agentId(posicional)SíID del agente a eliminar.
JSON--jsonNoImprime el resultado como JSON ({"id","name","deleted"}). Por defecto: false.
Confirmar-y, --yesNoOmite la confirmación (scripts y CI). Alias: --confirm. Por defecto: false.

Ejemplos

bash
01# Eliminar un agente (pide confirmación)
02plazbot agent delete age_AbcDef123
03 
04# Eliminar sin preguntar (scripts y CI)
05plazbot agent delete age_AbcDef123 --yes
06 
07# Eliminar y obtener el resultado en JSON
08plazbot agent delete age_AbcDef123 --yes --json

Resultado

text
01 You are about to delete the following agent:
02 ID: age_AbcDef123
03 Name: Sales Plazbot
04 Description: Asistente virtual de ventas
05 
06? Delete agent "Sales Plazbot" (age_AbcDef123)? This cannot be undone. (y/N) y
07✔ Agent "Sales Plazbot" deleted

Si respondes que no, se imprime Aborted. y el comando termina con código 1.

Salida JSON

json
01{
02 "id": "age_AbcDef123",
03 "name": "Sales Plazbot",
04 "deleted": true
05}

La eliminación no se puede deshacer. Si podrías necesitar el agente otra vez, expórtalo antes: plazbot agent export age_AbcDef123 -o agent.json (ver export).

Errores comunes

MensajeCausaSolución
This action needs confirmation and there is no interactive terminal.Se ejecutó sin terminal (CI, pipes) o con --json y sin --yes.Agrega --yes.
Resource not found.El ID no existe en el workspace activo.Revisa el ID con plazbot agent list.
You are not signed in.No hay sesión activa.Ejecuta plazbot login.
¿Quieres probar la API en vivo? Abre el Playground.