Memória
Adicionar leitura e gravação em um repositório de memória do fluxo.
O que faz
Integre a memória ao fluxo para adicionar uma memória, obter uma memória, obter todas as memórias e excluir memórias.
Quando usar: Use quando o seu fluxo precisar adicionar leitura e gravação em um repositório de memória do fluxo.
Exemplo de situação: Processar os dados antes de seguir para a próxima etapa.
Antes de começar
Conexão necessária: Sem conexão externa obrigatória.
Nenhuma conta externa é obrigatória para usar este bloco.
Passo a passo
- Adicione Memória ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
- Nenhuma conta externa é obrigatória para usar este bloco.
- Escolha a operação. O painel mostra só os campos que essa operação usa.
- Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
- Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
- Só publique depois de conferir o resultado da execução de teste.
Operações
| Operação | O que faz |
|---|---|
| Adicionar memória | Adiciona memória com o bloco Memória. |
| Obter todas as memórias | Obtém todas as memórias com o bloco Memória. |
| Obter memória | Obtém memória com o bloco Memória. |
| Excluir memória | Exclui memória com o bloco Memória. |
Campos
Operação
Escolhe qual ação este bloco executará.
- Opções:
- Adicionar memória · Obter todas as memórias · Obter memória · Excluir memória
- Padrão:
- Adicionar memória
Identificador
Obrigatório conforme a operaçãoInforme o ID da conversa (ex.: usuario-123).
- Aparece em:
- Adicionar memória
- Exemplo:
- id-do-recurso
Papel
Obrigatório conforme a operaçãoSelecione o papel.
- Aparece em:
- Adicionar memória
- Opções:
- Usuário · Assistente · Sistema
- Exemplo:
- Usuário
Conteúdo
Obrigatório conforme a operaçãoInforme o conteúdo da mensagem.
- Aparece em:
- Adicionar memória
- Exemplo:
- Olá! Sua solicitação foi processada com sucesso.
Saídas
Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <memoria.memories>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
| Referência | Tipo | O que contém |
|---|---|---|
<memoria.memories> | json | Dados da memória. |
<memoria.id> | string | Identificador da memória. |
Exemplo de uso
Objetivo: Processar os dados antes de seguir para a próxima etapa.
- Operação
- Adicionar memória
- Identificador
- id-do-recurso
- Papel
- Usuário
- Conteúdo
- Olá! Sua solicitação foi processada com sucesso.
Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.
Erros comuns e como resolver
- O bloco não executa
- Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
- Aparece “Validação do fluxo” no terminal
- Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
- Um campo chega vazio na etapa seguinte
- Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <memoria.memories>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
- O campo que eu procuro não aparece
- Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
Blocos relacionados
- AgendamentoIniciar a execução automaticamente nos dias e horários programados.
- Aguardar uma pessoaPausar a execução e aguardar uma decisão ou informação fornecida por uma pessoa.
- AnotaçãoAdicionar uma anotação visual ao desenho do fluxo sem executar uma ação.
- APIExpor um endpoint HTTP legado para iniciar o fluxo; em fluxos novos, prefira o bloco Início.
- AvaliadorAvaliar um conteúdo com critérios definidos e devolver uma nota ou conclusão.
- Base de conhecimentoPesquisar semanticamente nas bases de conhecimento disponíveis.