Ao adicionar uma nova etapa a um Fin Procedure, a etapa de instrução é a etapa padrão. A etapa de instrução é a mais poderosa, pois permite definir uma unidade coerente de trabalho para o Fin executar em linguagem natural.
Capacidades da etapa de instrução
Ao executar etapas de instrução, por padrão o Fin tem acesso às ferramentas abaixo:
Para usar essas ferramentas dentro de uma etapa de instrução, basta digitar @ para abrir o menu de busca.
Categoria | Ferramenta | Descrição |
Lógica e controles de fluxo | @Condition | Adiciona lógica de ramificação (SE / SENÃO). |
| @Run sub-procedure | Permite reutilizar um fluxo comum sem reescrevê-lo, ou um fluxo complexo que você deseja ocultar do fluxo principal. |
| @Create sub-procedure | Crie um novo fluxo aninhado diretamente do seu editor atual. |
Operações de dados | @Read attribute | Instrua o Fin para puxar dados específicos do Intercom para o contexto do procedimento. Isso inclui detalhes de People (como nome ou função do usuário), informações de Company, detalhes da Conversation (como canal atual, idioma ou se possui anexos) ou atributos personalizados Temporary. Exemplo: @read name and greet the customer by their name. |
| @Update attribute | Você pode instruir o Fin a @update qualquer atributo do intercom. |
| @Create attribute | Crie um novo atributo na hora se o que você precisa ainda não existir. |
Conhecimento e contexto | @Look up content | Direciona o Fin para buscar informações específicas no seu Help Center ou knowledge base externa. |
| @Use data connector (Call an API endpoint) | Quando você @use um data connector, o Fin acessará esse endpoint da API. Otimize para usar no máximo um data connector por etapa. |
| @Create data connector | Crie um novo fluxo aninhado diretamente do seu editor atual. |
Roteamento e finalização | @End | Encerra o Procedure imediatamente e retorna para o Fin. |
| @Handoff to team | Passa a conversa para uma equipe ou colega. Isso segue o caminho de escalonamento definido no fluxo de trabalho após o bloco Fin definido na seção Deploy. |
| @Switch procedure | Encerra o procedimento atual e inicia imediatamente outro diferente. Esta é uma transição unilateral. O Fin sairá do Procedure atual e entrará no novo imediatamente, mas não retornará ao Procedure original após o novo ser concluído. @Switch não conta como uma transferência de Procedure e não altera o estado de resolução — não é marcado como uma resolução presumida ou resultado de transferência de Procedure. A troca ignora completamente as verificações de elegibilidade do público: o Fin transita diretamente para o procedimento alvo pelo ID sem reavaliar se a conversa corresponde ao público desse procedimento. Isso faz do @Switch a forma de aplicar segmentação de conteúdo baseada em público atualizada no meio da conversa — atualize um atributo da empresa ou cliente, depois @Switch para o procedimento criado para esse novo valor de atributo, e o procedimento de destino roda imediatamente com sua própria segmentação de conteúdo, instruções e conhecimento, exatamente como se o cliente tivesse correspondido a esse público desde o início. |
Ações na conversa | @Add note | Adicione uma mensagem pré-definida que aparecerá como uma nota para colegas na inbox. |
| @Tag | Isso permite que o Fin aplique dinamicamente uma tag a uma conversa. |
Nota:
Geralmente, se você não pode “@” a capacidade, então ela não é suportada. Por exemplo, o Fin não pode enviar e-mails, fazer chamadas telefônicas ou remover tags.
Evite comandos em linguagem natural como “vá para outro procedimento”, “adicione uma nota” ou “verifique o OTP do cliente”. Use ferramentas suportadas em vez disso.
Melhores práticas
Existem dois princípios de design de alto nível ao escrever instruções
Uma etapa de instrução deve representar uma unidade significativa de trabalho
Menos etapas bem projetadas que combinam ações relacionadas de forma coerente são melhores do que muitas etapas pequenas separadas. Ao mesmo tempo, as etapas não devem ser muito grandes: como regra geral, limite o número de chamadas de data connector em uma etapa a uma e reduza o número de atributos atualizados ou tags ao que for absolutamente necessário para que o Fin possa executar mais rápido.
❌ Exemplo menos eficaz:
Step 1 - @read Email.
Step 2 - Ask for email if it's not there.
Step 3 - @use get_subscription_details
Step 4 - Send a reply listing every API field.
✅ Exemplo mais eficaz e melhor estruturado:
@read email. If it is not known, ask the user for their email before continuing. Then @use get_subscription_details and reply asking the user what they need help with. Include the user's current plan, plan status, and next renewal date in your reply.
Mantenha as coisas simples e claras
Sempre otimize para manter as coisas simples e claras para que o Fin possa seguir suas instruções sem se confundir. Se um humano sem contexto não consegue entender suas instruções, o Fin também não entenderá.
Use verbos simples e concretos. Escreva etapas com verbos de ação do dia a dia (perguntar, verificar, enviar, atualizar, escalar). Evite verbos abstratos ou formais (validar, averiguar, realizar, facilitar).
❌ Exemplo menos eficaz - Não está claro o que é um número de pedido ou número de rastreamento:
Collect the customers order number: Collect the customers order number and make sure it is valid and not a tracking number.
✅ Etapa bem estruturada - Diga ao Fin como é o número do pedido e o que fazer se o cliente não puder fornecê-lo:
Collect the customers order number:
If they provided a number but it is longer than 11 characters excluding the # at the start of the number, then let them know that it may be a tracking number and ask them for the order number again.
If the customer can not provide their order number do not continue @Escalate:Support team
Adicione etapas de confirmação apenas onde forem importantes
Nem toda etapa precisa de uma mensagem de confirmação antes de continuar. Reserve uma etapa de confirmação para logo antes de uma chamada de data connector que execute uma ação difícil de desfazer — cancelar um pedido, ou atualizar ou cancelar uma assinatura, por exemplo. Quando uma etapa apenas coleta ou exibe informações, você pode pular o vai e vem extra: mostre o que encontrou e deixe o cliente corrigir se estiver errado. Confirme uma vez, claramente, imediatamente antes da ação que não pode ser facilmente revertida.