---
id: "sistema.referencia-cli-inspecao"
titulo: "Inspeccionar comandos y contexto"
resumo: "Referencia de dos comandos de lectura: el registro de comandos y el descubrimiento de dónde está usted."
idioma: "es"
tipo: "referencia"
categoria: "ajustes"
aplicavelDesde: "0.0.16"
capabilities: ["settings.cli.schema", "settings.cli.context"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/es/sistema/referencia-cli-inspecao/"
fonte: "pt-br/sistema/referencia-cli-inspecao.md"
caminhoPublico: "docs/publica/es/sistema/referencia-cli-inspecao.md"
hashFonte: "sha256:9072bef79aadd970bdd6ff723a40d6c5f525ad9e3964eba4c8e2b57b6c4cff2d"
hashDestaPagina: "sha256:ab7f5885d0d3d28641da856ac86287384984da7b8a327dc913dc5434214ce919"
traducaoAssistidaPorIA: true
traducaoDesatualizada: false
corpoRetido: false
---
<!-- traducao-assistida-por-ia: idioma=ES fonte=pt-br/sistema/referencia-cli-inspecao.md fonteHash=sha256:9072bef79aadd970bdd6ff723a40d6c5f525ad9e3964eba4c8e2b57b6c4cff2d estado=atual -->

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

- [Ajustes](/docs/es/sistema/ajustes/)
- [Avanzado](/docs/es/sistema/avancado/)