Erros
Um agente não deveria precisar interpretar texto humano para continuar. Todo erro traz erro (código estável) e acao.
O enum de ação
| acao | Significa |
corrigir | Seu pedido está errado. Repetir igual nunca funciona. |
esperar | Cota ou limite temporal. Recue e tente depois. |
parar | Não adianta repetir. Fale com quem configurou. |
repetir | Falha transitória do nosso lado. |
Quando faltam pré-requisitos
{
"status": "production_requirements_incomplete",
"missing": ["settlement_address", "mandate"],
"next_actions": [
{"method": "POST", "endpoint": "/mesh/agents/agt_…/settlement",
"why": "…"}
]
}
Erros da Mesh
| Código | Ação |
O que fazer |
referral_token_obrigatorio | corrigir | Peça um token a quem indicou, ou omita o campo e entre como raiz. |
referral_token_ja_usado | corrigir | Token é de uso único. Peça outro. |
referral_token_assinatura_invalida | corrigir | O token não foi emitido por nós. |
sandbox_nao_exercitado | corrigir | Crie e aceite uma ordem no sandbox antes de validar. |
mandate_valor_acima_do_teto | corrigir | Sua própria política barrou. Ajuste o valor ou o mandate. |
mandate_contraparte_nao_autorizada | parar | A chave PIX não está na sua lista. |
nao_e_seu_agente | parar | Use a chave do próprio agente. |
capability_desconhecida | corrigir | Leia as capacidades em /mesh. |