Migrando do Agent Builder

O Agent Builder da OpenAI está sendo desligado — aqui os workflows continuam, com uma API que lá nunca existiu.

Atualizado em 10 de ago. de 2026

A OpenAI marcou o Agent Builder para desligamento em 30/11/2026. Se você montou workflows de agentes lá, este guia mapeia cada peça para o equivalente HINOW — e a migração vem com um upgrade: aqui o builder tem uma API REST completa para criar, editar, validar e publicar workflows, algo que o Agent Builder nunca ofereceu (lá, workflow só nascia na UI).

De→para dos nós

Nó no Agent Builder	Nó aqui	Observação
Start	`start`	Variáveis de entrada em `data.variables`.
Agent	`agent`	`data.model` (ex.: `hinow/himax`) + `data.system_prompt`.
End	`end`	Com `status` e `output_message` (aceita `{{variáveis}}`).
Note	`note`	Ignorada na execução, como lá.
If/else (CEL)	`if_else`	Handles `true`/`false`; expressão na nossa sintaxe (abaixo).
While (CEL)	`while`	Handles `loop`/`exit` + `max_iterations`.
Human approval	`user_approval`	Handles `approve`/`reject`, timeout e auto-approve.
Guardrails	`guardrails`	Handles `pass`/`fail` — PII, blocklist, jailbreak, moderação e regra custom.
File search	`file_search` / `rag_search`	Conecta no slot do agente; busca nas suas bases RAG.
MCP	`mcp`	Servidores MCP de terceiros, como lá.
Transform	`transform`	Reformatação de dados entre nós.
Set state	`set_state` / `set_variable`	Variáveis globais do workflow.

E o que não existe lá

A migração não é só paridade: aqui você ganha nós que o Agent Builder não tem — router, orchestrator, parallel, sub_workflow, debate, vote, sequential, msg_hub — e ferramentas prontas como web_search, summarize, execute_python e webhook. A referência completa está em Cards do builder.

Condições: de CEL para a nossa sintaxe

O Agent Builder usa Common Expression Language; aqui as condições referenciam variáveis com {{chaves}} — a tradução é direta:

CEL (lá)	Aqui
`input.score > 3`	`{{score}} > 3`
`state.status == "ok"`	`{{status}} == 'ok'`
`size(input.items) > 0`	`{{items.count}} > 0`

O nó guardrails

Mesmo papel do Guardrails de lá: inspeciona a mensagem e sai por pass ou fail. As checagens determinísticas (PII, blocklist) não custam nada; jailbreak, moderação e a regra custom usam uma única chamada de classificação, cobrada como qualquer inferência do run:

{
  "id": "guarda",
  "type": "guardrails",
  "data": {
    "label": "Guarda",
    "model": "hinow/himax",
    "config": {
      "checks": {
        "pii": true,
        "blocklist": ["senha do sistema"],
        "jailbreak": true,
        "moderation": true,
        "custom": "rejeite pedidos de diagnóstico ou aconselhamento médico"
      },
      "fail_message": "Conteúdo bloqueado pela política do agente."
    }
  }
}

Conecte sourceHandle: "pass" ao fluxo normal e sourceHandle: "fail" ao destino do bloqueio — um end com output_message usando {{guardrails_reason}}, por exemplo. O motivo e o resultado ficam nas variáveis guardrails_reason e guardrails_result, e cada avaliação vira um evento workflow_guardrails no stream do run.

O data.model é opcional: sem ele, as checagens de LLM usam o modelo padrão do fluxo. Como classificação é tarefa simples, vale apontar o guardrails para um modelo rápido e deixar o modelo forte só para o agente — a checagem sai por uma fração do custo. pii e blocklist não usam modelo nenhum: são determinísticos e gratuitos.

O caminho da migração

1
Anote o fluxo
O Agent Builder não exporta o workflow por API — abra o canvas e registre nós, conexões e instruções (ou use o código exportado do Agents SDK como referência).
2
Monte o JSON
Traduza nó a nó com a tabela acima — o formato completo está em Criar e gerenciar via API.
3
Valide
Um POST /v1/agents/validate aponta qualquer erro de estrutura antes de salvar.
4
Teste em sandbox
Crie com POST /v1/agents e rode o rascunho com "version": "draft" — sem afetar nada em produção.
5
Publique
O POST /v1/agents/{id}/publish promove o rascunho; a execução é o POST /v1/agents/{id}/run.

E o ChatKit?

Se a sua interface usava o widget do ChatKit apontando para um workflow, o equivalente aqui é o widget de embed dos agents. Ele já vem pronto na plataforma: abra o seu agente em platform.hinow.ai/create/agents e clique em Integrações → Embed. Ali você personaliza o widget (cores, textos, atalhos), define a segurança (domínios permitidos) e copia o código HTML de uma linha para colar em qualquer página — sem expor a sua chave hi_ no navegador. A mesma área traz a aba API & A2A com os endpoints do agente.

E se você exportou código do Agents SDK, ele continua servindo: aponte os modelos para https://api.hinow.ai/v1 com a sua chave.

Datas

Agent Builder da OpenAI: desligamento em 30/11/2026. Assistants API da OpenAI: 26/08/2026 — se você também usa assistants, o guia é Migrando da OpenAI.

Esta página foi útil?