Pular para o conteúdo principal

Criar uma skill de processo

Objetivo: transformar um processo repetitivo da sua organização em uma skill reutilizável — neste exemplo, um gerador de proposta comercial — e disponibilizá-la para o time. O fluxo vai do Skill Studio à publicação e à atribuição por perfil.

Uma skill empacota o conhecimento do processo (o que perguntar, como estruturar o resultado) de modo que qualquer pessoa autorizada obtenha um resultado consistente. Para o conceito, veja O que são skills.

Pré-requisitos​

  • Papel de administrador de skills ou administrador da org (criar e publicar skills exige um desses papéis — veja Usuários & papéis).
  • Acesso ao console em /app.
  • Pelo menos um grupo de skills (a publicação exige escolher um grupo). Crie em Grupos de skills.

Passo a passo​

1. Descrever a skill no Skill Studio​

  1. No console /app, abra Skills e entre no Skill Studio (gerador conversacional).
  2. Descreva o processo em linguagem natural, por exemplo: 
    Quero uma skill que gere uma proposta comercial. Ela deve perguntar:
    nome do cliente, escopo do projeto, prazo e valor. Com isso, deve produzir
    um documento com: capa, sumário executivo, escopo detalhado, cronograma,
    investimento e condições comerciais. O resultado final é um .docx.
  3. O Studio conduz as fases discovery → refining → proposal → generating, fazendo perguntas para fechar o desenho. Responda até a proposta refletir o seu processo.
  4. Clique em Aprovar e Criar Skill. O Studio cria o rascunho e já publica a skill.
Outros caminhos para criar

Além do Studio conversacional, a página Skills oferece Create Skill (formulário com Name/Group/Category/Description) e Import from ZIP (manifesto + scripts). Veja Criar uma skill.

2. Revisar e ajustar o rascunho​

No editor da skill você refina antes (ou depois) de publicar:

  • Metadata — confirme o modo de execução (normal/local_plain ou protegida/local_protected). Para a maioria dos processos de escritório, o modo normal basta. Veja Modos de execução.
  • Prompt Editor — ajuste o conteúdo do prompt que guia o agente. Um banner de manifesto bloqueia a publicação enquanto houver erro.
  • Env Secrets — se a skill precisar de credenciais (ex.: uma API interna), declare aqui. Veja Segredos de ambiente.

3. Publicar​

  1. Defina o campo version (string semver, ex.: 1.0.0) e escreva o changelog (obrigatório no Studio).

  2. Escolha o grupo de destino (obrigatório) e publique.

    A publicação é idempotente: a mesma versão com o mesmo conteúdo é um no-op; a mesma versão com conteúdo diferente retorna 422 ("faça bump da versão"). Detalhes em Publicar uma skill.

4. Atribuir a um perfil​

Skills chegam aos usuários por perfis. Sem um perfil que inclua a skill, ela não aparece para o usuário.

  1. No console, abra Perfis e edite (ou crie) o perfil do time que vai usar a skill — por exemplo, "Comercial".
  2. No card Skills do perfil, adicione o Gerador de Proposta.
  3. No card Users, confirme que as pessoas certas estão no perfil.

Veja Perfis.

5. Usar​

Os clientes sincronizam as skills no início da sessão. A pessoa autorizada simplesmente pede:

Gere uma proposta comercial para o cliente Acme, escopo de migração de dados,
prazo de 8 semanas e valor de R$ 120.000.

O agente reconhece o processo, coleta o que faltar e entrega o .docx.

Resultado​

Uma skill publicada, versionada e atribuída a um perfil — disponível para todo o time autorizado, com resultado consistente a cada uso. Mudanças futuras viram novas versões (com changelog), e a política é reavaliada automaticamente após cada publicação.

Veja também​

Criar uma skill

Os três caminhos do Skill Studio em detalhe.

Abrir →Perfis

Como ligar skills a usuários.

Abrir →Publicar uma skill

Versionamento, idempotência e rollback.

Abrir →