--- id: "canvas.criar-cartoes" titulo: "Crear tarjetas en el Canvas" resumo: "Abre conversación, terminal, nota, grupo de notas, navegador o móvil en el tablero — desde arriba, con el clic derecho y por la línea de comandos." idioma: "es" tipo: "guia" categoria: "telas" aplicavelDesde: "0.0.16" capabilities: ["canvas.cards.create", "canvas.cards.birth-role"] estadoEditorial: "aprovado" nivelEvidencia: "artefato-distribuido" refFonte: "27574c339b58316408f6be2d62169d59041d07bf" revisaoFonte: "2026-09-24" revisor: "mantenedor (v1, 2026-10-03)" rota: "/docs/es/canvas/criar-cartoes/" fonte: "pt-br/canvas/criar-cartoes.md" caminhoPublico: "docs/publica/es/canvas/criar-cartoes.md" hashFonte: "sha256:f9314fdc6512ee7f76ff4f009575a9f69f257b52b89047c56614940505c294bd" hashDestaPagina: "sha256:c1898163a7455738aab09045c022c9d08e75fb756ddeaa9794fbd59274c86d62" traducaoAssistidaPorIA: true traducaoDesatualizada: false corpoRetido: false --- 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](/docs/es/canvas/notas/visao-geral/). - **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 [--workspace ] [--agent ] [--role ] [--model ] [--title ] [--content ] [--content-file ] [--position ] [--size ] [--link-to ] [--orchestrator] [--path ] [--cwd ] [--url ] [--device-id ] [--platform ] [--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](/docs/es/canvas/cartao-conversa/); - `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 ` 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.