modbender 📄 Skill: Registro de Contrato de Locação
Esta skill registra contratos de locação por meio de um Google Forms, realizando validação completa dos dados, gerando um resumo para confirmação e executando o envio somente após aprovação.
⚠️ Regras de Execução (Obrigatórias)
- Todos os campos obrigatórios são validados antes da execução.
- A variável de ambiente
FORM_IDé obrigatória. - O agente deve apresentar o resumo dos dados e solicitar confirmação explícita do usuário.
- Em caso de erro de validação, a execução é abortada.
- Suporte a modo de simulação com
DRY_RUN.
⚙️ Variáveis de Ambiente
FORM_ID (obrigatória)
ID do Google Forms que receberá os dados.
export FORM_ID="SEU_FORM_ID"
DRY_RUN (opcional)
Quando definida, a skill não envia dados reais, apenas exibe o payload gerado.
export DRY_RUN=1
📥 Forma de Entrada de Dados
✅ Recomendado: STDIN
echo '{"dados": {...}}' | python3 scripts/main.py
Alternativa: Argumento CLI
python3 scripts/main.py '{"dados": {...}}'
📦 Estrutura Esperada do Payload
{
"dados": {
"email": "string (obrigatório)",
"telefone": "string (obrigatório, apenas dígitos)",
"nome": "string (obrigatório)",
"cpf": "string (obrigatório, apenas dígitos)",
"endereco": "string (obrigatório)",
"numero": "string (obrigatório)",
"bairro": "string (obrigatório)",
"cidade": "string (obrigatório)",
"estado": "UF (obrigatório)",
"data_entrada": "YYYY-MM-DD (obrigatório)",
"data_saida": "YYYY-MM-DD (obrigatório)",
"valor": "string (obrigatório)",
"caucao": "string (opcional)",
"complemento": "string (opcional)"
}
}
📘 Exemplo de Payload
{
"dados": {
"email": "exemplo@email.com",
"telefone": "11988887777",
"nome": "Fulano de Tal",
"cpf": "12345678910",
"endereco": "Rua das Flores",
"numero": "123",
"bairro": "Centro",
"cidade": "São Paulo",
"estado": "SP",
"data_entrada": "2025-05-01",
"data_saida": "2025-05-05",
"valor": "2500",
"caucao": "1000",
"complemento": "Apto 42"
}
}
📥 Parâmetros de Entrada
Campos Obrigatórios
| Campo | Tipo | Descrição |
|---|---|---|
email |
string | E-mail do locatário |
telefone |
string | Telefone com DDD |
nome |
string | Nome completo |
cpf |
string | CPF (11 dígitos) |
endereco |
string | Rua / Avenida |
numero |
string | Número |
bairro |
string | Bairro |
cidade |
string | Cidade |
estado |
string | UF (2 letras) |
data_entrada |
string | Formato YYYY-MM-DD |
data_saida |
string | Formato YYYY-MM-DD |
valor |
string | Valor total |
Campos Opcionais
| Campo | Tipo | Descrição |
|---|---|---|
caucao |
string | Depósito caução |
complemento |
string | Complemento do endereço |
🔄 Fluxo de Execução
- Coleta dos dados via chat.
- Validação estrutural e de formato.
- Exibição de resumo para confirmação.
- Execução da skill após confirmação.
- Envio dos dados via POST para Google Forms.
- Retorno de sucesso ou erro.
✅ Retornos Esperados
Sucesso
Sucesso: contrato registrado e PDF será enviado.
Erro de Validação
Erro: Campos obrigatórios ausentes: email, cpf
Modo DRY_RUN
[DRY-RUN] Payload gerado: {...}
Versão 1.0.0