Source: https://docs.aivax.net/pt-br/docs/generations/teach-skill.html

# Ensinar Habilidade

Use o recurso Ensinar Habilidade para transformar demonstrações gravadas em instruções de habilidade reutilizáveis, passo a passo. Os usos típicos incluem capturar o fluxo de tela de um especialista para que agentes de suporte o repitam consistentemente, converter tutoriais de integração em comportamento de assistente e iniciar um rascunho de habilidade que um humano depois aperfeiçoa.

Envie vídeos tutoriais como partes de conteúdo `video_url` — URLs hospedados ou URIs de dados base64. Como a análise leva um tempo em gravações mais longas, a API recomenda `direct.inference.aivax.net`.

## Grave uma demonstração que ensine bem

A qualidade do rascunho segue a qualidade da gravação. Antes de enviar:

- Mostre o fluxo de trabalho na ordem em que deve ser compreendido, um passo de cada vez, sem pular entre telas.
- Narre ou legendue a intenção por trás de cada ação ("Eu abro este painel porque..."), não apenas o clique em si — gravações silenciosas deixam o contexto necessário implícito e forçam o modelo a adivinhar.
- Mantenha credenciais, dados pessoais e informações do cliente fora do quadro; tudo que for visível pode acabar nas instruções resultantes.
- Prefira algumas gravações curtas e focadas em vez de uma sessão longa quando o procedimento tem fases naturais.

## Crie um rascunho de habilidade

Organize as gravações na ordem em que o procedimento deve ser compreendido. A resposta usa o envelope JSON padrão. `data.resultText` contém um rascunho Markdown estruturado que pode incluir front matter, etapas, notas e suposições quando a gravação deixa o contexto necessário implícito. `data.usage.processedUnits` relata as unidades de uso processadas para a solicitação.

Um rascunho gerado não é publicado automaticamente como uma habilidade de conta. Valide cada etapa contra o fluxo de trabalho real, remova detalhes específicos da gravação (tamanhos de janela, nomes de teste, valores pontuais), confirme pré-requisitos e reescreva etapas vagas como instruções imperativas antes de salvá-lo. Consulte [Habilidades](https://docs.aivax.net/pt-br/docs/features/skills.md) para a estrutura da habilidade e orientações de ativação.

A referência incorporada é a fonte de verdade para a entrada de vídeo aceita e o comportamento da resposta.

[API endpoint reference](https://inference.aivax.net/apidocs?embed=iframe&embed-endpoint=Teach%20skill)

## Preços, limites e erros

Para disponibilidade atual e limites de conta, veja [Preços](https://docs.aivax.net/pt-br/docs/pricing.md) e [Planos e Limites](https://docs.aivax.net/pt-br/docs/limits.md). Corrija conteúdo de vídeo inválido ou inacessível antes de tentar novamente uma solicitação falhada.