Components

Components são valores reutilizáveis que você define uma vez e pode referenciar em diferentes partes da plataforma — incluindo prompts de Agente, Tasks, MCPs e Tools.

Em vez de repetir a mesma informação em vários lugares, você cria um Component e o insere onde for necessário. Quando o valor muda, você o atualiza em um único lugar e ele se reflete automaticamente em todos os lugares.

---

🧩 O que é um Component

Um Component é uma variável nomeada com um valor fixo.

Ele tem três propriedades:

• Name — como você o referencia (ex.: especialidade)
• Type — o tipo de valor que ele armazena (String, Number ou Boolean)
• Value — o conteúdo real que será injetado quando o Component for usado

Components são globais — uma vez criados, ficam disponíveis para todos os Agentes do seu workspace.

---

💡 Quando Usar Components

Components são úteis sempre que você tem uma informação que:

• Se repete entre múltiplos Agentes ou configurações
• Pode mudar ao longo do tempo e precisa se manter consistente
• Deve ser gerenciada centralmente, em vez de editada em cada prompt

Exemplos comuns:

• Nome da clínica, especialidade ou nome do médico usados em vários prompts de Agente
• Um limite numérico (ex.: máximo de tentativas, limite de pontuação) compartilhado entre Tools
• Uma feature flag (Boolean) que controla o comportamento em múltiplos Agentes

---

➕ Como Criar um Component

1. Dentro do seu Agente, acesse Components no menu esquerdo
2. Clique em New Component
3. Preencha o Name, o Type e o Value
4. Clique em Add Component

O Component fica imediatamente disponível em todo o seu workspace.

---

🔢 Tipos de Component

Type	Campo de valor	Use quando
String	Texto livre (até 250 caracteres)	Nomes, descrições, instruções, rótulos
Number	Seletor numérico	Contagens, limites, IDs, pontuações
Boolean	Alternador (ligado/desligado)	Feature flags, condições, habilitar/desabilitar

💬 Como Usar um Component

Onde quer que a plataforma aceite variáveis (prompts, Tasks, MCPs, Tools, etc.), você pode inserir um Component de duas formas:

• Digite @ no campo de texto e selecione o Component na lista
• Clique dentro do campo e escolha o Component no painel que aparece

O Component aparecerá como uma tag no editor (ex.: [[especialidade]]) e será substituído pelo seu valor em tempo de execução.

Exemplo:

Prompt: “Você é um Agente de IA para a clínica do Dr. [[especialidade]]”

Em tempo de execução: “Você é um Agente de IA para a clínica do Dr. Estética Dental”

---

🔄 Atualizando um Component

Para alterar o valor de um Component:

1. Acesse Components no menu esquerdo
2. Encontre o Component e clique no menu ⋯
3. Edite o valor e salve

O valor atualizado será aplicado em todos os lugares onde o Component é usado — sem necessidade de mexer em prompts ou configurações individuais.

---

📌 Boas Práticas

• Use nomes claros e descritivos — o nome é como você e sua equipe encontrarão e referenciarão o Component
• Prefira Components em vez de valores fixos (hardcoded) diretamente nos prompts quando a mesma informação aparecer em mais de um lugar
• Use Components do tipo Boolean como feature flags para alternar comportamentos sem editar prompts
• Use Components do tipo Number para limites que você possa precisar ajustar ao longo do tempo

---

✅ Ponto-Chave

Components permitem:

• Definir valores uma vez e reutilizá-los entre Agentes, prompts, Tasks, MCPs e Tools
• Manter seu workspace consistente e fácil de manter
• Atualizar informações globalmente sem editar cada Agente individualmente

É uma pequena mudança que faz uma grande diferença ao gerenciar múltiplos Agentes em escala.