> ## Documentation Index > Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt > Use this file to discover all available pages before exploring further. # AI Skills > Crie, configure, teste e gerencie AI Skills reutilizáveis para tarefas repetíveis de clientes. Uma Skill ensina um AI Agent a concluir uma tarefa específica e repetível, definindo quando a tarefa deve ser iniciada e quais etapas o agente deve seguir. Use Skills para processos como processamento de reembolsos, qualificação de leads, consultas sobre pedidos, agendamento de consultas ou outras solicitações de clientes em várias etapas. ## Quando você deve criar uma Skill? Escolha fluxos de trabalho nos quais a IA possa reduzir significativamente o trabalho manual e onde o processo esperado possa ser descrito de forma clara. ### Bons candidatos * Tarefas repetitivas e de alta frequência atualmente tratadas por sua equipe * Tarefas que exigem várias perguntas ou verificações antes da conclusão * Processos com regras de negócios claras, informações necessárias e condições de encerramento * Tarefas que precisam de dados de um sistema externo por meio de um conector de dados * Processos que podem precisar de transferência para um atendente humano em condições específicas ### Antes de começar * Selecione uma tarefa de negócios bem delimitada * Documente o processo correto e os casos de exceção importantes * Confirme quais informações do cliente a tarefa exige * Prepare e ative todos os conectores de dados necessários * Defina quando a IA deve parar ou transferir a conversa para um atendente humano **Recomendado:** Comece com uma ou duas Skills de alto valor. Uma Skill pequena e bem testada costuma ser mais confiável do que uma única Skill que tenta lidar com muitas tarefas não relacionadas. *** ## Criar e gerenciar Skills ### Abrir a página de Skills 1. Abra o AI Agent que você deseja configurar. 2. Abra **Settings** e, em seguida, selecione a aba **Skills** . 3. Selecione **New Skill**. [Abrir a página de Skills da YCloud](https://www.ycloud.com/console/#/app/chatbot/agent/6a2906717c73707cc395680f/skills) ### Gerenciar Skills existentes A lista de Skills mostra o nome de cada Skill, o gatilho de início (Start trigger), o horário da última atualização e o status. * **Pesquisar:** Encontre uma Skill pelo nome. * **Used / Unused:** Use a chave de status para controlar se o AI Agent pode usar a Skill. * **Editar:** Selecione o nome de uma Skill para atualizar seu gatilho ou suas instruções. * **Excluir:** Abra o menu de ação de uma Skill e selecione Delete. Desativar uma Skill impede que o AI Agent a utilize. Exclua uma Skill apenas quando não precisar mais de sua configuração. *** ## Configurar uma Skill Editor de New Skill com o Start trigger destacado acima das instruções Step-by-Step. ### 1. Insira um título claro Nomeie o resultado ou a tarefa, e não um departamento ou tópico amplo. Títulos claros tornam as Skills mais fáceis de encontrar e manter. | **Qualidade** | **Exemplo** | **Motivo** | | - | - | - | | **Recomendado** | Processar uma solicitação de reembolso | Descreve uma tarefa específica do cliente | | **Evite** | Atendimento ao cliente | Amplo demais para indicar o que a Skill realmente faz | ### 2. Defina o Start trigger O Start trigger informa ao AI Agent quando e quando não usar a Skill. Inclua a intenção do cliente, o contexto obrigatório e exclusões importantes. > Use esta Skill quando um cliente solicitar claramente o cancelamento de um pedido qualificado e o recebimento de um reembolso. Não a utilize para dúvidas sobre política de devolução, falhas no pagamento ou pedidos que já foram enviados. #### Checklist do Start trigger * Descreva a intenção do cliente usando linguagem natural. * Inclua variações comuns da solicitação quando for útil. * Especifique quando a Skill não deve ser executada se uma solicitação semelhante exigir um processo diferente. * Evite gatilhos vagos, como "quando necessário" ou "para dúvidas de suporte". ### 3. Escreva instruções Step-by-Step Descreva o procedimento completo que o AI Agent deve seguir. Cada etapa deve ter um propósito claro e começar com uma ação. 1. **Confirme o recebimento** da solicitação do cliente. 2. **Colete** as informações necessárias para identificar o pedido. 3. **Verifique** se a solicitação atende à política de reembolso. 4. **Use** o conector de dados apropriado para recuperar ou atualizar o pedido. 5. **Confirme** o resultado e explique o que acontecerá em seguida. 6. **Transfira** ou encerre a conversa quando a condição relevante for atendida. #### Práticas recomendadas de redação * Numere as etapas na ordem em que devem ser executadas. * Mantenha cada etapa focada em uma única ação ou decisão. * Especifique as informações necessárias em vez de esperar que a IA as deduza. * Defina o que fazer quando houver dados ausentes, inválidos ou contraditórios. * Indique explicitamente as condições de conclusão e de transferência. * Divida instruções longas ou condicionais em etapas menores. **Evite suposições infundadas.** Se as instruções, o Profile, a base de conhecimento ou os sistemas conectados não fornecerem as informações necessárias, oriente o AI Agent a perguntar ao cliente, parar o processo ou transferir para um atendente humano. *** ## Usar comandos nas instruções da Skill No editor de instruções passo a passo, digite **/** para inserir um comando disponível. O menu exibe as ações integradas e os conectores de dados ativos disponíveis para o AI Agent. ### Ações integradas | **Ação** | **Use para** | **Exemplo de condição** | | - | - | - | | **Hand Off** | Transferir a conversa para um atendente humano ou equipe | O reembolso está fora da política, o cliente contesta o resultado ou é necessária aprovação humana | | **Close Conversation** | Encerrar a conversa após a conclusão bem-sucedida da Skill | O resultado foi confirmado e o cliente não precisa de mais assistência | | **Add to unsubscribe list** | Adicionar o contato atual à sua lista de cancelamento de inscrição | O contato solicita claramente parar de receber mensagens de marketing | Para inserir uma ação, digite **/** em **Step-by-Step instructions** e selecione-a em **Built in actions**. A ação aparece como um comando nas instruções da Skill. ### Conectores de dados Os conectores de dados permitem que uma Skill consulte ou atualize dados comerciais externos. Apenas conectores configurados e ativos aparecem no menu de comandos. Para cada etapa do conector, descreva claramente: * Quando o conector deve ser usado * Quais valores de entrada devem ser coletados ou passados * Como o AI Agent deve interpretar o resultado * O que fazer quando a solicitação falhar ou não retornar dados correspondentes * Se o cliente precisa confirmar antes que os dados sejam alterados Não instrua uma Skill a usar um conector que não tenha sido configurado e ativado. Teste o sucesso do conector, resultados vazios, entradas inválidas e respostas de falha antes de publicar. *** ## Visualizar, publicar e melhorar ### Testar no Preview Use o painel Preview ao editar a Skill. Teste tanto as solicitações que devem acionar a Skill quanto solicitações semelhantes que não devem acioná-la. Reinicie o Preview quando precisar de uma conversa limpa. #### Checklist mínimo de teste * Uma solicitação típica do cliente aciona a Skill correta * Uma solicitação semelhante, mas excluída, não aciona a Skill * O AI Agent coleta todas as informações necessárias antes de realizar uma ação * As etapas são executadas na ordem pretendida * Os caminhos de sucesso e falha do conector de dados se comportam corretamente * A Skill transfere o atendimento quando julgamento ou aprovação humana são necessários * A conversa é encerrada somente após a conclusão da tarefa * O AI Agent não inventa dados, elegibilidade ou resultados de ações ### Ativar e publicar 1. Volte à lista de Skills e defina o status da Skill como **Used**. 2. Selecione **Publish** para colocar no ar as alterações de Skill do Agent. 3. Teste o Agent publicado no canal do cliente onde ele será utilizado. 4. Revise conversas reais e ajuste o gatilho de início ou as instruções ao identificar falhas recorrentes. Uma Skill confiável é construída de forma iterativa. Comece com um processo restrito, teste casos extremos realistas, publique e aprimore um problema recorrente por vez. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.