---
id: "sistema.assistentes"
titulo: "Assistentes"
resumo: "Veja quais assistentes existem nesta máquina e escolha qual responde por padrão."
idioma: "pt-br"
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/pt-br/sistema/assistentes/"
fonte: "pt-br/sistema/assistentes.md"
caminhoPublico: "docs/publica/pt-br/sistema/assistentes.md"
hashFonte: "sha256:7423ee5ba3d827e57409a6ad9a579d6775e011c315376d901327fff7c3b678d1"
hashDestaPagina: "sha256:7423ee5ba3d827e57409a6ad9a579d6775e011c315376d901327fff7c3b678d1"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
**Ajustes > Assistentes** tem duas metades: o **catálogo** de assistentes que o Elyra conhece e as
**preferências** de execução de cada um.

## O catálogo

O catálogo lista os assistentes conhecidos e o estado de cada um **nesta máquina**.

1. Abra **Ajustes > Assistentes**.
2. Veja a lista de assistentes conhecidos com o estado detectado.
3. Use **procurar novamente** para refazer a detecção — útil depois de instalar ou remover um assistente
   fora do app.

> **Catálogo conhecido não significa executável instalado.** O Elyra conhece vários assistentes; ele só
> usa o que está presente. **Leia o estado detectado da linha**, não a presença do nome na lista.

O mesmo vale pela linha de comando:

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

- A coluna `id` é o que `--agent <id>` aceita em outros comandos.
- Com o app em execução, cada linha diz **instalado** ou **não instalado**.
- **Sem o app acessível, cada linha diz `unverified`** — que significa "não verificado", **nunca
  "ausente"**. O comando continua bem-sucedido.
- O alias `elyra agent list`, no singular, resolve para o mesmo comando.

## O assistente padrão

Você pode deixar a escolha em **Automático** ou fixar um assistente específico.

- **Automático** deixa o app decidir conforme o que está disponível.
- **Um assistente escolhido** passa a ser o padrão das novas conversas.

**Se o assistente padrão sair do `PATH` ou for desabilitado, a escolha volta para Automático.** O app não
fica apontando para algo que não existe.

## Habilitar, desabilitar e sobrescrever o comando

Por assistente, você pode:

- **ativar ou desativar** o assistente;
- **substituir o comando de inicialização**;
- **substituir argumentos**;
- **definir variáveis de ambiente** de execução.

**O app persiste opções de execução — ele não instala os executáveis dos provedores.** Escolher um
assistente não o traz para a sua máquina; você instala o assistente pelo canal do próprio provedor.

Vários controles mexidos ao mesmo tempo passam por uma fila de gravação, para que um toggle não
sobrescreva o outro.

## Cuidado com o que você digita aqui

**Argumentos e variáveis de ambiente podem conter segredos.** Dois cuidados:

- **Nunca publique valores reais** — nem em exemplo, nem em captura de tela, nem em relato.
- **Uma preferência salva não é prova de presença.** Que o assistente esteja escolhido não significa que
  o executável existe na máquina.

## Resultado

- Você sabe quais assistentes estão presentes nesta máquina.
- O padrão das novas conversas segue a sua escolha, ou volta para Automático quando ela deixa de valer.
- O comando, os argumentos e o ambiente de um assistente refletem o que você configurou.

## Limites

- **O estado detectado é um retrato.** Ele muda quando o ambiente muda; use **procurar novamente** depois
  de mexer na máquina.