# Como o Agent Credits Funciona

Source: https://support.kapsulehost.com/pt-pt/agents-credits

Os Créditos são o medidor por trás dos Agentes Kapsule e Kora: ler a sua conta é sempre gratuito, e só gasta quando um especialista produz trabalho acabado ou efetua uma alteração que confirmou.

## O Que É Um Crédito

Um crédito é, aproximadamente, uma troca de texto curta. Os créditos são sempre números inteiros, nunca frações, e o livro de contas por trás deles é só-acrescenta: cada concessão, cada gasto e cada expiração é uma linha que pode ver na página Créditos.

> **Note:** A página Créditos fica em **Agentes**, depois o arco de créditos no cabeçalho da página, ou vá diretamente para `/agents/credits`. O mesmo arco aparece na página inicial de Agentes e na página Competências, por isso o seu saldo está sempre a um relance de distância.

## As Leituras São Gratuitas

Esta é a coisa mais útil a saber. Quando um especialista verifica o seu plano, lê a sua lista de faturas, vê os seus sites, obtém o seu mapa do site, ou quando Kora procura algo na sua conta, isto custa **zero créditos**. O mesmo acontece com o planeamento e o esclarecimento que um especialista faz antes de responder.

Gasta em saída e em alterações, não em ver.

![A página de créditos de Agentes no KPanel](https://support.kapsulehost.com/help/screenshots/agents-credits.c0c41211.webp)

## O Que Diferentes Trabalhos Custam

Estes são os pesos padrão. São ajustáveis centralmente, por isso trate-os como a forma atual do preço em vez de uma tabela contratual, e confie sempre na estimativa que o painel lhe mostra antes de se comprometer.

| Trabalho | Créditos |
|---|---|
| Planeamento, encaminhamento e esclarecimento | 0 |
| Resposta de chat curta | 1 |
| Resposta de conteúdo típica | 2 |
| Geração longa, cerca de 1500 palavras | 3 |
| Execução de competência | 4, limitado a 5 por execução |
| Leitura de conta Kora | 0 |
| Alteração de conta Kora | 2 |
| Chamada de aplicação externa através de uma ligação | 1 |
| Imagem padrão | 9 |
| Ampliação de imagem | 15 |
| Imagem Premium ou HD | 25 |
| Logótipo ou pacote de marca | 40 |

O compositor numa conversa mostra uma dica ao vivo (**Cerca de 2 créditos por resposta**), um cartão de competência mostra a sua estimativa antes de começar, e um cartão de confirmação mostra o custo da alteração antes de aprovar.

## Os Seus Créditos de Teste

Cada conta recebe uma oferta única de **40 créditos de teste** da primeira vez que toca em qualquer superfície de Agentes. A concessão é idempotente, por isso abrir a página repetidamente não cria mais, e nunca duplica a concessão.

Os créditos de teste **expiram em 30 dias** depois de chegarem. Este é o único relógio que têm, e a página Créditos mostra a data exata.

> **Tip:** Os créditos de teste são a forma mais barata de descobrir se os Agentes compensam para si. Gaste-os nos trabalhos que de outra forma pagaria a uma pessoa: uma reescrita de página inicial, um rascunho de política de devoluções, um conjunto de descrições de produtos. Uma execução completa de competência custa cerca de um décimo da oferta.

## Onde Os Seus Créditos Vivem

A página Créditos mostra um cartão **Onde vivem os seus créditos** listando cada silo que realmente tem, cada um com a sua própria expiração:

| Silo | De onde vem | Expiração |
|---|---|---|
| Oferta de teste | A concessão de inscrição única | 30 dias a partir da concessão |
| Incluído no seu plano | Uma provisão mensal trazida pelo seu plano | Rola durante um mês, depois expira |
| Pacote de créditos | O complemento mensal de pacote de créditos | Rola enquanto o pacote está ativo, 90 dias |
| Recarga | Uma compra única | 90 dias |

Os silos com saldo zero estão ocultos em vez de serem mostrados como linhas vazias, por isso o cartão apenas lista créditos que realmente tem.

## Quais Créditos São Usados Primeiro

Nunca escolhe. O motor aloca automaticamente, e a regra é concebida para que nada expire enquanto ainda tinha uso para isto:

1. **Tudo o que expira em breve é gasto primeiro.**
2. Onde duas concessões expiram ao mesmo tempo, a ordem é Oferta de teste, depois Créditos de plano, depois Pacote de créditos, depois Recarga.

Isto significa que a sua oferta de teste e a sua provisão de plano são sempre consumidas antes de qualquer coisa que tenha pago separadamente.

## Os Créditos São Reservados Enquanto Um Trabalho Está Em Execução

Antes de um especialista começar uma resposta ou execução de competência, o custo estimado é colocado em espera contra o seu saldo. Isto importa por duas razões:

- Dois trabalhos em execução ao mesmo tempo não podem ambos gastar os últimos créditos.
- Um trabalho nunca o pode cobrar mais do que reservou. Quando termina, a espera liquida-se pelo custo real, que é limitado à estimativa. Se o trabalho nunca foi executado, a espera é libertada e não lhe é cobrado nada.

Há uma proteção adicional que vale a pena conhecer: quando uma alteração é recusada **antes** de ser executada, por exemplo porque a sua função não o permite, porque precisava de um checkout, ou porque uma ligação não estava pronta, isto custa **zero créditos**. Nunca o cobram por uma ação que nunca aconteceu.

## Ficando Baixo e Ficando Sem

Quando o seu saldo disponível cai para 20 créditos ou menos, a nota de herói na página Créditos muda para um aviso: *Ficando baixo. A sua equipa fará pausa quando chegar a zero.*

Em zero, as conversas fazem pausa em vez de se degradarem. O chat mostra **Ficou sem créditos** com uma ligação para a página Créditos, e a conversa continua exatamente onde parou assim que tiver créditos novamente. Nada se perde e nada fica meio-feito.

## Adicionar Mais

Quando um pacote de créditos está disponível na sua conta, a página Créditos mostra um cartão **Pacote de créditos**: 500 créditos cada mês, faturados mensalmente, cancele a qualquer momento. O preço mostrado é o preço cobrado, resolvido na moeda de faturação da sua própria conta, e uma legenda **mais IVA** aparece onde o IVA se aplica à sua moeda de conta.

Assim que um pacote estiver ativo, o cartão do pacote é substituído por uma linha dizendo o número de créditos mensal do pacote e a sua data de renovação. Os seus créditos de teste e plano são sempre usados antes dos créditos de pacote.

> **Warning:** Os preços no KPanel são mostrados excluindo IVA. O valor com IVA incluído aparece apenas no checkout, no botão de pagamento. Um cartão mostrando um preço ex-IVA com uma legenda **mais IVA** está correto, não uma discrepância. Ver [Faturação e Faturas](https://support.kapsulehost.com/pt-pt/billing-and-invoices).

## Ler A Sua Atividade Recente

O cartão **Atividade recente** lista as suas últimas linhas do livro de contas, mais recentes primeiro, cada uma com uma etiqueta amigável, uma data e um montante assinado. As adições mostram um plus, gastos e expirações mostram um menos. As etiquetas mapeiam para o que realmente aconteceu: *Chat rápido*, *Resposta de chat*, *Resposta de chat longa*, *Execução de competência*, *Leitura de conta*, *Alteração de conta*, *Chamada de ligação*, *Oferta de teste*, *Créditos de plano*, *Pacote de créditos*, *Recarga*.

Se uma linha lê **Leitura de conta** com um montante zero, esta é a regra de leituras gratuitas mostrando o seu funcionamento.

## E Se Falhar

**O meu saldo caiu e não fiz nada caro.** Verifique Atividade recente. Gerações longas e execuções de competência são a resposta usual, e trabalhos de imagem são as linhas mais caras na tabela.

**Os créditos desapareceram sem serem gastos.** Procure uma linha **expirada**. Os créditos de teste expiram 30 dias depois de chegarem, os créditos de plano rolam um mês, e os créditos de pacote e recarga duram 90 dias.

**Uma alteração falhou e ainda quero saber se paguei.** As recusas que aconteceram antes de a alteração ser executada não custam nada. Uma falha genuína durante a execução é cobrada pelo peso de alteração de conta, porque o trabalho foi tentado. O feed de atividade distingue-os.

**O cartão Pacote de créditos não está a aparecer.** O pacote não é oferecido atualmente na sua conta. Tudo o resto na página funciona normalmente.

## Leitura Relacionada

- [Visão Geral do Kapsule Agents](https://support.kapsulehost.com/pt-pt/agents-overview)
- [Utilizar Competências do Agent](https://support.kapsulehost.com/pt-pt/agents-skills)
- [Como o Kora funciona: seu assistente de suporte com IA](https://support.kapsulehost.com/pt-pt/how-kora-works)