Conecta-seEntrar na plataforma

Memória

Adicionar leitura e gravação em um repositório de memória do fluxo.

Lógica e processamentoRecurso internoConexão: Sem conexão externa obrigatória

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

  1. Adicione Memória ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Nenhuma conta externa é obrigatória para usar este bloco.
  3. Escolha a operação. O painel mostra só os campos que essa operação usa.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Operações

OperaçãoO que faz
Adicionar memóriaAdiciona memória com o bloco Memória.
Obter todas as memóriasObtém todas as memórias com o bloco Memória.
Obter memóriaObtém memória com o bloco Memória.
Excluir memóriaExclui memória com o bloco Memória.

Campos

Mostrar campos de
  • 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ção

    Informe o ID da conversa (ex.: usuario-123).

    Aparece em:
    Adicionar memória
    Exemplo:
    id-do-recurso
  • Papel

    Obrigatório conforme a operação

    Selecione o papel.

    Aparece em:
    Adicionar memória
    Opções:
    Usuário · Assistente · Sistema
    Exemplo:
    Usuário
  • Conteúdo

    Obrigatório conforme a operação

    Informe 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ênciaTipoO que contém
<memoria.memories>jsonDados da memória.
<memoria.id>stringIdentificador da memória.

Exemplo de uso

Objetivo: Processar os dados antes de seguir para a próxima etapa.

InícioMemóriapró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