---
id: "inicio"
titulo: "Elyra ADE — documentação"
resumo: "O ponto de entrada da documentação do Elyra ADE: o que é o produto e por onde começar."
idioma: "pt-br"
tipo: "landing"
categoria: "comecar"
aplicavelDesde: "0.0.16"
capabilities: []
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/pt-br/inicio/"
fonte: "pt-br/inicio.md"
caminhoPublico: "docs/publica/pt-br/inicio.md"
hashFonte: "sha256:22ac548114a919e925c2b4bfdebc6d8b0cc68854b5ef1cbbdecbd9f1b6e771f2"
hashDestaPagina: "sha256:22ac548114a919e925c2b4bfdebc6d8b0cc68854b5ef1cbbdecbd9f1b6e771f2"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
O **Elyra ADE** é um ambiente de desenvolvimento de agentes, desktop e local: você constrói software conversando e orquestrando vários agentes de código em paralelo, com Canvas, Conversa, Terminal e Navegador sobre o mesmo projeto. Tudo roda na sua máquina.

## Por onde começar

| Se você quer… | Vá para |
|---|---|
| ver o produto funcionando do zero | [Do zero ao primeiro projeto](/docs/pt-br/primeiro-projeto/) — adicionar uma pasta descartável, abrir o primeiro cartão e apagar tudo no fim |
| consultar um comando da CLI | [Referência: `elyra workspace list`](/docs/pt-br/cli-workspace-list/) — flags, saída, erros e limites |
| entender o modelo mental | [Projetos, telas e workspaces](#projetos-telas-e-workspaces), abaixo |
| organizar o trabalho em cartões | [O Canvas](/docs/pt-br/canvas/visao-geral/) |
| conversar com um agente | [A tela Conversa](/docs/pt-br/conversa/visao-geral/) |
| usar o terminal do projeto | [A tela Terminal](/docs/pt-br/ferramentas/terminal/visao-geral/) |
| ver o seu app rodando | [A tela Navegador](/docs/pt-br/ferramentas/navegador/visao-geral/) |
| coordenar vários agentes | [Orquestração: o maestro e os cartões ligados](/docs/pt-br/fluxos/orquestracao-conceito/) |
| trabalhar com git | [Git no Elyra](/docs/pt-br/fluxos/git-conceito/) |

## Projetos, telas e workspaces

Três palavras aparecem o tempo todo e significam coisas diferentes:

- **Projeto** é um repositório ou uma pasta de trabalho. É a unidade que você abre.
- **Workspace** é **um nome e uma pasta dentro do projeto**. As telas do projeto abrem sobre a pasta do workspace selecionado. Vários workspaces podem apontar para a mesma pasta, ou para pastas diferentes.
- **Telas** são os lugares onde você trabalha: **Canvas**, **Conversa**, **Terminal** e **Navegador**.

Duas frases que evitam a maior parte da confusão:

1. **O git segue a pasta do projeto; os arquivos seguem a pasta do workspace.** As operações de git resolvem o repositório do projeto; abrir, ler e gravar arquivos resolve a pasta do workspace.
2. **Um workspace não é um worktree do git.** Worktree é um recurso do git e vive na tela Git; `elyra workspace list` nunca lista worktrees do git.

Nomes técnicos como `workspace`, `branch`, `commit`, `terminal` e `agents` continuam com o nome original — são os nomes que você encontra no produto e no resto da internet.