About the functional apis of langgraph

[postbird]

Recently, I noticed that langgraph provided the functional apis like https://langchain-ai.github.io/langgraphjs/how-tos/react-agent-from-scratch-functional/.

I'm wondering what the next iterator direction of the langgraph, will you prefer functional apis? For this react agent api reference, it seems like some complex for me, and break the concept of the graph.

Is there any more blogs or docs that I can learn more about the thinking or any other thinks of functional apis?

Thanks.

[hinthornw]

Our team's main focus is the underlying pregel API's, with the functional API and stategraph API being two ways to access the same underlying orchestration & durable execution engine. Choosing between the two is largely personal preference.

The Functional API is usually easier to learn, since it's more familiar to typical imperative programming.

The benefit of the graph API is that the execution boundaries are obvious (every bit of code is a function and depends solely on the input state). When resuming from an interruption or doing more intensive distributed operations, it's clear what is going on. Your'e less likely to accidentally write code with side effects that has to be re-executed upon resumption.