Inspeccionar comandos y contexto
Referencia de dos comandos de lectura: el registro de comandos y el descubrimiento de dónde está usted.
Dos comandos de lectura pura que ayudan a descubrir qué existe y dónde está usted. Ninguno de los dos cambia nada.
elyra agent-context
elyra agent-context [--json]Imprime el registro de comandos en formato legible por máquina: comandos, argumentos y opciones conocidas.
| Característica | Detalle |
|---|---|
| Lectura local pura | No necesita la app en ejecución |
| Seguro en contexto remoto | Funciona por SSH y en ambiente sin interfaz |
| Qué describe | Comandos, argumentos y flags — no los resultados |
No infiera la API del producto a partir de este registro. Describe la superficie de comandos; no representa el formato de respuesta de cada comando, ni es un contrato de API HTTP.
elyra context
elyra context [--json]Dice dónde está usted. Dos informaciones diferentes vienen juntas:
| Campo | Qué significa |
|---|---|
screen |
La pantalla que la persona está mirando ahora: Canvas, Conversación, Terminal o Navegador |
caller.surface |
Dónde está usted alojado: canvas (usted es una tarjeta) o terminal (usted es una pestaña de la pantalla Terminal) |
Los dos pueden discrepar. Es exactamente por eso que son campos separados: la persona puede estar mirando el Canvas mientras el proceso corre en una pestaña de Terminal.
Fuera de una terminal de Elyra, caller.surface viene como unknown y no existe tarjeta — nada falla
por causa de eso.
La regla práctica
Ejecute elyra context antes de crear una terminal, una conversación o una nota:
- Con
screen=canvasocaller.surface=canvas, prefiera crear una tarjeta en el Canvas. - En caso contrario, crear una pestaña de Terminal es el camino.
Resultado
- Usted sabe qué comandos existen y qué opciones acepta cada uno.
- Usted sabe la diferencia entre la pantalla visible y la superficie donde vive el proceso.
Límites
- El registro no es un esquema de salida. No describe el JSON de respuesta de los comandos.
- No adivine la superficie por la pantalla. Especialmente en SSH, o en una sesión que sigue corriendo después de que usted cambie de pantalla.
- El comando
contextno falla fuera de la app. Devuelveunknowny sigue.