Um agente de IA é um briefing guardado. Os workflows usam-no para escrever, por isso, em vez de descrever o que quer em cada execução, descreve-o uma vez e o agente aplica-o sempre.
Os agentes são criados e geridos a partir do passo Use AI agent de um workflow, e esse é o único sítio onde existem.
O passo Use AI agent, selecionado no construtor de workflows. Pick AI agent é também onde se cria um agente.
Criar um agente
Num workflow, selecione o passo Use AI agent e depois New agent. Um agente tem cinco elementos.
Agent name — Used to identify this agent in workflows. Dê-lhe o nome do trabalho que faz: RSS summariser, DM responder.
Prompt — Defines the agent persona, context, and behavior. Isto é o agente. Tudo o resto são interruptores.
LLM — Select which provider and model to use for this agent. As opções são GPT-4o mini, GPT-4o e GPT-5.1.
Image generation — Allow the agent to generate images if needed.
Web search — Allow the agent to search the web if needed.
Escrever o prompt
O valor por defeito é You are a helpful assistant, que produz exatamente o resultado insípido que seria de esperar. Um prompt que vale a pena cobre quatro coisas:
- Como quem escreve — a marca, o que faz, quem lhe compra
- O trabalho — transformar o artigo numa publicação curta que dê vontade de o ler
- Restrições — tamanho, tom, o que evitar, se inclui uma ligação
- O que não fazer — sem hashtags, sem emojis, não inventar estatísticas
A diferença entre um prompt de duas linhas e um bem pensado é a diferença entre uma automatização que desliga ao fim de uma semana e uma que deixa a funcionar.
O prompt do agente é independente do seu perfil da marca, que é lido pelo resto da IA do Ocoya. Um agente só sabe o que o seu prompt lhe diz, por isso repita lá o essencial.
Escolher um modelo
O GPT-4o mini é o mais rápido e o mais barato de executar. É adequado para resultados curtos e formulaicos, como a confirmação de uma DM ou a resposta de uma linha a um comentário.
O GPT-4o e o GPT-5.1 lidam melhor com nuances. Compensam quando o resultado é público e variado, como transformar um artigo numa publicação ou responder a algo que exige uma leitura cuidada.
O custo em créditos não muda com o modelo: uma execução de workflow custa 1 crédito, qualquer que seja a sua escolha.
Geração de imagens e pesquisa na web
Deixe ambas desligadas, a menos que o agente precise delas.
A Image generation faz sentido para um agente que alimenta um passo Create social post em que quer uma imagem de cada vez. A Web search faz sentido quando o agente precisa de algo que vá além do que o gatilho lhe fornece.
Cada uma acrescenta tempo a uma execução e mais margem para falhas, por isso ative-as de forma deliberada e não por defeito.
Teste antes de ativar
Existe um botão Test — Your agent is always ready. Ask it for something. Um teste custa 1 crédito.
Teste sempre primeiro. Um crédito gasto a verificar vale mais do que descobrir um prompt mau ao fim de trinta execuções reais, e é a única forma de ver o resultado do agente antes de as pessoas o verem.
A reutilização melhora tudo de uma só vez
Um agente pertence à marca e pode ser usado por vários workflows. Melhorar o seu prompt melhora todos os workflows que o usam, o que justifica ter poucos agentes bem escritos em vez de um por workflow.
Edit AI agent e Delete AI agent estão no mesmo painel. Um agente que ainda esteja a ser usado por um workflow não pode ser eliminado até o desligar nesse workflow.