---
title: "Span-01: Modelo de Comportamento como Guard Rail para Desenvolvimento"
description: "Integrando o Span-01 ao ciclo de desenvolvimento para criar guard rails automáticos e validação de código contra documentação."
canonical: "https://ronanrodrigo.dev/notes/span-01-guardrails"
markdown: "https://ronanrodrigo.dev/notes/span-01-guardrails.md"
last-updated: "2026-09-26"
---
## Span-01: Entendendo o Modelo

[Span-01 no Modelo System](https://modelsystem.one/pt-br/models/span-01) é um modelo de pontuação de comportamento desenvolvido pela Respan, especializado em monitorar e avaliar respostas de inteligência artificial. Diferentemente de modelos generativos, o Span-01 lê trechos de conversas ou código e calcula a probabilidade de comportamentos específicos estarem presentes no texto, funcionando como um classificador de comportamento com alta precisão.

**Características principais:**
- Função: Análise de comportamento através de probabilidades
- Aplicações: Guard rails de segurança, avaliação de modelos, monitoramento de agentes de IA em larga escala
- Versões: Disponível em precisão padrão e versão mais leve (Span-01 Lite)
- Preço: USD 0,02 por milhão de tokens de entrada via OpenRouter, com tokens de saída gratuitos

## Aplicando Span-01 como Guard Rail no Desenvolvimento

O ciclo de desenvolvimento beneficia-se da análise comportamental do Span-01 em múltiplos pontos:

### Code Review Automático contra Documentação

Integre o Span-01 em seu pipeline de CI/CD para validar automaticamente que o código gerado ou modificado adere aos padrões definidos na documentação técnica. O modelo analisa trechos de código, comentários e commits, calculando a probabilidade de conformidade com as práticas documentadas.

**Implementação:**
1. Defina comportamentos esperados em sua documentação (padrões de erro handling, logging, segurança, performance)
2. Configure webhooks de pull request para executar análise com Span-01
3. Use as probabilidades retornadas como pass/fail: pontuações acima de 0,75 (75%) indicam conformidade
4. Bloqueie merge de PRs que falham critérios críticos (segurança, logging obrigatório)

### Guard Rails em Tempo de Geração

Se você usa assistentes de IA para gerar código, aplique Span-01 imediatamente após a geração para validar se a saída adere aos padrões. Isso é especialmente valioso em:

- **Geração de API endpoints**: Validar que tratamento de erros, autenticação e logging estão presentes
- **Geração de componentes**: Verificar conformidade com padrões de acessibilidade, performance e testes
- **Geração de scripts de infraestrutura**: Garantir que security groups, tags e backup policies seguem padrão documentado

### Monitoramento Contínuo de Comportamentos

Recolha métricas do Span-01 ao longo do tempo para entender padrões de comportamento em seu codebase:

- Quais áreas do código têm maior variância de conformidade?
- Há degradação comportamental em branches de desenvolvimento?
- Quais tipos de mudança mais frequentemente violam guard rails?

Essas métricas informam refatoração e treinamento de equipe.

## Implementação Prática

### Setup Mínimo com OpenRouter

```
# Variáveis de ambiente
SPAN01_API_KEY=seu_openrouter_token
SPAN01_MODEL=respan/span-01

# Análise de snippet de código
curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $SPAN01_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "respan/span-01",
    "messages": [
      {"role": "user", "content": "[CÓDIGO_OU_TRECHO_A_ANALISAR]"}
    ]
  }'
```

### Integração em GitHub Actions

Crie um workflow que valida PRs contra documentação:

1. Extraia trechos de código modificado (git diff)
2. Envie ao Span-01 com contexto da documentação relevante
3. Compare probabilidades contra thresholds definidos por tipo de mudança
4. Rejeite ou aprove baseado em pontuação

## Comparação com Alternativas

Span-01 não substitui linters ou testes unitários, mas complementa:

| Ferramenta | Força | Caso de Uso |
|---|---|---|
| **Linters (ESLint, Pylint)** | Sintaxe e padrões superficiais | Detecção de erros óbvios |
| **Span-01** | Avaliação semântica e comportamental | Conformidade contra documentação, padrões emergentes |
| **Testes Unitários** | Verificação de lógica e contratos | Garantia de funcionalidade |
| **Code Review Humano** | Julgamento contextual e mentoring | Decisões de design, knowledge sharing |

Span-01 preenche a lacuna entre validação automática rígida (linters) e revisão humana custosa.

## Recursos Adicionais

- [Documentação oficial do Span-01](https://modelsystem.one/pt-br/models/span-01)
- [OpenRouter - API para Span-01](https://openrouter.ai)
- [Respan - Criadora do modelo](https://respan.ai)