zihin-criar-agente

Criar e publicar um agente Zihin

Sequência canônica — não pule a validação nem inverta a ordem:

Passo 1 — Criar o agente

create_agent com name (interno), commercial_name (exibido ao usuário final), bio, type (assistant | chatbot | workflow | classifier | orchestrator — orchestrator invoca outros agentes) e llm_config:

• model: "provider.modelo" explícito (ex.: openai.gpt-4.1-nano) ou "auto" (roteamento inteligente). Consulte modelos válidos no resource zihin://models — NUNCA invente IDs de modelo. O prefixo de provider é obrigatório: "gpt-4o" é rejeitado, "openai.gpt-4o" é aceito.
• fallback_chain: até 5 modelos ordenados, sem repetição.
• max_iterations: teto de iterações do loop por turno (máx. 30 — o runtime clampa aí).
• Contrato completo em zihin://schemas/llm_config. Ele é campo da tool, não schema_data — validate_schema_data não aceita esse tipo.
• Guarde o agent_id retornado.

Tier do plano — onde o erro aparece. Modelo acima do tier não bloqueia create_agent nem update_agent: a chamada passa e volta com warnings explicando. O bloqueio é no publish_agent, com MODEL_TIER_RESTRICTED. Se vier um warnings sobre tier, trate ali — trocar o modelo ou usar "auto" — em vez de seguir e descobrir na publicação. whoami informa o plano do tenant.

Outro erro esperável: PLAN_LIMIT_REACHED (limite de agentes do plano).

Passo 2 — Persona (obrigatória antes de publicar)

create_schema com schema_type: "persona_config". Formato canônico ÚNICO aceito:

{
  "editor_schema": {
    "persona": {
      "role": "Assistente de atendimento",        // obrigatório, min 3 chars
      "objective": "Responder dúvidas de clientes de forma objetiva.", // obrigatório, min 10 chars
      "tone": "profissional",
      "language": "pt-BR",
      "expertise": ["área 1"],
      "constraints": ["NUNCA fazer X", "SEMPRE fazer Y"],
      "personality_traits": ["Objetivo"]
    }
  }
}

O formato legado com instructions na raiz NÃO funciona. Contrato formal: zihin://schemas/persona_config. Pergunte ao usuário sobre objetivo/comportamento antes de criar — não invente persona.