Habilidades

Em vez de configurar do zero o jeito que cada agente deve responder, você cria uma habilidade — um "perfil profissional" pronto, com instruções, palavras-chave e categoria — e plugá-la em qualquer agente. Funciona como um catálogo da empresa: o RH cria "Analista de Folha", o Jurídico cria "Revisor de Contrato", e cada agente herda essas competências quando precisa.

Três níveis de habilidade

Pessoal (só sua)

Habilidades que só você vê — útil para experimentar antes de compartilhar com a equipe.

Organização

Compartilhada com toda a empresa. Qualquer membro pode usar nos agentes dele.

Sistema (curadas pela Adalink)

Modelos prontos que vêm na plataforma — Analista Financeiro, Revisor SWOT, Code Reviewer. Você pode usar como ponto de partida.

Como criar

Clique em Nova Habilidade no canto superior direito.
Dê um nome (ex: Atendente de SAC), escolha uma categoria, escreva as instruções (o "como se comportar") e algumas palavras-chave para os agentes acharem ela.
Você pode importar de um arquivo já pronto (.skill, .md, .txt, .pdf, .docx até 10 MB) — a Adalink lê e preenche os campos pra você.
Salve. Pronto, ela está disponível para vincular em qualquer agente da sua organização.

Promover entre níveis

Quando uma habilidade pessoal está madura, você pode promovê-la para Organização (todo mundo passa a usar). Em casos especiais, a Adalink pode promover uma habilidade da sua org para Sistema, deixando ela disponível em todas as orgs da plataforma — a autoria fica preservada.

Como o agente usa a habilidade

Quando você instala uma habilidade num agente (ou ela é detectada automaticamente pelas palavras-chave), o conteúdo dela entra no contexto da conversa — o agente passa a responder do jeito que aquela habilidade ensina, dentro do projeto onde está atuando.

Dica: capriche nas palavras-chave. Elas são o que faz a habilidade certa ser ativada na hora certa, sem você ter que vincular manualmente em cada agente.

Para quem é útil

Líderes de área — encapsulam expertise do time num "perfil" reutilizável.
Quem cria muitos agentes — evita repetir as mesmas instruções em cada um.
Empresas com muitas frentes — cada área publica suas habilidades; agentes herdam o que precisam.

As Habilidades expõem CRUD em /v1/skills, marketplace público em /v1/skills/marketplace e ações de instalação/promoção em /v1/skills/{id}/install e /v1/skills/{id}/promote.

Criar uma habilidade

scope aceita USER, ORG ou SYSTEM (este último restrito a superadmin). Categorias suportadas: analysis, marketing, sales, technology, management, hr, operations, product, education, legal, data, strategy, custom.

curl

curl -X POST https://api.adalink.ai/v1/skills \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Atendente de SAC",
    "description": "Responde duvidas de clientes seguindo o tom Acme",
    "category": "operations",
    "scope": "ORG",
    "instructions": "Voce e um atendente da Acme. Sempre comece cumprimentando...",
    "keywords": ["sac", "atendimento", "cliente"]
  }'

Promover e instalar

Promoção preserva a autoria (createdBy permanece). Instalação cria o vínculo entre uma skill e o contexto do usuário — o agente consulta as skills instaladas durante a execução.

curl

# Promover skill pessoal -> organizacao
curl -X PATCH https://api.adalink.ai/v1/skills/SKILL_ID/promote \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "targetScope": "ORG" }'

# Instalar skill em um agente (relaciona ao usuario/contexto)
curl -X POST https://api.adalink.ai/v1/skills/SKILL_ID/install \
  -H "Authorization: Bearer SEU_TOKEN"

Importar de arquivo

POST /v1/skills/import aceita multipart com .skill, .md, .txt, .pdf ou .docx (até 10 MB). O parser extrai metadados (nome, categoria, instruções) e devolve o draft já preenchido — útil para subir uma biblioteca pré-existente sem refazer cadastro a cadastro.