Criar AI Skills

Aprimore suas automações com o poder da generative AI criando AI Skills reutilizáveis no AI Agent Studio. As AI Skills permitem que desenvolvedores profissionais configurem prompts, parâmetros, entradas de arquivos e conexões de modelos para produzir resultados de IA contextuais e consistentes que podem ser reutilizados em várias soluções.

As AI Skills são criadas selecionando uma Model connections, configurando a lógica do prompt e disponibilizando a habilidade para desenvolvedores cidadãos e desenvolvedores profissionais criarem automações.

Nota: Antes de criar uma AI Skills, confirme que a conexão do modelo desejada oferece suporte aos recursos que o seu caso de uso exige. Para uma lista completa de modelos compatíveis, tipos de arquivo e compatibilidade de recursos, consulte Habilidades de IA: modelos compatíveis.

Este tópico orienta você sobre as etapas para criar AI Skills.

Pré-requisitos

Um desenvolvedor profissional precisa dessas funções e permissões para criar e testar uma AI Skill.
  • Função: AAE_Basic, função personalizada de desenvolvedor profissional
  • Permissão: Bot Creator
  • Configuração: Administração > Configurações > Gerenciamento de dados de IA > Configurações de registro de dados deve estar habilitado. O administrador de automação pode habilitar essa configuração para o desenvolvedor profissional

Consulte Funções e permissões

Outros requisitos:

Como parte do teste de Model connection, é necessário executar o bot no seu desktop. Portanto, certifique-se de que o Bot Agent esteja configurado para seu usuário. Se você precisar mudar a conexão para uma outra Control Room, consulte: Alternar o registro do dispositivo entre instâncias da Control Room.

Procedimento

  1. Crie um novo AI Skill.
    1. Faça login na Control Room.
    2. Navegue até Automação > Criar ou clique no ícone "+" e selecione Habilidade de IA.
    3. Digite um nome e uma descrição e, em seguida, clique em Criar e editar. Vamos criar um exemplo com o nome Agente de alta de pacientes.
  2. Conexão de modelo: escolha uma Model connection. No topo do editor da AI Skill, clique em Escolher... em Model connection para abrir a lista de Model connections atribuídas a você.
    Uma vez selecionado:

    • O Nome da conexão do modelo, o fornecedor e a Descrição aparecem no cabeçalho.

    • Campos de parâmetro como Penalidade de frequência, Penalidade de presença, N, Máximo de tokens, Temperatura e Top P tornam-se editáveis.

    Esses padrões são adaptados ao modelo selecionado, mas podem ser ajustados conforme necessário.

  3. Prompt do sistema (Opcional): use essa opção para definir diretrizes de alto nível sobre contexto ou comportamento. Se a Model connection selecionada for compatível com o System prompt, você verá uma seção de System prompt. Para obter mais informações sobre System prompt, consulte Prompt do sistema. Por exemplo: você é um médico de família criando um plano abrangente de alta para o paciente.
  4. Prompt do usuário: digite as instruções para o modelo. Você faz referência a entradas do tipo string utilizando a sintaxe $variableName$. O prompt do usuário permite a entrada de texto em várias linhas e a área de texto expansível, conforme mostrado na captura de tela. Por exemplo: Crie um plano detalhado de alta para o paciente... Utilize os seguintes $patientdetails$ para criar o título…
  5. Entrada do prompt: (lado direito)
    Entradas de String:
    • Clique em Adicionar string ou + para incluir uma string de entrada. Insira uma Chave e Valor.
    • Mostra variáveis criadas para entradas baseadas em texto.
    • Cada entrada inclui um nome, valor e ações (copiar, excluir).
    • Exemplo: patientdetails.
    Entradas de Arquivo:
    • Clique em Adicionar arquivo ou + para adicionar uma string de arquivo. Insira uma Chave e Valor.

    • Escolha um arquivo do repositório da Control Room ou faça upload de um novo. Dentre os tipos de arquivo compatíveis estão:

      • Imagens: .jpeg, .jpg, .png, .gif, .webp

      • Documentos: .txt, .pdf, .docx, .csv

    AI Skill parâmetros
    Nota: Restrições específicas do modelo quanto ao tamanho do arquivo, tipos compatíveis e número máximo de arquivos são aplicadas automaticamente.
  6. Prompt de arquivo (opcional): A seção Prompt de arquivo é exibida apenas quando o modelo selecionado permite entrada multimodal. Se você tiver adicionado Arquivos, será possível selecioná-los no menu suspenso. Ele controla quais entradas de arquivo (do painel de arquivos à direita) são incluídas na solicitação final enviada ao modelo.
    Nota: Arquivos anexados a uma AI Skill não são processados pelas AI Guardrails para mascaramento de dados.

    As proteções avaliam e mascaram apenas prompts de texto.

    O conteúdo dos arquivos é passado diretamente para o modelo exatamente como fornecido.

  7. Obter resposta: use Obter resposta para visualizar o resultado utilizando a Model connection selecionada. Você pode testar sua AI Skill com as AI Guardrails. Use a opção Testar com proteção de IA para simular o impacto de proteções selecionadas em seus prompts e respostas do modelo. Se uma proteção for escolhida, o prompt será verificado quanto a toxicidade e dados confidenciais. Se nenhuma proteção for selecionada, nenhuma avaliação de proteção será realizada nos prompts.
    Nota: Para usar Testar com proteção de IA, as AI Guardrails devem estar habilitadas nas configurações globais de administração e você precisará das permissões Exibir proteções de IA e Exibir configurações. Você pode revisar o histórico de auditoria na AI Governance para um registro detalhado de cada teste.

    Ao testar com uma proteção, você verá a Toxicidade para o User prompt e para a Resposta. Para visualizar os resultados da mascaramento de dados, clique em exibir execução de mascaramento de dados. Isso exibirá os valores mascarados e tokenizados de todos os dados confidenciais identificados no prompt.

    Quando uma AI Skill envia um prompt que viola uma regra de bloqueio definida em uma proteção ativa, a automação que usa essa habilidade interromperá a execução com uma mensagem de erro e nenhuma resposta do LLM. A mensagem de erro normalmente indica que o prompt foi bloqueado por uma proteção. Para mais informações sobre como configurar a Regra de toxicidade, consulte Criar e gerenciar AI Guardrails.

  8. Registro de dados: um botão aparece no canto superior direito da tela: Registro de dados desativado.

    Quando ativado: o botão muda para Registro de dados ativado. O sistema registra o prompt, a resposta, os parâmetros do modelo e os metadados do arquivo em IA > Governança > Log de prompts de IA

    Quando desativado: apenas metadados mínimos são capturados.

    Os desenvolvedores podem decidir quanta informação é registrada com base na sensibilidade do conteúdo.

    Nota: AI Governance não armazena o conteúdo dos arquivos enviados nem seus metadados.

