# Equipa de Pesquisa Multi-Agente com Verificação de Confiança

> Construa um pipeline de pesquisa multi-agente onde cada agente deve passar por uma verificação de confiança antes de participar, com todas as ações registadas num histórico de auditoria verificável.

- Fonte: https://doutorai.pt/apps/trust-gated-agent-team
- Categoria: Equipas de Agentes
- Dificuldade: Avançado
- Modelos: OpenAI
- Frameworks: -
- Corre local?: Precisa de APIs cloud
- Chaves necessárias: OPENAI_API_KEY
- Licença: Apache-2.0
- Site: Doutor AI (https://doutorai.pt) - ferramentas de IA para pequenos negócios em português

## Tutorial completo

# 🛡️ Equipa de Investigação Multi-Agente com Verificação de Confiança

Constrói um pipeline de investigação multi-agente onde cada agente de IA deve passar por uma **verificação de confiança** antes de participar, e cada ação é registada num **rasto de auditoria encadeado por hash** que é verificável de forma independente.

## Funcionalidades

- **Verificação de Confiança** - Os agentes são pontuados (0-100) e classificados (ouro/prata/bronze). Apenas os agentes que atingem o limiar podem participar
- **Rasto de Auditoria Criptográfico** - Cada ação do agente é registada com hashes SHA-256 encadeados à entrada anterior. Se algum registo for alterado, todos os hashes subsequentes ficam inválidos
- **Pipeline Multi-Agente** - Investigador → Analista → Escritor, cada um a construir sobre a saída anterior
- **Painel Visual** - Vê quais agentes passam, quais são bloqueados e verifica toda a cadeia de auditoria
- **Sem Dependências Externas** - Totalmente autónomo. Apenas requer `openai` e `streamlit`

## Como Funciona

```
                ┌─────────────────────┐
                │   Trust Registry    │
                │  (verify agents)    │
                └──┬───────┬───────┬──┘
                   │       │       │
             ┌─────▼──┐ ┌──▼────┐ ┌▼────────┐
             │Research │ │Analyst│ │ Writer  │
             │ ✅ 75   │ │ ✅ 60 │ │ 🚫 5   │
             └────┬───┘ └──┬────┘ └─────────┘
                  │        │
                  ▼        ▼
          ┌──────────────────────┐
          │  Research Pipeline   │
          │  (trusted only)      │
          └──────────┬───────────┘
                     │
                     ▼
          ┌──────────────────────┐
          │  Hash-Chained Audit  │
          │  (tamper-evident)    │
          └──────────────────────┘
```

# Verificação de Confiança

1. **Verificação de Confiança** - A pontuação de cada agente é verificada em relação ao limiar mínimo
2. **Portão** - Agentes abaixo do limiar são bloqueados do pipeline
3. **Executar** - Agentes verificados são executados em sequência, cada um construindo sobre a saída anterior
4. **Auditoria** - Cada ação (incluindo verificações de confiança) é registada numa cadeia de hashes

## Começar

### Pré-requisitos

- Python 3.9+
- Chave da API OpenAI

### Instalação

```bash
pip install -r requirements.txt
```

### Define a tua chave de API (opcional - também podes colar na barra lateral)

```bash
export OPENAI_API_KEY=your-api-key
```

### Run

```bash
streamlit run trust_gated_agents.py
```

### Início Rápido (3 passos)

1. Cola a tua chave de API do OpenAI na barra lateral
2. Clica em **Executar Pipeline com Confiança** - os agentes são pré-selecionados com um bot não confiável como Escritor
3. Observa: Investigador (75) e Analista (60) passam, Bot Não Confiável (5) é bloqueado

Troca o dropdown do Escritor para "Escritor de Relatórios (pontuação 45)" para ver os 3 a passar.

## Rasto de Auditoria

O rasto de auditoria utiliza o mesmo padrão de encadeamento de hashes que os registos de transações em blockchain:

```json
[
  {
    "seq": 0,
    "agent": "researcher-001",
    "action": "trust_verification",
    "hash": "a1b2c3...",
    "prev_hash": "0000000000000000000000000000000000000000000000000000000000000000"
  },
  {
    "seq": 1,
    "agent": "researcher-001",
    "action": "pipeline_step_1",
    "hash": "d4e5f6...",
    "prev_hash": "a1b2c3..."
  }
]
```

Cada entrada tem o seu `hash` calculado a partir de: `sequence + timestamp + agent + action + input_hash + output_hash + trust_score + prev_hash`. Alterar qualquer campo em qualquer entrada invalida todos os hashes subsequentes.

O JSON exportado é verificável de forma independente - não são necessárias ferramentas especiais, apenas SHA-256.

## Porque é que isto é importante

Em sistemas multi-agente, dois problemas se agravam:

1. **Confiança** - Como sabes quais agentes são fiáveis antes de lhes atribuíres trabalho?
2. **Responsabilidade** - Depois de algo correr mal, como reconstruís o que aconteceu?

A verificação de confiança resolve o problema #1 ao verificar credenciais antes da execução. O registo de auditoria resolve o problema #2 ao criar um registo à prova de manipulação que sobrevive à própria execução dos agentes - armazenado externamente, não na memória do próprio agente.

## Stack Tecnológico

- **Streamlit** - UI interativa com painel de confiança visual
- **OpenAI** - GPT-4o-mini para raciocínio de agentes
- **SHA-256** - Registo de auditoria encadeado por hash (sem dependências externas de criptografia)

## Poupe horas todas as semanas com IA, sem complicações

O **Doutor AI** dá-lhe 1859 prompts de IA prontos a copiar, por indústria e em português simples - mais uma biblioteca técnica completa para quem quer ir mais longe. [Ver planos →](https://doutorai.pt/precos)

---
Conteúdo de Doutor AI (https://doutorai.pt). Ao citar, indique a fonte: https://doutorai.pt/apps/trust-gated-agent-team