Este artigo demonstra como escrever bons prompts para o Super Agent do ClickUp.
Nunca usou Super Agents? Leia o artigo O que são Super Agents? antes de começar.
A disponibilidade e os limites dos recursos variam conforme o plano e o perfil do usuário. Saiba mais
Há configurações de privacidade, segurança e permissões que se aplicam exclusivamente aos Super Agents. Saiba mais
Para usar Super Agents, você precisa ativar o AI ClickApp no seu Espaço de trabalho.
Nunca usou Super Agents? Leia o artigo O que são Super Agents? antes de começar.
Configurar um Super Agent manualmente
Certifique-se de ter todas as informações necessárias! Saiba como configurar manualmente seu Super Agent, incluindo a inserção do prompt.
Os Super Agents também podem ser criados no nosso construtor de Super Agent em linguagem natural.
Os trechos de prompt descritos abaixo estão divididos em seções. Em cada seção, há um exemplo de prompt bom e um prompt otimizado.
Função e objetivo
Os Super Agents do ClickUp funcionam como colegas de trabalho. Você pode atribuir a eles uma função ou persona e delegar tarefas. Pense neles como um novo funcionário ou alguém que acabou de assumir um cargo.
| Prompt bom | Prompt otimizado |
| Você é um agente de conteúdo e insights focado em identificar novos recursos de produto lançados recentemente e transformá-los em resumos claros, em linguagem acessível, e em argumentos de vendas para jovens profissionais entusiastas de tecnologia, mas que podem não ter formação técnica. | Você é um agente perspicaz e criativo focado em identificar novos recursos de produto lançados recentemente, coletar informações sobre esses recursos e transformar essas informações em argumentos de vendas convincentes para jovens profissionais entusiastas de tecnologia, mas que podem não ter formação técnica. |
Por que o prompt otimizado é melhor?
O prompt otimizado usa linguagem rica. Por exemplo, "Você é um agente perspicaz e criativo."
- A linguagem rica dá ao Super Agent nuance e contexto para tarefas que exigem raciocínio subjetivo, dedução ou síntese semelhantes aos de um humano.
O prompt otimizado usa o mesmo termo para manter a consistência e repete os termos para que o Super Agent não precise inferir nenhuma informação. Por exemplo, "focado em identificar novos recursos de produto lançados recentemente, coletar informações sobre esses recursos e transformar essas informações em argumentos de vendas."
- Manter a consistência dos termos e reduzir inferências preserva a capacidade de processamento do Super Agent para a tarefa principal.
Escopo
Esta parte do prompt apresenta ao Super Agent o escopo da tarefa.
| Prompt bom | Prompt otimizado |
| Toda semana, colete os trabalhos de funcionalidades concluídos em todo o espaço de trabalho nos últimos 7 dias. Exclua correções de bugs óbvias, tarefas de manutenção, refatorações ou tarefas exclusivamente internas quando identificadas por título ou etiquetas. |
Toda semana, colete os trabalhos de funcionalidades concluídos em todo o espaço de trabalho nos últimos 7 dias. Concentre-se em novos recursos de produto, excluindo correções de bugs óbvias, tarefas de manutenção, refatorações ou tarefas exclusivamente internas quando identificadas por título ou etiquetas. |
Por que o prompt otimizado é melhor?
O prompt otimizado usa comandos positivos em vez de negativos. Por exemplo, "Concentre-se em novos recursos de produto, excluindo correções de bugs óbvias, tarefas de manutenção, refatorações ou tarefas exclusivamente internas quando identificadas por título ou etiquetas."
- Quando você começa a frase dizendo ao Super Agent para "excluir correções de bugs óbvias", ele gasta capacidade de processamento pensando em bugs em vez de encontrar novos recursos de produto.
- Começar de forma positiva, com "Concentre-se em novos recursos de produto", permite que o Super Agent direcione sua capacidade de processamento para encontrar novos recursos em vez de se concentrar em bugs.
Próximas etapas
Informe ao Super Agent quais ferramentas usar. Por exemplo, para identificar novos recursos de produto, o Super Agent precisará ter acesso a todo o Espaço de trabalho ou a parte dele.
Saiba mais sobre como criar Super Agents no ClickUp.
No prompt, diga ao Super Agent como usar a ferramenta. Por exemplo, você pode instruí-lo: "Verifique se existe uma tarefa chamada 'Recursos semanais do produto'; se não encontrar, crie-a usando a ferramenta de criação de tarefas."
Saiba mais sobre como usar as ferramentas de IA do Brain.
Orientações de redação
Esta parte do prompt instrui o Super Agent sobre o que produzir com base nas informações coletadas.
| Prompt bom | Prompt otimizado |
| Forneça de 1 a 3 argumentos de vendas diretos por funcionalidade, usando linguagem orientada à ação e benefícios específicos. | Forneça de 1 a 3 argumentos de vendas diretos por funcionalidade, usando linguagem orientada à ação e benefícios específicos. Use as informações coletadas sobre os recursos para refletir sobre como eles poderiam beneficiar ou entusiasmar clientes jovens e apaixonados por tecnologia que não têm formação técnica. Escreva em linguagem direta e orientada à ação que crie uma imagem envolvente e empolgante de como vender cada recurso. |
Por que o prompt otimizado é melhor?
O prompt otimizado demonstra causa e efeito de forma eficiente. Por exemplo, "Destile as informações coletadas sobre os recursos em argumentos de vendas de alto impacto que falem diretamente às necessidades dos clientes."
- Esse tipo de linguagem é útil quando o Super Agent não está aproveitando suficientemente algum elemento do seu prompt na saída.
O prompt otimizado usa causa e efeito para pedir ao Super Agent que transforme as informações coletadas na saída. Por exemplo, "Use as informações coletadas sobre os recursos para refletir sobre como eles poderiam beneficiar ou entusiasmar clientes jovens e apaixonados por tecnologia que não têm formação técnica."
- Use esse tipo de linguagem quando o Super Agent estiver se fixando em apenas uma parte do seu prompt.
O prompt otimizado traz outro exemplo de linguagem rica: "Escreva em linguagem direta e orientada à ação que crie uma imagem envolvente e empolgante de como vender cada recurso."
- Use esse tipo de linguagem para obter exatamente a saída que você está buscando.
Formato de saída
Esta parte do prompt funciona como um modelo que diz ao Super Agent como formatar sua saída.
| Prompt bom | Prompt otimizado |
| Entradas de funcionalidades: Nome: (título da tarefa) Fonte: link para a tarefa O que é: explicação em 1 a 2 frases em linguagem acessível |
Formato das entradas de funcionalidades: Nome: (título do recurso) Fonte: link para a tarefa sobre o recurso O que é o recurso: (Explique de forma concisa o que é o recurso, como ele funciona e como ele se encaixa no produto como um todo.) |
Por que o prompt otimizado é melhor?
Os dois prompts fornecem um modelo com parênteses. O Super Agent saberá substituir o marcador pelo conteúdo que coletou. Por exemplo, "Nome: (título do recurso)."
O prompt otimizado é muito mais descritivo. Por exemplo, "O que é o recurso: (Explique de forma concisa o que é o recurso, como ele funciona e como ele se encaixa no produto como um todo.)"
- Use a formatação de saída quando o Super Agent se beneficiar de orientações em vez de definir o formato por conta própria. Por exemplo, em relatórios estruturados, POPs ou blogs.
Próxima etapa
Para reforçar a estrutura que você está buscando, você pode complementar esta seção com um resumo. Por exemplo:
"Formato de saída: Produza um Markdown polido e pronto para publicação na página semanal. Use parágrafos curtos e listas com marcadores. Mantenha cada entrada de funcionalidade com no máximo ~120 palavras, excluindo os marcadores."
Use delimitadores para rotular as seções do prompt
Quando seu prompt incluir material de referência — como diretrizes de marca, descrições de produto ou conteúdo de exemplo — indique onde cada seção começa e termina.
| Prompt bom | Prompt otimizado |
| Diretrizes de marca: 1 Use frases curtas. 2 Evite jargões. 3 Sempre comece com o benefício. Descrição do produto: Um Super Agent que garante que todos sigam as diretrizes de marca. |
Diretrizes de marca: 1 Use frases curtas. 2 Evite jargões. 3 Sempre comece com o benefício. --fim das diretrizes de marca-- Descrição do produto: Um Super Agent que garante que todos sigam as diretrizes de marca. —fim da descrição do produto— |
Por que o prompt otimizado é melhor?
O prompt otimizado usa delimitadores para marcar explicitamente onde cada seção termina. Isso elimina ambiguidade e permite que o Super Agent passe de uma seção para a próxima sem precisar adivinhar.
Você pode formatar os delimitadores como preferir, desde que seja consistente ao longo do prompt. Algumas opções:
- --fim de [nome da seção]--
-
Tags XML: <brand_guidelines> Seu conteúdo aqui </brand_guidelines>
- Tags XML são um formato de delimitador especialmente eficaz. Modelos de IA geralmente interpretam esses limites de forma confiável.
- Traços ou outros separadores visuais
Evite abreviações e linguagem vaga
Super Agents não entendem linguagem abreviada tão bem quanto os humanos. Preserve a capacidade de processamento do Super Agent para gerar saídas melhores.
| Prompt bom | Prompt otimizado |
| Olha o doc e escreve alguma coisa pras redes sobre o novo recurso. | Leia o briefing do produto e escreva uma publicação para redes sociais anunciando o novo recurso de agendamento. Concentre-se no benefício para equipes remotas. |
Por que o prompt otimizado é melhor?
O prompt otimizado substitui termos vagos por termos específicos, mantendo o Super Agent focado na tarefa em vez de interpretar abreviações ou linguagem imprecisa.
Usando comandos positivos ou negativos
Se a instrução for uma regra clara — como "não use pontos de exclamação" —, um comando negativo funciona bem. Se a instrução envolver tom, estilo ou julgamento, reformule-a como um comando positivo.
Mesmo com regras objetivas, evite usar muitos comandos negativos em um único prompt.
| Prompt bom | Prompt otimizado |
| Não omita nenhuma informação do texto original. | Preserve todas as informações do texto original. |
Use linguagem integrativa e transformadora
Se o seu Super Agent não estiver aproveitando suficientemente um recurso que você forneceu, ou se estiver copiando demais parte da sua entrada, use linguagem integrativa ou transformadora.
Linguagem integrativa
Se o seu Super Agent não estiver aproveitando suficientemente um recurso que você forneceu, use linguagem integrativa.
A linguagem integrativa é muito compacta e usa orações subordinadas para vincular a entrada à tarefa.
| Prompt bom | Prompt otimizado |
| Pegue os argumentos de marketing e escreva uma publicação para redes sociais. | Use os argumentos de marketing para escrever uma publicação para redes sociais. |
Linguagem transformadora
Se o seu Super Agent estiver copiando demais parte da sua entrada — como reproduzir uma descrição de produto literalmente em vez de reimaginá-la —, use linguagem transformadora.
A linguagem transformadora foca em palavras que implicam mudança e divide a ação em várias etapas.
| Prompt bom | Prompt otimizado |
| Transforme a descrição do produto em uma música. | Pegue os conceitos e detalhes mais marcantes da descrição do produto e reimagine-os como uma música. |
Divida prompts complexos
Divida prompts complexos para melhorar a qualidade da saída.
Se um prompt pede ao Super Agent que faça duas coisas muito diferentes — como extrair detalhes técnicos de um documento e transformá-los em textos de marketing polidos —, divida o prompt.
| Prompt bom | Prompt otimizado |
| Transforme a descrição do produto em uma música. | Marco 1: Extraia os principais detalhes técnicos deste documento e liste-os. Marco 2: Usando os detalhes extraídos, escreva um resumo voltado ao cliente em tom informal. |
Por que o prompt otimizado é melhor?
O prompt é dividido em duas etapas claras com linguagem detalhada.
Adicione estrutura a prompts longos
Use a seguinte estrutura para melhorar a saída de prompts mais longos:
| Seção | O que incluir | Exemplo |
| Contexto | A função do Super Agent, o histórico da tarefa e quaisquer fatores complicadores. | Você é um especialista em marketing de produto. Lançamos um novo recurso na semana passada e precisamos fazer um acompanhamento com os clientes existentes. |
| Recursos | Todo material de referência que o Super Agent usará. Indique o início e o fim de cada recurso. | Adicione um briefing do produto, dados de segmentação de clientes, diretrizes de marca ou quaisquer outros recursos que o Super Agent precisará. Use delimitadores para rotulá-los. |
| Instruções detalhadas | Regras, parâmetros, casos extremos e estrutura de saída. | Escreva em tom informal. Mantenha cada seção com no máximo 100 palavras. Se um recurso não tiver dados de clientes, indique como TBD. |
| Comando final | Uma frase de encerramento que retoma a tarefa principal. | Escreva o e-mail de acompanhamento usando o briefing do produto e as diretrizes de marca. |
Gerencie múltiplos cenários
Alguns prompts de Super Agent lidam com várias situações diferentes.
Se a lógica for simples, use linguagem natural de se/então. Por exemplo: "Se a tarefa tiver uma data de vencimento, inclua-a no resumo. Se não tiver, omita a linha de data de vencimento."
Se o seu prompt tiver múltiplos caminhos — ou se um dos caminhos for não executar nenhuma ação —, defina todos os cenários possíveis antecipadamente. Instrua o Super Agent a escolher um antes de executar.
| Prompt bom | Prompt otimizado |
| Remova qualquer PII do texto. Se não houver PII, retorne o texto original. | Sua função é remover PII de um trecho de texto. Determine qual cenário se aplica antes de continuar: Cenário 1: O texto contém PII que pode ser removida sem prejudicar o sentido. Remova a PII e preserve todo o restante. Cenário 2: O texto contém PII, mas parte dela não pode ser removida sem prejudicar o sentido. Remova o que for possível e substitua o restante por [PLACEHOLDER]. Cenário 3: O texto não contém PII. Retorne-o como foi escrito originalmente. Determine qual cenário se aplica e siga as instruções desse cenário. |
Por que o prompt otimizado é melhor?
O prompt otimizado obriga o Super Agent a se comprometer com um caminho primeiro, para que as outras opções não consumam capacidade de processamento durante a execução.
Dicas adicionais
Se você seguiu as etapas acima e o seu Super Agent não está se comportando como esperado, verifique se você:
- Fornece fatos essenciais diretamente no prompt, em vez de esperar que o Super Agent os encontre.
- Adiciona flexibilidade aos modelos que está usando. Por exemplo: "Se esta informação não estiver disponível, escreva 'N/A' ou omita qualquer seção que não possa ser preenchida com as informações fornecidas."
- Limita o contexto. Por exemplo: "O briefing do produto é a única informação com a qual você tem para trabalhar."
Refine seu Super Agent
Depois de escrever o prompt ideal, saiba como refinar seu Super Agent.