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, permitindo 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 |
Controles de lógica e 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ê gostaria de 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), informações de Company, status da Conversation (como anexos) ou atributos personalizados Temporary. Exemplo: @read name e cumprimente o usuário pelo nome. |
| @Update attribute | Você pode instruir o Fin a @update qualquer atributo do intercom.
NOTA: Fin pode apenas atualizar o atributo de email de People para leads anônimos sem email ou telefone existentes, e somente quando uma flag de recurso é ativada pela equipe Intercom. Em todos os outros casos, a solicitação de atualização é rejeitada para proteger os detalhes de contato. |
| @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 no seu Help Center ou knowledge base externa por informações específicas. Saiba mais sobre @Look up content. |
| @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 de equipe. |
| @Handoff to Workflow | Encerra o Procedure e passa o usuário para um Workflow. |
| @Switch procedure | Encerra o procedimento atual e inicia imediatamente outro diferente. Esta é uma transição unidirecional. O Fin sairá do Procedure atual e entrará no novo imediatamente, mas não retornará ao Procedure original quando o novo terminar. @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ções de 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 emails, 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 conseguir 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, executar, 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