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

# Pontuações de Confiança

> Avaliação contínua de confiança comportamental para agentes de IA com fatores de pontuação configuráveis.

# Pontuações de Confiança

As pontuações de confiança fornecem uma **avaliação contínua e em tempo real** da confiabilidade comportamental de um agente de IA. Cada agente na plataforma Truthlocks recebe uma pontuação de 0 a 100, atualizada após cada ação.

## Como funciona

```
Agent Action → Event Logged → Score Recomputed → Policy Evaluated
                                    │
                              ┌─────┴─────┐
                              │ Score: 87  │
                              │ Trend: ↑   │
                              └────────────┘
                                    │
                        ┌───────────┼───────────┐
                        ▼           ▼           ▼
                    No Action   Alert Team   Suspend Agent
                   (score > 70) (50 < s < 70) (score < 50)
```

> [!TIP]
>
> Todos os endpoints de pontuação de confiança e testemunha possuem um playground de API interativo. Abra qualquer endpoint na referência da API [Confiança e Testemunha](https://docs.truthlocks.com/pt/api-reference/machine-identity/trust-scores/get.md) e clique em **Enviar** para testá-lo ao vivo.

## Fatores de pontuação

| Fator | Peso Padrão | Descrição |
| - | - | - |
| `behavioral_compliance` | 35% | As ações permanecem dentro dos limites do escopo declarado |
| `scope_adherence` | 25% | Nenhuma tentativa de acessar recursos não autorizados |
| `anomaly_score` | 20% | Desvio estatístico dos padrões de comportamento históricos |
| `peer_attestations` | 10% | Outros agentes na rede de testemunhas atestam o comportamento |
| `session_hygiene` | 10% | Ciclo de vida da sessão adequado (criação, renovação, término) |

## Lendo Pontuações de Confiança

### Obter pontuação atual

```bash theme={null}
curl https://api.truthlocks.com/v1/trust-scores/maip-agent:01JXXXX \
  -H "X-API-Key: $API_KEY"
```

```json theme={null}
{
  "agent_id": "maip-agent:01JXXXX",
  "score": 87,
  "factors": {
    "behavioral_compliance": 92,
    "scope_adherence": 95,
    "anomaly_score": 12,
    "peer_attestations": 78,
    "session_hygiene": 90
  },
  "trend": "stable",
  "computed_at": "2026-04-06T12:00:00Z"
}
```

### Obter histórico de pontuação

```bash theme={null}
curl "https://api.truthlocks.com/v1/trust-scores/maip-agent:01JXXXX/history?period=7d" \
  -H "X-API-Key: $API_KEY"
```

### Forçar recálculo

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/trust-scores/maip-agent:01JXXXX/compute \
  -H "X-API-Key: $API_KEY"
```

## Configurando Limiares

| Limite | Ação Recomendada |
| - | - |
| 90-100 | Autonomia total — o agente opera sem intervenção |
| 70-89 | Operação padrão — monitorização normal |
| 50-69 | Monitorização melhorada — alertar equipa, aumentar a verbosidade do registo |
| 30-49 | Modo restrito — requer aprovação humana para ações críticas |
| 0-29 | Suspensão automática — kill switch acionado |

## Rede de Testemunhas

Os agentes podem participar de uma **rede de testemunhas** onde os pares atestam o comportamento uns dos outros.

### Criar uma Solicitação de Testemunha

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/witness/request \
  -H "X-API-Key: $API_KEY" \
  -d '{
    "subject_agent_id": "maip-agent:01JXXXX",
    "claim": "Completed invoice processing without errors",
    "evidence": { "task_id": "task_456", "records_processed": 150 }
  }'
```

### Atestar como Testemunha

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/witness/maip-witness:01JWWWW/attest \
  -H "X-API-Key: $API_KEY" \
  -d '{
    "attestor_agent_id": "maip-agent:01JBBBB",
    "verdict": "confirmed",
    "confidence": 0.95
  }'
```

### Consenso

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/witness/maip-witness:01JWWWW/consensus \
  -H "X-API-Key: $API_KEY"
```

```json theme={null}
{
  "witness_id": "maip-witness:01JWWWW",
  "consensus": "confirmed",
  "confidence": 0.91,
  "attestations": 4,
  "quorum_met": true
}
```

## Integração com o Risk Engine

As pontuações de confiança alimentam diretamente o motor de avaliação de risco do Truthlocks. Pontuações de confiança baixas aumentam automaticamente o sinal de risco para qualquer ação que o agente execute:

```
Trust Score < 50 → Risk Signal: HIGH → Action blocked or requires approval
```

## Medição de uso

Cada cálculo de pontuação de confiança sob demanda incrementa o contador de uso `maip.trust_computes` para o seu ciclo de faturamento. As atualizações de pontuação em segundo plano acionadas pela plataforma (como após ações do agente) também contam para esta métrica.

Você pode monitorar seu consumo com a [API de uso](https://docs.truthlocks.com/pt/api-reference/billing/usage.md) ou no console em **Configurações > Cobrança > Uso** na seção **MAIP**.

> [!NOTE]
>
> As cotas de cálculo de pontuação de confiança variam de acordo com o nível do plano. Consulte a [visão geral de faturamento](https://docs.truthlocks.com/pt/billing/overview.md#metered-products) para obter detalhes sobre todos os produtos medidos pelo MAIP.

## Próximos passos

> [card] [Identidade da Máquina](https://docs.truthlocks.com/guides/machine-identity.md)
>
> Visão geral completa do Protocolo de Identidade do Agente de Máquina.

> [card] [Delegação entre Inquilinos](https://docs.truthlocks.com/guides/cross-tenant-delegation.md)
>
> Permitir que agentes operem em diferentes limites organizacionais.


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