Skip to main content
O plugin em integrations-extras/dify no repositório do SDK de Python é um provedor de ferramentas com seis ferramentas: O cliente (tipo e id), o id da conversa e o canal são definidos por quem monta o app, em geral a partir das variáveis do app (sys.user_id, sys.conversation_id), e nunca pelo modelo.

​
Instalar

  1. Gere o pacote a partir do repositório (pip install dify_plugin niadra e dify plugin package ./dify produzem o .difypkg), instale-o no seu Dify e adicione o provedor com uma chave de fonte da Niadra (do Console). O campo de endereço da API fica vazio; ele só serve para o emulador local.
  2. Num chatflow: um nó Get context antes do nó LLM (mensagem do cliente = sys.query, id da conversa = sys.conversation_id), o texto dele no prompt de sistema do LLM depois das suas instruções, e um nó Record reply depois do LLM.
  3. Num agente: acrescente as ferramentas do histórico; as descrições são as mesmas que o modelo recebe de todo SDK da Niadra.

​
As cinco primitivas

​
Limites

  • As seis recebem os mesmos campos de conexão: o tipo e o id do cliente, o id da conversa e o canal, mapeados das variáveis do app.
  • Com a Niadra lenta ou fora, o contexto sai vazio e uma ferramenta diz que o histórico está indisponível; o app nunca para.
  • O plugin não guarda nada; PRIVACY.md no pacote lista o que ele envia à Niadra (o handle do cliente, o id da conversa, as mensagens de cada turno e as consultas do modelo).
  • Testado com o SDK de plugins do Dify (dify-plugin 0.10.2) e a Niadra no emulador, em integrations-extras/dify/test_niadra_plugin.py.

​
Próximos passos

Langflow

os três componentes do Langflow.

SDK de Python

a biblioteca que o plugin usa.