---
id: "sistema.assistentes"
titulo: "Assistants"
resumo: "See which assistants exist on this machine and choose which one answers by default."
idioma: "en"
tipo: "guia"
categoria: "ajustes"
aplicavelDesde: "0.0.16"
capabilities: ["settings.agents.catalog", "settings.agents.preferences"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/en/sistema/assistentes/"
fonte: "pt-br/sistema/assistentes.md"
caminhoPublico: "docs/publica/en/sistema/assistentes.md"
hashFonte: "sha256:7423ee5ba3d827e57409a6ad9a579d6775e011c315376d901327fff7c3b678d1"
hashDestaPagina: "sha256:9e120fc4acfd4fcdbb496d026e8f9cf49b9ac628c34efab038dec7a9b6774d80"
traducaoAssistidaPorIA: true
traducaoDesatualizada: false
corpoRetido: false
---
<!-- traducao-assistida-por-ia: idioma=EN fonte=pt-br/sistema/assistentes.md fonteHash=sha256:7423ee5ba3d827e57409a6ad9a579d6775e011c315376d901327fff7c3b678d1 estado=atual -->

**Ajustes > Assistentes** (Settings > Assistants) has two halves: the **catalogue** of assistants Elyra
knows about and the **preferences** for running each of them.

## The catalogue

The catalogue lists the known assistants and the state of each one **on this machine**.

1. Open **Ajustes > Assistentes**.
2. See the list of known assistants with the detected state.
3. Use **procurar novamente** to redo detection — useful after installing or removing an assistant
   outside the app.

> **A known catalogue does not mean an installed executable.** Elyra knows several assistants; it only
> uses the one that is present. **Read the detected state of the row**, not the presence of the name in
> the list.

The same holds on the command line:

```
elyra agents list --json
```

- The `id` column is what `--agent <id>` accepts in other commands.
- With the app running, each row says **instalado** or **não instalado**.
- **Without the app reachable, each row says `unverified`** — which means "not verified", **never
  "absent"**. The command still succeeds.
- The alias `elyra agent list`, in the singular, resolves to the same command.

## The default assistant

You can leave the choice on **Automático** or pin a specific assistant.

- **Automático** lets the app decide according to what is available.
- **A chosen assistant** becomes the default for new conversations.

**If the default assistant leaves the `PATH` or is disabled, the choice falls back to Automático.** The
app does not keep pointing at something that does not exist.

## Enabling, disabling and overriding the command

Per assistant, you can:

- **enable or disable** the assistant;
- **replace the startup command**;
- **replace arguments**;
- **set environment variables** for the run.

**The app persists run options — it does not install the providers' executables.** Choosing an assistant
does not bring it to your machine; you install the assistant through the provider's own channel.

Several controls touched at the same time go through a write queue, so that one toggle does not overwrite
the other.

## Be careful with what you type here

**Arguments and environment variables can contain secrets.** Two precautions:

- **Never publish real values** — not in an example, not in a screenshot, not in a report.
- **A saved preference is not proof of presence.** That the assistant is chosen does not mean the
  executable exists on the machine.

## Result

- You know which assistants are present on this machine.
- The default for new conversations follows your choice, or falls back to Automático when it stops
  applying.
- An assistant's command, arguments and environment reflect what you configured.

## Limits

- **The detected state is a snapshot.** It changes when the environment changes; use **procurar novamente**
  after touching the machine.