Tarefa com IA

É a etapa que executa uma tarefa assistida no motor do Imaginne. Ela pode usar ferramentas e skills, e é a única etapa cujo resultado não é determinístico — por isso é também a que mais precisa ser bem declarada.

Quatro perguntas, nesta ordem

O painel é organizado em torno delas:

1. O que a IA deve fazer? — o objetivo.
2. Quais dados ela usa? — os dados de entrada.
3. Ela pode buscar informação ou usar recursos? — as ferramentas.
4. Como deve ser a resposta? — a saída esperada.

E fecha com a pergunta que decide tudo: como esta etapa será considerada concluída?

Objetivo e instruções

Campo	Uso
Objetivo	O que você pediria a uma pessoa. Obrigatório
Instruções	Como fazer: tom, formato, restrições. Opcional

Insira dados de etapas anteriores pelo botão Dado — nunca digitando caminho técnico.

Instrução e dados são coisas diferentes

Instrução é o que fazer. Dados é o conteúdo entregue para fazer.

• Um dado inserido no meio do objetivo vira texto dentro do pedido.
• Um item na lista de dados de entrada é entregue como estrutura, com nome.

Quando o mesmo dado aparece nos dois lugares, o Studio avisa. Não é erro — mas precisa ser decisão, e não descuido.

Ferramentas

Modo	O que significa
Nenhuma	Só raciocínio sobre os dados entregues
Apenas as que eu escolher	Você seleciona da lista de recursos liberados
Qualquer uma liberada no Agent Space	A IA escolhe entre tudo que o espaço libera

Você pode marcar uma ferramenta como obrigatória: sem ela, a etapa falha — e falha antes de gastar o modelo, quando a indisponibilidade é conhecida de antemão.

Buscar informação não é ligado sozinho

Ativar pesquisa custa dinheiro e muda o resultado entre execuções. Quando o Studio percebe que o objetivo pede busca ou consulta a um sistema, ele sugere — a decisão é de quem monta.

Skills

A etapa pode acionar skills da organização. Elas precisam estar liberadas no espaço e permitidas pela política da organização no Imaginne. As duas condições valem juntas: liberar no espaço não contorna a política.

Saída esperada

Aqui está a diferença entre uma etapa verificável e uma etapa que apenas "respondeu".

Formato	Quando usar
Texto	A resposta é o próprio texto, e será usada como tal
Campos	Você declara nome, tipo e obrigatoriedade de cada campo

Com campos declarados, o Agents confere o que voltou. Campo obrigatório ausente reprova a etapa — é o que impede uma resposta pela metade de passar por completa. E os campos declarados ficam disponíveis, um a um, para as etapas seguintes.

Uma etapa sem verificação é publicável, e avisa

Uma Tarefa com IA sem ferramenta obrigatória e sem campos declarados pode ser publicada, mas nada permite verificar se ela cumpriu o objetivo. O Studio avisa na validação. Trate o aviso como o que ele é: uma etapa que sempre "dá certo" não está dando certo — está sem critério.

Como a etapa é julgada

"O motor respondeu" não é o mesmo que "a tarefa foi cumprida". A conferência acontece nesta ordem, escolhida pelo diagnóstico mais acionável:

#	Verificação	Falha com
1	Uma ferramenta obrigatória não concluiu com sucesso	Ferramenta obrigatória indisponível
2	O motor parou por um motivo que não é conclusão	Um dos motivos abaixo
3	Alguma ferramenta falhou, sem tolerância declarada	Ferramenta falhou
4	Um campo declarado não veio	Saída fora do formato declarado

Os motivos de parada que não são conclusão:

Situação	O que significa
A IA pediu informação a uma pessoa	Em execução automática não há quem responda
Bateu no limite de trabalho	O teto de iterações ou de resposta foi atingido
Entregou resultado parcial	O que veio não é a resposta inteira
Parou sem chegar a um resultado	Nenhuma conclusão foi alcançada
Erro do modelo	Falha transitória; a etapa pode tentar de novo

Um motivo desconhecido reprova. Um motor mais novo não pode fazer um agente declarar sucesso por desconhecimento.

Requisitos

Esta etapa exige que a organização tenha uma conta de execução ativa. Sem ela, a definição não publica. Ver Conta de execução.

Quando usar outra etapa

Se você quer…	Use
Escrever, resumir, classificar ou traduzir um texto	Gerar com um modelo — mais simples e previsível
Chamar um sistema com entrada e saída fixas	Ação do fluxo ou Executar automação
Montar um dado a partir de outros	Preparar dados

Erros comuns

Sintoma	Causa	O que fazer
A etapa "deu certo" mas o resultado é inútil	Sem campos declarados, não há o que verificar	Declare a saída esperada
Falha por saída fora do formato	O modelo não devolveu um campo obrigatório	Reduza o número de campos, ou torne-os mais explícitos no objetivo
Falha por ferramenta obrigatória	A ferramenta não está liberada ou não respondeu	Ver Recursos liberados
Falha por pedido de informação	O objetivo depende de algo que não foi entregue	Complete os dados de entrada

Próximos passos

• Dados entre etapas
• Testar antes de publicar
• Erros de execução