# Plugins

> O que é um plugin no Reverie, os três tipos, e onde eles ficam.

Source: https://reverie.im/pt/docs/plugins
Language: pt

Um plugin é uma pequena extensão que você instala numa conversa. Ele pode acrescentar instruções ocultas ao prompt de um personagem, registrar uma ferramenta que o modelo pode chamar e que é desenhada como um cartão, ou colocar na conversa um botão que abre um diálogo. Os plugins são escritos pela Reverie e por outros usuários.

## Onde ficam os plugins \[#where-plugins-live]

Abra uma conversa, abra o **painel lateral** e escolha a aba **Plugins**. Tudo sobre plugins acontece ali:

| Aba            | O que lista                                                    |
| -------------- | -------------------------------------------------------------- |
| **Meus**       | Os plugins que você criou, mais um botão **Ver Ganhos**        |
| **Oficiais**   | Os plugins publicados pela Reverie                             |
| **Comunidade** | Plugins públicos e aprovados de outros usuários, com uma busca |

O cabeçalho da aba traz um botão **Criar Plugin**. Não existe uma página de loja separada — o painel é a superfície inteira. [Painel lateral →](https://reverie.im/pt/docs/chatting/side-panel)

## Os três tipos \[#the-three-kinds]

| Tipo           | O que faz                                                                                                                         | Aparece na conversa                 | Paga comissão |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | ------------- |
| **Prompt**     | Acrescenta texto ao prompt de sistema do personagem a cada turno                                                                  | Não — você vê o efeito, não o texto | Sim           |
| **Ferramenta** | Registra uma ferramenta que o modelo pode chamar no meio da resposta; o resultado é desenhado como um cartão estilizado           | Sim, como cartão                    | Sim           |
| **Interativo** | Acrescenta um item ao menu de plugins ao lado da caixa de mensagem, que abre um diálogo, um formulário ou um painel gerado por IA | Sim, como item de menu e painel     | Não           |

> **Plugins de ferramenta não buscam dados reais.** Um plugin de ferramenta não
> faz nenhuma chamada de rede — nada de requisições web, de acesso a agenda, de
> consultas ao vivo. Quando o modelo chama a ferramenta, é o próprio modelo que
> fornece os argumentos, e o plugin apenas arruma esses argumentos inventados
> no cartão que o autor desenhou. Uma ferramenta de "clima" desenha um cartão
> de clima convincente com um clima que o modelo inventou.

Plugins de ferramenta também precisam de um modelo que dê conta de chamadas de ferramenta. Num que não dá, os cartões deles ficam desativados com **O modelo atual não suporta plugins de ferramentas**.

## O que você instala \[#what-you-install]

Cada plugin carrega a configuração do autor e, opcionalmente, ajustes que você mesmo preenche — caixas de texto, números, controles deslizantes, interruptores, listas suspensas, tabelas e campos de markdown. Você preenche na instalação e pode reabri-los quando quiser pelo cartão do plugin.

Instalar fixa a versão que existe naquele momento. Quando o autor edita o plugin, sua conversa segue rodando a versão que você instalou até você escolher atualizá-la, então uma reescrita lá em cima não muda uma conversa por baixo de você.

## Quem pode instalar o quê \[#who-can-install-what]

* Plugins **Oficiais** qualquer pessoa instala.
* Plugins da **Comunidade** só dá para instalar quando são públicos e aprovados. Um plugin público à espera de revisão mostra **Aguardando Aprovação** para o autor e não é oferecido a mais ninguém.
* **Os seus** você instala sempre, aprovados ou não.
* Um plugin pode estar preso a um personagem; nesse caso ele só é oferecido nas conversas com esse personagem.

As instalações são por conversa. O mesmo plugin pode estar ligado numa conversa com um personagem e desligado em outra.

> Você também pode ver uma etiqueta **Parâmetro** num plugin oficial. Esse
> quarto tipo ajusta as configurações de amostragem do modelo e pertence à
> Reverie — não é algo que você possa criar.

**[Usar plugins](https://reverie.im/pt/docs/plugins/using-plugins)**

Instalar, configurar, ativar e atualizar um plugin dentro de uma conversa.

**[Criar plugins](https://reverie.im/pt/docs/plugins/creating-plugins)**

Escrever um plugin, publicá-lo para revisão e ganhar com ele.

**[Painel lateral](https://reverie.im/pt/docs/chatting/side-panel)**

O resto do painel onde a aba de plugins fica.

**[Créditos](https://reverie.im/pt/docs/billing/credits)**

O que um plugin acrescenta ao custo de uma mensagem.