Exemplo:

Clique nas reticências ao lado de um AI Skill para visualizar e acessar ações disponíveis para o desenvolvedor profissional.

AI Skill ações

Ações Função
AI Skill Mover Clique nesta ação para selecionar o local para onde deseja mover o AI Skill, de acordo com suas permissões de pasta.
Fazer checkin no AI Skill Permite que você faça checkin de uma AI Skill em uma pasta diferente. O Status da AI Skill é atualizado e exibe a pasta que você fez checkin no AI Skill. Exemplo: se você fez checkin do AI Skill na pasta pública, o rótulo de Status exibirá Público.
Exibir AI Skill Abre o AI Skill exibindo detalhes.
Editar AI Skill Permite editar o AI Skill.
Nota: O Desenvolvedor profissional tem essa permissão.
Copiar AI Skill Permite copiar um AI Skill existente para criar um novo com os mesmos detalhes. Você deve fornecer um nome diferente, pois não pode haver duplicatas de um AI Skills.
Nota: O Desenvolvedor profissional tem essa permissão.
Visualizar referências Permite visualizar referências a outros bots que dependem diretamente do atual em que este AI Skill foi usado.
Excluir AI Skill Permite excluir AI Skill.
Nota: O Desenvolvedor profissional tem essa permissão.

Próximas etapas

Seu próximo passo seria fazer o checkin do AI Skills para disponibilizá-lo aos desenvolvedores cidadãos do AI Skills package.

Por que você faria checkin de uma AI Skill?

Depois de criar uma AI Skill, faça checkin na pasta Pública. Isso permitirá que o desenvolvedor profissional e o desenvolvedor cidadão o utilizem a partir do AI Skills package no ambiente de produção.

Para referência, consulte:

O Task Bot, com um ou múltiplos AI Skills integrados, pode ser adicionado a uma automação maior que execute um cenário de fluxo de trabalho completo.

Nota: Quando você cria ou testa um AI Skill na tela Habilidades de IA, os detalhes de sucesso ou falha e as respostas do modelo podem ser visualizados em Administração > Log de auditoria e na navegação Administração > Governança de IA. Consulte AI Governance

Como próximo passo na sua sequência de tarefas, acesse Usar AI Skills em um Task Bot.