Tags

As Tags são etiquetas que você cria para agrupar seus especialistas por área, competência ou qualquer critério que faça sentido para o seu time — Jurídico, Financeiro, RH, Atendimento, Onboarding... Cada tag tem nome, cor e (opcionalmente) ícone, então no marketplace de especialistas a equipe identifica de longe quem é quem.

Criar uma tag

Clique em Nova tag, dê um nome curto (ex: Jurídico), escolha uma das 16 cores disponíveis e, se quiser, um ícone — a Adalink mostra um preview no topo conforme você preenche.

Cada especialista pode ter até 10 tags. Quando você apaga uma tag, ela some automaticamente de todos os especialistas em que estava.

Como vincular a um especialista

Quando você cria ou edita um especialista, o seletor de tags aparece e você marca quais se aplicam. As tags marcadas aparecem como badges coloridas no card do especialista — facilitando filtrar ("todos os especialistas com a tag Jurídico") e dar o contexto visual certo.

Para quem é útil

Times grandes — encontram o especialista certo num catálogo com dezenas de opções.
Whitelabel / consultorias — usam tags por cliente ou por projeto.
Onboarding — tags marcam especialistas "em curadoria", "prontos para uso", "experimental".

Tags são gerenciadas em /v1/tags e vinculadas a Especialistas através do campo tagIds: string[] em CreateSpecialistPayload / UpdateSpecialistPayload. Limite: 10 tags por especialista. Cores são fixas (16 valores Tailwind: slate, red, orange, amber, yellow, lime, green, emerald, teal, cyan, sky, blue, indigo, violet, purple, pink). Ícones são strings de nomes válidos da lib lucide-react.

CRUD de tags

curl

# Listar tags da org
curl https://api.adalink.ai/v1/tags \
  -H "Authorization: Bearer SEU_TOKEN"

# Criar tag
curl -X POST https://api.adalink.ai/v1/tags \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Juridico", "color": "indigo", "icon": "Briefcase" }'

# Atualizar tag
curl -X PATCH https://api.adalink.ai/v1/tags/TAG_ID \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Juridico - Trabalhista", "color": "violet" }'

# Vincular tags a um specialist (no payload de criacao/edicao)
curl -X POST https://api.adalink.ai/v1/specialists \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Consultor Juridico",
    "instructions": "...",
    "tagIds": ["TAG_ID_1", "TAG_ID_2"]
  }'

# Deletar tag (cascade — sai de todos os specialists)
curl -X DELETE https://api.adalink.ai/v1/tags/TAG_ID \
  -H "Authorization: Bearer SEU_TOKEN"

Ao deletar uma tag, o backend executa cascade removê automático em todos os especialistas que a tinham — não há soft-delete para tags. Cache de especialistas é invalidado pelo client.