Construindo agentes

Um agente executa um ciclo controlado: envia mensagens e ferramentas ao modelo, recebe uma solicitação de função, valida e executa a ação, devolve o resultado e repete até obter uma resposta final.

1. 1

   Declare ferramentas pequenas

   Use nomes específicos, descrições objetivas e parâmetros restritos por JSON Schema.

2. 2

   Valide antes de executar

   Trate argumentos como entrada não confiável. Verifique tipos, permissões e limites.

3. 3

   Devolva o resultado

   Inclua a mensagem de ferramenta com o tool_call_id correspondente.

4. 4

   Imponha limites

   Defina máximo de etapas, timeout, tentativas e orçamento.

5. 5

   Confirme ações de impacto

   Exija aprovação humana antes de cobrar, apagar, publicar ou enviar.

Escolha do modelo

Comece com HiNova para uso geral. Avalie HiMax quando o fluxo exigir planejamento, muitas restrições ou análise complexa; avalie HiGenesis em ferramentas simples, repetíveis e de alto volume. A decisão final deve vir dos seus testes.

Checklist de produção

• Registre chamadas, ferramentas, argumentos, resultados, custo e duração.
• Use idempotência em ações repetíveis.
• Retorne erros estruturados para permitir correção.
• Bloqueie dados e ferramentas fora do escopo do usuário.
• Teste sucesso, recusa, timeout, repetição e resultado vazio.
• Tenha uma saída segura para o limite de etapas.