Crear tarjetas en el Canvas

Hay dos caminos para crear una tarjeta: la barra de arriba del tablero y el clic derecho en el fondo. Los dos crean el mismo tipo de tarjeta; el clic derecho tiene la ventaja de colocar la tarjeta ya en el punto que señalaste.

Desde la barra de arriba

La barra ofrece Conversación, Terminal, Nota (con submenú Nota y Grupo de notas), Navegador y Móvil.

• Conversación abre un selector de asistente antes de crear la tarjeta: elegir el asistente es parte de la creación, no un paso posterior.
• Terminal ofrece un shell puro o un terminal ya con un asistente.
• Nota crea una tarjeta de nota vacía; el Grupo de notas crea el archivador. Los dos están detallados en Notas en el Canvas.
• Móvil queda deshabilitado cuando el emulador no está disponible en la build, con el aviso “El emulador todavía no está disponible en esta versión”.

Con el clic derecho en el fondo

Con el clic derecho en el fondo del tablero, el elemento “Agregar aquí” crea la tarjeta donde señalaste. Para Conversación y Terminal abre un submenú para elegir el asistente.

La tarjeta de Archivo no está en esa lista ni en la barra: nace cuando abres un archivo real del proyecto, y reutiliza la misma cola de apertura de la pantalla Archivos.

Quién puede crear tarjetas de agente

Solo la tarjeta orquestadora crea tarjetas de Conversación y Terminal. Una tarjeta sin ese papel que pide un agente es rechazada, y la petición debe encaminarse al orquestador.

La excepción existe para que el tablero nunca se atasque: la primera tarjeta de agente de un Canvas vacío nace orquestadora. Un Canvas nuevo, por lo tanto, siempre tiene por dónde empezar. Las tarjetas de nota, archivo, navegador y móvil no son agentes y cualquiera puede crearlas.

Por la línea de comandos

Un agente puede crear tarjetas sin tocar la interfaz:

elyra canvas create <type> [--workspace <selector>] [--agent <id>] [--role <name>]
                          [--model <id>] [--title <text>] [--content <text>]
                          [--content-file <path|->] [--position <x,y>] [--size <w,h>]
                          [--link-to <nodeId>] [--orchestrator] [--path <path>]
                          [--cwd <folder>] [--url <url>] [--device-id <id>]
                          [--platform <android|ios>] [--json]

El tipo es uno de chat, terminal, note, file, browser, device. Las flags son específicas por tipo, y pasar la flag equivocada al tipo equivocado se rechaza:

Tipo	Flags propias	Observaciones
chat	--agent, --model	El modelo se elige aquí y solo aquí.
terminal	--agent, --cwd	--model no se acepta: el asistente ejecuta su propia interfaz y no hay una forma uniforme de elegir el modelo en el arranque.
note	--content, --content-file, --title	Escribe el archivo .md ya al nacer.
file	--path (obligatorio)	La ruta es relativa a la raíz del workspace y el archivo tiene que existir.
browser	--url	Define la página inicial de la tarjeta.
device	--device-id, --platform	Acepta android o ios.

Reglas que evitan sorpresas:

• --position y --size llevan dos números separados por coma: "400,120" y "900,600".
• --link-to enlaza la tarjeta nueva a una tarjeta existente (por id o título exacto). Sin la flag, la tarjeta ya nace enlazada a quien llamó, cuando existe una tarjeta llamadora.
• --orchestrator es azúcar para --role orquestrador; pasar las dos es un error.
• Crear una tarjeta de móvil no enciende el emulador: la tarjeta es solo el lugar donde va a aparecer.

Lo que devuelve el comando

Cada tipo devuelve un identificador propio, que es lo que usan los comandos siguientes:

• terminal devuelve la sesión, y esta pasa a aparecer en la lista de terminales;
• chat devuelve un handle estable (con el formato chat_<12 hex>), que no aparece en la lista de terminales — ver La conversación en el Canvas;
• note devuelve la ruta absoluta real del archivo .md, que está fuera de la carpeta del proyecto;
• los demás devuelven el identificador de la tarjeta.

Papel declarado en la creación

La flag --role declara el papel pretendido, pero el papel nombrado todavía no se aplica en el momento de la creación: hasta que ese enlace se cierre, la tarjeta nace sin papel y la promueves después con elyra canvas set-orchestrator <card> o con el diálogo de papeles. La excepción es la automática: la primera tarjeta de agente de un Canvas vacío nace orquestadora.

Después de crear: qué esperar

• Un terminal no queda listo al instante. Tarda unos segundos (la medición conocida es del orden de 7 segundos en Windows) en aparecer en la lista de terminales y aceptar entrada. Hasta entonces no aparece en ningún lugar — no vuelvas a crear la tarjeta.
• Una sesión de conversación no aparece en la lista de terminales. Corre por el SDK, con dirección propia.
• La carpeta de un terminal tiene que existir. Si el directorio pedido en --cwd no existe cuando el terminal arranca, abre en la carpeta del workspace y lo dice en sus primeras líneas; la raíz de un disco se rechaza antes de crear la tarjeta. Crea el directorio primero.

Recuperación y limpieza

• Nota creada sin archivo. Si el archivo de la nota no se puede crear, la tarjeta aparece en el Canvas y el aviso dice dónde intentó guardar Elyra y por qué. El texto que escribas ahí puede no guardarse — comprueba la ruta informada antes de confiar en la nota.
• Tarjeta creada por error. Ciérrala con el botón de cerrar de la tarjeta. Atención: cerrar un terminal termina la sesión y cerrar una nota borra el archivo.
• Terminal que no aparece. Espera el tiempo de arranque antes de cualquier cosa; volver a crear la tarjeta deja dos terminales y dos procesos donde querías uno.