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

# Visão geral

> Recursos transformam eventos brutos em métricas de cobrança, definindo quais eventos contam e como são agregados.

> Recursos são a ponte entre eventos de uso e faturamento. Eles definem **quais eventos** entram no cálculo de cobrança e **como** esses eventos são agregados ao longo do ciclo.

<Frame>
  <img src="https://mintcdn.com/aira-e93056c6/D0DI4R_7r28AeG1L/static/resource-list.png?fit=max&auto=format&n=D0DI4R_7r28AeG1L&q=85&s=0de17699430c810df1e1cc514d2487a9" alt="Aira — Listagem de recursos" width="4056" height="2380" data-path="static/resource-list.png" />
</Frame>

<h2 id="o-que-e-um-recurso">
  O que é um recurso
</h2>

Um recurso é uma configuração que transforma eventos brutos em uma métrica de cobrança reutilizável. Ele faz duas coisas:

1. **Filtra** — seleciona quais eventos participam do cálculo (por `eventName`, propriedades ou tags)
2. **Agrega** — define como os valores dos eventos filtrados são combinados (soma, último do período ou valores únicos)

O resultado é um número único por ciclo de cobrança — a "volumetria" — que será precificado pelo [plano](/planos/criar-planos).

<Tip>
  Pense em recursos como queries reutilizáveis sobre os seus dados de uso. Você define a query uma vez e ela é executada automaticamente a cada ciclo de cobrança.
</Tip>

<br />

## Como recursos se encaixam no fluxo

<Steps>
  <Step title="Eventos (dados brutos)">
    Sua aplicação envia registros de uso para a Aira.
  </Step>

  <Step title="Recurso (filtragem + agregação)">
    O recurso filtra quais eventos contam e agrega seus valores em uma métrica.
  </Step>

  <Step title="Plano (precificação)">
    O plano aplica regras de preço sobre o valor agregado pelo recurso.
  </Step>

  <Step title="Fatura">
    O resultado é um item de linha na fatura do cliente.
  </Step>
</Steps>

Um mesmo conjunto de eventos pode alimentar múltiplos recursos. Por exemplo, a partir de eventos `ticket_resolved`:

* **Recurso A**: soma todos os tickets resolvidos (independente do agente)
* **Recurso B**: soma apenas tickets resolvidos por IA (`properties.agent_type = "ai"`)
* **Recurso C**: soma apenas tickets resolvidos por humanos

Cada recurso gera uma métrica independente que pode ser precificada de forma diferente no plano.

<br />

## Criar um recurso

<Tabs>
  <Tab title="Via Dashboard">
    1. Acesse **Recursos** no menu lateral
    2. Clique em **Novo Recurso**
    3. Configure:
       * **Nome** — nome descritivo (ex: "Requisições de API")
       * **Tipo** — Unitário ou Monetário
       * **Agregação** — Soma, Último do Período ou Único
       * **Filtros** — quais eventos incluir (por `eventName` e propriedades)
    4. Salve o recurso
  </Tab>

  <Tab title="Exemplo: Help desk com IA">
    Para um help desk que cobra separadamente por tickets resolvidos por IA e por humanos:

    **Recurso 1: Tickets IA**

    * Filtro: `eventName = "ticket_resolved"` AND `properties.agent_type = "ai"`
    * Agregação: Soma
    * Tipo: Unitário

    **Recurso 2: Tickets Humanos**

    * Filtro: `eventName = "ticket_resolved"` AND `properties.agent_type = "human"`
    * Agregação: Soma
    * Tipo: Unitário

    Ambos os recursos podem ser usados como métricas separadas no mesmo plano, cada um com seu próprio preço.
  </Tab>
</Tabs>

<br />

<h2 id="proximos-passos">
  Próximos passos
</h2>

* [Filtragem e agregação](/recursos/filtragem-e-agregacao) — entenda as opções de filtro e os tipos de agregação em detalhes
* [Tipos de recursos](/recursos/tipos-de-recursos) — aprenda a diferença entre recursos unitários e monetários
* [Planos](/planos/criar-planos) — veja como associar recursos a modelos de precificação