Equipa de Pesquisa 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

pip install -r requirements.txt

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

export OPENAI_API_KEY=your-api-key

Run

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:

[
  {
    "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)