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

# Instalar e gerir listings do Marketplace

> Instale um agente ou swarm a partir do Marketplace do Kolmena. Comece um período de avaliação gratuito, compre uma licença única ou subscreva mensalmente. Gira, atualize ou cancele os seus alugueres a qualquer momento.

Instalar um listing do Marketplace do Kolmena adiciona ao seu espaço de trabalho uma cópia privada de um agente ou swarm. Pode começar com um período de avaliação gratuito, quando existir, comprar uma licença única ou subscrever mensalmente. Esta página explica como instalar um listing, gerir o seu aluguer e deixar uma avaliação.

## Instalar um listing

**1. Encontre um listing**

Explore o [Marketplace](https://docs.kolmena.ai/pt/marketplace.md) e abra um listing que lhe interesse. Leia a descrição, a apresentação comercial e as capturas de ecrã para perceber o que faz.

**2. Escolha o seu plano**

A janela de instalação mostra o modelo de preço: gratuito, compra única ou subscrição. Se houver um período de avaliação gratuito, pode começá-lo de imediato. Se já usou o período de avaliação deste listing, a janela avisa-o de que instalar agora inicia de imediato a faturação paga.

**3. Confirme e instale**

Clique no botão de instalar. É adicionada uma cópia privada aos seus agentes ou swarms. No caso dos agentes, é gerada uma chave de API para que possa chamar o agente a partir de fora do Kolmena. No caso dos swarms, é criada uma cópia de toda a equipa.

**4. Guarde as suas chaves de API**

Depois da instalação, a janela mostra as suas chaves de API uma única vez. Copie-as e guarde-as de imediato. Se for necessário, pode gerar novas chaves mais tarde na página de detalhes do agente.

## O que acontece depois da instalação

Quando instala um listing, o Kolmena bloqueia a identidade, a persona, os exemplos e as skills do agente ou swarm original. Não pode editar essas partes, mas pode definir as suas próprias credenciais de integração para que o agente se ligue às suas contas.

Nas subscrições, se cancelar, mantém o acesso até ao fim do período de faturação atual. As compras únicas são suas para sempre. Os listings gratuitos não têm qualquer faturação.

## Gerir ou cancelar um aluguer

Controla os seus alugueres na página de detalhes do agente ou swarm copiado:

* **Cancel subscription**: abra o agente ou swarm e clique em **Manage Subscription**. Cancelar para a faturação futura e mantém o acesso até ao fim do período. Não há reembolsos.
* **Resubscribe**: se uma subscrição expirar, aparece um botão **Resubscribe** para a reativar.
* **Obter atualizações**: quando o criador lança uma atualização, aparece um botão **Pull Update**. Aplicar a atualização traz a versão mais recente e preserva as suas credenciais.
* **Renew**: nos alugueres expirados, pode renovar para recuperar o acesso total.

## Deixar uma avaliação

Depois de usar um listing, pode classificá-lo e avaliá-lo para ajudar outros utilizadores:

1. Abra a página do listing no Marketplace.
2. Clique em **Leave Review**.
3. Selecione uma classificação de 1 a 5 estrelas.
4. Escreva uma avaliação curta, com até 300 caracteres.
5. Clique em **Submit Review**.

Pode editar ou eliminar a sua avaliação a qualquer momento na mesma página do listing.

## Próximos passos

> [card] [Visão geral do Marketplace](https://docs.kolmena.ai/pt/marketplace.md)
>
> Explore as categorias, os modelos de preço e as avaliações.

> [card] [Vender no Marketplace](https://docs.kolmena.ai/pt/marketplace/sell-on-the-marketplace.md)
>
> Saiba como publicar os seus próprios agentes e swarms para que outros os instalem.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.