Ir al contenido

Inspeccionar comandos y contexto

Referencia de dos comandos de lectura: el registro de comandos y el descubrimiento de dónde está usted.

Ver Markdown

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=canvas o caller.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 context no falla fuera de la app. Devuelve unknown y sigue.

Próximos pasos