docs: add "One Card per Step" Studio page (AGE-107)

Document the merge of the task and agent nodes into a single step card on
the Studio canvas. Written as evergreen present-tense feature docs with a
dated rollout banner (June 24th) for the pre-launch customer announcement;
the banner is the only time-bound content and is flagged for removal after
ship. Added in edge + v1.14.7 across en, pt-BR, ko, and ar, with nav entries
in docs.json and three canvas/editor/swap screenshots.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Jesse Miller
2026-06-19 11:06:35 -04:00
parent 854c67d21c
commit ac7d7ae238
12 changed files with 704 additions and 0 deletions

View File

@@ -0,0 +1,87 @@
---
title: Um Card por Etapa
description: "Cada etapa no canvas do Studio é um único card que combina a tarefa e o agente que a executa."
icon: "layer-group"
mode: "wide"
---
{/* CLEANUP: This <Note> banner is the only time-bound content on the page. After the feature ships (Wednesday, June 24th 2026), delete the banner below — the rest of the page is evergreen present-tense docs and needs no other edits. */}
<Note>
**Lançamento na quarta-feira, 24 de junho.** O canvas do Studio passa a exibir um card por etapa, em vez de nós separados para tarefa e agente, para simplificar o canvas à medida que adicionamos novas funcionalidades em breve. Suas automações existentes continuam funcionando sem nenhuma alteração necessária — cada configuração de tarefa e de agente continua disponível, apenas organizada em um único card.
</Note>
## Visão geral
No canvas do Studio, cada etapa de trabalho é representada por um **único card**. O card combina dois elementos que antes ficavam em nós separados:
- **A tarefa** — o que fazer (nome, descrição, saída esperada e formato da resposta).
- **O agente** — quem faz (o agente atribuído, seu modelo e suas ferramentas).
Um agente não é um participante independente do seu fluxo de trabalho — ele é um atributo da tarefa: *qual agente executa este trabalho.* Colocar a tarefa e seu agente em um único card torna essa relação explícita e transforma sua automação em uma única cadeia de unidades de trabalho, da esquerda para a direita, mais fácil de ler em uma olhada.
<Frame caption="Um card por etapa: a tarefa com o agente atribuído resumido no rodapé.">
![Cards de etapa unificados no canvas](/images/enterprise/merged-step-card-canvas.png)
</Frame>
## No canvas
Cada card recolhido mostra:
- O **nome e a descrição da tarefa** no topo.
- Um **rodapé resumindo o agente atribuído** — avatar, nome, modelo e ferramentas.
Não há nó de agente separado nem aresta vertical de agente → tarefa. Suas etapas se conectam diretamente umas às outras na ordem em que são executadas.
## No editor
Abra um card para editá-lo. A visão expandida é o mesmo card em um estado detalhado — não uma tela diferente — organizada em duas seções claramente identificadas.
<Frame caption="O editor expandido: a seção da tarefa aberta, com o agente resumido abaixo.">
![Editor de etapa expandido](/images/enterprise/merged-step-card-editor.png)
</Frame>
### A tarefa — o que fazer
Aberta por padrão, já que é o que você costuma editar:
- **Nome**
- **Descrição**
- **Saída Esperada**
- **Formato da Resposta** — exibido aqui porque controla exatamente o que as etapas seguintes (como o roteamento) leem desta etapa.
### O agente — quem faz
O agente atribuído é mostrado como um resumo — **nome, modelo e ferramentas em linha**. Sua configuração mais detalhada é preservada por trás de duas seções recolhíveis:
- **Papel, objetivo e história**
- **Configurações do agente** — raciocínio, máximo de tentativas de raciocínio, permitir delegação, máximo de iterações e configurações de LLM.
<Tip>
A configuração completa de um agente — Papel, Objetivo, História, Modelo, Ferramentas, Configurações de LLM e todo o bloco de Configurações do agente — fica por trás das seções recolhíveis **Papel, objetivo e história** e **Configurações do agente**, organizada pela frequência com que você a edita.
</Tip>
## Trocar vs. editar o agente
Há duas maneiras distintas de trabalhar com o agente em um card, e elas fazem coisas diferentes:
- **Trocar** reatribui *qual* agente executa esta tarefa. Use o controle **Trocar** para escolher um agente diferente deste projeto, selecionar um do seu Repositório de Agentes ou criar um novo agente. Isso tem escopo limitado à tarefa.
- **Editar** o agente — abrindo **Papel, objetivo e história** ou **Configurações do agente** — altera o agente *em si*.
<Frame caption="Trocar muda qual agente executa a tarefa.">
![Painel de troca de agente](/images/enterprise/merged-step-card-swap-agent.png)
</Frame>
<Warning>
**Os agentes são reutilizáveis e compartilhados.** O mesmo agente pode executar mais de uma tarefa em todo o seu projeto. Editar o papel, a história ou as configurações de um agente atualiza esse agente **em todos os lugares onde ele é usado** — não apenas no card que você abriu. Se quiser que uma alteração se aplique a apenas uma etapa, **Troque** por um agente diferente em vez de editar o agente compartilhado.
</Warning>
## Relacionados
<CardGroup cols={2}>
<Card title="Crew Studio" href="/pt-BR/enterprise/features/crew-studio" icon="pencil">
Crie automações com assistência de IA e um editor visual.
</Card>
<Card title="Repositórios de Agentes" href="/pt-BR/enterprise/features/agent-repositories" icon="users">
Gerencie e reutilize agentes em suas automações.
</Card>
</CardGroup>