> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Modelos de IA

> Descubra e valide os modelos de IA disponíveis para os nós AI Agent e AI_TASK: filtros por provedor e capacidade, validação e cache do catálogo.

`jelou models` consulta o catálogo de modelos de IA disponíveis para a sua
organização — os que você pode usar nos nós **AI Agent** e **AI\_TASK**. Serve
para duas coisas: descobrir quais modelos você tem e validar que o nome que vai
escrever em um workflow existe.

<Tip>
  Se o seu agente já precisa de outro contexto do workspace (identidade, drift
  do projeto, segredos, bancos de dados), `jelou context --agent` traz tudo
  isso em uma única chamada, incluindo essa mesma lista de modelos permitidos
  em `data.models` (com `source`, `fetchedAt`, `count`, `allowed[]`,
  `deprecated[]` e `byProvider{}`). É um atalho útil quando você já vai pedir
  esse contexto mais amplo de qualquer forma.
</Tip>

## Listar

```bash theme={null}
jelou models list                                  # todos
jelou models list --provider anthropic             # de um provedor
jelou models list --capability vision --json       # que suportam imagens
```

| Flag                                              | Descrição                                                                                   |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| `--provider <nome>`                               | Filtra por provedor                                                                         |
| `--capability <cap>`                              | `vision`, `json`, `pdf`, `reasoning`, `streaming`, `audio`, `system`, `tools`, `structured` |
| `--type <tipo>`                                   | `platform` (da plataforma) ou `custom` (seus)                                               |
| `--include-deprecated`                            | Inclui modelos com data de fim de vida                                                      |
| `--no-cache`                                      | Consulta nova, ignora o cache local                                                         |
| `--sort <catalog\|name\|input-cost\|output-cost>` | Ordem dos resultados (padrão `catalog`)                                                     |
| `--max-input-cost <número>`                       | Somente modelos com custo de entrada por 1M tokens igual ou menor                           |
| `--max-output-cost <número>`                      | Somente modelos com custo de saída por 1M tokens igual ou menor                             |

Modelos depreciados **não aparecem** a menos que você passe
`--include-deprecated`.

## Ver detalhes

Aceita o nome curto, o id qualificado ou o id numérico:

```bash theme={null}
jelou models show gpt-4.1
jelou models show openai/gpt-4.1
```

## Validar

Confirma que um modelo existe antes de escrevê-lo em um workflow. É o comando
pensado para CI e para agentes:

```bash theme={null}
jelou models validate openai/gpt-4.1        # forma canônica
jelou models validate gpt-4.1               # forma curta, expande sozinha
jelou models validate gpt-4o --provider openai
```

| Código de saída | Significado                                            |
| --------------- | ------------------------------------------------------ |
| `0`             | Válido e não depreciado                                |
| `2`             | Depreciado, ou o nome curto é ambíguo entre provedores |
| `3`             | Não existe no catálogo                                 |

| Flag                 | Descrição                                               |
| -------------------- | ------------------------------------------------------- |
| `--provider <nome>`  | Exige que o modelo pertença a esse provedor             |
| `--allow-deprecated` | Trata os depreciados como válidos (saída `0` com aviso) |

<Tip>
  `--provider` é útil para validar o par modelo+provedor de um `fallbackModel`
  antes de publicar um workflow.
</Tip>

## Cache do catálogo

O catálogo fica em cache no disco para não consultar a API a cada chamada. Se
você acabou de habilitar um modelo e ele não aparece:

```bash theme={null}
jelou models refresh                        # consulta nova e reescreve o cache
jelou models refresh --clear                # apaga o cache do perfil ativo
jelou models refresh --clear --all-profiles # apaga o de todos os perfis
```

Você também pode passar `--no-cache` em `list`, `show` e `validate` para uma
consulta pontual sem mexer no cache.