Meu primeiro agent
Do canvas vazio ao agente publicado: quatro cards, três ligações e um assistente que pesquisa na web.
Atualizado em 10 de ago. de 2026
Vamos montar o agente mais útil possível com o mínimo de peças: um assistente que pesquisa na web antes de responder. São quatro cards e três ligações — este é o resultado no canvas:
- 1
Crie o agente
Em platform.hinow.ai, Criar → Agents → Novo agente. O canvas já abre com o card Início — ele é fixo, todo fluxo nasce nele.
- 2
Arraste o Agent
Da paleta à esquerda, arraste o card Agent para baixo do Início. Clique nele para abrir o modal: dê o nome
Pesquisador, escolha o modelo (usamoshinow/himax, o modelo da casa) e escreva o prompt — ver abaixo. - 3
Arraste a Busca Web
Arraste Busca Web para o lado direito do Agent. No modal, deixe
num_results: 5(o padrão já serve). - 4
Faça as três ligações
Saída do Início → topo do Agent (fluxo). Handle esquerdo da Busca Web → slot direito do Agent (ferramenta, a linha tracejada). Saída do Agent → topo do Fim.
- 5
Teste e publique
Use o chat de teste do editor ("qual a cotação do dólar hoje?") e veja o agente decidir chamar a busca. Funcionou? Publicar — a versão publicada é a que a API serve.
Só dois cards precisam de configuração real neste agente:
{
"name": "Pesquisador",
"model": "hinow/himax",
"system_prompt": "Você é um assistente de pesquisa. Quando a pergunta envolver fatos atuais (notícias, preços, eventos), USE a ferramenta de busca antes de responder. Cite as fontes que usar. Se a pergunta for atemporal, responda direto.",
"config": {
"temperature": 0.7,
"max_tokens": 4096,
"max_tool_loops": 10
}
}{
"config": {
"num_results": 5,
"safe_search": true
}
}O prompt é o manual da ferramenta
O modelo só chama a busca quando entende que deve. Dizer quando usar ("fatos atuais") e o que fazer com o resultado ("cite as fontes") no prompt vale mais que qualquer configuração.
As três linhas do canvas têm dois papéis diferentes — e entender isso é entender o builder inteiro:
| Ligação | Tipo | O que significa |
|---|---|---|
| Início → Pesquisador | Fluxo (linha cheia) | Ordem de execução: a mensagem do usuário entra e o turno começa no agente. |
| Busca Web → slot do Pesquisador | Ferramenta (tracejada) | NÃO é executada em sequência — vira uma *tool* que o modelo pode chamar quantas vezes quiser durante o turno (até max_tool_loops). |
| Pesquisador → Fim | Fluxo (linha cheia) | Quando o agente termina a resposta, o turno encerra com status success. |
Em execução, um turno típico fica assim: a pergunta chega pelo Início → o Pesquisador lê o prompt e decide chamar web_search("cotação do dólar hoje") → recebe os 5 resultados → escreve a resposta citando as fontes → o fluxo segue ao Fim. No stream de eventos você vê exatamente essa história: workflow_node_start → tool_use → tool_result → agent_message → done.
Tudo que você montou vira um workflow {nodes, edges} gravado no agente — é o que a API executa depois do publish:
{
"nodes": [
{ "id": "start", "type": "start", "data": { "label": "Início", "variables": [] } },
{ "id": "agent-1", "type": "agent", "data": { "name": "Pesquisador",
"model": "hinow/himax", "system_prompt": "Você é um assistente de pesquisa..." } },
{ "id": "search-1", "type": "web_search", "data": { "config": { "num_results": 5 } } },
{ "id": "end-1", "type": "end", "data": { "label": "Fim", "status": "success" } }
],
"edges": [
{ "source": "start", "target": "agent-1" },
{ "source": "search-1", "sourceHandle": "tool", "target": "agent-1", "targetHandle": "slot-1" },
{ "source": "agent-1", "sourceHandle": "output", "target": "end-1" }
]
}Repare no targetHandle: "slot-1" — é assim que o runtime sabe que a Busca Web é ferramenta do agente, e não um passo do fluxo.
curl -N -X POST https://agents.hinow.ai/v1/agents/SEU_AGENT_ID/run \
-H "Authorization: Bearer hi_SUA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"message": "qual a cotação do dólar hoje?"}'