Saltar para o conteúdo principal

Competências

Competências são arquivos markdown que fornecem conhecimento específico de domínio à IA. Quando um usuário faz uma pergunta sobre um tópico coberto por uma competência, a IA lê o arquivo de competência para dar uma resposta informada.

Definindo competências

Adicione competências ao seu kazzle.config.ts:
import { defineConfig } from './kazzle.types';

export default defineConfig({
  skills: [
    { name: 'Guia de API', path: './skills/api/SKILL.md' },
    { name: 'Modelo de dados', path: './skills/data-model/SKILL.md' }
  ]
});

Formato do arquivo de competência

Cada competência é um arquivo markdown (convencionalmente nomeado SKILL.md) que contém instruções, exemplos e contexto que a IA deve conhecer.
# Guia de API

Esta competência ensina à IA como usar a API do app.

## Endpoints

- `GET /items` — listar todos os itens
- `POST /items` — criar um item

## Autenticação

Todas as requisições requerem um token Bearer no cabeçalho Authorization.

Como a IA usa competências

Quando a IA encontra uma pergunta relacionada a um app que tem competências, ela lê os arquivos de competência relevantes para fundamentar sua resposta. Competências são carregadas sob demanda — a IA não lê todas as competências antecipadamente. Competências são puramente informacionais. Elas não executam código ou disparam ações.