Compare commits

..
Author SHA1 Message Date
William Fu-Hinthorn 78e5bf4511 Merge branch 'main' into wfh/docs/memstoreconcept 2024-12-04 08:58:40 -08:00
Nuno Campos 9ab5fbc0f8 Merge pull request #2627 from langchain-ai/nc/4dec/state-ensure-config
lib: Call ensure_config in state crud methods
2024-12-04 11:53:03 -05:00
William FH c141f0fdf0 Add memory how-to (#2629) 2024-12-04 08:39:53 -08:00
William FH 830557d6b7 Clarify behavior in docstring (#2628) 2024-12-04 16:38:09 +00:00
Nuno Campos e5b00cdd1e Fix 2024-12-04 08:30:10 -08:00
Nuno Campos 8eea7ac401 lib: Call ensure_config in state crud methods
- this ensures that config from context vars is merged in
2024-12-04 08:15:01 -08:00
William FH c322f7ffa6 Add Memory Store conceptual doc section (#2624)
On semantic search
2024-12-04 15:19:49 +00:00
William Fu-Hinthorn 2709c7e786 Relative 2024-12-04 07:06:12 -08:00
William FH e6c83abecd Fix ref doc formatting (#2623) 2024-12-04 06:55:15 -08:00
William Fu-Hinthorn 62dafd2f2f Update the common dims table 2024-12-04 06:53:55 -08:00
William Fu-Hinthorn c5904135cc Merge remote-tracking branch 'origin/main' into wfh/docs/memstoreconcept 2024-12-04 06:49:29 -08:00
William Fu-Hinthorn fb188c4c5c Add Memory Store conceptual doc section
On semantic search
2024-12-04 06:45:23 -08:00
ACMCMC a8db511e24 Fix typo (#2620) 2024-12-04 06:30:05 -08:00
湛露先生 84d33f9621 Fix typos in langgraph_sdk client. (#2621)
Fix typos in langgraph_sdk client.

Signed-off-by: zhanluxianshen <zhanluxianshen@163.com>
2024-12-04 06:29:28 -08:00
William FH 9220049b35 Add store langgraph.json config ref (#2622) 2024-12-04 06:28:54 -08:00
William FH 879df6b52c [JS] Update SDK version (#2619) 2024-12-03 23:01:19 -08:00
William FH 9b8bf70d9e Add link to local studio testing (#2617) 2024-12-04 04:36:59 +00:00
Phoenix Logan aca67107c1 fix: make database saver classes inheritance-friendly (#2615)
Replace hardcoded database saver class names with `cls` in
`from_conn_string` factory methods to improve subclassing support

## Changes
* Replaced direct class instantiations with `cls(conn)` in
`from_conn_string` classmethods across all database implementations
* Updated both synchronous and asynchronous variants for DuckDB,
PostgreSQL, and SQLite savers

## Why
This refactor makes the database saver classes more extensible by
following Python's convention of using `cls` in class methods. This
enables proper inheritance patterns where subclasses can reuse the
factory methods without needing to override them. Previously, the
hardcoded class names would always instantiate the parent class, even
when called from a subclass.

## Testing
The change is backward compatible and doesn't alter existing
functionality. All existing tests should continue to pass as this is
purely a structural refactoring that preserves the current behavior
while improving extensibility.

## Notes
This PR addresses follow up on comments from #2518 - AsyncPostgresSaver
didn't need to be fixed but many of the other DB saver classes did.
2024-12-03 20:26:06 -08:00
William FH 5fa196ab38 Update docstrings for store classes (#2616) 2024-12-03 19:51:25 -08:00
Nuno Campos 584d9271ce Merge pull request #2614 from langchain-ai/nc/3dec/handle-command
Handle Command returned from node (in addition to GraphCommand)
2024-12-03 19:05:05 -05:00
Nuno Campos 1bee33db3a Fix 2024-12-03 15:52:41 -08:00
Nuno Campos a203ddecf7 Handle Command returned from node (in addition to GraphCommand) 2024-12-03 15:48:59 -08:00
Vadym Barda 5e3c326424 langgraph: bump sdk, release 0.2.54 (#2613) 2024-12-03 16:38:59 -05:00
Nuno Campos 86407aa6e8 Merge pull request #2071 from langchain-ai/brace/doc-nits
fix(docs): Small nits & typo fixes
2024-12-03 16:38:36 -05:00
Vadym Barda 7a80d6cb87 sdk-py: release 0.1.42 (#2612) 2024-12-03 16:34:08 -05:00
Nuno Campos 70f323779e Update persistence.md 2024-12-03 16:26:36 -05:00
Brace SproulandVadym Barda 23d5162945 Update human_in_the_loop.md
Co-authored-by: Vadym Barda <vadym@langchain.dev>
2024-12-03 16:26:36 -05:00
bracesproul 9d755f54e4 fix(docs): Small nits & typo fixes 2024-12-03 16:26:36 -05:00
Nuno Campos 75cccc4fc4 Merge pull request #2589 from stneng/main
fix: get correct reducer when type has multiple metadata.
2024-12-03 16:23:33 -05:00
Nuno Campos dd010e9230 Merge pull request #2593 from langchain-ai/nc/2dec/sdk-sse
sdk-py: Fix SSE parsing to split lines only \n \r , remove httpx-sse, fix missing decoder flush
2024-12-03 16:23:11 -05:00
Nuno Campos 2d87195b59 Merge pull request #2611 from langchain-ai/vb/remote-graph-kwargs
langgraph: allow passing kwargs to SDK methods in RemoteGraph's invoke/stream
2024-12-03 16:21:09 -05:00
vbarda 515242d0ba langgraph: allow passing kwargs to SDK methods in RemoteGraph's invoke/stream 2024-12-03 15:40:18 -05:00
Nuno Campos 3bf92d0b03 Fix 2024-12-03 11:04:28 -08:00
William FH 36b6cd1493 fix: Handle empty store similarity (numpy) (#2602) 2024-12-02 18:20:19 -08:00
William FH 0361554fcf Bump Checkpoint Postgres (#2601) 2024-12-02 17:56:23 -08:00
William FHandTai Groot 4332a9515d Fixup initial provisioning of aio postgres db (#2571) (#2600)
fixes #2570

---------

Co-authored-by: Tai Groot <tai@taigrr.com>
2024-12-03 01:55:26 +00:00
Nuno Campos 64b99c187a Merge pull request #2544 from langchain-ai/brace/type-interrupts-py
fix(sdk-py): Add typing for interrupts
2024-12-02 20:52:19 -05:00
Nuno Campos afa37d2059 Merge pull request #2552 from langchain-ai/vb/remove-assertion
langgraph: relax graph validation to handle nodes without return typehints
2024-12-02 20:51:50 -05:00
Nuno Campos b80933c5fb Merge branch 'main' into main 2024-12-02 20:50:44 -05:00
Nuno Campos d70b659adb Merge pull request #2430 from langchain-ai/nc/15nov/command-subgraph
Handle interrupt/resume for subgraphs
2024-12-02 20:45:40 -05:00
William FH 15f0765d60 Add IVFFlat and HNSW support (#2598)
It seems that actually once i moved the operators & other things out,
the query planner does do reasonable things and do sequential scanning
if filtered N < some size but the index otherwise, even with namespace
filtering.
2024-12-02 17:42:29 -08:00
Mingqi HuandWilliam FH fe538d4bcb docs: Use edit mode as default to install template (#2590)
Small change to install the dependencies with `edit` mode so that users
or freshman can see the effect immediately when they change the template
code. As below,
`pip install -e .`

It's very good to evaluate how agent works and easy to test &
re-develop!

---------

Signed-off-by: Mingqi Hu <mingqi.hu@intel.com>
Co-authored-by: William FH <13333726+hinthornw@users.noreply.github.com>
2024-12-02 17:36:13 -08:00
Nuno Campos 4e26a5cf2e Merge pull request #2597 from langchain-ai/nc/2dec/remote-command
lib: Handle Command in RemoteGraph
2024-12-02 20:34:08 -05:00
William FH 20f091a277 [postgres] Sort Ascending (#2594)
Adds a few of preliminaries:
1. Makes the returned "score" actually the result of the requested
operation (cosine, inner_product, l2)
2. Sorts asc, etc. so that if you were to add an HNSW index (and not
have any WHERE filters), it would be used
3. Drop the inner WHERE statement if no namespace or other filters are
provided. See (2) for why.
I don't yet add an index to the migrations since I think we need to
agree on the right balance to ensure it's actually used in common query
patterns.
2024-12-03 01:08:24 +00:00
Nuno Campos 0071bd1e1c Lint 2024-12-02 17:01:12 -08:00
Nuno Campos d36e6ceaaf Fix 2024-12-02 16:59:38 -08:00
Nuno Campos a3feaef2eb lib: Handle Command in RemoteGraph 2024-12-02 16:45:07 -08:00
David Duong c6fe26510e Merge pull request #2596 from langchain-ai/dqbd/sdk-cancel-on-disconnect
feat(sdk): pass cancel on disconnect when joining stream
2024-12-03 04:45:00 +04:00
Nuno Campos efbd02a27d Implement support for interrupt/resume in subgraphs 2024-12-02 16:43:35 -08:00
Tat Dat Duong a91bf116cb Bump to 0.1.41 2024-12-03 01:31:55 +01:00
Tat Dat Duong 6a6c3ed84c Bump to 0.0.30 2024-12-03 01:31:11 +01:00
Tat Dat Duong 988dd237d2 feat(sdk): pass cancel on disconnect when joining stream 2024-12-03 01:17:15 +01:00
David Duong 63f5f15c04 Merge pull request #2592 from langchain-ai/dqbd/sdk-list-runs-by-status
feat(sdk): add ability to search runs via status
2024-12-03 04:03:29 +04:00
Nuno Campos 6fc1c602ab Add one more 2024-12-02 13:53:44 -08:00
Nuno Campos 2b65308508 WIP: Handle commands for subgraphs 2024-12-02 13:53:44 -08:00
Nuno Campos 3cee1d5087 Remove httpx_sse, fix missing flush of sse decoder 2024-12-02 12:03:31 -08:00
Nuno Campos 2ce2021c39 Revert "Revert "sdk-py: Fix SSE parsing to split lines only \n \r \r\n per SSE spec""
This reverts commit 53ec7c41b2.
2024-12-02 11:29:06 -08:00
Tat Dat Duong 46dd424a7e feat(sdk): add ability to search runs via status 2024-12-02 19:53:58 +01:00
stneng 363c6e2e4c fix 2024-12-01 16:07:15 -08:00
Vadym Barda 784821705b checkpoint-postgres: pin psycopg >= 3.2.0 (#2580) 2024-11-29 11:30:19 -05:00
William FH 65172c2a43 [CLI] Nonblocking debugpy mode (#2573) 2024-11-28 12:24:00 -08:00
William FH 1130c3accb [CLI] Add Store config to CLI (#2548) 2024-11-28 01:58:18 -08:00
William FH ee8653d1c5 [SDK] Add SearchItem (#2567) 2024-11-27 22:50:52 -08:00
William FH 12486d977a Update postgres-checkpoint min bounds (#2564) 2024-11-27 22:31:16 -08:00
William FH c87f9ab6b1 Fix sentence fragment (#2566) 2024-11-27 22:31:03 -08:00
William FH 855a3d21ff Update Checkpoint Version (#2565) 2024-11-27 20:50:11 -08:00
William FH d767af421b feat: Add vector search (#2535)
- Initializing the store with an 'embedding config' -> this contains the
'dims' (used to create the table) and the encoder object (rn langchain
embeddings object, though that is ......)
- Call setup() -> creates the vector table.

Each document has 1 or more vectors associated with it for each json
path in the embedding config.

Would welcome critique and requests! 

Leaving the params as the defaults for pgvector but open to feedback if
you think it's important to be able to more transparently configure that
in setup()

```python
from typing import TypedDict, List, Dict, Any, Optional

from langchain_openai import OpenAIEmbeddings
from langgraph.graph import StateGraph
from langgraph.store.postgres import PostgresStore

emb_config = {
    "dims": 1536,  # OpenAI embedding dimensions
    "embed": OpenAIEmbeddings(model="text-embedding-3-small"),
    "distance_type": "cosine",
}
with PostgresStore.from_conn_string(
    "postgres://postgres:postgres@localhost:5441",
    embedding=emb_config,
) as store:
    store.setup()


# Define the state type for our graph
class State(TypedDict):
    query: str
    results: Optional[List[Dict[str, Any]]]


def put_stuff(state: State) -> State:
    docs = [
        ("doc1", {"text": "red apple in kitchen"}),
        ("doc2", {"text": "blue car in garage"}),
        ("doc3", {"text": "green apple on table"}),
    ]
    for key, value in docs:
        store.put(("docs",), key, value)


def search_stuff(state: State) -> State:
    """Search for documents using vector similarity."""
    results = store.search(("docs",), query=state["query"])

    return {"results": results}


builder = StateGraph(State)
builder.add_node(put_stuff)
builder.add_node(search_stuff)
builder.add_edge("__start__", "put_stuff")
builder.add_edge("put_stuff", "search_stuff")
# Compile
with PostgresStore.from_conn_string(
    "postgres://postgres:postgres@localhost:5441",
    embedding=emb_config,
) as store:
    chain = builder.compile(store=store)

    result = chain.invoke({"query": "sour apple"})

# Print results
for doc in result["results"]:
    print(doc.key)
    print(doc.value)
    print(doc.response_metadata)

```
2024-11-28 04:40:12 +00:00
Nuno Campos 07ac016e60 Merge pull request #2562 from langchain-ai/nc/27nov/revert-sdk
Revert "sdk-py: Fix SSE parsing to split lines only \n \r \r\n per SSE spec"
2024-11-27 17:36:07 -08:00
Nuno Campos 4576a259dd sdk-py 0.1.39 2024-11-27 17:32:07 -08:00
Nuno Campos 53ec7c41b2 Revert "sdk-py: Fix SSE parsing to split lines only \n \r \r\n per SSE spec"
This reverts commit dc09b13400.
2024-11-27 17:31:21 -08:00
Nuno Campos 769f6a1925 Fix 2024-11-27 15:59:48 -08:00
William FH 62a36befd5 Add in-mem vector search (#2547) 2024-11-27 14:53:24 -08:00
Andrew Nguonly dfaff2511b docs: Update API docs and remove unused pages (#2561) 2024-11-27 14:39:12 -08:00
Nuno Campos 1d9a0d1e4e sdk-py 0.1.37 2024-11-27 14:17:15 -08:00
Nuno Campos 35c7eb18ee Merge pull request #2560 from langchain-ai/nc/27nov/fix-sse-parser
sdk-py: Fix SSE parsing to split lines only \n \r \r\n per SSE spec
2024-11-27 14:16:43 -08:00
Nuno Campos dc09b13400 sdk-py: Fix SSE parsing to split lines only \n \r \r\n per SSE spec 2024-11-27 14:10:50 -08:00
Nuno Campos b2d8acffc4 Merge pull request #2558 from langchain-ai/nc/27nov/exc-note
lib: Add exception note identify node/task
2024-11-27 12:57:03 -08:00
Nuno Campos 1031e54860 lib: Add exception note identify node/task 2024-11-27 12:44:31 -08:00
Jacob Lee 7ac365ea84 fix(sdk-js): Avoid retrying 402s (#2554) 2024-11-27 19:33:23 +00:00
Vadym Barda 5144b8f374 langgraph: allow create_react_agent to take empty tools (#2553) 2024-11-27 12:54:59 -05:00
Vadym Barda f4a9d17d24 Merge branch 'main' into vb/remove-assertion 2024-11-27 10:02:24 -05:00
vbarda f416480e9d nit 2024-11-27 10:01:24 -05:00
vbarda 61e47cb137 langgraph: relax graph validation to handle nodes without return typehints 2024-11-27 09:56:04 -05:00
Brace Sproul d4bbb66963 Merge branch 'main' into brace/type-interrupts-py 2024-11-26 13:01:41 -08:00
Nuno Campos 4b1b3cecb4 Merge pull request #2546 from langchain-ai/jacob/jsenv
fix(js): Adds fallback for fetching environment variables
2024-11-26 12:34:18 -08:00
jacoblee93 c6a953c02a Bump version 2024-11-26 12:31:00 -08:00
jacoblee93 16b955dee2 Adds fallback for fetching environment variables 2024-11-26 12:30:33 -08:00
Brace Sproul 877124f7df Merge pull request #2545 from langchain-ai/release
release(sdk-js): 0.0.27
2024-11-26 11:54:45 -08:00
bracesproul d3a4865c0e release(sdk-js): 0.0.27 2024-11-26 11:42:20 -08:00
Brace Sproul 45b5f386e5 Merge branch 'main' into brace/type-interrupts-py 2024-11-26 11:41:07 -08:00
bracesproul a1ec55abc5 fix(sdk-py): Add typing for interrupts 2024-11-26 11:40:47 -08:00
Brace Sproul a3761ac522 Merge pull request #2543 from langchain-ai/brace/type-interrupts
fix(sdk-js): Add typing for interrupts on threads
2024-11-26 11:40:34 -08:00
bracesproul 376c58ff3b expose interupt type 2024-11-26 11:28:50 -08:00
bracesproul 58b99c899e cr 2024-11-26 11:28:19 -08:00
bracesproul 2ee279a977 fix(sdk-js): Add typing for interrupts on threads 2024-11-26 11:26:18 -08:00
William FH f04ce5d1ee [CLI] Add python-dotenv for inmem group (#2540) 2024-11-26 07:56:57 -08:00
William FH 8f649abd0a Release PG Checkpointer (#2536) 2024-11-26 01:44:45 +00:00
William FH 1febec7c0d Dedup store batch operations (#2534) 2024-11-25 16:31:26 -08:00
Nuno Campos a4eb4c6942 Merge pull request #2520 from langchain-ai/nc/22nov/parent-command
lib: Add Command(graph=Command.PARENT, ...)
2024-11-25 15:39:51 -08:00
Nuno Campos 8e1cd0e225 Add test 2024-11-25 14:11:20 -08:00
98935e1ffd fix: Fix race condition in PostgresSaver (#2494)
Signed-off-by: Tyler Ball <tyleraball@gmail.com>
Co-authored-by: Phoenix Logan <plogan@chanzuckerberg.com>
Co-authored-by: Tyler Ball <2481463+tyler-ball@users.noreply.github.com>
2024-11-25 20:19:52 +00:00
William FH 328ef609af [CLI] Python path (#2531) 2024-11-25 11:59:49 -08:00
Talha Munir 486d5412af docs: Fix grammatical mistake in introduction.ipynb (#2521) 2024-11-23 14:37:55 -05:00
Nuno Campos abc0c8c223 Fix 2024-11-22 16:35:20 -08:00
Nuno Campos 5bbb9dae57 Fix 2024-11-22 16:34:55 -08:00
Nuno Campos fed60e713c lib: Add Command(graph=Command.PARENT, ...)
- This makes the command bubble up out of the current graph and be handled by the calling graph (the immediate parent)
- This could be extended to support eg. ROOT graph, or some other level
2024-11-22 16:28:43 -08:00
Eugene Yurtsev 4f4e7a6981 docs: more fixes for python version (#2515) 2024-11-22 19:50:31 +00:00
Mingqi HuandEugene Yurtsev 3351d4f6c5 docs: fix typo (#2510)
`python-dotenv` not `python-dot-env`

Signed-off-by: Mingqi <mingqi.hu@intel.com>
Co-authored-by: Eugene Yurtsev <eyurtsev@gmail.com>
2024-11-22 14:17:59 -05:00
Eugene Yurtsev b4900341e4 docs: fix broken link (#2514)
We need to check later why CI didn't fail with original PR that broke
the link
2024-11-22 14:07:54 -05:00
Eugene Yurtsev 65f515e020 docs: add helm chart link (#2512) 2024-11-22 17:17:36 +00:00
Eugene Yurtsev 0d0665a6e3 docs: Add resource allocation (#2511) 2024-11-22 11:56:16 -05:00
Eugene Yurtsev 93b8525dc1 docs: fix link checker (#2508)
3rd attempt to fix localhost link
2024-11-21 21:59:43 -05:00
Eugene Yurtsev aeb6f784e1 docs: fix link checking? (#2506) 2024-11-21 21:21:30 -05:00
Nuno Campos 3eedeac0d4 Not red 2024-11-21 15:31:52 -08:00
Eugene Yurtsev b09e7b20b0 docs: do not check localhost links (#2505) 2024-11-21 23:28:24 +00:00
Eugene Yurtsev 26ce731eab docs: update README.md (#2474) 2024-11-21 22:48:12 +00:00
Eugene Yurtsev 55593446f8 docs: get started with langgraph platform (#2469) 2024-11-21 17:41:03 -05:00
William FH 7082e2613e [CLI] Dotenv support (#2501) 2024-11-21 16:28:53 +00:00
dependabot[bot]andWilliam FH ceeb9636ee build(deps-dev): bump notebook from 7.0.7 to 7.2.2 in /libs/langgraph (#2411)
Bumps [notebook](https://github.com/jupyter/notebook) from 7.0.7 to
7.2.2.
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/jupyter/notebook/releases">notebook's
releases</a>.</em></p>
<blockquote>
<h2>v7.2.2</h2>
<h2>7.2.2</h2>
<p>(<a
href="https://github.com/jupyter/notebook/compare/@jupyter-notebook/application-extension@7.2.1...0426a897ad6b5708d73e6e49ea424076de2906a1">Full
Changelog</a>)</p>
<h3>Maintenance and upkeep improvements</h3>
<ul>
<li>Upgrade JupyterLab dependencies to v4.2.5 <a
href="https://redirect.github.com/jupyter/notebook/pull/7447">#7447</a>
(<a
href="https://github.com/krassowski"><code>@​krassowski</code></a>)</li>
</ul>
<h3>Contributors to this release</h3>
<p>(<a
href="https://github.com/jupyter/notebook/graphs/contributors?from=2024-06-07&amp;to=2024-08-27&amp;type=c">GitHub
contributors page for this release</a>)</p>
<p><a
href="https://github.com/search?q=repo%3Ajupyter%2Fnotebook+involves%3Agithub-actions+updated%3A2024-06-07..2024-08-27&amp;type=Issues"><code>@​github-actions</code></a>
| <a
href="https://github.com/search?q=repo%3Ajupyter%2Fnotebook+involves%3Akrassowski+updated%3A2024-06-07..2024-08-27&amp;type=Issues"><code>@​krassowski</code></a>
| <a
href="https://github.com/search?q=repo%3Ajupyter%2Fnotebook+involves%3ARRosio+updated%3A2024-06-07..2024-08-27&amp;type=Issues"><code>@​RRosio</code></a></p>
<h2>v7.2.1</h2>
<h2>7.2.1</h2>
<p>(<a
href="https://github.com/jupyter/notebook/compare/@jupyter-notebook/application-extension@7.2.0...e881745c98ea0a0ea585df78f1ca8950a0edeaa2">Full
Changelog</a>)</p>
<h3>Bugs fixed</h3>
<ul>
<li>Remove pseudoelement obstructing the cell collapser <a
href="https://redirect.github.com/jupyter/notebook/pull/7392">#7392</a>
(<a
href="https://github.com/krassowski"><code>@​krassowski</code></a>)</li>
</ul>
<h3>Contributors to this release</h3>
<p>(<a
href="https://github.com/jupyter/notebook/graphs/contributors?from=2024-05-16&amp;to=2024-06-07&amp;type=c">GitHub
contributors page for this release</a>)</p>
<p><a
href="https://github.com/search?q=repo%3Ajupyter%2Fnotebook+involves%3Agithub-actions+updated%3A2024-05-16..2024-06-07&amp;type=Issues"><code>@​github-actions</code></a>
| <a
href="https://github.com/search?q=repo%3Ajupyter%2Fnotebook+involves%3Ajtpio+updated%3A2024-05-16..2024-06-07&amp;type=Issues"><code>@​jtpio</code></a>
| <a
href="https://github.com/search?q=repo%3Ajupyter%2Fnotebook+involves%3Ameeseeksmachine+updated%3A2024-05-16..2024-06-07&amp;type=Issues"><code>@​meeseeksmachine</code></a></p>
<h2>v7.2.0</h2>
<h2>7.2.0</h2>
<p>(<a
href="https://github.com/jupyter/notebook/compare/@jupyter-notebook/application-extension@7.1.2...31bf294e85175bbf39816a90dc8858dedaf73bde">Full
Changelog</a>)</p>
<h3>Enhancements made</h3>
<ul>
<li>Update to JupyterLab 4.2.0 <a
href="https://redirect.github.com/jupyter/notebook/pull/7357">#7357</a>
(<a href="https://github.com/jtpio"><code>@​jtpio</code></a>)</li>
<li>Update to JupyterLab 4.2.0rc0 <a
href="https://redirect.github.com/jupyter/notebook/pull/7333">#7333</a>
(<a href="https://github.com/jtpio"><code>@​jtpio</code></a>)</li>
<li>Add <code>@jupyterlab/theme-dark-high-contrast-extension</code> <a
href="https://redirect.github.com/jupyter/notebook/pull/7331">#7331</a>
(<a href="https://github.com/jtpio"><code>@​jtpio</code></a>)</li>
<li>Update to JupyterLab 4.2.0a2 <a
href="https://redirect.github.com/jupyter/notebook/pull/7307">#7307</a>
(<a href="https://github.com/jtpio"><code>@​jtpio</code></a>)</li>
</ul>
<h3>Bugs fixed</h3>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/jupyter/notebook/blob/@jupyter-notebook/tree@7.2.2/CHANGELOG.md">notebook's
changelog</a>.</em></p>
<blockquote>
<h2>7.2.2</h2>
<p>(<a
href="https://github.com/jupyter/notebook/compare/@jupyter-notebook/application-extension@7.2.1...0426a897ad6b5708d73e6e49ea424076de2906a1">Full
Changelog</a>)</p>
<h3>Maintenance and upkeep improvements</h3>
<ul>
<li>Upgrade JupyterLab dependencies to v4.2.5 <a
href="https://redirect.github.com/jupyter/notebook/pull/7447">#7447</a>
(<a
href="https://github.com/krassowski"><code>@​krassowski</code></a>)</li>
</ul>
<h3>Contributors to this release</h3>
<p>(<a
href="https://github.com/jupyter/notebook/graphs/contributors?from=2024-06-07&amp;to=2024-08-27&amp;type=c">GitHub
contributors page for this release</a>)</p>
<p><a
href="https://github.com/search?q=repo%3Ajupyter%2Fnotebook+involves%3Agithub-actions+updated%3A2024-06-07..2024-08-27&amp;type=Issues"><code>@​github-actions</code></a>
| <a
href="https://github.com/search?q=repo%3Ajupyter%2Fnotebook+involves%3Akrassowski+updated%3A2024-06-07..2024-08-27&amp;type=Issues"><code>@​krassowski</code></a>
| <a
href="https://github.com/search?q=repo%3Ajupyter%2Fnotebook+involves%3ARRosio+updated%3A2024-06-07..2024-08-27&amp;type=Issues"><code>@​RRosio</code></a></p>
<!-- raw HTML omitted -->
<h2>7.2.1</h2>
<p>(<a
href="https://github.com/jupyter/notebook/compare/@jupyter-notebook/application-extension@7.2.0...e881745c98ea0a0ea585df78f1ca8950a0edeaa2">Full
Changelog</a>)</p>
<h3>Bugs fixed</h3>
<ul>
<li>Remove pseudoelement obstructing the cell collapser <a
href="https://redirect.github.com/jupyter/notebook/pull/7392">#7392</a>
(<a
href="https://github.com/krassowski"><code>@​krassowski</code></a>)</li>
</ul>
<h3>Contributors to this release</h3>
<p>(<a
href="https://github.com/jupyter/notebook/graphs/contributors?from=2024-05-16&amp;to=2024-06-07&amp;type=c">GitHub
contributors page for this release</a>)</p>
<p><a
href="https://github.com/search?q=repo%3Ajupyter%2Fnotebook+involves%3Agithub-actions+updated%3A2024-05-16..2024-06-07&amp;type=Issues"><code>@​github-actions</code></a>
| <a
href="https://github.com/search?q=repo%3Ajupyter%2Fnotebook+involves%3Ajtpio+updated%3A2024-05-16..2024-06-07&amp;type=Issues"><code>@​jtpio</code></a>
| <a
href="https://github.com/search?q=repo%3Ajupyter%2Fnotebook+involves%3Ameeseeksmachine+updated%3A2024-05-16..2024-06-07&amp;type=Issues"><code>@​meeseeksmachine</code></a></p>
<h2>7.2.0</h2>
<p>(<a
href="https://github.com/jupyter/notebook/compare/@jupyter-notebook/application-extension@7.1.2...31bf294e85175bbf39816a90dc8858dedaf73bde">Full
Changelog</a>)</p>
<h3>Enhancements made</h3>
<ul>
<li>Update to JupyterLab 4.2.0 <a
href="https://redirect.github.com/jupyter/notebook/pull/7357">#7357</a>
(<a href="https://github.com/jtpio"><code>@​jtpio</code></a>)</li>
<li>Update to JupyterLab 4.2.0rc0 <a
href="https://redirect.github.com/jupyter/notebook/pull/7333">#7333</a>
(<a href="https://github.com/jtpio"><code>@​jtpio</code></a>)</li>
<li>Add <code>@jupyterlab/theme-dark-high-contrast-extension</code> <a
href="https://redirect.github.com/jupyter/notebook/pull/7331">#7331</a>
(<a href="https://github.com/jtpio"><code>@​jtpio</code></a>)</li>
<li>Update to JupyterLab 4.2.0a2 <a
href="https://redirect.github.com/jupyter/notebook/pull/7307">#7307</a>
(<a href="https://github.com/jtpio"><code>@​jtpio</code></a>)</li>
</ul>
<h3>Bugs fixed</h3>
<ul>
<li>Add the <code>@jupyterlab/notebook-extension:copy-output</code>
plugin <a
href="https://redirect.github.com/jupyter/notebook/pull/7353">#7353</a>
(<a href="https://github.com/jtpio"><code>@​jtpio</code></a>)</li>
<li>Fix CSS for <code>full</code> windowing mode <a
href="https://redirect.github.com/jupyter/notebook/pull/7337">#7337</a>
(<a href="https://github.com/jtpio"><code>@​jtpio</code></a>)</li>
<li>Force notebook windowing mode to <code>defer</code> <a
href="https://redirect.github.com/jupyter/notebook/pull/7335">#7335</a>
(<a href="https://github.com/jtpio"><code>@​jtpio</code></a>)</li>
<li>Fix scrollbar always showing up by default <a
href="https://redirect.github.com/jupyter/notebook/pull/7327">#7327</a>
(<a href="https://github.com/jtpio"><code>@​jtpio</code></a>)</li>
<li>Default to the <code>full</code> windowing mode <a
href="https://redirect.github.com/jupyter/notebook/pull/7321">#7321</a>
(<a href="https://github.com/jtpio"><code>@​jtpio</code></a>)</li>
</ul>
<h3>Maintenance and upkeep improvements</h3>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/jupyter/notebook/commit/d1d232b27c5441c4a040dd3ca491a7cf0fa6c528"><code>d1d232b</code></a>
Publish 7.2.2</li>
<li><a
href="https://github.com/jupyter/notebook/commit/0426a897ad6b5708d73e6e49ea424076de2906a1"><code>0426a89</code></a>
Upgrade JupyterLab dependencies to v4.2.5 (<a
href="https://redirect.github.com/jupyter/notebook/issues/7447">#7447</a>)</li>
<li><a
href="https://github.com/jupyter/notebook/commit/3542421de92c91892d8d8c40ebbd023215c39606"><code>3542421</code></a>
Publish 7.2.1</li>
<li><a
href="https://github.com/jupyter/notebook/commit/e881745c98ea0a0ea585df78f1ca8950a0edeaa2"><code>e881745</code></a>
Backport PR <a
href="https://redirect.github.com/jupyter/notebook/issues/7392">#7392</a>:
Remove pseudoelement obstructing the cell collapser (<a
href="https://redirect.github.com/jupyter/notebook/issues/7393">#7393</a>)</li>
<li><a
href="https://github.com/jupyter/notebook/commit/30587b826a0fe7055a02ea96d43e6305d8b5590b"><code>30587b8</code></a>
Publish 7.2.0</li>
<li><a
href="https://github.com/jupyter/notebook/commit/31bf294e85175bbf39816a90dc8858dedaf73bde"><code>31bf294</code></a>
Add user facing changelog for 7.2 (<a
href="https://redirect.github.com/jupyter/notebook/issues/7372">#7372</a>)</li>
<li><a
href="https://github.com/jupyter/notebook/commit/08fe5c5df12182178280bad5d2fbae02b3486146"><code>08fe5c5</code></a>
Update <code>@jupyterlab/galata</code> (<a
href="https://redirect.github.com/jupyter/notebook/issues/7361">#7361</a>)</li>
<li><a
href="https://github.com/jupyter/notebook/commit/7891117aa9f9cb95c8e301875f9bf74d9496a301"><code>7891117</code></a>
Update config.yml (<a
href="https://redirect.github.com/jupyter/notebook/issues/7363">#7363</a>)</li>
<li><a
href="https://github.com/jupyter/notebook/commit/a1e25b92bf10ef13a760353837114db9b498f242"><code>a1e25b9</code></a>
Publish 7.2.0rc1</li>
<li><a
href="https://github.com/jupyter/notebook/commit/f5d8aea3bdc3eea25213792f9d101738f2a1f627"><code>f5d8aea</code></a>
Default to the <code>full</code> windowing mode (<a
href="https://redirect.github.com/jupyter/notebook/issues/7321">#7321</a>)</li>
<li>Additional commits viewable in <a
href="https://github.com/jupyter/notebook/compare/@jupyter-notebook/tree@7.0.7...@jupyter-notebook/tree@7.2.2">compare
view</a></li>
</ul>
</details>
<br />


[![Dependabot compatibility
score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=notebook&package-manager=pip&previous-version=7.0.7&new-version=7.2.2)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores)

Dependabot will resolve any conflicts with this PR as long as you don't
alter it yourself. You can also trigger a rebase manually by commenting
`@dependabot rebase`.

[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)

---

<details>
<summary>Dependabot commands and options</summary>
<br />

You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits
that have been made to it
- `@dependabot merge` will merge this PR after your CI passes on it
- `@dependabot squash and merge` will squash and merge this PR after
your CI passes on it
- `@dependabot cancel merge` will cancel a previously requested merge
and block automerging
- `@dependabot reopen` will reopen this PR if it is closed
- `@dependabot close` will close this PR and stop Dependabot recreating
it. You can achieve the same result by closing it manually
- `@dependabot show <dependency name> ignore conditions` will show all
of the ignore conditions of the specified dependency
- `@dependabot ignore this major version` will close this PR and stop
Dependabot creating any more for this major version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop
Dependabot creating any more for this minor version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop
Dependabot creating any more for this dependency (unless you reopen the
PR or upgrade to it yourself)
You can disable automated security fix PRs for this repo from the
[Security Alerts
page](https://github.com/langchain-ai/langgraph/network/alerts).

</details>

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: William FH <13333726+hinthornw@users.noreply.github.com>
2024-11-21 08:00:26 -08:00
dependabot[bot]andWilliam FH f7788abbb6 build(deps-dev): bump starlette from 0.38.6 to 0.40.0 (#2421)
Bumps [starlette](https://github.com/encode/starlette) from 0.38.6 to
0.40.0.
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/encode/starlette/releases">starlette's
releases</a>.</em></p>
<blockquote>
<h2>Version 0.40.0</h2>
<p>This release fixes a Denial of service (DoS) via
<code>multipart/form-data</code> requests.</p>
<p>You can view the full security advisory:
<a
href="https://github.com/encode/starlette/security/advisories/GHSA-f96h-pmfr-66vw">GHSA-f96h-pmfr-66vw</a></p>
<h2>Fixed</h2>
<ul>
<li>Add <code>max_part_size</code> to <code>MultiPartParser</code> to
limit the size of parts in <code>multipart/form-data</code>
requests <a
href="https://github.com/encode/starlette/commit/fd038f3070c302bff17ef7d173dbb0b007617733">fd038f3</a>.</li>
</ul>
<h2>Version 0.39.2</h2>
<h2>Fixed</h2>
<ul>
<li>Allow use of <code>request.url_for</code> when only &quot;app&quot;
scope is available <a
href="https://redirect.github.com/encode/starlette/pull/2672">#2672</a>.</li>
<li>Fix internal type hints to support
<code>python-multipart==0.0.12</code> <a
href="https://redirect.github.com/encode/starlette/pull/2708">#2708</a>.</li>
</ul>
<hr />
<p><strong>Full Changelog</strong>: <a
href="https://github.com/encode/starlette/compare/0.39.1...0.39.2">https://github.com/encode/starlette/compare/0.39.1...0.39.2</a></p>
<h2>Version 0.39.1</h2>
<h2>Fixed</h2>
<ul>
<li>Avoid regex re-compilation in <code>responses.py</code> and
<code>schemas.py</code> <a
href="https://redirect.github.com/encode/starlette/pull/2700">#2700</a>.</li>
<li>Improve performance of <code>get_route_path</code> by removing
regular expression usage <a
href="https://redirect.github.com/encode/starlette/pull/2701">#2701</a>.</li>
<li>Consider <code>FileResponse.chunk_size</code> when handling multiple
ranges <a
href="https://redirect.github.com/encode/starlette/pull/2703">#2703</a>.</li>
<li>Use <code>token_hex</code> for generating multipart boundary strings
<a
href="https://redirect.github.com/encode/starlette/pull/2702">#2702</a>.</li>
</ul>
<hr />
<p><strong>Full Changelog</strong>: <a
href="https://github.com/encode/starlette/compare/0.39.0...0.39.1">https://github.com/encode/starlette/compare/0.39.0...0.39.1</a></p>
<h2>Version 0.39.0</h2>
<h2>Added</h2>
<ul>
<li>Add support for HTTP Range to <code>FileResponse</code> <a
href="https://redirect.github.com/encode/starlette/pull/2697">#2697</a></li>
</ul>
<hr />
<p><strong>Full Changelog</strong>: <a
href="https://github.com/encode/starlette/compare/0.38.6...0.39.0">https://github.com/encode/starlette/compare/0.38.6...0.39.0</a></p>
</blockquote>
</details>
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/encode/starlette/blob/master/docs/release-notes.md">starlette's
changelog</a>.</em></p>
<blockquote>
<h2>0.40.0 (October 15, 2024)</h2>
<p>This release fixes a Denial of service (DoS) via
<code>multipart/form-data</code> requests.</p>
<p>You can view the full security advisory:
<a
href="https://github.com/encode/starlette/security/advisories/GHSA-f96h-pmfr-66vw">GHSA-f96h-pmfr-66vw</a></p>
<h4>Fixed</h4>
<ul>
<li>Add <code>max_part_size</code> to <code>MultiPartParser</code> to
limit the size of parts in <code>multipart/form-data</code>
requests <a
href="https://github.com/encode/starlette/commit/fd038f3070c302bff17ef7d173dbb0b007617733">fd038f3</a>.</li>
</ul>
<h2>0.39.2 (September 29, 2024)</h2>
<h4>Fixed</h4>
<ul>
<li>Allow use of <code>request.url_for</code> when only &quot;app&quot;
scope is available <a
href="https://redirect.github.com/encode/starlette/pull/2672">#2672</a>.</li>
<li>Fix internal type hints to support
<code>python-multipart==0.0.12</code> <a
href="https://redirect.github.com/encode/starlette/pull/2708">#2708</a>.</li>
</ul>
<h2>0.39.1 (September 25, 2024)</h2>
<h4>Fixed</h4>
<ul>
<li>Avoid regex re-compilation in <code>responses.py</code> and
<code>schemas.py</code> <a
href="https://redirect.github.com/encode/starlette/pull/2700">#2700</a>.</li>
<li>Improve performance of <code>get_route_path</code> by removing
regular expression usage
<a
href="https://redirect.github.com/encode/starlette/pull/2701">#2701</a>.</li>
<li>Consider <code>FileResponse.chunk_size</code> when handling multiple
ranges <a
href="https://redirect.github.com/encode/starlette/pull/2703">#2703</a>.</li>
<li>Use <code>token_hex</code> for generating multipart boundary strings
<a
href="https://redirect.github.com/encode/starlette/pull/2702">#2702</a>.</li>
</ul>
<h2>0.39.0 (September 23, 2024)</h2>
<h4>Added</h4>
<ul>
<li>Add support for <a
href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Range_requests">HTTP
Range</a> to
<code>FileResponse</code> <a
href="https://redirect.github.com/encode/starlette/pull/2697">#2697</a>.</li>
</ul>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/encode/starlette/commit/4ded4b7ac517bd301cee69f5c189b1cb48c069b6"><code>4ded4b7</code></a>
Version 0.40.0 (<a
href="https://redirect.github.com/encode/starlette/issues/2728">#2728</a>)</li>
<li><a
href="https://github.com/encode/starlette/commit/fd038f3070c302bff17ef7d173dbb0b007617733"><code>fd038f3</code></a>
Merge commit from fork</li>
<li><a
href="https://github.com/encode/starlette/commit/e11684013fe5ca084f5bd4e54830512a4dff9618"><code>e116840</code></a>
Bump the python-packages group with 6 updates (<a
href="https://redirect.github.com/encode/starlette/issues/2713">#2713</a>)</li>
<li><a
href="https://github.com/encode/starlette/commit/0b50b9c4abd992a39d6e32148cc6f577ac3b1c44"><code>0b50b9c</code></a>
Version 0.39.2 (<a
href="https://redirect.github.com/encode/starlette/issues/2710">#2710</a>)</li>
<li><a
href="https://github.com/encode/starlette/commit/fe46d99d92da17efe1827f96ad29d748aac870d2"><code>fe46d99</code></a>
Support <code>request.url_for</code> when only &quot;app&quot; scope is
avaialable (<a
href="https://redirect.github.com/encode/starlette/issues/2672">#2672</a>)</li>
<li><a
href="https://github.com/encode/starlette/commit/1a6018e08a994c78f5c169b8535408259af0f249"><code>1a6018e</code></a>
Support python-multipart 0.0.12 (<a
href="https://redirect.github.com/encode/starlette/issues/2708">#2708</a>)</li>
<li><a
href="https://github.com/encode/starlette/commit/fa7b382a66cd99e3dc18f3baa44dae5ec68be76b"><code>fa7b382</code></a>
Version 0.39.1 (<a
href="https://redirect.github.com/encode/starlette/issues/2706">#2706</a>)</li>
<li><a
href="https://github.com/encode/starlette/commit/075efd0c5c9f5e49a4416f3b4a24e24efab135f8"><code>075efd0</code></a>
generate boundary with token_hex (<a
href="https://redirect.github.com/encode/starlette/issues/2702">#2702</a>)</li>
<li><a
href="https://github.com/encode/starlette/commit/b8139f9fe3b1acb34ddbe38dc6472a60b621540e"><code>b8139f9</code></a>
Consider <code>FileResponse.chunk_size</code> when handling multiple
ranges (<a
href="https://redirect.github.com/encode/starlette/issues/2703">#2703</a>)</li>
<li><a
href="https://github.com/encode/starlette/commit/4fbf766b3eac4146b86175682cec88d266fd8470"><code>4fbf766</code></a>
test: add tests in <code>test_requests</code> (<a
href="https://redirect.github.com/encode/starlette/issues/2677">#2677</a>)</li>
<li>Additional commits viewable in <a
href="https://github.com/encode/starlette/compare/0.38.6...0.40.0">compare
view</a></li>
</ul>
</details>
<br />


[![Dependabot compatibility
score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=starlette&package-manager=pip&previous-version=0.38.6&new-version=0.40.0)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores)

Dependabot will resolve any conflicts with this PR as long as you don't
alter it yourself. You can also trigger a rebase manually by commenting
`@dependabot rebase`.

[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)

---

<details>
<summary>Dependabot commands and options</summary>
<br />

You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits
that have been made to it
- `@dependabot merge` will merge this PR after your CI passes on it
- `@dependabot squash and merge` will squash and merge this PR after
your CI passes on it
- `@dependabot cancel merge` will cancel a previously requested merge
and block automerging
- `@dependabot reopen` will reopen this PR if it is closed
- `@dependabot close` will close this PR and stop Dependabot recreating
it. You can achieve the same result by closing it manually
- `@dependabot show <dependency name> ignore conditions` will show all
of the ignore conditions of the specified dependency
- `@dependabot ignore this major version` will close this PR and stop
Dependabot creating any more for this major version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop
Dependabot creating any more for this minor version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop
Dependabot creating any more for this dependency (unless you reopen the
PR or upgrade to it yourself)
You can disable automated security fix PRs for this repo from the
[Security Alerts
page](https://github.com/langchain-ai/langgraph/network/alerts).

</details>

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: William FH <13333726+hinthornw@users.noreply.github.com>
2024-11-21 07:58:30 -08:00
dependabot[bot] 9bd430142a build(deps-dev): bump aiohttp from 3.10.6 to 3.10.11 (#2454)
Bumps [aiohttp](https://github.com/aio-libs/aiohttp) from 3.10.6 to
3.10.11.
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/aio-libs/aiohttp/releases">aiohttp's
releases</a>.</em></p>
<blockquote>
<h2>3.10.11</h2>
<h2>Bug fixes</h2>
<ul>
<li>
<p>Authentication provided by a redirect now takes precedence over
provided <code>auth</code> when making requests with the client -- by
:user:<code>PLPeeters</code>.</p>
<p><em>Related issues and pull requests on GitHub:</em>
<a
href="https://redirect.github.com/aio-libs/aiohttp/issues/9436">#9436</a>.</p>
</li>
<li>
<p>Fixed :py:meth:<code>WebSocketResponse.close()
&lt;aiohttp.web.WebSocketResponse.close&gt;</code> to discard non-close
messages within its timeout window after sending close -- by
:user:<code>lenard-mosys</code>.</p>
<p><em>Related issues and pull requests on GitHub:</em>
<a
href="https://redirect.github.com/aio-libs/aiohttp/issues/9506">#9506</a>.</p>
</li>
<li>
<p>Fixed a deadlock that could occur while attempting to get a new
connection slot after a timeout -- by :user:<code>bdraco</code>.</p>
<p>The connector was not cancellation-safe.</p>
<p><em>Related issues and pull requests on GitHub:</em>
<a
href="https://redirect.github.com/aio-libs/aiohttp/issues/9670">#9670</a>,
<a
href="https://redirect.github.com/aio-libs/aiohttp/issues/9671">#9671</a>.</p>
</li>
<li>
<p>Fixed the WebSocket flow control calculation undercounting with
multi-byte data -- by :user:<code>bdraco</code>.</p>
<p><em>Related issues and pull requests on GitHub:</em>
<a
href="https://redirect.github.com/aio-libs/aiohttp/issues/9686">#9686</a>.</p>
</li>
<li>
<p>Fixed incorrect parsing of chunk extensions with the pure Python
parser -- by :user:<code>bdraco</code>.</p>
<p><em>Related issues and pull requests on GitHub:</em>
<a
href="https://redirect.github.com/aio-libs/aiohttp/issues/9851">#9851</a>.</p>
</li>
<li>
<p>Fixed system routes polluting the middleware cache -- by
:user:<code>bdraco</code>.</p>
<p><em>Related issues and pull requests on GitHub:</em></p>
</li>
</ul>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/aio-libs/aiohttp/blob/master/CHANGES.rst">aiohttp's
changelog</a>.</em></p>
<blockquote>
<h1>3.10.11 (2024-11-13)</h1>
<h2>Bug fixes</h2>
<ul>
<li>
<p>Authentication provided by a redirect now takes precedence over
provided <code>auth</code> when making requests with the client -- by
:user:<code>PLPeeters</code>.</p>
<p><em>Related issues and pull requests on GitHub:</em>
:issue:<code>9436</code>.</p>
</li>
<li>
<p>Fixed :py:meth:<code>WebSocketResponse.close()
&lt;aiohttp.web.WebSocketResponse.close&gt;</code> to discard non-close
messages within its timeout window after sending close -- by
:user:<code>lenard-mosys</code>.</p>
<p><em>Related issues and pull requests on GitHub:</em>
:issue:<code>9506</code>.</p>
</li>
<li>
<p>Fixed a deadlock that could occur while attempting to get a new
connection slot after a timeout -- by :user:<code>bdraco</code>.</p>
<p>The connector was not cancellation-safe.</p>
<p><em>Related issues and pull requests on GitHub:</em>
:issue:<code>9670</code>, :issue:<code>9671</code>.</p>
</li>
<li>
<p>Fixed the WebSocket flow control calculation undercounting with
multi-byte data -- by :user:<code>bdraco</code>.</p>
<p><em>Related issues and pull requests on GitHub:</em>
:issue:<code>9686</code>.</p>
</li>
<li>
<p>Fixed incorrect parsing of chunk extensions with the pure Python
parser -- by :user:<code>bdraco</code>.</p>
<p><em>Related issues and pull requests on GitHub:</em>
:issue:<code>9851</code>.</p>
</li>
<li>
<p>Fixed system routes polluting the middleware cache -- by
:user:<code>bdraco</code>.</p>
</li>
</ul>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/aio-libs/aiohttp/commit/3e09325e4839117df13fbac301f360edf8d3a0ee"><code>3e09325</code></a>
Remove 3.10.11rc0 from 3.10 changelog (<a
href="https://redirect.github.com/aio-libs/aiohttp/issues/9858">#9858</a>)</li>
<li><a
href="https://github.com/aio-libs/aiohttp/commit/beb7b740533b81d75706e6615f07d92fcbf1c325"><code>beb7b74</code></a>
Release 3.10.11 (<a
href="https://redirect.github.com/aio-libs/aiohttp/issues/9857">#9857</a>)</li>
<li><a
href="https://github.com/aio-libs/aiohttp/commit/259edc369075de63e6f3a4eaade058c62af0df71"><code>259edc3</code></a>
[PR <a
href="https://redirect.github.com/aio-libs/aiohttp/issues/9851">#9851</a>/541d86d
backport][3.10] Fix incorrect parsing of chunk extensions w...</li>
<li><a
href="https://github.com/aio-libs/aiohttp/commit/bc15db61615079d1b6327ba42c682f758fa96936"><code>bc15db6</code></a>
[PR <a
href="https://redirect.github.com/aio-libs/aiohttp/issues/9852">#9852</a>/249855a
backport][3.10] Fix system routes polluting the middleware ...</li>
<li><a
href="https://github.com/aio-libs/aiohttp/commit/158bf304bdd8047eec192540fa5bf7fe3862bffd"><code>158bf30</code></a>
Release 3.10.11rc0 (<a
href="https://redirect.github.com/aio-libs/aiohttp/issues/9848">#9848</a>)</li>
<li><a
href="https://github.com/aio-libs/aiohttp/commit/e5917cd3480b01e7527b6524f9bec954325e1d5f"><code>e5917cd</code></a>
[PR <a
href="https://redirect.github.com/aio-libs/aiohttp/issues/9844">#9844</a>/fabf3884
backport][3.10] Fix compressed get request benchmark paylo...</li>
<li><a
href="https://github.com/aio-libs/aiohttp/commit/68a1f42af90a5beae28c8617e0dfc15c3bd5153c"><code>68a1f42</code></a>
[PR <a
href="https://redirect.github.com/aio-libs/aiohttp/issues/9840">#9840</a>/cc5fa316
backport][3.10] Add benchmark for sending compressed paylo...</li>
<li><a
href="https://github.com/aio-libs/aiohttp/commit/4f4b90fef082fbb37395c394d68ee0ab3fcbc7e6"><code>4f4b90f</code></a>
[PR <a
href="https://redirect.github.com/aio-libs/aiohttp/issues/9835">#9835</a>/32ccfc9a
backport][3.10] Adjust client payload benchmarks to better...</li>
<li><a
href="https://github.com/aio-libs/aiohttp/commit/f3dd0f9fece79dc3cd9d00e2ffddd49c36598361"><code>f3dd0f9</code></a>
[PR <a
href="https://redirect.github.com/aio-libs/aiohttp/issues/9832">#9832</a>/006f4070
backport][3.10] Increase allowed import time for Python 3....</li>
<li><a
href="https://github.com/aio-libs/aiohttp/commit/f2aab2e40336848d6a53ea03dc6d072a38c5e7f9"><code>f2aab2e</code></a>
[PR <a
href="https://redirect.github.com/aio-libs/aiohttp/issues/9827">#9827</a>/14fcfd4c
backport][3.10] Adjust client GET read benchmarks to inclu...</li>
<li>Additional commits viewable in <a
href="https://github.com/aio-libs/aiohttp/compare/v3.10.6...v3.10.11">compare
view</a></li>
</ul>
</details>
<br />


[![Dependabot compatibility
score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=aiohttp&package-manager=pip&previous-version=3.10.6&new-version=3.10.11)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores)

Dependabot will resolve any conflicts with this PR as long as you don't
alter it yourself. You can also trigger a rebase manually by commenting
`@dependabot rebase`.

[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)

---

<details>
<summary>Dependabot commands and options</summary>
<br />

You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits
that have been made to it
- `@dependabot merge` will merge this PR after your CI passes on it
- `@dependabot squash and merge` will squash and merge this PR after
your CI passes on it
- `@dependabot cancel merge` will cancel a previously requested merge
and block automerging
- `@dependabot reopen` will reopen this PR if it is closed
- `@dependabot close` will close this PR and stop Dependabot recreating
it. You can achieve the same result by closing it manually
- `@dependabot show <dependency name> ignore conditions` will show all
of the ignore conditions of the specified dependency
- `@dependabot ignore this major version` will close this PR and stop
Dependabot creating any more for this major version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop
Dependabot creating any more for this minor version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop
Dependabot creating any more for this dependency (unless you reopen the
PR or upgrade to it yourself)
You can disable automated security fix PRs for this repo from the
[Security Alerts
page](https://github.com/langchain-ai/langgraph/network/alerts).

</details>

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-11-21 07:56:56 -08:00
dependabot[bot] 72dac006f4 build(deps): bump cross-spawn from 7.0.3 to 7.0.6 in /libs/cli/js-examples (#2456)
Bumps [cross-spawn](https://github.com/moxystudio/node-cross-spawn) from
7.0.3 to 7.0.6.
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/moxystudio/node-cross-spawn/blob/master/CHANGELOG.md">cross-spawn's
changelog</a>.</em></p>
<blockquote>
<h3><a
href="https://github.com/moxystudio/node-cross-spawn/compare/v7.0.5...v7.0.6">7.0.6</a>
(2024-11-18)</h3>
<h3>Bug Fixes</h3>
<ul>
<li>update cross-spawn version to 7.0.5 in package-lock.json (<a
href="https://github.com/moxystudio/node-cross-spawn/commit/f700743918d901eff92960e15a8dd68f87bd4176">f700743</a>)</li>
</ul>
<h3><a
href="https://github.com/moxystudio/node-cross-spawn/compare/v7.0.4...v7.0.5">7.0.5</a>
(2024-11-07)</h3>
<h3>Bug Fixes</h3>
<ul>
<li>fix escaping bug introduced by backtracking (<a
href="https://github.com/moxystudio/node-cross-spawn/commit/640d391fde65388548601d95abedccc12943374f">640d391</a>)</li>
</ul>
<h3><a
href="https://github.com/moxystudio/node-cross-spawn/compare/v7.0.3...v7.0.4">7.0.4</a>
(2024-11-07)</h3>
<h3>Bug Fixes</h3>
<ul>
<li>disable regexp backtracking (<a
href="https://redirect.github.com/moxystudio/node-cross-spawn/issues/160">#160</a>)
(<a
href="https://github.com/moxystudio/node-cross-spawn/commit/5ff3a07d9add449021d806e45c4168203aa833ff">5ff3a07</a>)</li>
</ul>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/moxystudio/node-cross-spawn/commit/77cd97f3ca7b62c904a63a698fc4a79bf41977d0"><code>77cd97f</code></a>
chore(release): 7.0.6</li>
<li><a
href="https://github.com/moxystudio/node-cross-spawn/commit/6717de49ff1e5de49622488dcb9c33fb25370c85"><code>6717de4</code></a>
chore: upgrade standard-version</li>
<li><a
href="https://github.com/moxystudio/node-cross-spawn/commit/f700743918d901eff92960e15a8dd68f87bd4176"><code>f700743</code></a>
fix: update cross-spawn version to 7.0.5 in package-lock.json</li>
<li><a
href="https://github.com/moxystudio/node-cross-spawn/commit/9a7e3b2165917367f74b8365faad9873b30d7263"><code>9a7e3b2</code></a>
chore: fix build status badge</li>
<li><a
href="https://github.com/moxystudio/node-cross-spawn/commit/085268352dcbcad8064c64c5efb25268b4023184"><code>0852683</code></a>
chore(release): 7.0.5</li>
<li><a
href="https://github.com/moxystudio/node-cross-spawn/commit/640d391fde65388548601d95abedccc12943374f"><code>640d391</code></a>
fix: fix escaping bug introduced by backtracking</li>
<li><a
href="https://github.com/moxystudio/node-cross-spawn/commit/bff0c87c8b627c4e6d04ec2449e733048bebb464"><code>bff0c87</code></a>
chore: remove codecov</li>
<li><a
href="https://github.com/moxystudio/node-cross-spawn/commit/a7c6abc6fee79641d45b452fe6217deaa1bd0973"><code>a7c6abc</code></a>
chore: replace travis with github workflows</li>
<li><a
href="https://github.com/moxystudio/node-cross-spawn/commit/9b9246e0969e86656d7ccd527716bc3c18842a19"><code>9b9246e</code></a>
chore(release): 7.0.4</li>
<li><a
href="https://github.com/moxystudio/node-cross-spawn/commit/5ff3a07d9add449021d806e45c4168203aa833ff"><code>5ff3a07</code></a>
fix: disable regexp backtracking (<a
href="https://redirect.github.com/moxystudio/node-cross-spawn/issues/160">#160</a>)</li>
<li>Additional commits viewable in <a
href="https://github.com/moxystudio/node-cross-spawn/compare/v7.0.3...v7.0.6">compare
view</a></li>
</ul>
</details>
<br />


[![Dependabot compatibility
score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=cross-spawn&package-manager=npm_and_yarn&previous-version=7.0.3&new-version=7.0.6)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores)

Dependabot will resolve any conflicts with this PR as long as you don't
alter it yourself. You can also trigger a rebase manually by commenting
`@dependabot rebase`.

[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)

---

<details>
<summary>Dependabot commands and options</summary>
<br />

You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits
that have been made to it
- `@dependabot merge` will merge this PR after your CI passes on it
- `@dependabot squash and merge` will squash and merge this PR after
your CI passes on it
- `@dependabot cancel merge` will cancel a previously requested merge
and block automerging
- `@dependabot reopen` will reopen this PR if it is closed
- `@dependabot close` will close this PR and stop Dependabot recreating
it. You can achieve the same result by closing it manually
- `@dependabot show <dependency name> ignore conditions` will show all
of the ignore conditions of the specified dependency
- `@dependabot ignore this major version` will close this PR and stop
Dependabot creating any more for this major version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop
Dependabot creating any more for this minor version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop
Dependabot creating any more for this dependency (unless you reopen the
PR or upgrade to it yourself)
You can disable automated security fix PRs for this repo from the
[Security Alerts
page](https://github.com/langchain-ai/langgraph/network/alerts).

</details>

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-11-21 07:56:33 -08:00
William FH 54d848913f [CLI] Update Inmem Version (#2500) 2024-11-21 15:49:59 +00:00
Nuno Campos 7021e81150 Merge pull request #2496 from langchain-ai/vb/fix-error-message
langgraph: fix error message on invalid update
2024-11-20 18:46:50 -08:00
vbarda b977045679 langgraph: fix error message on invalid update 2024-11-20 21:24:50 -05:00
William FH a933776436 [CLI] Validate node version (#2489) 2024-11-20 17:24:34 -08:00
Nuno Campos 588373c2d5 0.2.53 2024-11-20 17:13:42 -08:00
Nuno Campos 267962bece Merge pull request #2491 from langchain-ai/nc/20nov/stream-putnowait-loop
lib: For subgraphs / stream modes call stream.put as a callback in the original event loop
2024-11-20 17:11:56 -08:00
Nuno Campos 4ae29b6e2a Merge pull request #2492 from langchain-ai/wfh/accept_313
[CLI] Accept 3.13 in build
2024-11-20 17:04:15 -08:00
William Fu-Hinthorn 3c0de26914 Accept 3.13 in build 2024-11-20 16:26:17 -08:00
Nuno Campos a570662773 Lint 2024-11-20 15:43:46 -08:00
Nuno Campos 9766068896 lib: For subgraphs / stream modes call stream.put as a callback in the original event loop
- This is asynchronous, so we shouldn't use for regular writes to the output stream (ie those from PregelLoop)
- For writes from subgraphs / nodes this is fine to use, as we make no guarantees about when those show up anyway
2024-11-20 15:39:30 -08:00
Vadym Barda 7e8eef88ca docs: small fix for tutorial (#2487) 2024-11-20 14:36:42 -05:00
Eugene Yurtsev e3e63c70c9 docs: how-to guide language changes (#2462) 2024-11-19 14:54:08 -05:00
Brace Sproul 312f0982bc Merge pull request #2476 from langchain-ai/release
(sdk-js): Release 0.0.26
2024-11-19 11:38:11 -08:00
bracesproul 153245145e (sdk-js): Release 0.0.26 2024-11-19 11:32:22 -08:00
Brace Sproul c95abd88a1 Merge pull request #2117 from langchain-ai/brace/default-assign-api-key
fix(sdk-js): Pass api key in headers by default if in env
2024-11-19 11:26:01 -08:00
Brace Sproul a2b357bed5 Merge branch 'main' into brace/default-assign-api-key 2024-11-19 11:16:55 -08:00
Brace Sproul 7090d7e9a8 Merge pull request #2471 from langchain-ai/brace/drop-trailing-slash
fix(sdk-js): remove trailing slash from url
2024-11-19 09:31:59 -08:00
bracesproul b3fa43e4a6 fix(sdk-js): remove trailing slash from url 2024-11-19 09:23:47 -08:00
Vadym Barda b1779cf348 docs: update autogen docs (#2470) 2024-11-19 11:57:26 -05:00
Harrison Chase 26d18d3ca5 add how to guides for autogen integration (#2466) 2024-11-19 08:44:17 -08:00
William FHandHarrison Chase 12052d7d26 CLI docs (#2464)
Co-authored-by: Harrison Chase <hw.chase.17@gmail.com>
2024-11-19 10:57:07 -05:00
Vadym Barda e3a30a9b69 docs: fix prompt (#2467) 2024-11-19 09:42:20 -05:00
William FH ff1370a9a5 Release CLI (#2465) 2024-11-19 08:41:18 +00:00
William FH 679a7365da Add default ns in put_writes (#2404) 2024-11-18 22:55:12 -08:00
William FHandEugene Yurtsev b2522ffe19 CLI Dev command (#2463)
Co-authored-by: Eugene Yurtsev <eyurtsev@gmail.com>
2024-11-19 05:12:03 +00:00
Eugene Yurtsev 4212a795a0 docs[minor]: Fix layout issues in available templates (#2452) 2024-11-18 22:53:19 -05:00
Eugene Yurtsev 517d67aa32 docs: Update to use LANGSMITH_API_KEY throughout (#2461) 2024-11-18 22:51:36 -05:00
Brace Sproul feaf14765a Merge pull request #2458 from langchain-ai/brace/expose-command-interface
fix(sdk-js): Expose Command interface
2024-11-18 18:54:19 -08:00
Vadym Barda cc6063c729 docs: simplify multi-agent tutorials (#2443) 2024-11-19 02:31:12 +00:00
Ian SullivanandIan Sullivan 013397042e docs: grammar (#2449)
Co-authored-by: Ian Sullivan <ian@frame.ai>
2024-11-18 21:01:37 -05:00
Nuno Campos 9a775d9c9f 0.2.52 2024-11-18 17:17:40 -08:00
Nuno Campos 2c945ceb68 Copy configurable in ensure_config 2024-11-18 17:17:20 -08:00
Erick Friis 39eabd0fb8 Merge pull request #2459 from langchain-ai/erick/docs-self-hosted-plan-links
docs: self-hosted plan links
2024-11-18 16:42:02 -08:00
Erick Friis e5cc2e2044 docs: self-hosted plan links 2024-11-18 16:35:19 -08:00
bracesproul f00c0515e7 add jsdoc 2024-11-18 16:32:32 -08:00
bracesproul d87c0d4d53 fix(sdk-js): Expose Command interface 2024-11-18 16:25:51 -08:00
Nuno Campos fb40a974c8 0.2.51 2024-11-18 16:03:04 -08:00
Nuno Campos d63bfc6879 Add missing property 2024-11-18 16:02:54 -08:00
Nuno Campos 97dd30711a Merge pull request #2437 from langchain-ai/nc/16nov/speed-up-find-subgraph
lib: find_subgraph doesn't need to look in both func and afunc
2024-11-18 15:59:58 -08:00
Vadym Barda 016a9c1936 checkpoint-postgres: release 2.0.3 (#2455) 2024-11-18 16:55:54 -05:00
Nuno Campos a2d6837fba Merge pull request #2413 from langchain-ai/vb/fix-pipeline
checkpoint-postgres: handle cases when conn.pipeline is not supported
2024-11-18 10:39:56 -08:00
Andrew Nguonly f5bb2a3b04 docs: Update LangGraph Server API docs (#2451) 2024-11-18 09:38:38 -08:00
vbarda f807b73092 use capabilities 2024-11-18 12:15:18 -05:00
Nuno Campos 167405daf2 Merge pull request #2434 from langchain-ai/nc/15nov/update-state-copy-parent
lib: When copying checkpoint, make it a child of the parent
2024-11-18 08:34:34 -08:00
William FH c6360e5408 [Checkpoint] 2.0.5 (#2450) 2024-11-18 08:19:17 -08:00
vbarda f0505155a2 cache 2024-11-18 11:12:21 -05:00
Nuno CamposandWilliam Fu-Hinthorn 886df0fa86 checkpoint: Add option to use persistent dict for in-memory checkpointer (#2439)
- This should only be used in very specific circunstances, sqlite or
postgres adapters much more appropriate in most circunstances

---------

Co-authored-by: William Fu-Hinthorn <13333726+hinthornw@users.noreply.github.com>
2024-11-18 16:04:05 +00:00
Kevin Markham 3f1792d6ba docs: fix typo (#2406) 2024-11-18 09:11:57 -05:00
Zapiron 9208052a94 docs: Update link to LCEL Concept Guide (#2438)
Updated the link to the LCEL concept guide
2024-11-18 09:09:12 -05:00
Nuno Campos 7866bd2718 lib: find_subgraph doesn't need to look in both func and afunc
- if they both exist they're expected to share the same implementation, so looking in both is redundant
2024-11-16 16:57:32 -08:00
Nuno Campos 7c11325e23 Separate 2024-11-15 17:33:01 -08:00
Nuno Campos d99dc7d81b Fix missing writes 2024-11-15 17:23:00 -08:00
Nuno Campos 973ad76a58 Fix 2024-11-15 17:05:18 -08:00
Nuno Campos 36e49eb190 Add distinct source 2024-11-15 17:04:40 -08:00
Nuno Campos 66b9a7dee7 lib: When copying checkpoint, make it a child of the parent 2024-11-15 16:56:17 -08:00
Nuno Campos 5494855ffa 0.2.50 2024-11-15 15:43:37 -08:00
Nuno Campos 38d93a324c 0.2.49 2024-11-15 15:02:31 -08:00
Nuno Campos 07c65321c1 Merge pull request #2432 from langchain-ai/nc/15nov/copy-checkpoint
lib: Restore prev behavior for update_state(None)
2024-11-15 15:00:18 -08:00
Nuno Campos 1dbdd7df2e Lint 2024-11-15 14:54:55 -08:00
Nuno Campos dab29ce094 lib: Restore prev behavior for update_state(None)
- update_state(None) copies checkpoint and keeps current (PUSH) tasks, eg for replay
- update_state(None, as_node=END) clears all tasks (PUSH or PULL)
2024-11-15 14:48:56 -08:00
Vadym Barda 0388534b9f docs: update double texting how-tos (#2431) 2024-11-15 22:45:36 +00:00
Nuno Campos 81077e7c3a Merge pull request #2429 from langchain-ai/nc/15nov/sdk-js-types
sdk-js: Update types for state.task
2024-11-15 11:54:59 -08:00
Nuno Campos 29a0042149 sdk-js: Update types for state.task 2024-11-15 11:54:00 -08:00
William FH e9162e2516 Update CLI pyproject.toml (#2428) 2024-11-15 11:00:32 -08:00
Vadym Barda 0f6c001c25 docs: update replay in persistence concepts (#2427) 2024-11-15 18:49:20 +00:00
Eugene Yurtsev 7f26325c87 cli: minor wording change in new command (#2422) 2024-11-15 03:13:53 +00:00
Nuno Campos 3c4ce3f945 Merge pull request #2420 from langchain-ai/nc/14nov/js-sdk-command
Nc/14nov/js sdk command
2024-11-14 18:21:38 -08:00
Nuno Campos 84ef939bf4 sdk-js 0.0.24 2024-11-14 18:17:22 -08:00
Nuno Campos bdc22ea127 sdk-js: Accept command when creating run 2024-11-14 18:17:04 -08:00
Vadym Barda 5abbb79e1b Merge branch 'main' into vb/fix-pipeline 2024-11-14 19:08:18 -05:00
vbarda 0a5220aa07 code review 2024-11-14 19:06:41 -05:00
Nuno Campos 970e68edcc Merge pull request #2417 from langchain-ai/vb/fix-debug-async
langgraph: add debug to AsyncPregelLoop
2024-11-14 06:53:18 -08:00
vbarda da1a80e86d lint 2024-11-14 09:37:39 -05:00
vbarda c4b240e0c2 langgraph: add debug to AsyncPregelLoop 2024-11-14 09:36:33 -05:00
vbarda c2052d11c2 checkpoint-postgres: remove pipeline flag in cursor 2024-11-13 21:42:51 -05:00
Vadym Barda dc0281b99c docs: update rollback in double-texting concepts (#2412) 2024-11-13 21:21:12 -05:00
Nuno Campos 3a860ad537 0.2.48 2024-11-13 17:45:04 -08:00
Nuno Campos 7051bccc30 checkpoint 2.0.4 2024-11-13 17:37:01 -08:00
Nuno Campos 199e41b228 sdk py 0.1.36 2024-11-13 17:07:07 -08:00
Nuno Campos 229a9e19a8 sdk-py: Add command arg for creating runs 2024-11-13 17:06:56 -08:00
Nuno Campos 3c3a1a1f35 0.2.47 2024-11-13 14:02:25 -08:00
Nuno Campos f11127648e Merge pull request #2346 from langchain-ai/nc/4nov/send-eager
lib: Execute Sends in the superstep that originated them (feature-flagged)
2024-11-13 13:39:50 -08:00
Nuno Campos 29f833b1a7 Merge pull request #2393 from langchain-ai/nc/11nov/command-resume
lib: Add interrupt() function
2024-11-13 13:34:19 -08:00
Nuno Campos 7a3ea42743 Merge pull request #2410 from langchain-ai/nc/13nov/command-dataclass
Nc/13nov/command dataclass
2024-11-13 13:28:13 -08:00
Nuno Campos a94902db8a Lint 2024-11-13 13:17:02 -08:00
Nuno Campos 9fd152ef3a format 2024-11-13 13:14:03 -08:00
Nuno Campos 03bc9ba6e6 Make Command a dataclass 2024-11-13 13:11:28 -08:00
Nuno Campos 7fe6f88876 Add resumeable/ns properties to Interrupt 2024-11-13 12:51:55 -08:00
Nuno Campos 1d88affd29 Merge pull request #2400 from langchain-ai/nc/12nov/command
Make Command accept generic arg for destinations
2024-11-13 10:03:27 -08:00
Eugene Yurtsev 6906e12edb cli: add ability to output docker compose file (#2379)
* Add ability to output docker compose file `langgraph dockerfile
Dockerfile --add-docker-compose`
* Add emoji in places
2024-11-13 12:42:58 -05:00
William FH 7b4c29a20d [Checkpointers] MemorySaver: refrain from overwriting writes (#2399) 2024-11-13 00:20:38 +00:00
Nuno Campos 16bfa80b58 Make Command accept generic arg for destinations 2024-11-12 16:18:23 -08:00
Eugene Yurtsev cb10437c3f cli: Add default to interactive flow in new command (#2398) 2024-11-12 16:38:15 -05:00
Eugene Yurtsev 2bcf1c0a20 cli[minor]: Add langgraph new command (#2369)
Adds a "new" command to create langgraph application from a template.
2024-11-12 14:30:51 -05:00
Nuno Campos 00964b18f6 Undo 2024-11-11 18:12:25 -08:00
Nuno Campos 0d5c6201d3 Disable in py 3.10 or below for async 2024-11-11 18:09:58 -08:00
Nuno Campos 86d2847dab Use neg idx 2024-11-11 17:57:45 -08:00
Nuno Campos b3a4eaa967 Remove print 2024-11-11 17:56:10 -08:00
Nuno Campos 87fc519ce7 Remove print 2024-11-11 17:54:56 -08:00
Nuno Campos ef3a1ee997 Undo 2024-11-11 17:54:04 -08:00
Nuno Campos 311e16dffd Remove prints 2024-11-11 17:52:18 -08:00
Nuno Campos c83b8f6d04 Update 2024-11-11 17:49:58 -08:00
Nuno Campos 62d3a85b07 Add sync test 2024-11-11 17:46:54 -08:00
Nuno Campos 810ae0ef51 lib: Add interrupt() function
- This works similarly to the input() function from stdlib
- calling it in a node interrupts execution
- invoking the graph with Command(resume=...) will set ... as the return value of interrupt() so that the node can access the "answer" to the "question"
- This PR also starts the work to control the graph on invoke/stream with Command() input, to be continued in a future PR
2024-11-11 17:44:03 -08:00
Nuno Campos 2ff49d2200 Update 2024-11-11 15:43:20 -08:00
Nuno Campos d0567dc7be Add feature flag (default off) so we can merge this before releasing
- Add additional ci job to test with FF on
2024-11-11 15:38:48 -08:00
Nuno Campos ea64ac5c07 Update 2024-11-11 14:18:14 -08:00
Nuno Campos 090b53ccc1 Lint 2024-11-11 14:14:23 -08:00
Nuno Campos 0e872e7482 Lin t 2024-11-11 14:12:33 -08:00
Nuno Campos 3ad966e057 Update 2024-11-11 14:08:59 -08:00
Nuno Campos a73f9affab Merge pull request #2391 from langchain-ai/nc/11nov/control-to-command
lib: Rename Control to GraphCommand
2024-11-11 14:06:17 -08:00
Nuno Campos 89a0859928 Execute Sends in same super step that triggered them
- Keep old code path for compatibility with existing checkpoints
- Keep a similar order of application of updates, in some cases there will be no visible change
- Update task path for Sends to contain the path of all the parent tasks (multiple parents when a Send task creates another Send)
- That lineage path is used to ensure order of application of updates respects their logical lineage (ie updates from parents always applied before their child tasks)
- Move Interrupt writes to use negative indexes, which allow replacing/shadowing (when task is re-run it may interrupt again, or succeed)
- Runner will now attempt to schedule new Send tasks as soon as the write is received (ie while the originating node is still running)
- Update kafka scheduler to support new Send behavior
2024-11-11 14:01:16 -08:00
Nuno Campos 75c502cd93 Lint 2024-11-11 13:59:18 -08:00
Nuno Campos 0cc45f7a35 Lint 2024-11-11 13:04:23 -08:00
Nuno Campos efb1dd6a10 lib: Rename Control to GraphCommand 2024-11-11 13:01:04 -08:00
Nuno Campos 6edb213fe7 Merge pull request #2388 from langchain-ai/nc/11nov/update-none-clear-all-tasks
lib: update_state(values=None) should clear all tasks
2024-11-11 12:07:51 -08:00
Nuno Campos c0513076a2 Lint 2024-11-11 11:07:36 -08:00
Nuno Campos c043f148a6 lib: update_state(values=None) should clear all tasks 2024-11-11 10:48:34 -08:00
David Duong 366b5e04c7 Merge pull request #2376 from langchain-ai/dqbd/js-0.0.23-lc_build
fix(sdk-js): move to `@langchain/scripts` for building, bump to 0.0.23
2024-11-11 15:33:53 +01:00
Tat Dat Duong 72239d2228 Bump to 0.0.23, use @langchain/scripts 0.1.4 2024-11-11 15:01:12 +01:00
Vadym Barda b7f238975a docs: fix nav sidebar (#2382) 2024-11-10 16:32:14 -05:00
Tat Dat Duong a3c45141ee Make sure we actually build the CJS 2024-11-08 20:52:44 +01:00
Tat Dat Duong f7b899a54d fix(sdk-js): move to @langchain/scripts for building 2024-11-08 20:08:38 +01:00
Vadym Barda 95477277a2 docs: improve breadcrumbs behavior (#2375) 2024-11-08 18:39:59 +00:00
Andrew Nguonly 64b446f671 Update LangGraph server API docs (#2374) 2024-11-08 10:32:17 -08:00
David Duong c2d2e44794 Merge pull request #2372 from langchain-ai/dqbd/0.0.22-sdk-js
feat(sdk-js): bump to 0.0.22
2024-11-08 16:17:45 +01:00
Eugene Yurtsev f60b9f3b43 cli: add --version option (#2373)
- add version option
- add unit test
2024-11-08 02:49:30 +00:00
Tat Dat Duong e3acfa3435 feat(sdk-js): bump to 0.0.22 2024-11-08 03:19:27 +01:00
Vadym Barda 0f92c89529 docs: show nav menu for mobile (#2371) 2024-11-07 20:31:49 -05:00
Andrew Nguonly 7cba75ec35 sdk-js: Add custom and messages-tuple stream modes (#2370) 2024-11-07 16:32:08 -08:00
Vadym Barda 8408ba3a3e docs: add breadcrumbs (#2363) 2024-11-07 21:33:55 +00:00
Nuno Campos c8c58b30d5 Merge pull request #2368 from langchain-ai/nc/7nov/control
lib: Rename args in Control object
2024-11-07 13:19:12 -08:00
Nuno Campos b4bed3329c lib: Rename args in Control object
- update_state -> state
- trigger -> goto
2024-11-07 13:12:19 -08:00
Eugene Yurtsev 4eec3aa69e docs: fix some typos (#2364) 2024-11-07 14:52:47 -05:00
Vadym Barda 35e3276e34 langgraph: add add_sequence to StateGraph (#2352) 2024-11-07 13:16:34 -05:00
Nuno Campos b346f4ead8 Merge pull request #2358 from langchain-ai/nc/6nov/kafka-missing-task-id
kafka: Add missing task id for TaskNotFound error
2024-11-06 16:48:25 -08:00
Vadym Barda fef748e6cc docs: add another ignore url pattern to link check (#2357) 2024-11-07 00:43:22 +00:00
Nuno Campos 19cc95f7b6 kafka: Add missing task id for TaskNotFound error 2024-11-06 16:41:43 -08:00
Vadym Barda eef65d94ac docs: fix numbered list in assistant versioning (#2356) 2024-11-06 22:17:01 +00:00
Nuno Campos 72d497e052 Move code 2024-11-06 09:02:06 -08:00
Nuno Campos 32f58258aa Merge pull request #2355 from langchain-ai/nc/6nov/loop-match-writes
lib: Split out _match_writes util in PregelLoop
2024-11-06 08:55:10 -08:00
Nuno Campos 87d57b434a lib: Split out _match_writes util in PregelLoop 2024-11-06 08:48:30 -08:00
Nuno Campos 4bbbb7d246 Merge pull request #2354 from langchain-ai/nc/6nov/cached-tasks-output-timing
lib: For cached tasks, emit output events after task events
2024-11-06 08:29:38 -08:00
Nuno Campos c1ce3c6b5f lib: For cached tasks, emit output events after task events 2024-11-06 08:22:54 -08:00
Nuno Campos 511de6f5f6 Merge pull request #2353 from langchain-ai/dqbd/runnable-passthrough-test
fix(graph): invalid graph representation if RunnablePassthrough is used
2024-11-06 08:14:19 -08:00
Nuno Campos 4dc08cd724 Fix 2024-11-06 08:07:48 -08:00
Tat Dat Duong d7b9b3b01d fix(graph): invalid graph representation if RunnablePassthrough is used 2024-11-06 16:34:29 +01:00
Vadym Barda a82ded65c6 docs: fix install/env cell for customer support tutorial (#2350) 2024-11-05 19:50:05 -05:00
Brace Sproul 1ca49fa568 Merge pull request #2348 from langchain-ai/brace/filter-status-js
feat(js-sdk): Add status field in search args
2024-11-05 16:40:23 -08:00
bracesproul 4eb3cd32fa cr 2024-11-05 16:04:52 -08:00
Brace Sproul 80d2a315aa Merge branch 'main' into brace/filter-status-js 2024-11-05 16:03:58 -08:00
bracesproul 82c9aa8485 feat(js-sdk): Add status field in search args 2024-11-05 16:03:24 -08:00
Nuno Campos 8ecfafefbf Merge pull request #2347 from langchain-ai/nc/5nov/control-serializable
lib: Make Control object serializable
2024-11-05 15:34:13 -08:00
Nuno Campos 010564cbb3 lib: Make Control object serializable 2024-11-05 15:24:20 -08:00
Nuno Campos 18a3fa4a00 Ignore unknown tasks 2024-11-05 14:22:23 -08:00
Nuno Campos de8e487ff1 Add todo 2024-11-05 10:53:42 -08:00
Nuno Campos e5ebdff4d8 Merge pull request #2342 from langchain-ai/nc/5nov/send-test-interrupt-before
Add two more test cases for Send + interrupt
2024-11-05 09:34:04 -08:00
Nuno Campos f283dac325 Add one more test for send-react-interrupt flow with replacing tool call 2024-11-05 09:27:02 -08:00
Nuno Campos 639501809c api: Add one more test case for send + interrupt before
- Testing same exact behavior as send + interrupt after
2024-11-05 09:15:46 -08:00
Nuno Campos 36e6b89081 Merge pull request #2333 from langchain-ai/nc/apply-writes-order
lib: Enforce write application order in apply_writes
2024-11-05 09:07:23 -08:00
Nuno Campos 90639e6cd7 Merge pull request #2332 from langchain-ai/nc/4nov/update-state-latest
lib: When updating state from latest, apply pending writes first
2024-11-04 16:59:51 -08:00
Nuno Campos dec0b7f439 Lint 2024-11-04 16:43:07 -08:00
Nuno Campos 04657408f8 lib: Enforce write application order in apply_writes
- Previously order was enforced in prepare_next_tasks, but that's not a good fit for future features
- This changes order between PULL and PUSH tasks, updates from PUSH tasks will now be applied after updates from PULL tasks
2024-11-04 16:39:04 -08:00
Nuno Campos 971d746061 Lint 2024-11-04 16:33:20 -08:00
Nuno Campos 9a2ba8c8cd lib: When updating state from latest, apply pending writes first
- This picks a default value for as_node which matches the node which last acted, even if the step didnt finish (due to an interrupt)
2024-11-04 16:20:21 -08:00
Nuno Campos b50d41bbf3 Merge pull request #2331 from langchain-ai/nc/4nov/get-state-latest-next
lib: When getting latest state, alst make `next` reflect pending writes
2024-11-04 16:16:53 -08:00
Nuno Campos b71fd5092b lib: When getting latest state, alst make next reflect pending writes
- ie. tasks already executed should not show up in `next` list
2024-11-04 16:03:34 -08:00
Nuno Campos f9b151b67f Merge pull request #2330 from langchain-ai/nc/4nov/test-react-send
lib: Add test for react architecture using Send + interrupt_before
2024-11-04 15:58:27 -08:00
William FH 7ba9a66301 [Docs] Clarify checkpointer options (#2328) 2024-11-04 15:43:00 -08:00
Nuno Campos 1b85764bf6 Merge pull request #2329 from langchain-ai/nc/4nov/get-state-apply-pending-writes
lib: In calls to get_state apply pending writes
2024-11-04 15:42:23 -08:00
Nuno Campos 5e4c928948 Merge pull request #2327 from langchain-ai/nc/4nov/send-tests
lib: Add two more tests for Send
2024-11-04 15:42:08 -08:00
Nuno Campos ae282e3ae1 lib: Add test for react architecture using Send + interrupt_before
- Both for cond edge and edgeless graphs
2024-11-04 15:41:02 -08:00
Nuno Campos de3b654735 Add one more assertion 2024-11-04 15:14:29 -08:00
Nuno Campos d28734f287 Lint 2024-11-04 15:12:34 -08:00
Nuno Campos f9409022ed lib: In calls to get_state apply pending writes
- When calling get_state without a checkpoint id (ie to get the latest state) apply any pending writes for current checkpoint
2024-11-04 15:10:12 -08:00
Nuno Campos 8138c88b41 Add async versions 2024-11-04 11:56:31 -08:00
Nuno Campos 38332fd3c6 Lint 2024-11-04 11:55:14 -08:00
Nuno Campos 5606bef3dd lib: Add two more tests for Send 2024-11-04 11:52:39 -08:00
Vadym Barda 895079bbdc langgraph: release 0.2.45 (#2326) 2024-11-04 14:34:07 -05:00
Nuno Campos 6aaf80f2fd Merge pull request #2325 from langchain-ai/nc/4nov/unset-skip-done-tasks
lib: Unset skip_done_tasks after each tick of the loop
2024-11-04 11:30:08 -08:00
Vadym Barda 2e656d9145 langgraph: add config metadata to pregel loop (#2323) 2024-11-04 19:26:34 +00:00
Nuno Campos 1fb8e013f7 Merge pull request #2303 from langchain-ai/nc/1nov/test-send-order
Test order of update application after Send
2024-11-04 11:26:04 -08:00
Nuno Campos f8fe2041d9 Merge pull request #2144 from langchain-ai/nc/19oct/graph-control
lib: Add support for graphs without edges
2024-11-04 11:25:40 -08:00
Nuno Campos 014f8485a6 lib: Unset skip_done_tasks after each tick of the loop 2024-11-04 11:23:53 -08:00
Nuno Campos 1e3953d1e0 Test order of update application after Send
- updates from inside Send tasks are applied in the order the Sends were created, if when you fan out, and have each task write results to a list with reducer, the final list is in the order you used when triggering
2024-11-01 13:23:10 -07:00
Nuno Campos 18e71469e1 Lint 2024-10-31 12:57:00 -07:00
Nuno Campos 2624fc43dd Fix 2024-10-31 09:40:24 -07:00
Nuno Campos 0c5c2e6370 lib: Add support for graphs without edges
- Return Control(update_state=, trigger=, send=) from your nodes instead
- Annotate nodes with Control[Literal["destination"]] to see your graph connections drawn
2024-10-31 09:38:43 -07:00
bracesproul 433c382280 cr 2024-10-15 11:37:20 -07:00
bracesproul 7352ab14a2 cr 2024-10-15 11:36:37 -07:00
bracesproul 85a76912d3 fix(sdk-js): Pass api key in headers by default if in env 2024-10-15 11:33:40 -07:00
186 changed files with 20682 additions and 7131 deletions

No files matched your search

+1 -2
View File
@@ -22,8 +22,7 @@ def test(
# check docker available
capabilities = langgraph_cli.docker.check_capabilities(runner)
# open config
with open(config) as f:
config_json = langgraph_cli.config.validate_config(json.load(f))
config_json = langgraph_cli.config.validate_config_file(config)
set("Running...")
args = [
+8 -1
View File
@@ -19,14 +19,19 @@ jobs:
- "3.13"
core-version:
- "latest"
ff-send-v2:
- "false"
include:
- python-version: "3.11"
core-version: ">=0.2.42,<0.3.0"
- python-version: "3.11"
core-version: "latest"
ff-send-v2: "true"
defaults:
run:
working-directory: libs/langgraph
name: "test #${{ matrix.python-version }} (langchain-core: ${{ matrix.core-version }})"
name: "test #${{ matrix.python-version }} (langchain-core: ${{ matrix.core-version }}, ff-send-v2: ${{ matrix.ff-send-v2 }})"
steps:
- uses: actions/checkout@v4
- name: Set up Python ${{ matrix.python-version }} + Poetry ${{ env.POETRY_VERSION }}
@@ -52,6 +57,8 @@ jobs:
- name: Run tests
shell: bash
env:
LANGGRAPH_FF_SEND_V2: ${{ matrix.ff-send-v2 }}
run: |
make test
+14 -3
View File
@@ -44,6 +44,8 @@ jobs:
deploy:
# needs: run-changed-notebooks
runs-on: ubuntu-latest
env:
GITHUB_TOKEN: ${{ secrets.MKDOCS_GITHUB_TOKEN }}
steps:
- uses: actions/checkout@v4
with:
@@ -58,8 +60,14 @@ jobs:
- name: Install dependencies
run: |
poetry install --with test
poetry run pip install -U pytest pytest-check-links langsmith langchain GitPython
poetry install --with test --no-root
poetry run pip install -U \
pytest \
pytest-check-links \
langsmith \
langchain \
GitPython \
"git+https://${GITHUB_TOKEN}@github.com/langchain-ai/mkdocs-material-insiders.git"
- name: Lint Docs
# This step lints the docs using the existing linting set up.
@@ -80,9 +88,11 @@ jobs:
--check-links-ignore "https://(api|web|docs)\.smith\.langchain\.com/.*" \
--check-links-ignore "https://x.com/.*" \
--check-links-ignore "https://github\.com/.*" \
--check-links-ignore "http://localhost:8123/.*" \
--check-links-ignore "/.*\.(ipynb|html)$" \
--check-links-ignore "https://python\.langchain\.com/.*" \
--check-links-ignore "https://openai.com/index/memory-and-new-controls-for-chatgpt/" \
--check-links-ignore "https://openai\.com/.*" \
--check-links-ignore "https://pepy\.tech/.*" \
--check-links $(find docs/site -name "index.html" | grep -v 'storm/index.html')
else
@@ -95,6 +105,7 @@ jobs:
echo "Running link check on HTML files matching changed notebook files..."
poetry run pytest -v \
--check-links-ignore "https://(api|web|docs)\.smith\.langchain\.com/.*" \
--check-links-ignore "http://localhost:8123/.*" \
--check-links-ignore "https://x.com/.*" \
--check-links-ignore "https://github\.com/.*" \
--check-links-ignore "/.*\.(ipynb|html)$" \
+1 -1
View File
@@ -49,7 +49,7 @@ gain understanding of concepts and how they interact by showing one way to achie
They should **avoid** giving
multiple permutations of ways to achieve that goal in-depth. Choice is burdensome. Instead, they should guide a new user through a recommended path to accomplishing a concrete goal. While the end result of a tutorial does not necessarily need to
be completely production-ready, it should be useful and practically satisfy the the goal that you clearly stated in the tutorial's introduction.
be completely production-ready, it should be useful and practically satisfy the goal that you clearly stated in the tutorial's introduction.
To quote the Diataxis website:
+1 -1
View File
@@ -13,7 +13,7 @@ serve-clean-docs: clean-docs
poetry run python -m mkdocs serve -c -f docs/mkdocs.yml --strict -w ./libs/langgraph
serve-docs: build-typedoc
poetry run python -m mkdocs serve -f docs/mkdocs.yml -w ./libs/langgraph --dirty
poetry run python -m mkdocs serve -f docs/mkdocs.yml -w ./libs/langgraph -w ./libs/checkpoint --dirty
clean-docs:
find ./docs/docs -name "*.ipynb" -type f -delete
+1 -1
View File
@@ -238,7 +238,7 @@ final_state["messages"][-1].content
* [How-to Guides](https://langchain-ai.github.io/langgraph/how-tos/): Accomplish specific things within LangGraph, from streaming, to adding memory & persistence, to common design patterns (branching, subgraphs, etc.), these are the place to go if you want to copy and run a specific code snippet.
* [Conceptual Guides](https://langchain-ai.github.io/langgraph/concepts/high_level/): In-depth explanations of the key concepts and principles behind LangGraph, such as nodes, edges, state and more.
* [API Reference](https://langchain-ai.github.io/langgraph/reference/graphs/): Review important classes and methods, simple examples of how to use the graph and checkpointing APIs, higher-level prebuilt components and more.
* [Cloud (beta)](https://langchain-ai.github.io/langgraph/cloud/): With one click, deploy LangGraph applications to LangGraph Cloud.
* [LangGraph Platform](https://langchain-ai.github.io/langgraph/concepts/#langgraph-platform): LangGraph Platform is a commercial solution for deploying agentic applications in production, built on the open-source LangGraph framework.
## Contributing
+2 -1
View File
@@ -36,10 +36,11 @@ NOTEBOOKS_NO_EXECUTION = [
"docs/docs/tutorials/rag/langgraph_self_rag_local.ipynb",
# this loads a massive dataset from gcp
"docs/docs/tutorials/usaco/usaco.ipynb",
# TODO: figure out why autogen notebook is not runnable (they are just hanging. possible due to code execution?)
"docs/docs/how-tos/autogen-integration.ipynb",
# TODO: need to update these notebooks to make sure they are runnable in CI
"docs/docs/tutorials/storm/storm.ipynb", # issues only when running with VCR
"docs/docs/tutorials/lats/lats.ipynb", # issues only when running with VCR
"docs/docs/tutorials/multi_agent/hierarchical_agent_teams.ipynb", # taking a very long time to run
"docs/docs/tutorials/rag/langgraph_crag.ipynb", # flakiness from tavily
"docs/docs/tutorials/rag/langgraph_adaptive_rag.ipynb", # Cannot create a consistent method resolution error from VCR
"docs/docs/how-tos/map-reduce.ipynb" # flakiness from structured output, only when running with VCR
@@ -1 +1 @@
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 truncated
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 truncated
@@ -1 +1 @@
eNrtWgl4E8UepwfQpyAgFZCjLJGbbprNndZSSik96H3fZbOZNNtudsPuJj2gKAUEsRxBBKSoUHrYQgGlghwFyyEKAsolFR6ggihXFRCUq282SaEFfOh79XvPT/J9aXZn/vO/5z+/mU5RpQWwHMnQTqtImgcsTvDwhVtQVMmCCWbA8dMqjIA3MLqyqMjYuBVmlmwYbuB5E+ft5YWbSDFjAjROignG6GXBvAgDznvBZxMFbGzKtIwu/yuXAxNFRsBxeBbgRN5I6kQRwUBZNA9fRMmMGcFZgOAIZzYB1kJyDIvwOJcDdEguyRsQI07jWSSdBSngMEFbXOCNaAGfCwCN8AaA6BmKYnIFolyGzYEk3ggSAziAs4QBsJ5IAKMDrBgJIi0PDTBzgEUctnrCB87E0A7JAqGdH8IzCPQMQoM8XowE4oShuSOXpCgE6q1nWCPUUFAcwSGDBxmRghDOTPGcrZvjcd7MiZFEA1RIT9IkZwC6B8SPDYkIiQ0WizwREctQQHAWl8/xwCgq9ERa+VAwDzEAaJKgFqWziTCxMKAIyQu6C5bA4BpJGqda8hOMf4jbfS+18jeuZSzAE8k1MAhnYMyCFIdH/JBItrktFzj09kNiAQUgBUMDhNHDsA+xdwzxRIbcj43wZovOkPRHGZoO24ywmxIas0w8KmcEMhq+YvDXhLM4RQEqk2cYKpOAz0KC6XGKg5qKOJ4FuLFFA2QJQwU9zwpCJGKV0GYbaWBIQmibKOLzTTYN9GbaNhUEcfeeBQIaN9oIWMbMgxhbwDggKix08HJk+H/IBlLpAEewpMlBKBI5zISzEIbCNtTEwlnH8iSwvwohsD0A2ixYmyqyO1oYed/RwpvN0SLBp83qQRfBSWDXXpgEJAt0NhY2pi0pGW02jCakLEwvrDQAHHLi5pYZGI63rm5dCNbgBAFgqABNMDrI3VqTVUCaPBEd0FM4D6phVtHA5ghrdQ4AJhSnYMZV2EdZ1+ImE0UStpzzyuYYepUjNVFBk4e7q4UcRmFpoXlrbSRUwj/EKyofViwawcRytViyNg+Fs42kKViBUAqH+lSYbP2bW3aYcCIHMkEd1dBaYR+8uiUNw1nLw3EiMrYVS8G91nKcNSrl61q2s2aaJ43AWhkQ9bA4R+d9cTIxhok177VizOXThLXclrwbWg0GPJuPEgzkYV0uWd3sHwrQWbzBukKjUrzLOhJqaoW90hSVwViAzz6pdNTh0shxzUE82a5H2RgYF2tdnMHsiUiVcOKaEKlEKkcwhbdE7q3AkKDwuFUBDjFxjwzDe3EsTnN6GIrA5rBXEgYzDct4dcAjA14nBBxaI6gPpz0K8kwMB1CHVtZVSWiMvSqjIWPW2bMLZdgsnCYLbGKtVUIw4YpD0rWObjgxBJZQOGrkrCswlXK1o6fZz9XQLgmKSVAJtlHIfQKmlaC4iWF5lAMEXN/4fGuDpxHPE3LKV4YpZEqJROKDkDRBmXUg1qwdwxihTM4HVlhAMbhuUx4KawqgSCMJg2D761hPYL5gcLDkw4cpeCYH0Jz1XZnE/tnakoQFggTBjHuMyjTws+XRRM28pAKNWqnc1JqMAy0UWqE0ch8+3O9gUSrhVuU1E6OkztowEL5kqvQSQq+Ua3C9FNOrgRZTYWqtnpACuV4jU6r0awLGogFwUQRorC3brJVjkiP8w0MCqmMh7wCGySHB/K+cXDIzCX2m1ugbF6SgyaRQRRTICwsw5honKGIKgrhELjFfmm1OYJLHJWZxSUTUmNGBahRTSVUypUyiwVBMLBFjYgwdh4dOUEl5LjkfROpMbIrORIlT8goi1BYiiAozB4/OTgT5KeF6fV6CJI4AwSGxlviCxEBjJJWbnJXL5OK0PHdcqErOFujDLePGxJNUbHx0Fownzht8vXwQmImwDnK+jvmAwvmA2meDrHk2+CA6Wxb4ilvXPh8kGIKjSJrK94HTCKYTgL+wdseSPPCNgEthwwLoA7OF1Pmywf456sSEqGgpFoprU0BOXmaev0ER7o9Joyh1kg4kkqGyPIrMzo9u4QSFRIVKHH5QSuRqW/LcV/0/1Gp9EtpyeqORtuUHxpFmOJrU6ytiITIDrLWaoBizDpZxFlTAmMf4J1tr1YRGLlViKjkuVWBqQoIGJsasbeZ2rxiUCWuADQ5OqbAvOrucdvZ/za2d7eMCv01NfEw6UyJxLzyXmHRDEzZpuueWQW/FfRBdnh1bS4+bnvZh1w0fW4yHugX+2th9nvNsbw/PCx77Z8wt5N2cFgaMRo7HlsTP2rzy570V/5ic7rVhX3a/9Ds1R2+FX719vfeYG/WRiz/o9Ou14jcLswo/1ZWrUwYHdsnqXbUr4Uim62uSZ+rKTzm98Zl1Q21Msmo+fbq99cK+dL8Xu9+YDwzIgJf6jnbTWHL6RJ85Nmr0loZbZaMJw6vzOvl1c065YnE+3Evv+VwP/QuLQ/Do2qrAfb+6ro25Il+xdO7Hd3KXXtz99tBzP6RenVji9eP11XcnZNIJqhnGvkFrTnkMnlx3zd88ZVaKLsCv+6TFQ3rqp728LH73kffX/9Jv9vztp6e3GzDKnJw4lOrjMcen67Fj/Qb6fDhfc77f0tMu356ZtP6lpYeXv/du57Pn3t5/9VDUi4vKD175NO2aW/vun12MnX2YP+dElJ+vS31nv9P5LrkdQveGNhze09O9Zplf5vUCyciqbm+9g41Az3aP6Xtn7oLvDMMuXDbnhRaOGrwnur5PjGW3KyfpsbJ2fOmYGvkFj87uw3eZsC5T10x2n8qxd52EULm0K1qsGuoL49aWGwXnTv9mo/BfgtzHIMnfjRX/KL6zL/6ZMYFRYY9Ad/6IA6twgmViJJ6DNhhITrAH5MGpygPEjlYgGDfCrZAObhpCaJOZbwbcWmHrZIErqu4BQkinR/Lh7grWO5t/OABsPoKAUxjP6O0DzdBagczB755HIZl9HzLe1jRULBYPGy9+PByFycDmt4LSvwky7aSPQ5kn23V9gjP/9zizgrCt49aGK//ny/ifsMA+hLEVUnnbYmzpXxRjy7G/IcbWqCRtjrHVWrWGwHUCnNbqCIVGqpFJNQQmkWFqhUInl/8mxm4D7IYrdErlY7BbJU7B6FkI6zqDzFfkLZfLRD6IEfdVK+USyQPAbu99YMfH7KWPS7puuTBiZl1Z+1Wjvb58jx72VcAX28NjXxj6bE/nQdHPGreOjjF12tGUMfP9QbsMZmRmv30XTZa5HqNHjQvu5t55ffvEz7bdqr11vffI98/IMndtPsLezWn6dsKtIwk/WSZ3XDdnwFV02MXpPy+fl4Zpq9x90wxF6A9xOwJrZ/p9XC/l2y0ahPerSTgaWda/ffQ3HTm/4gM7xx4s6hX8xboZXUcH5Vp6BIZkDAisvxjz9c5ead2DZ7zT1RlNTnSiOil6PP30um6eZWvH8KsD9x6DsO79VR8Vz559q1G9ca4G/1jae6vnkZsLF/n9NPnOvDUJ28wLXqy5ELIt4+aypcurn9s174Br//M/xMumjRp/+cMbHY8HW30nbWyaHBjktnZ1asS0S6t2THDxQr+Y0bmsT9SSp25drhhQHFK7aMkbqkaVqUj11JDGzBt+r5vkVSlTGzQfcHfkxVM+TSHfLFkZt7y0aMngQ659bmwiPzlZXnLB5VKJpujg/BElyRtfKH29Lv1aqYRucBt7bnq7Eaie8O10d++eUC1mXudxdOWGkEDf4a5Tx91IknQk/nFg+PDs0vT19OrhJUF50YP8Pc6cfmvLtnZ2fJd78MDN6DbGdy4+fx6+a32ISZspqgUJDgsWLNKw696Jn+Os8DegHCkAFJFAlEliEzSmOLVRF43nxsVoIyKSWKk8JS7r9yI+nM0yG6FWgjTRxDQ76EmDL2kiO7Aa0sLoIcPSRIUiAf08cCjbgiaNbmm9YE0rqzJ/j+5P4PATOPwEDj+Bw20Eh9VS1R+Dw889Bg7L/5pwuAyCNexviIeVijbHw0Cv0uo1KkwvwzRytRziVBnQEmqdGpNKVTqN5M/Ew0CNy7R/7Cyz+sGzzOj6OYckXevOjRi71TO4c+gS457v1gf3XY+MShn4jGs5LQ3fYn5xoW+31IQ7uWdqS15x6dn/ZMmN2yc/G+eKxL3wVFfzkI2Xa+Y0+vUd2U+V6bHgq0kTb0+NzOzv0Xhq847BTUnHD2i7uddO3L4kM74x+3zN2ATdfv5SlLTDl3xdWlb+whNoUGllB/O8DxZ+mzpr0adXlBEJE5akT+tX1btu6Oks13Y/SrcOKCV/THaf55lh9ahbhM7S9nbuOocfNe1aRv7CV3Z9E3pU12vf4psTZ0TFTv3I9eiwHVGznvlg8C/hEapyN9dct+LViWOzo7YODSfXH6/xZYMq5Csu79sXZrlq6evG+XnLXz6Q1KV4n7O7S2eq49tpobImL+Tqu8/cmLoIj9V/frPonYrLS1IuGM553Z7W+Eb01pV9QyMHX7sWllB8cZjzL4rLeb9kGbd7n0cTwzrK6yXhjfsnf1NwZETJ2Z7zXy1/uyphZVNVdYfk4ZeyFj17btqe2sQZulma6+53v3/+VvaasNfoE+ahtRvi1+85mr+k8WDYmMrvvRyI9vm4vgPrndsW0bq+8eRqw1/oakOc7VID5AgH2pmktULWogc5IiTnnUan0ePHj7ejlzT6kaBdIBDobEY7kCo02o4bIby8xyWNboXkYYsNdjvQsf0f9E8uaDy5oNE2FzSe7BWe7BX+z/YKZRimkrXtZkHxFz07V8olf8P7KTJpm+8VIFTH1TqAKbS4Qi+R63S4UovL9BKZklBqZfI/c68gJeRqQvrf3nu4d0bumzo9Y33sP0+UGp1dfQeGzxosdk1JCeGHzn8usabzjqaM77uFYCn93LRB62RL//n6jl4zO2k7kJ8OqynmVf0zaF8uc/LNr186sSCxy5envs/tdmdP/61ruiSuNTxfsGH3gozkxpj0518dWHv+69qxEccsP39Z7502/eStd12Line truncated
eNrtWXtUE1caF6wuba0Lsp621uqYVUAlIYEEEuoKGsNDBBGiEAXCMLlhBiYzYeaGECjbVotttS4NWvf46G5FBEvVAmXFHhV84LoVsR6qtfjco+2p1gOeta1b6oO9MwnykD48q3s8Wzj8MZn73e/93d9vZpZW5QOOp1jGYxvFQMDhBEQ/+DVLqziQZwM8fLXSAiDJmioS5yfrN9s4qn0KCaGVDw8Kwq2UDGcgybFWipARrCUoXxFkATyPZwO+Ios1OU57dhZJLHiBEbK5gOEl4ZhCHqwMxCQ9UujOkiIJx9IAXUlsPOAkaJVgkSsMFG6lkDj05zFIAozPs+EcwDiWhRhrxpTBEZLidEEXawK0IEvQuM0EpCFSlZRnGQZAKY1DFIKgknfwEFgEKQNrwwQ9OMbbrIDLp3iWwyDO5wITZqcgiVlwBs+mmGwkgRwR0oMLOcGyALQDwIi+mFmaZu2CkJ3lcpEIisOfAzzAOYIEnH8g5k8gtzj/dBkWTeXfs0uIFHNnOBBd8FaWcZsXBF1KMchiqB4YAwqgDNPhBNmzYKdoGkPOm1nOgtwUvMdwpGCgIkowwttoyIvLPMShjZdhKSRyyEwxFE8C0wDzUbEJsckxMiFnkGVpI0GyFCFUp0gCHVaxTMJ9YZ3BLeLvJNaGOkdS7N7iLuqAVbRoAjzBUVYhmWJp7wbJCSLChSvSWDPGsD2JRfeASfSyR6iPhxRjtUEjj1Juwfu5yGblAEIsvBV1J+AgJfYa8gpZEC8AYxPaYYmkt2qu1jO5LlxWJEKD9SjlIYdqJykWAhVqR3HAJKoQlaYXF6cXV5EARwr488O8K0iWh87ae4bkA5wggBVKAYNsIX3O7dmFlDUQMwGz0K7VhNC64hQ6q3MBsEpxGjVQpWuXswa3WmmKEDsyKAe1+Tb3sEgFL+9drhY6TYpGjYHOhlk9fgQlOtBMM5hcFqKRyWsKpKgzKIZGQ4lGBrlUaRXXd/ddsOJELtIjdZ8XzkrX5h19ZVjeuSUeJ+Yn91MpZNe5BecsocoP+97nbAykLMBZpU2815x7sddciEyhkGlq+ynmHQzh3GLGaR7U3k3y3S3VwfLgEKk8VCpXNPRTDSDnkBIssuDcJN/Rk0AaMNmQdG4OU8m3ukaCB8sqXTOztEJojKP/qHIfXOXz43pL7VMxBxXOuVdvA4GYQoMlsPkYMq3E5MHhcnW4UoNFx+u3ad1m9IPWqVbP4QxvRrXS9fRFFUHaGHQqVWsH7Yh2SW/EHLJPUxYKSt1nCqqj8NNZoZTL5e1+PynJoeFBZwGyWBGi0Wh+Rq8wLtBZL8QnVSikCo3eHaV6cTs22E7X0e/2p1LwB3k0+Scke/3pkcZ+UvpH/NEsrnY7LaVMzj3o2ihXqFLz9XmopPEkm6QPLShYnBAValBuzqdwZ7VCpsCyWTabBh9oo6RadNwCabJYfWfVHEPCrPhY7bZUaRKbxaI06HGULoZlQGUywhDAOasJmrWZ0AhzoBJtT5plcNargZLAw9RECKFSESEASHUpSTU9fXC3zhXC/Itw+Uql64hp7pq40muY+DdcX3pubnPkqJILU04lk7vT8a8+Az7fzn6i7vWYdR3N575WUhvejFjTuHue7njLxi9e1GQvP7asJONYfEbaxL8vykhPb7l8++btmojG8QmlmZFNI+elBFw85jXSb3SsVfLO1t+PGP6HolGZm56SFR4NbQ/19ZvdemTPthV7AvdHtlTEPHGDulMyjSfLJ389bkpr7ccrLwH7Jfbqa9fnbE2vLZ1oL2xf6sEVXz85fmzVF+WTpn3+rFeEakRmqW9gy4ceCyasf/wd+e3uetljh18/IUldMemZ13M1L3R7P/dl2GSPJekdo6wnmk5XLl7Lohi7u4cPG7t8n/kFj2HDHhTv8H1EeMcggOg6W40csNLGHigdAI0LeYR0JMULcAcKACEgn2sbJpxDIpibWMRUICnCpQNxGjtKiSDPAyC6jeASgaPgMY7l4zQ6m9IYzP0nyPMka6NNmBU1HMQoKMi7GECmeCtAJpNNzZRhesEN9I94EpVFiwAsaBdSNjgEDwBcwV/xYkCIerJ/SH0iRZcIr4Aw6oKnHEaQOAddlOTnoFg01xe03UxgCJz/P8BZFaJ4oOCsUvwqwFnzaIGzSjEYOKfk6hLy8uKj4/Tq3LB4OzCzfJ6Be7jgrAmRgzDz/YDzIY/YPuicaJh/INL7zvQNDp+y2e9GNjdKMiYtjyy/6DRbohe3d9L2bN/aKy+FLSFOVH3USJjHBfAx73I3oXKmrqvwVtpnDfbvcvjGgvr3Nxz80yTPmeNGBcCETh9JTcVsbXhK+NrwzGlHFszyXFc28/B+k/w5dds4h3fpxSsFvzvsPStq/YKQyfNbSwMuRWf7zPY85T/3Dc+3faKvS1ZP+2Zu8BOyxF2n41YeGFP7bphiVYl9y/mV3zmfbNOSm40LJG8XPr2oo/PJv82PvtRV9sn5IPvKDnPWB52ndhV9XvbRy1712zw/gUnv6Ta37Xv8RcsMbVtklOPlNW9PaikvS5uRS8S17n3rt+mWj8JW3Swmz/zZa/zqWOnc6B+6Z57bh3csyPZ648Zc3T93N/m1Niw5AiM7sHUJZp+3vmra6zi70+hG+x3WRZ/ufHBo/9iYh4v2gVjvbpznKXTsMLC/CqQfuh4tJbH+6OGcBLRVhFkCpwmbgB2Da0dAKrwPcJ2x/SBOVCea7vvcbUTe9332HoxMiJDcF3wllMXKclDkC2mMC95F7sDncTBAGTx1qvjwTpl6rNjQNKp1UJMTbdAmJ4VwMSmJwJCazFqjEPXpl457k7lkgMOuFxADEp5sQ4jJ82YbTTt6cN8UnsZkZma6IkpjftZnUTqNSYYmRF3CsVCZUi0PU8pDNWqlPEwdmsbcfYeBnDT+ouCEJPBGwHEsh6RF6ELxDpG9IbI3RPb+92SvQiFXBj9Ythf8a2B7iF09WmwveDC2p9QCIsHMk3Z7qsq+KJTMUsWQMO4hsz0zrjEF39ermJu9ZG9eaWvOQbn3q0bdUcPouovqNxjpq7OLrmz6ImmFzw2/vNy4nfYRscsu7J1cf/zTfWER8pT6p8YXzlzkdyHs9vd1Zyd8efPbGZ0TWs599enVOx7juGcvr5WYX5pMzqvd7fHJ2brvseOXCe3z478+VrW8Duw8ol4eWWYgVp5NfXJV+MhNmPXaqaYFm77Z/senX2vwnTph9V9j4hUrVvxmYerJuusH5Yf4M0WbOsuP6GoVVw+sOROPf7aBe6VLu2zK6JNz/kK8PLykskw54ta4eUR5om9aTHqVs9N4dqzlmTL9mKYA+dnqo6qssu6jpx13PFz0zHRC9cO0B0fPhmf+d/SsL6MQSFEgdpdr/QLi9mNb9YPSMQR+6Dzg2ALKIrS34x5aIZPcDyMY+uw09Nlp6LPTENn5BW+21KHKB8t1Qn4VXCf4EeM6IYNxHa0qK8ag5rWpUaZFdkM+BfMK8ATLw+U6eKg8C03v/XCd230/OxnjDkZ6Nze1zDBi3fSX539IrPVeWr/Q2+ldtmWt325VQ8r2SRfSZZLLl4513jLnN9eW6K6NXrhxTXv0v6xzm9Zf5Fo3HDqT07VL1iA/fnXdgbGalIleI5fBWVvfeSF8uwE/Hhf3fOD6HTekOgP01eB+q9rUravV8fhxr+m1BxrfbEoce2XaNU/bjjFm46GPM9SGINkpvGtjp+nmnOnns0eM2tW5jJ2eQXnJZhaVPL//2/dqdp1Zs+HcHyqvnNz33sb3X8nxvxWRk6Eu/HfzU/vrroUPj3gp+/BE0xZOkl/T1dEWuefOyboX1ze62U4b87hyBrr+D6cPbus=
@@ -1 +1 @@
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 truncated
@@ -1 +1 @@
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 truncated
@@ -1 +1 @@
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 truncated
@@ -0,0 +1 @@
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 truncated
@@ -0,0 +1 @@
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 truncated
@@ -0,0 +1 @@
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 truncated
@@ -1 +0,0 @@
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 truncated
@@ -1 +0,0 @@
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 truncated
@@ -0,0 +1 @@
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 truncated
@@ -0,0 +1 @@
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 truncated
@@ -0,0 +1 @@
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 truncated
@@ -0,0 +1 @@
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 truncated
@@ -0,0 +1 @@
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 truncated
@@ -0,0 +1 @@
eNrsuwVQ3N2yL4q7BYIFDUFCYIBBBofgwYME92FwZgjumuAaILgFdwjubiG4u7u7w+X79rfP3fuec6rue7VvvVd196qamfqv7tXdq2X11PzW+OY6QmztzGFQ+CJzqD3E1hBs//xgF+ubawv57ACxs/+SYw2xN4MZZ31UVFHNdLA1n6E1s7e3seNjZTW0MWeB2UCghuYsYJg1qyOQFWJtBDE2Noea2mUZwYxdZlzdaMyhNg72NHzU2tpcbEAeZmogByc7MzU3LyczNQcHGzM15/OLg40dyEzNzsEB5Gam5uXg4dHVZaamsYYZQ6yeV9LYQ5ztAf8hGsABsLM2tLKieWaBQMGwP+b0TWC21oZ/qKExMrSDgDhpPHLNIIbGz1uLyDKD2dlHlfyzsaWGYDDE5lnqXwKiik1dzW2YqY0hJlaG9pACMAwKhfzpiqgCSwjEBmBoZe4IyfnbqqgyQxsbK3Ow4R90Vgs7GLTomd8eArUH2LvYQP4zucDBDmILMDR95oiqVHw2QkSa9aPLs1eh1EAWLjYWYJkzwM7e0BxqBbGzA1gZPtuTY/MnveEfCTaGYMtnIYC/IhaV87fFJf/IA7OLypY3BCuq/JNIQ1uwWVS2oa01iLPiH+dtHaD25taQqFyxj/9Z3V/E/6mOgwUIZGEv/yfBdi5QcFS2iaGVHaTmnxZD7G1dAGDYs4yoDLaSv/vHCgI1tTeLygSys+fZQuxsnlMN4pfzvMzewc436zkWkN+9udbPAp73+UNR9u9BXIQjzRJ/jktUkzrEmJmajZNaHAKmZmdj56QGgvjYuPnYgdRS8qpFYn+pUf0vw1CuamsItTN5DoXE38OeCzZzgFpCjAvE/suAN/wR8Ofd/GG+LczqedIK5gSA2ZqbmkOjMt41/S9kiLMNzA4C+MvoqCINgPLfigggLV70t+QD/JnVUdX/dU5X/MUEszU1hJq7/ml6VP4fCQE2e/Zs5V9kG1vYH3r/WGhtF/WDC1TyF+HvoSp4dg0bAMgGYAPW2dnbmoOfM/OPvdvAbO0BdhDwcxnbu0TNMFsbOv+RloIcQC4OEBsbGz+1ORRs5WAMUXEwEodZP6u046e2sYVYwQyN650Bts8hsDK3Nn+O45/vfx0RzykHfF7MVvufOexhlhCoXVTen/Tn0fyPLLaQPzT8sYv/EJTF+zwa/2umv2Tl8v45gPX/zGUH+Qd7MkHWdrX/mf6XhB9sdkXOf2cGmBtHzdA+P+ibmIDZeMAQNg4eTm5OLmNjEyOQETfEBAgyMeZh5+HkLBWTBIgZgs0gAJU/8zUqV1xTQUReWqxA5Vm2GAxmaQ75NguPqK8PNtE3shZkk2WTtIcaspmzyHE7qiorc4s6KSmaghVUpBwkNUxsQOySYoY2IsZmytw8ACA3BwfHH0qAACDLc02zAAEaGqo8NlZgF0cFUaCjvpwMGxjqKC4qr2noaq4kZyatIcUiy/2JzZZFwcrRUZxbkcdGAWLvDLX8oAmFsLCJKctycEprmTiK8kprmVkbisGMP9mJS/AoPYfT0N5MkJWf+jlZzZ/dIvhXRQGeKwrwt3ri+Hs98VMb/5kEgiz/fHryU394bgGKUCsXfmqVP7IJ8vxpaA1RMbeHCCrAoJCZmGcfODiaGwt+kOZhk9ayURblkOHk/sBprc7FpiprxOFqbg/lspZ3ljOWkTAWcXbWt7GC/YMTONnZAWx/+QHExsnzZ+78T9P/X1pVrQH4xwMCoGjzZ6+LyoXC7KDmJiY5KhDb5wqKKgBbwRyMnxuBLSTnOebKIppRlTwQsDEbmIcTYshuCDYxAgNUZMTK/i7tP46TrD+6SK6h1XOROYKjKsw4BGn4ODk5aPiprQ0FeUCcbGx/9kWfnD+KEmraRfKKKgQN7s+BqJooS1DPV7O5dZQ7XZV7zlj3VvoytAHtA97H8sJCTLwXH6NkEdbHbw51r7327K864ZVbf8mopW7VnKY93e6VtswVsZyeHHk93t59wl5begI3OSr2nP/x/Dfy4+3Q0tGTk+nJYPBd021My5yXl1qaG/DpYUj/3kv/poX74WxqSdreNk/lpdEQQrn98Bll8/bjTmMbMyUHpqOM2HFG2SePWXRk3G34fM7EQ4fKZWU1g6sJhF3ztYq0bB619IUCbvf9e+0hUAS1iL0oeXeFulQ/fZ5g7RkVvubuO6Qf75DROe/m6YwOQhyGRqMC+p2LbDatKHTnQ3F8Aux+DFd+27BqrtNB4FYMiFoAeyFYLTchm8AUM8u75AXbJLX6cpvSVeZmvH7euINUrqk5W/vCOm5/mgYhhDnl3qEeOh51DcW//SA6As8087rExbKOH29yEGUueLWi7ydO3T2Ug2xPb9X4W94W3kvJpBVt+4+tr/Tfdc0diFfN/uB7vfMjfc8pzaBYeszVMd+6NfII55wEqcEKONqAWJ28ppLd0jxtbKoHtyD0wvxbDdAAIZR6d89U8eRDbmhMwUg7ceNRudebOD2zPV2cSA+yY83aKE+c+N+vt4eTd6H5F3YgEGGwtM2bDlaqiCKMdL6EClYriaq45BcukUvipjQCWQlKiRyk5n584GgymPfXcQD1VgGGYItOzEB4J0skPxJHE3S/aVBSXy3dxMKXKrDf5yRusqU1u0WKp9SUe60mLVksbUG28za+h0/FyRwOcAAd2zPTbxsljiP6xBWxzdVcJVhI1izWycjk5VZ4azW/XwmfEj2fHVG22nrqrK/Sq6cnTSR76e38jhX+fHFueEkgjczpWEEULYABZTpGkdgpipsStRg6t8Jjqf+wDN8lShw5M57awUqQNl0wfBUI5SwMe50YQ5bbJmIPUl378ZNYP0c1Q6pZaUevXYXTronmB5mmnvGKoHac0Dl9ZvwX7rSQWkXQUTlx+9gBIb6mcqGVJ3FsYPX6QB7LgXXrEMbysgn8q4sXHU2tvgNwpThFJ2vNVXtdruMERdDHpFfMQJ3XEw6oYVP3sh24DJehzOY405IvHxi3cB8EEHs7RCq5r1kAOQ20+hNi3AAlG51MZeKFtQpRI6eTvBMK885QGfmMRAy+atQR2y2OuOtIDH5shiu5sdyUHJftmxnR5FdsDnFo27z2uq8zv7cFXIi6e3nzufHbP+gTp76V9lwKwfxWe4HvSSn0NqFtLFp5QaeZjxZ5lTLZR95gm1SYdoOsy39ktcKO6OfG90ns1SGTtYoBx6OfLptoWRA3+mShIL6OpLfwYtQB52UlrK+NcHHfGT8sLgruIHkR4fDqYfQ5XpnTUBLRf1lQR0ejoQjeXDiPXw6nWnw8LNr/kY1cAygKzTvlRst/ODWYhUvhmyveSzlK6KKwvnafezNQYT0/xNcilxcdh6pW1JOTeigkn24KAsg3uthLMw1jdEefXtS1R2XecOvfyKTm4YBUQGlzupjRPV0/SHucQsvZjyNLYhjcuXuSwyKae1dstKGPVoPh/Ue9HpipAZAIANU5y0DdPuBuCvSmSPu+yLJK1V+c2WJ3f8BUeGs5JZ2AkZVH9LFCX8gdLsprHMtVZ8uPloqYSqiXZDmATyPhfPwBY7rAlsH9iSQzYTcXxdZBT6WxNCTVJjJ6BblO3QJkP3UFkpNwLro2S/GKc0Whjk93r7HelbDVleVQZ2y5CJUXb75NJhENn74gApdOT3hTHIHhFujXA2nzstKkjRVsRlGppHqYhnuGhvGOXYM5PpVpTzHjhyGN7tmf5/ZBf+6MOdCcz0fLCTrzTxiNUeIbC/DICFk+LMuaU7SUeYy2HyuneLmvodyvTp3ea3OcE1IrH4LOXOgOL1ziqWAa8rWXdBqIbFVz/q1mQbBrgXgHTrnrc8kx5h2NkL2vQAOwUvfdFmKa30HQQDnsZZkyC25wKQdK49lFypJr1maInesvzCjfwVs7xUxjTu8yVFyccx9XWlWKxZEtR+i7t13tAQXt5kfBxjCFMvKf31of9vZYSmhu34cs+Qwhm6eVq+zFlCHhLWtkJ3n2tqhg6c39Oq7b7NRx5cgl4duV6CpBc3Y6GclHsPFlcfyoM94ppImzu77jU2oXfRGdEIsxS9L/4m7PHZKs5PZhQV9vOsVPflwoEiB6yNuJFEpFxrxE3NCae4Ge/2mFWFtOpKGV3sxBZ35BjNVskFGCsQKXh0Hlya3Zn1J0dLlnf2fG3oVSxdkg+701pCJ/a6hQ3yCLylJrPwJVtzH7gUxLBG+tYXh8pEigAe709kZuzRSfw5Gfm47c1zoQFmA0TMq7jJM8AZElPDl1zHUjwgmcfRQFPHjffhVEIZXs35DsNEInJdTkh9Mgh7xi+WAsi7fZV/oIzmYpY2r0cRQZAzDl//Cs5ltLO0JWyxCxOeX5XoLWOea9arQ8+ZALt1D3nSzPdDDg1cvfhzFm6fDGBE6cxazJ/Gbpn9PfJFFe2N0ihEr4YY2bOmST8LqDbB+vEKiqw909B7buV3EZz/1Oa1In9GTOgAGwhcFjrSOSm5gOuEhVtelmq4FEoRPmH62zNuMovhunGlCWj9LhMXwmqldWd6PYXzgIV2jOcUiFlzIRyle+ffyKLcPp7RqsdFtPrR+pUxr3qhB/pJ9ZR99xpC12X1zBcJkHS7sLee/evOL9TcH5D9zDsbGU9sqLdBt/fVemOG4D3jiu4cKdBeKVqc8zG8iYNuf72ILJCRNDcLSYnfaZRhOl+6GwYGZxkQmdXgW2OKtUBU0cvKkc1SUr4UPaBfa1oWt7xeODOKxUNKzuR3HCuaC7mc5ilF/Yy2W29NlCLPvDrevZi3kVXokz8wPM/rkSL/KYXnBlbu2dPu7w724G+jh4qXtfkCI3UqEspnShxywbkwpMtAMQxhaeaNlu8bCpHMqDiH595W0k7whEE8dyEAFhYd5Osbx57+3KKZjjdiN1tLuQrX115ImQj13KeT8RMf+bLP5MypvrLtv3xOObjDPUNPVV0OftG/nxnOHYOoJuKeEC0/xPoqptyyIHiykLV9vW1mZdPYWsn8oMKYYUcIJtjtPvrphLine truncated
@@ -0,0 +1 @@
eNpteHdUU9v2tRQFlCqKBemIFyUQWui99y6dGEKoIYlJQECayKVDjEqXjoQqvVcF6YJI7x0EBKR3+OK9vve773tv/3HG2HvNPdfae821zhkngOAOQ2OckAiSfCcEFoaGQLHECQYfQEDDnrrBMNjALFcY1hFpl6mvZ2Sc4YZ2GuV2xGJRGEkBAQjKiR+JgiEgTvxQpKuAu6AAzNUWZmfnhHDAZNoi7TxHIc85nRAoNyynJLulpQiQj10QKCHMxy4MkhAkPoHW1nzsnK5IOxicCODEwjywgH8zAIQBGFcIHM5JhMAQUOSvNbA9Eu0K+cXGaQvBwEAinD4ERxjEjniCqUv0mY5IDBb/4T+jKoRAoTAUkfc3Bb7AwcsJxcduB7OHQ7CwXCgSgYD9dWZ8rgsMhgJA4E7usKy/d+GLICgU3AkK+WUXcMYgEflEPBaGwAKwnijYf5tz3TAwNADiQETgy/SIQShoCOh7Eq8PwS7ILwrkFyzyAGCwECcEHIbBAOAQYjxZqL/stf80oCBQFyIJ4Hdq8Fl/b/7wTwwSg3+vA4HqGf0HJQQNdcS/h6BdQSKl/1xHuyGwTq4wPEFJ/7/d/Tb+nzthfkFBfqHi/yDGeCKg+Pf2EDgGVvkfm2FYtCcAiiRy4NOAWVAk0sUJhh/dBoOh9mBbVxmgFlAVi4AAnfi1xdyNDQ3FFJ8Z6DlAdY3U3FTN7FEgIVUlCErBztFQTBwgKCYsLCwkLiIiCBDkJx6YXxBgZmYsjoJDPd11FQXdwdqaQCjCXVlRxxzi5WSg7ahhpsavJWYCRPPrwt3dlcX0xFG6MKwHwkXdHAHjByoZagmLaFjYuytKaFg4ukKUkHYmGGUVcQMpdmJ0bu5OdjLqGuJADQuUoaKwpoiYuoirqSjQWMtW2MsJixB11fHQttNUsVPw8ACj4Mh/hCciJAQA/o4QBBQRB/4aH/6lDTgM4YB1xKdLiGWjYRgUsZxgL7OIN4Z1wwRkEmUI624nuBLvjpjidD2t/1Pw7UxloiTx9aYwOz52oAi7MgzKLgQUEmEXBEkCxSSFhNjVdIzzlX57Mf6fCiw2RkMQGHuiClX+pXgC1NEN4QKzy1X6n1qv/aV1YiJ/RY9GwomLcOQzABLt5OCEwKc9rP//zDAPFBIDA/wOGp9vBjD8u1EANJTz/647wF8lja/43wVd+huERDtAEE5ef4WOz/lVC1BHoqjKfptRaOQvv782umLw6SLCH34b/qXSXOLVAAGCQABQsBqDRTtBiUX56+woJBoLwMCgxFaF9cSP8rlCPH5VpIywoKgwiJgmKXYnBBTuZgczcrNVRroSXWKk2FFoGBwJsavxAKCJKYA7uToR0/jX83cbJFab4K8kV/03Aot0gRE7ZvZfduJo+CcEDfvl4dcp/k2UKUEcdf8b9JuLIPHXANX8JwoD+0c8GSBXTNV/238zpAMx+R7/AgOc7PCj3MQJ2A5kLy4BhIIgErZQEYignS1I2F5EHGYrKiYubGdvDylUUgUoQaCOMIDRX3rFE5TNdRV0NJQqzAD/FB5AD/X3e4KAQGIQTvb2WUYwNDEz+FwoHOlmR+ytaFgWkctQwRxfJg6D2gGh4jAYTFgCam8LBRhpKhX9i+3fMs381ZgJEDgxee5QfKmjsAynpIiIMKcUuytERhwkAgT+9U55kfUr2QiHz7eBbOGUl/4aZMYJlnQlnRVZm8OFcfGV+2GU6iZfpFIvSdwifeguySJvLK8scUNf6qTx2c/x0UkfKGeMfNKU4JTDgN/pWmHjOaI0tz248eJobdN0lM7vArc3BmD59mvud/7LfLwm55tyAe5K7wgbL/CW8/3iJxezaSl4cdYLnvADHzVGnhN3btQvGDMlG1V+h5k09aSQzsntCydHWPpdcUJ0nVe0OJdN0IzKK3PqOX82jxbkSlDdTdXzVB42iAo8d/KD7O0mc4nLDWgXdZ6QdXpaHBuIwDNU9OfIPV+e8DyWaI9Q+SH7wtpbnP6sFdNjJ84e09I91DGJdGtyfCo2O+4HU449qkgU2ipO/cJBOs/RGQSfQmaQlp/1cQUtbCbxMt8OtmBhDfWVxo1+0ysOSm5zUPxQaWSgE7nX528TzrKnWdnlcQtGEsh3c0WhmDLOAzd0csKoOcCb7iP6LF0yjZmSXQJkCrheEQn+lPqAU3ATb6nDkknCfcCZNRXvk7tYX8hh97yAJ0oxHL4v86754OQs6/FnpyerH7wuYQqmDOerMJeCk82pZ5TlBgYe0vQaFSjsLsy9WupUuLRznh3djmpPjFueLGUW8B2S93lC+7FO1g7zAsA6pvu636PdyuHW1IH0MbeqiK9Kov0O9o3KW3s7jqWAZ6PY2EaOOsU95cGrbnGz41zysW3YjGEmSMWJNt1NH914kC7igb/EzwYQu9rmj94UwezbZIa0gDahP6qTuSqkHDdunW5sunOQl64maZa9xb2yYXZD8aCvenw3GU12nm37waTDJvEEgWSpz+DapC5p4PvJFLTzh1mU9Zetqbw0AI2ozHGbS2u0wNq1xvivR+PtlE3ohQFyhj90jWliq1enDrJIMK/IuS0/MNG/XuAJGNv3SmlWaLbouql2aO5Od/fR5c/Xxgmc9J+PNQqPpnBVO3YVRc+9GfBd4r3uTSOBqKsS4axsQ6Wr3K5szYmHd1VXKyXHV6ZD1eqqqc9tA1kyhEOYdoGdLIL7wUnNPaPN8qCDEPWvk0IO8dNRdHXu1fRcQz6t39sGZ5wO7mfSSz9iTFg48e8PYA5z4SU9nfUo6zPJdkMrv6O21yPl8mc+zDJVQdyWykrg8+zsz6h8n7IlPVZ6LWbhvuHRamqY60cuFa1S3lCfnINDZlK54LktbFrMAarWekWchP5GDo/v8Z2tbxVO4RMVhqrFPbW6qEiawFEFJqd7lCSM9s3v6M8iOD6i3ytjUjlvbU/3Rtsd58DK5FJUy764xUp+bu0KrOsn/c5GryYErinqyHwXxi9m/PpU01jesxtUV7cstjC0BAXxuQ0rxkmRlS91O9TuNNDSx/U/KKbW2rz9zEH2VBnAk3Lm2/vHoBbZHXa1c+WtvISdWlv2oxKqHM8p3sEDH6l2fVmVkVs/npL9AeAHqWOMstSWAaWj0usN2V6vH3ycH1HGfLXyHmF21Cs7s86Jib1AMTRUXKMKZX/xUfwm/VQMN8Gcwbr2MkVfwJRAQxprx2BYLVjA4dCxgc4PpDbJ4FWwyVH4WSzsoCRIYn4iKFWS1WNO1/xKzGPGRqD2Vuj3oX36p66KytnRtj926opmZr2Fbe1u7/xZtTE/thXb//7Pym7J672TV3vyfeVpm+fOt/O491juFneR5iDAIWlLYO3oyaVrPcNcVm2bg1vbO6/Sg4dbRR4DbhY9LywromSjmN5rhpbVmiPZ9ofauAn6Blv6wZFh3FwhvsfNQ2edL0/Uag3n9+uLBR8+IFvRGT4JF1Ssg+8YBh6kndL3T6D7OOU0Hi7e7wkpnwZ/tArOuLrD2+ekLxy9viB0J61qHTaHr/thT1g3aQL4qm68Iak9/yOloUhiEjzQ6Jr5/ZmfyH6W0kbxM7S9RwiHpEZrUkLhehLViMj1n8wCm935UX4pJiG6hBLWRmeofW0SfW7I4GLwzKy1PTUJTLnydufCjUHvfYfG8ylTiTpqB95dh4Dvlh8XHg4qVSpP9Mvjsny++g8YtOmXzbKDb/EYcEi+3Idv8LTod/Q9D+0K2cLlUXbrU6kb36qav3Gv2hF6zOTGs9wxciILQjUYxF9PQzYdNrAYF8G2YDeyLFu+e+Y5Z4tVPJ+z0ehoXcu4mlamw5dL7rUJtD7KpjQ2Y/et65IMUqJXenCXJ32rnIYpW/fy3Azt67k8w6GUfvuAy7FCc94BtIVe3WkoWrbzZJ8eOGcGf1oqfnohN6/3A1IrSukA9/T99gGfeHPzB+bdwfG3dphsMt+KYHlJShKetMXoSeOGfCavvSP57q8RwIM7X0ipVLv7UNyARJfl6hemaX0r1b6fb9YSFMJXHfjpZeoAozfq2OjKei7UH9WGxsCkA7+un/pbECL1dTo1MH0hOvE8hOerP4esR/zPC4Z3K8FHE6I8379oLW62qQU4XAjdD4kP0Kt75J73Wdbb2ay7jGesOL/2/v2OK+jxzrSgz/anMpCSF5yvHXINCm3BI4GX1e36MksaCmo7qhOppHN2pRAnb35Qahb4zXJDFRfa4HNJWyhuj4krPIAPi7d6i+ud0uxwNw3K1X54Kz1Z0H+3+RAPNiQzG1Djkmeb1d19p9sDdzKhfi+wfDK3kjy3Ij5Ek55hfVxBOhcVistRBUp6DeSBooWZDy/P1qc3Tf9ZCZxn63dU9BWAovFBmLak/qcv6r4dKdfnWonipZned0EkokBY12CBMAytWO39n5UEj00gBhU+7UEPbYyDB6E5PymRfjh3f5PZo331g/zaBRXDjSCH/RKo2YO9eK+JDFKt3D2/XfeJGt0EQOydwW9zrj2y5clXR3JSBVLP/xBC366/9DNanZm3pg6TwlZIEeySTwga2rp3BIkoqabHsEbhJAmzO8XrraJ+L3u+WhgLtt1iVXz6NnXWA+ml/7HWVkmK++vDN1w6vZo09mSynpSBB4qUE/Vm4Gttt507Ht+t1QUoPPdVyRhA5MvUs5yYlptRvUmlnhrHrxG4E5We3oDw9Yck2IBLegrQDPDRI8V7lspxHKYWM81Tq/Nvpv0ES6sr6ZpD+tV3verzqkPu06KXNfcJeZi1rMLivPcmuJxnhvbApzOfFEieCfhhvL5GiHZUBtrSUs9dS74Z2f001c6Fg3ODs6E0Z1SebCqPRB/nYUnQqWygGjrTQvYuv3cZOqNMKT7hkfQocfRKSKZ2WZwztJW5WdG/8ZKu8CRcwUrXiTNhc5+fbypBU+9xd43GiLWOeGauytV5oDE1iUugMSvdOe33kVnp/BF6E/BF4/ZaBnT4yVV46DE3KiOlIUDssdec1ZTOEJ113YvV5QSjy0zLine truncated
@@ -0,0 +1,123 @@
# How to add semantic search to your LangGraph deployment
This guide explains how to add semantic search to your LangGraph deployment's cross-thread [store](../../concepts/persistence.md#memory-store), so that your agent can search for memories and other documents by semantic similarity.
## Prerequisites
- A LangGraph deployment (see [how to deploy](setup_pyproject.md))
- API keys for your embedding provider (in this case, OpenAI)
- `langchain >= 0.3.8` (if you specify using the string format below)
## Steps
1. Update your `langgraph.json` configuration file to include the store configuration:
```json
{
...
"store": {
"index": {
"embed": "openai:text-embeddings-3-small",
"dims": 1536,
"fields": ["$"]
}
}
}
```
This configuration:
- Uses OpenAI's text-embeddings-3-small model for generating embeddings
- Sets the embedding dimension to 1536 (matching the model's output)
- Indexes all fields in your stored data (`["$"]` means index everything, or specify specific fields like `["text", "metadata.title"]`)
2. To use the string embedding format above, make sure your dependencies include `langchain >= 0.3.8`:
```toml
# In pyproject.toml
[project]
dependencies = [
"langchain>=0.3.8"
]
```
Or if using requirements.txt:
```
langchain>=0.3.8
```
## Usage
Once configured, you can use semantic search in your LangGraph nodes. The store requires a namespace tuple to organize memories:
```python
def search_memory(state: State, *, store: BaseStore):
# Search the store using semantic similarity
# The namespace tuple helps organize different types of memories
# e.g., ("user_facts", "preferences") or ("conversation", "summaries")
results = store.search(
namespace=("memory", "facts"), # Organize memories by type
query="your search query",
limit=3 # number of results to return
)
return results
```
## Custom Embeddings
If you want to use custom embeddings, you can pass a path to a custom embedding function:
```json
{
...
"store": {
"index": {
"embed": "path/to/embedding_function.py:embed",
"dims": 1536,
"fields": ["$"]
}
}
}
```
The deployment will look for the function in the specified path. The function must be async and accept a list of strings:
```python
# path/to/embedding_function.py
from openai import AsyncOpenAI
client = AsyncOpenAI()
async def aembed_texts(texts: list[str]) -> list[list[float]]:
"""Custom embedding function that must:
1. Be async
2. Accept a list of strings
3. Return a list of float arrays (embeddings)
"""
response = await client.embeddings.create(
model="text-embedding-3-small",
input=texts
)
return [e.embedding for e in response.data]
```
## Querying via the API
You can also query the store using the LangGraph SDK. Since the SDK uses async operations:
```python
from langgraph_sdk import get_client
async def search_store():
client = get_client()
results = await client.store.search(
namespace=("memory", "facts"),
query="your search query",
limit=3 # number of results to return
)
return results
# Use in an async context
results = await search_store()
```
+6 -6
View File
@@ -21,7 +21,7 @@ Install the proper packages:
Ensure you have an API key, which you can create from the [LangSmith UI](https://smith.langchain.com) (Settings > API Keys). This is required to authenticate that you have LangGraph Cloud access. After you have saved the key to a safe place, place the following line in your `.env` file:
```python
LANGCHAIN_API_KEY = *********
LANGSMITH_API_KEY = *********
```
## Start the API server
@@ -54,7 +54,7 @@ You can either initialize by passing authentication or by setting an environment
from langgraph_sdk import get_client
# only pass the url argument to get_client() if you changed the default port when calling langgraph up
client = get_client(url=<DEPLOYMENT_URL>,api_key=<LANGCHAIN_API_KEY>)
client = get_client(url=<DEPLOYMENT_URL>,api_key=<LANGSMITH_API_KEY>)
# Using the graph deployed with the name "agent"
assistant_id = "agent"
thread = await client.threads.create()
@@ -66,7 +66,7 @@ You can either initialize by passing authentication or by setting an environment
import { Client } from "@langchain/langgraph-sdk";
// only set the apiUrl if you changed the default port when calling langgraph up
const client = new Client({ apiUrl: <DEPLOYMENT_URL>, apiKey: <LANGCHAIN_API_KEY> });
const client = new Client({ apiUrl: <DEPLOYMENT_URL>, apiKey: <LANGSMITH_API_KEY> });
// Using the graph deployed with the name "agent"
const assistantId = "agent";
const thread = await client.threads.create();
@@ -78,13 +78,13 @@ You can either initialize by passing authentication or by setting an environment
curl --request POST \
--url <DEPLOYMENT_URL>/threads \
--header 'Content-Type: application/json'
--header 'x-api-key: <LANGCHAIN_API_KEY>'
--header 'x-api-key: <LANGSMITH_API_KEY>'
```
#### Initialize with environment variables
If you have a `LANGCHAIN_API_KEY` set in your environment, you do not need to explicitly pass authentication to the client
If you have a `LANGSMITH_API_KEY` set in your environment, you do not need to explicitly pass authentication to the client
=== "Python"
@@ -154,7 +154,7 @@ Now we can invoke our graph to ensure it is working. Make sure to change the inp
}
```
=== "CURL"
=== "CURL"
```bash
curl --request POST \
+12 -12
View File
@@ -86,19 +86,19 @@ To create an assistant using the studio do the following steps:
1. Click on the "Create New Assistant" button:
![click create](./img/click_create_assistant.png)
![click create](./img/click_create_assistant.png)
2. Use the create assistant pane to enter info for the assistant you wish to create, and then click create:
1. Use the create assistant pane to enter info for the assistant you wish to create, and then click create:
![create](./img/create_assistant.png)
![create](./img/create_assistant.png)
3. See that your assistant was created and is displayed in the Studio
1. See that your assistant was created and is displayed in the Studio
![view create](./img/create_assistant_view.png)
![view create](./img/create_assistant_view.png)
4. Click on the edit button next to the selected assistant to manage your created assistant:
1. Click on the edit button next to the selected assistant to manage your created assistant:
![create edit](./img/edit_created_assistant.png)
![create edit](./img/edit_created_assistant.png)
## Create a new version for your assistant
@@ -131,15 +131,15 @@ Let's now say we wanted to add a system prompt to our assistant. We can do this
1. First, click on the edit button next to the `openai_assistant`. Then, add a system prompt and click "Save New Version":
![create new version](./img/create_new_version.png)
![create new version](./img/create_new_version.png)
2. Then you can see it is selected in the assistant dropdown:
1. Then you can see it is selected in the assistant dropdown:
![see version dropdown](./img/see_new_version.png)
![see version dropdown](./img/see_new_version.png)
3. And you can see all the version history in the edit pane for the assistant:
1. And you can see all the version history in the edit pane for the assistant:
![see versions](./img/see_version_history.png)
![see versions](./img/see_version_history.png)
## Point your assistant to a different version
@@ -83,7 +83,7 @@ We can now call `.get_schemas` to get schemas associated with this graph:
assistant_id=assistant["assistant_id"]
)
# There are multiple types of schemas
# We can get the `config_schema` to look at the the configurable parameters
# We can get the `config_schema` to look at the configurable parameters
print(schemas["config_schema"])
```
@@ -94,7 +94,7 @@ We can now call `.get_schemas` to get schemas associated with this graph:
assistant["assistant_id"]
);
// There are multiple types of schemas
// We can get the `config_schema` to look at the the configurable parameters
// We can get the `config_schema` to look at the configurable parameters
console.log(schemas.config_schema);
```
@@ -94,6 +94,7 @@ Now we can start our two runs and join the second on euntil it has completed:
assistant_id,
input={"messages": [{"role": "user", "content": "what's the weather in sf?"}]},
)
# sleep a bit to get partial outputs from the first run
await asyncio.sleep(2)
run = await client.runs.create(
thread["thread_id"],
@@ -114,6 +115,7 @@ Now we can start our two runs and join the second on euntil it has completed:
assistantId,
{ input: { messages: [{ role: "human", content: "what's the weather in sf?" }] } }
);
// sleep a bit to get partial outputs from the first run
await new Promise(resolve => setTimeout(resolve, 2000));
let run = await client.runs.create(
@@ -95,7 +95,6 @@ Now let's run a thread with the multitask parameter set to "rollback":
assistant_id,
input={"messages": [{"role": "user", "content": "what's the weather in sf?"}]},
)
await asyncio.sleep(2)
run = await client.runs.create(
thread["thread_id"],
assistant_id,
@@ -115,7 +114,6 @@ Now let's run a thread with the multitask parameter set to "rollback":
assistantId,
{ input: { messages: [{ role: "human", content: "what's the weather in sf?" }] } }
);
await new Promise(resolve => setTimeout(resolve, 2000));
let run = await client.runs.create(
thread["thread_id"],
@@ -139,7 +137,7 @@ Now let's run a thread with the multitask parameter set to "rollback":
--data "{
\"assistant_id\": \"agent\",
\"input\": {\"messages\": [{\"role\": \"human\", \"content\": \"what\'s the weather in sf?\"}]},
}" && sleep 2 && curl --request POST \
}" && curl --request POST \
--url <DEPLOY<ENT_URL>>/threads/<THREAD_ID>/runs \
--header 'Content-Type: application/json' \
--data "{
+4 -4
View File
@@ -1,4 +1,4 @@
# Quick Start
# LangGraph Cloud Quick Start
In this tutorial you will build and deploy a simple chatbot agent that can look things up on the internet. You will be using [LangGraph Cloud](../concepts/langgraph_cloud.md), [LangGraph Studio](../concepts/langgraph_studio.md) to visualize and test it out, and [LangGraph SDK](./reference/sdk/python_sdk_ref.md) to interact with the deployed agent.
@@ -8,9 +8,9 @@ If you want to learn how to build an agent like this from scratch, take a look a
This tutorial will use:
- Anthropic for the LLM - sign up and get an API key [here](https://console.anthropic.com/)
- Tavily for the search engine - sign up and get an API key [here](https://app.tavily.com/)
- LangSmith for hosting - sign up and get an API key [here](https://smith.langchain.com/)
- Anthropic for the LLM - sign up and get an API key [here](https://console.anthropic.com/).
- Tavily for the search engine - sign up and get an API key [here](https://app.tavily.com/).
- LangSmith for hosting - sign up and get an API key [here](https://smith.langchain.com/).
## Create and configure your app
File diff suppressed because it is too large. Load diff
@@ -1,19 +0,0 @@
<!doctype html>
<html>
<head>
<title>Open Assistants API Specification</title>
<meta charset="utf-8" />
<meta
name="viewport"
content="width=device-width, initial-scale=1" />
</head>
<body>
<script id="api-reference" data-url="./open_agent_api.json"></script>
<script>
var configuration = {}
document.getElementById('api-reference').dataset.configuration =
JSON.stringify(configuration)
</script>
<script src="https://cdn.jsdelivr.net/npm/@scalar/api-reference"></script>
</body>
</html>
+129 -19
View File
@@ -60,6 +60,16 @@
}
}
},
"404": {
"description": "Not Found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"409": {
"description": "Conflict",
"content": {
@@ -116,6 +126,16 @@
}
}
},
"404": {
"description": "Not Found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
@@ -1537,8 +1557,11 @@
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {}
"text/event-stream": {
"schema": {
"type": "string",
"description": "The server will send a stream of events in SSE format.\n\n**Example event**:\n\nid: 1\n\nevent: message\n\ndata: {}"
}
}
}
},
@@ -1885,8 +1908,11 @@
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {}
"text/event-stream": {
"schema": {
"type": "string",
"description": "The server will send a stream of events in SSE format.\n\n**Example event**:\n\nid: 1\n\nevent: message\n\ndata: {}"
}
}
}
},
@@ -2123,8 +2149,11 @@
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {}
"text/event-stream": {
"schema": {
"type": "string",
"description": "The server will send a stream of events in SSE format.\n\n**Example event**:\n\nid: 1\n\nevent: message\n\ndata: {}"
}
}
}
},
@@ -2848,9 +2877,18 @@
"description": "The cron schedule to execute this job on."
},
"assistant_id": {
"type": "string",
"format": "uuid",
"title": "Assistant Id"
"anyOf": [
{
"type": "string",
"format": "uuid",
"title": "Assistant Id"
},
{
"type": "string",
"title": "Graph Id"
}
],
"description": "The assistant ID or graph name to run. If using graph name, will default to the assistant automatically created from that graph by the server."
},
"input": {
"anyOf": [
@@ -3151,6 +3189,66 @@
],
"title": "Run"
},
"Send": {
"type": "object",
"title": "Send",
"description": "A message to send to a node.",
"properties": {
"node": {
"type": "string",
"title": "Node",
"description": "The node to send the message to."
},
"input": {
"type": "object",
"title": "Message",
"description": "The message to send."
}
},
"required": [
"node",
"input"
]
},
"Command": {
"type": "object",
"title": "Command",
"description": "The command to run.",
"properties": {
"update": {
"type": "object",
"title": "Update",
"description": "An update to the state."
},
"resume": {
"type": [
"object",
"array",
"number",
"string",
"null"
],
"title": "Resume",
"description": "A value to pass to an interrupted node."
},
"send": {
"anyOf": [
{
"$ref": "#/components/schemas/Send"
},
{
"type": "array",
"items": {
"$ref": "#/components/schemas/Send"
}
},
{
"type": "null"
}
]
}
}
},
"RunCreateStateful": {
"properties": {
"assistant_id": {
@@ -3176,13 +3274,19 @@
"input": {
"anyOf": [
{
"items": {
"type": "object"
},
"type": "array"
"type": "object"
},
{
"type": "object"
"type": "null"
}
],
"title": "Input",
"description": "The input to the graph."
},
"command": {
"anyOf": [
{
"$ref": "#/components/schemas/Command"
},
{
"type": "null"
@@ -3385,13 +3489,19 @@
"input": {
"anyOf": [
{
"items": {
"type": "object"
},
"type": "array"
"type": "object"
},
{
"type": "object"
"type": "null"
}
],
"title": "Input",
"description": "The input to the graph."
},
"command": {
"anyOf": [
{
"$ref": "#/components/schemas/Command"
},
{
"type": "null"
+114 -34
View File
@@ -26,10 +26,11 @@ The LangGraph command line interface includes commands to build and run a LangGr
The LangGraph CLI requires a JSON configuration file with the following keys:
| Key | Description |
|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `dependencies` | **Required**. Array of dependencies for LangGraph Cloud API server. Dependencies can be one of the following: (1) `"."`, which will look for local Python packages, (2) `pyproject.toml`, `setup.py` or `requirements.txt` in the app directory `"./local_package"`, or (3) a package name. |
| `graphs` | **Required**. Mapping from graph ID to path where the compiled graph or a function that makes a graph is defined. Example: <ul><li>`./your_package/your_file.py:variable`, where `variable` is an instance of `langgraph.graph.state.CompiledStateGraph`</li><li>`./your_package/your_file.py:make_graph`, where `make_graph` is a function that takes a config dictionary (`langchain_core.runnables.RunnableConfig`) and creates an instance of `langgraph.graph.state.StateGraph` / `langgraph.graph.state.CompiledStateGraph`.</li></ul> |
| `env` | Path to `.env` file or a mapping from environment variable to its value. |
| `store` | Configuration for adding semantic search to the BaseStore. Contains the following fields: <ul><li>`index`: Configuration for semantic search indexing with fields:<ul><li>`embed`: Embedding provider (e.g., "openai:text-embedding-3-small") or path to custom embedding function</li><li>`dims`: Dimension size of the embedding model. Used to initialize the vector table.</li><li>`fields` (optional): List of fields to index. Defaults to `["$"]`, meaningto index entire documents. Can be specific fields like `["text", "summary", "some.value"]`</li></ul></li></ul> |
| `python_version` | `3.11` or `3.12`. Defaults to `3.11`. |
| `pip_config_file` | Path to `pip` config file. |
| `dockerfile_lines` | Array of additional lines to add to Dockerfile following the import from parent image. |
@@ -41,33 +42,84 @@ The LangGraph CLI requires a JSON configuration file with the following keys:
</p>
</div>
Example:
### Examples
#### Basic Configuration
```json
{
"dependencies": ["langchain_openai", "./your_package"],
"dependencies": ["."],
"graphs": {
"my_graph_id": "./your_package/your_file.py:variable"
},
"env": "./.env"
"chat": "./chat/graph.py:graph"
}
}
```
Example:
#### Adding semantic search to the store
All deployments come with a DB-backed BaseStore. Adding an "index" configuration to your `langgraph.json` will enable [semantic search](../deployment/semantic_search.md) within the BaseStore of your deployment.
The `fields` configuration determines which parts of your documents to embed:
- If omitted or set to `["$"]`, the entire document will be embedded
- To embed specific fields, use JSON path notation: `["metadata.title", "content.text"]`
- Documents missing specified fields will still be stored but won't have embeddings for those fields
- You can still override which fields to embed on a specific item at `put` time using the `index` parameter
```json
{
"python_version": "3.11",
"dependencies": ["langchain_openai", "."],
"dependencies": ["."],
"graphs": {
"my_graph_id": "./your_package/your_file.py:make_graph"
"memory_agent": "./agent/graph.py:graph"
},
"env": {
"OPENAI_API_KEY": "secret-key"
"store": {
"index": {
"embed": "openai:text-embedding-3-small",
"dims": 1536,
"fields": ["$"]
}
}
}
```
!!! note "Common model dimensions"
- openai:text-embedding-3-large: 3072
- openai:text-embedding-3-small: 1536
- openai:text-embedding-ada-002: 1536
- cohere:embed-english-v3.0: 1024
- cohere:embed-english-light-v3.0: 384
- cohere:embed-multilingual-v3.0: 1024
- cohere:embed-multilingual-light-v3.0: 384
#### Semantic search with a custom embedding function
If you want to use semantic search with a custom embedding function, you can pass a path to a custom embedding function:
```json
{
"dependencies": ["."],
"graphs": {
"memory_agent": "./agent/graph.py:graph"
},
"store": {
"index": {
"embed": "./embeddings.py:embed_texts",
"dims": 768,
"fields": ["text", "summary"]
}
}
}
```
The `embed` field in store configuration can reference a custom function that takes a list of strings and returns a list of embeddings. Example implementation:
```python
# embeddings.py
def embed_texts(texts: list[str]) -> list[list[float]]:
"""Custom embedding function for semantic search."""
# Implementation using your preferred embedding model
return [[0.1, 0.2, ...] for _ in texts] # dims-dimensional vectors
```
## Commands
The base command for the LangGraph CLI is `langgraph`.
@@ -78,6 +130,37 @@ The base command for the LangGraph CLI is `langgraph`.
langgraph [OPTIONS] COMMAND [ARGS]
```
### `dev`
Run LangGraph API server in development mode with hot reloading and debugging capabilities. This lightweight server requires no Docker installation and is suitable for development and testing. State is persisted to a local directory.
**Installation**
This command requires the "inmem" extra to be installed:
```bash
pip install -U "langgraph-cli[inmem]"
```
**Usage**
```
langgraph dev [OPTIONS]
```
**Options**
| Option | Default | Description |
| ----------------------------- | ---------------- | ----------------------------------------------------------------------------------- |
| `-c, --config FILE` | `langgraph.json` | Path to configuration file declaring dependencies, graphs and environment variables |
| `--host TEXT` | `127.0.0.1` | Host to bind the server to |
| `--port INTEGER` | `2024` | Port to bind the server to |
| `--no-reload` | | Disable auto-reload |
| `--n-jobs-per-worker INTEGER` | | Number of jobs per worker. Default is 10 |
| `--no-browser` | | Disable automatic browser opening |
| `--debug-port INTEGER` | | Port for debugger to listen on |
| `--help` | | Display command documentation |
### `build`
Build LangGraph Cloud API server Docker image.
@@ -91,7 +174,7 @@ langgraph build [OPTIONS]
**Options**
| Option | Default | Description |
|----------------------|------------------|------------------------------------------------------------------------------------------------------------------------------|
| -------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `--platform TEXT` | | Target platform(s) to build the Docker image for. Example: `langgraph build --platform linux/amd64,linux/arm64` |
| `-t, --tag TEXT` | | **Required**. Tag for the Docker image. Example: `langgraph build -t my-image` |
| `--pull / --no-pull` | `--pull` | Build with latest remote Docker image. Use `--no-pull` for running the LangGraph Cloud API server with locally built images. |
@@ -100,7 +183,7 @@ langgraph build [OPTIONS]
### `up`
Start langgraph API server. For local testing, requires a LangSmith API key with access to LangGraph Cloud closed beta. Requires a license key for production use.
Start LangGraph API server. For local testing, requires a LangSmith API key with access to LangGraph Cloud closed beta. Requires a license key for production use.
**Usage**
@@ -110,20 +193,20 @@ langgraph up [OPTIONS]
**Options**
| Option | Default | Description |
|------------------------------|---------------------------|-----------------------------------------------------------------------------------------------------------------------|
| `--wait` | | Wait for services to start before returning. Implies --detach |
| `--postgres-uri TEXT` | Local database | Postgres URI to use for the database. |
| `--watch` | | Restart on file changes |
| `--debugger-base-url TEXT` | `http://127.0.0.1:[PORT]` | URL used by the debugger to access LangGraph API. |
| `--debugger-port INTEGER` | | Pull the debugger image locally and serve the UI on specified port |
| `--verbose` | | Show more output from the server logs. |
| `-c, --config FILE` | `langgraph.json` | Path to configuration file declaring dependencies, graphs and environment variables. |
| `-d, --docker-compose FILE` | | Path to docker-compose.yml file with additional services to launch. |
| `-p, --port INTEGER` | `8123` | Port to expose. Example: `langgraph test --port 8000` |
| `--pull / --no-pull` | `pull` | Pull latest images. Use --no-pull for running the server with locally-built images. Example: `langgraph up --no-pull` |
| `--recreate / --no-recreate` | `no-recreate` | Recreate containers even if their configuration and image haven't changed |
| `--help` | | Display command documentation. |
| Option | Default | Description |
| ---------------------------- | ------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `--wait` | | Wait for services to start before returning. Implies --detach |
| `--postgres-uri TEXT` | Local database | Postgres URI to use for the database. |
| `--watch` | | Restart on file changes |
| `--debugger-base-url TEXT` | `http://127.0.0.1:[PORT]` | URL used by the debugger to access LangGraph API. |
| `--debugger-port INTEGER` | | Pull the debugger image locally and serve the UI on specified port |
| `--verbose` | | Show more output from the server logs. |
| `-c, --config FILE` | `langgraph.json` | Path to configuration file declaring dependencies, graphs and environment variables. |
| `-d, --docker-compose FILE` | | Path to docker-compose.yml file with additional services to launch. |
| `-p, --port INTEGER` | `8123` | Port to expose. Example: `langgraph up --port 8000` |
| `--pull / --no-pull` | `pull` | Pull latest images. Use `--no-pull` for running the server with locally-built images. Example: `langgraph up --no-pull` |
| `--recreate / --no-recreate` | `no-recreate` | Recreate containers even if their configuration and image haven't changed |
| `--help` | | Display command documentation. |
### `dockerfile`
@@ -138,7 +221,7 @@ langgraph dockerfile [OPTIONS] SAVE_PATH
**Options**
| Option | Default | Description |
|---------------------|------------------|-----------------------------------------------------------------------------------------------------------------|
| ------------------- | ---------------- | --------------------------------------------------------------------------------------------------------------- |
| `-c, --config FILE` | `langgraph.json` | Path to the [configuration file](#configuration-file) declaring dependencies, graphs and environment variables. |
| `--help` | | Show this message and exit. |
@@ -148,9 +231,9 @@ Example:
langgraph dockerfile -c langgraph.json Dockerfile
```
Would generate something like the following:
This generates a Dockerfile that looks similar to:
```text
```dockerfile
FROM langchain/langgraph-api:3.11
ADD ./pipconf.txt /pipconfig.txt
@@ -170,6 +253,3 @@ RUN set -ex && \
RUN PIP_CONFIG_FILE=/pipconfig.txt PYTHONDONTWRITEBYTECODE=1 pip install --no-cache-dir -c /api/constraints.txt -e /deps/*
ENV LANGSERVE_GRAPHS='{"agent": "/deps/__outer_graphs/src/agent.py:graph", "storm": "/deps/__outer_graphs/src/storm.py:graph"}'
```
You can then customize, build images, push, and deploy from this file.
+4 -4
View File
@@ -53,7 +53,7 @@ You’ll build a Docker image using the [LangGraph CLI](./langgraph_cli.md), whi
For more information, please see:
* [Self-Hosted conceptual guide](./self_hosted.md)
* [Self-Hosted Deployment how-to guide](../how-tos/deploy-self-hosted.md)
* [Self-Hosted deployment how-to guide](../how-tos/deploy-self-hosted.md)
## Cloud SaaS
@@ -89,8 +89,8 @@ For more information please see:
## Related
For more information please see:
For more information, please see:
* [LangGraph Platform Plans](./plans.md)
* [LangGraph Platform Pricing](https://www.langchain.com/langgraph-platform-pricing)
* [LangGraph Platform plans](./plans.md)
* [LangGraph Platform pricing](https://www.langchain.com/langgraph-platform-pricing)
* [Deployment how-to guides](../how-tos/index.md#deployment)
+3 -5
View File
@@ -15,10 +15,12 @@ If you do not want to use LangGraph Platform, we describe the options we have im
![](img/double_texting.png)
## Reject
This is the simplest option, this just rejects any follow up runs and does not allow double texting.
See the [how-to guide](../cloud/how-tos/reject_concurrent.md) for configuring the reject double text option.
## Enqueue
This is a relatively simple option which continues the first run until it completes the whole run, then sends the new input as a separate run.
See the [how-to guide](../cloud/how-tos/enqueue_concurrent.md) for configuring the enqueue double text option.
@@ -35,10 +37,6 @@ See the [how-to guide](../cloud/how-tos/interrupt_concurrent.md) for configuring
## Rollback
This option rolls back all work done up until that point.
It then sends the user input in, basically as if it just followed the original run input.
This may create some weird states - for example, you may have two `User` messages in a row, with no `Asssitant` message in between them.
You will need to make sure the LLM you are calling can handle that, or combine those into a single `User` message.
This option interrupts the current execution AND rolls back all work done up until that point, including the original run input. It then sends the new user input in, basically as if it was the original input.
See the [how-to guide](../cloud/how-tos/rollback_concurrent.md) for configuring the rollback double text option.
+2 -2
View File
@@ -2,13 +2,13 @@
LLMs are extremely powerful, particularly when connected to other systems such as a retriever or APIs. This is why many LLM applications use a control flow of steps before and / or after LLM calls. As an example [RAG](https://github.com/langchain-ai/rag-from-scratch) performs retrieval of relevant documents to a question, and passes those documents to an LLM in order to ground the response. Often a control flow of steps before and / or after an LLM is called a "chain." Chains are a popular paradigm for programming with LLMs and offer a high degree of reliability; the same set of steps runs with each chain invocation.
However, we often want LLM systems that can pick their own control flow! This is one definition of an [agent](https://blog.langchain.dev/what-is-an-agent/): an agent is a system that uses an LLM to decide the control flow of an application. Unlike a chain, an agent given an LLM some degree of control over the sequence of steps in the application. Examples of using an LLM to decide the control of an application:
However, we often want LLM systems that can pick their own control flow! This is one definition of an [agent](https://blog.langchain.dev/what-is-an-agent/): an agent is a system that uses an LLM to decide the control flow of an application. Unlike a chain, an agent gives an LLM some degree of control over the sequence of steps in the application. Examples of using an LLM to decide the control of an application:
- Using an LLM to route between two potential paths
- Using an LLM to decide which of many tools to call
- Using an LLM to decide whether the generated answer is sufficient or more work is need
There are many different types of [agent architectures](https://blog.langchain.dev/what-is-a-cognitive-architecture/) to consider, which given an LLM varying levels of control. On one extreme, a router allows an LLM to select a single step from a specified set of options and, on the other extreme, a fully autonomous long-running agent may have complete freedom to select any sequence of steps that it wants for a given problem.
There are many different types of [agent architectures](https://blog.langchain.dev/what-is-a-cognitive-architecture/) to consider, which give an LLM varying levels of control. On one extreme, a router allows an LLM to select a single step from a specified set of options and, on the other extreme, a fully autonomous long-running agent may have complete freedom to select any sequence of steps that it wants for a given problem.
![Agent Types](img/agent_types.png)
+13 -13
View File
@@ -27,8 +27,8 @@ Adding a [breakpoint](./low_level.md#breakpoints) a specific location in the gra
Here, we compile our graph with a checkpointer and a breakpoint at the node we want to interrupt before, `step_for_human_in_the_loop`. We then perform one of the above interaction patterns, which will create a new checkpoint if a human edits the graph state. The new checkpoint is saved to the `thread` and we can resume the graph execution from there by passing in `None` as the input.
```python
# Compile our graph with a checkpoitner and a breakpoint before "step_for_human_in_the_loop"
graph = builder.compile(checkpointer=checkpoitner, interrupt_before=["step_for_human_in_the_loop"])
# Compile our graph with a checkpointer and a breakpoint before "step_for_human_in_the_loop"
graph = builder.compile(checkpointer=checkpointer, interrupt_before=["step_for_human_in_the_loop"])
# Run the graph up to the breakpoint
thread_config = {"configurable": {"thread_id": "1"}}
@@ -98,8 +98,8 @@ With persistence, we can surface the current agent state as well as the next ste
If approved, the graph resumes execution from the last saved checkpoint, which is saved to the `thread`:
```python
# Compile our graph with a checkpoitner and a breakpoint before the step to approve
graph = builder.compile(checkpointer=checkpoitner, interrupt_before=["node_2"])
# Compile our graph with a checkpointer and a breakpoint before the step to approve
graph = builder.compile(checkpointer=checkpointer, interrupt_before=["node_2"])
# Run the graph up to the breakpoint
for event in graph.stream(inputs, thread, stream_mode="values"):
@@ -120,7 +120,7 @@ See [our guide](../how-tos/human_in_the_loop/breakpoints.ipynb) for a detailed h
Sometimes we want to review and edit the agent's state.
As with approval, we can interrupt our agent at a [breakpoint](./low_level.md#breakpoints) prior the the step we want to check.
As with approval, we can interrupt our agent at a [breakpoint](./low_level.md#breakpoints) prior to the step we want to check.
We can surface the current state to a user and allow the user to edit the agent state.
@@ -131,8 +131,8 @@ We can edit the graph state by forking the current checkpoint, which is saved to
We can then proceed with the graph from our forked checkpoint as done before.
```python
# Compile our graph with a checkpoitner and a breakpoint before the step to review
graph = builder.compile(checkpointer=checkpoitner, interrupt_before=["node_2"])
# Compile our graph with a checkpointer and a breakpoint before the step to review
graph = builder.compile(checkpointer=checkpointer, interrupt_before=["node_2"])
# Run the graph up to the breakpoint
for event in graph.stream(inputs, thread, stream_mode="values"):
@@ -170,11 +170,11 @@ With editing, the user makes a decision about whether or not to edit the graph s
With input, we explicitly define a node in our graph for collecting human input!
The the state update with the human input then runs *as this node*.
The state update with the human input then runs *as this node*.
```python
# Compile our graph with a checkpoitner and a breakpoint before the step to to collect human input
graph = builder.compile(checkpointer=checkpoitner, interrupt_before=["human_input"])
# Compile our graph with a checkpointer and a breakpoint before the step to to collect human input
graph = builder.compile(checkpointer=checkpointer, interrupt_before=["human_input"])
# Run the graph up to the breakpoint
for event in graph.stream(inputs, thread, stream_mode="values"):
@@ -211,8 +211,8 @@ Even if the tool call is correct, we may also want to apply discretion:
With these points in mind, we can combine the above ideas to create a human-in-the-loop review of a tool call.
```python
# Compile our graph with a checkpoitner and a breakpoint before the step to to review the tool call from the LLM
graph = builder.compile(checkpointer=checkpoitner, interrupt_before=["human_review"])
# Compile our graph with a checkpointer and a breakpoint before the step to to review the tool call from the LLM
graph = builder.compile(checkpointer=checkpointer, interrupt_before=["human_review"])
# Run the graph up to the breakpoint
for event in graph.stream(inputs, thread, stream_mode="values"):
@@ -319,4 +319,4 @@ for event in graph.stream(None, config, stream_mode="values"):
See [this additional conceptual guide](https://langchain-ai.github.io/langgraph/concepts/persistence/#update-state) for related context on forking.
See see [this guide](../how-tos/human_in_the_loop/time-travel.ipynb) for a detailed how-to on doing time-travel!
See see [this guide](../how-tos/human_in_the_loop/time-travel.ipynb) for a detailed how-to on doing time-travel!
Binary file not shown.

Before

Width:  |  Height:  |  Size: 144 KiB

After

Width:  |  Height:  |  Size: 141 KiB

+5 -5
View File
@@ -30,7 +30,7 @@ The conceptual guide does not cover step-by-step instructions or specific implem
- [Streaming](streaming.md): Streaming is crucial for enhancing the responsiveness of applications built on LLMs. By displaying output progressively, even before a complete response is ready, streaming significantly improves user experience (UX), particularly when dealing with the latency of LLMs.
- [FAQ](faq.md): Frequently asked questions about LangGraph.
## LangGraph Platform
## LangGraph Platform
LangGraph Platform is a commercial solution for deploying agentic applications in production, built on the open-source LangGraph framework.
@@ -42,14 +42,14 @@ The LangGraph Platform offers a few different deployment options described in th
* LangGraph is an MIT-licensed open-source library, which we are committed to maintaining and growing for the community.
* You can always deploy LangGraph applications on your own infrastructure using the open-source LangGraph project without using LangGraph Platform.
**High Level**
### High Level
- [Why LangGraph Platform?](./langgraph_platform.md): The LangGraph platform is an opinionated way to deploy and manage LangGraph applications. This guide provides an overview of the key features and concepts behind LangGraph Platform.
- [Deployment Options](./deployment_options.md): LangGraph Platform offers four deployment options: [Self-Hosted Lite](./self_hosted.md#self-hosted-lite), [Self-Hosted Enterprise](./self_hosted.md#self-hosted-enterprise), [bring your own cloud (BYOC)](./bring_your_own_cloud.md), and [Cloud SaaS](./langgraph_cloud.md). This guide explains the differences between these options, and which Plans they are available on.
- [Plans](./plans.md): LangGraph Platforms offer three different plans: Developer, Plus, Enterprise. This guide explains the differences between these options, what deployment options are available for each, and how to sign up for each one.
- [Template Applications](./template_applications.md): Reference applications designed to help you get started quickly when building with LangGraph.
**Components**
### Components
The LangGraph Platform comprises several components that work together to support the deployment and management of LangGraph applications:
@@ -59,7 +59,7 @@ The LangGraph Platform comprises several components that work together to suppor
- [Python/JS SDK](./sdk.md): The Python/JS SDK provides a programmatic way to interact with deployed LangGraph Applications.
- [Remote Graph](../how-tos/use-remote-graph.md): A RemoteGraph allows you to interact with any deployed LangGraph application as though it were running locally.
**LangGraph Server**
### LangGraph Server
- [Application Structure](./application_structure.md): A LangGraph application consists of one or more graphs, a LangGraph API Configuration file (`langgraph.json`), a file that specifies dependencies, and environment variables.
- [Assistants](./assistants.md): Assistants are a way to save and manage different configurations of your LangGraph applications.
@@ -67,7 +67,7 @@ The LangGraph Platform comprises several components that work together to suppor
- [Cron Jobs](./langgraph_server.md#cron-jobs): Cron jobs are a way to schedule tasks to run at specific times in your LangGraph application.
- [Double Texting](./double_texting.md): Double texting is a common issue in LLM applications where users may send multiple messages before the graph has finished running. This guide explains how to handle double texting with LangGraph Deploy.
**Deployment Options**
### Deployment Options
- [Self-Hosted Lite](./self_hosted.md): A free (up to 1 million nodes executed), limited version of LangGraph Platform that you can run locally or in a self-hosted manner
+20 -1
View File
@@ -28,9 +28,28 @@ The CLI provides the following core functionality:
The `langgraph build` command builds a Docker image for the [LangGraph API server](./langgraph_server.md) that can be directly deployed.
### `dev`
!!! note "New in version 0.1.55"
The `langgraph dev` command was introduced in langgraph-cli version 0.1.55.
The `langgraph dev` command starts a lightweight development server that requires no Docker installation. This server is ideal for rapid development and testing, with features like:
- Hot reloading: Changes to your code are automatically detected and reloaded
- Debugger support: Attach your IDE's debugger for line-by-line debugging
- In-memory state with local persistence: Server state is stored in memory for speed but persisted locally between restarts
To use this command, you need to install the CLI with the "inmem" extra:
```bash
pip install -U "langgraph-cli[inmem]"
```
**Note**: This command is intended for local development and testing only. It is not recommended for production use. Since it does not use Docker, we recommend using virtual environments to manage your project's dependencies.
### `up`
The `langgraph up` command starts an instance of the [LangGraph API server](./langgraph_server.md) locally. This requires docker to be installed and running locally. It also requires a LangSmith API key for local development or a license key for production use.
The `langgraph up` command starts an instance of the [LangGraph API server](./langgraph_server.md) locally in a docker container. This requires thedocker server to be running locally. It also requires a LangSmith API key for local development or a license key for production use.
The server includes all API endpoints for your graph's runs, threads, assistants, etc. as well as the other services required to run your agent, including a managed database for checkpointing and storage.
+12 -4
View File
@@ -1,12 +1,12 @@
# Cloud SaaS
!!! info "Prerequisites"
- [LangGraph Platform](./langgraph_platform.md)
!!! info "Prerequisites"
- [LangGraph Platform](./langgraph_platform.md)
- [LangGraph Server](./langgraph_server.md)
## Overview
LangGraph's Cloud SaaS is a managed service that provides a scalable and secure environment for deploying LangGraph APIs. It is designed to work seamlessly with your LangGraph API regardless of how it is defined, what tools it uses, or any dependencies. Cloud SaaS provides a simple way to deploy and manage your LangGraph API in the cloud.
LangGraph's Cloud SaaS is a managed service for deploying LangGraph APIs, regardless of its definition or dependencies. The service offers managed implementations of checkpointers and stores, allowing you to focus on building the right cognitive architecture for your use case. By handling scalable & secure infrastructure, LangGraph Cloud offers the fastest path to getting your LangGraph API deployed to production.
## Deployment
@@ -14,6 +14,13 @@ A **deployment** is an instance of a LangGraph API. A single deployment can have
See the [how-to guide](../cloud/deployment/cloud.md#create-new-deployment) for creating a new deployment.
## Resource Allocation
| **Deployment Type** | **CPU** | **Memory** | **Scaling** |
|---------------------|---------|------------|---------------------|
| Development | 1 CPU | 1 GB | Up to 1 container |
| Production | 1 CPU | 2 GB | Up to 10 containers |
## Revision
A revision is an iteration of a [deployment](#deployment). When a new deployment is created, an initial revision is automatically created. To deploy new code changes or update environment variable configurations for a deployment, a new revision must be created. When a revision is created, a new container image is built automatically.
@@ -33,6 +40,7 @@ A high-level diagram of a Cloud SaaS deployment.
![diagram](img/langgraph_cloud_architecture.png)
## Related
- [Deployment Options](./deployment_options.md)
- [Deployment Options](./deployment_options.md)
+10
View File
@@ -35,6 +35,16 @@ While in Beta, LangGraph Studio is available for free to all [LangSmith](https:/
If you have deployed your LangGraph application on LangGraph Platform (Cloud), you can access the studio as part of that
### Development server
LangGraph CLI also contains a command for running an in-memory development server that can be used to connect a local LangGraph app with the studio.
See [instructions here](../cloud/reference/cli.md#dev) for more information.
The way this works is that it runs inside your local environment.
It will spin up an in-memory, development server to deploy the graph.
You can then connect to the studio via the Cloud hosted version of LangGraph Platform.
To be clear, the web studio will connect to your locally running server - your agent is still running locally and never leaves your device.
## Studio FAQs
### Why is my project failing to start?
+1 -1
View File
@@ -391,7 +391,7 @@ Read [this how-to](https://langchain-ai.github.io/langgraph/how-tos/recursion-li
It can often be useful to set breakpoints before or after certain nodes execute. This can be used to wait for human approval before continuing. These can be set when you ["compile" a graph](#compiling-your-graph). You can set breakpoints either _before_ a node executes (using `interrupt_before`) or after a node executes (using `interrupt_after`.)
You **MUST** use a [checkpoiner](./persistence.md) when using breakpoints. This is because your graph needs to be able to resume execution.
You **MUST** use a [checkpointer](./persistence.md) when using breakpoints. This is because your graph needs to be able to resume execution.
In order to resume execution, you can just invoke your graph with `None` as the input.
+24 -6
View File
@@ -171,7 +171,7 @@ trim_messages(
## Long-term memory
Long-term memory in LangGraph allows systems to retain information across different conversations or sessions. Unlike short-term memory, which is thread-scoped, long-term memory is saved within custom "namespaces."
Long-term memory in LangGraph allows systems to retain information across different conversations or sessions. Unlike short-term memory, which is **thread-scoped**, long-term memory is saved within custom "namespaces."
### Storing memories
@@ -180,16 +180,34 @@ LangGraph stores long-term memories as JSON documents in a [store](persistence.m
```python
from langgraph.store.memory import InMemoryStore
def embed(texts: list[str]) -> list[list[float]]:
# Replace with an actual embedding function or LangChain embeddings object
return [[1.0, 2.0] * len(texts)]
# InMemoryStore saves data to an in-memory dictionary. Use a DB-backed store in production use.
store = InMemoryStore()
store = InMemoryStore(index={"embed": embed, "dims": 2})
user_id = "my-user"
application_context = "chitchat"
namespace = (user_id, application_context)
store.put(namespace, "a-memory", {"rules": ["User likes short, direct language", "User only speaks English & python"], "my-key": "my-value"})
store.put(
namespace,
"a-memory",
{
"rules": [
"User likes short, direct language",
"User only speaks English & python",
],
"my-key": "my-value",
},
)
# get the "memory" by ID
item = store.get(namespace, "a-memory")
# list "memories" within this namespace, filtering on content equivalence
items = store.search(namespace, filter={"my-key": "my-value"})
# search for "memories" within this namespace, filtering on content equivalence, sorted by vector similarity
items = store.search(
namespace, filter={"my-key": "my-value"}, query="language preferences"
)
```
### Framework for thinking about long-term memory
@@ -232,7 +250,7 @@ Alternatively, memories can be a collection of documents that are continuously u
However, this shifts some complexity memory updating. The model must now _delete_ or _update_ existing items in the list, which can be tricky. In addition, some models may default to over-inserting and others may default to over-updating. See the [Trustcall](https://github.com/hinthornw/trustcall) package for one way to manage this and consider evaluation (e.g., with a tool like [LangSmith](https://docs.smith.langchain.com/tutorials/Developers/evaluation)) to help you tune the behavior.
Working with document collections also shifts complexity to memory **search** over the list. The `Store` currently supports [filtering by metadata](https://langchain-ai.github.io/langgraph/reference/store/#storage) and will soon add [semantic search shortly](https://python.langchain.com/docs/concepts/vectorstores/), but selecting the most relevant documents can be tricky as the list grows.
Working with document collections also shifts complexity to memory **search** over the list. The `Store` currently supports both [semantic search](https://langchain-ai.github.io/langgraph/reference/store/#langgraph.store.base.SearchOp.query) and [filtering by content](https://langchain-ai.github.io/langgraph/reference/store/#langgraph.store.base.SearchOp.filter).
Finally, using a collection of memories can make it challenging to provide comprehensive context to the model. While individual memories may follow a specific schema, this structure might not capture the full context or relationships between memories. As a result, when using these memories to generate responses, the model may lack important contextual information that would be more readily available in a unified profile approach.
+71 -15
View File
@@ -159,7 +159,7 @@ You must pass these when invoking the graph as part of the `configurable` portio
# {"configurable": {"thread_id": "1", "checkpoint_id": "0c62ca34-ac19-445d-bbb0-5b4984975b2a"}} # also valid config
config = {"configurable": {"thread_id": "1"}}
graph.invoke(inputs, config=config)
graph.invoke(None, config=config)
```
Importantly, LangGraph knows whether a particular checkpoint has been executed previously. If it has, LangGraph simply *re-plays* that particular step in the graph and does not re-execute the step. See this [how to guide on time-travel to learn more about replaying](../how-tos/human_in_the_loop/time-travel.ipynb).
@@ -218,13 +218,16 @@ The final thing you can optionally specify when calling `update_state` is `as_no
## Memory Store
![Update](img/persistence/shared_state.png)
![Model of shared state](img/persistence/shared_state.png)
A [state schema](low_level.md#schema) specifies a set of keys that are populated as a graph is executed. As discussed above, state can be written by a checkpointer to a thread at each graph step, enabling state persistence.
But, what if we want to retrain some information *across threads*? Consider the case of a chatbot where we want to retain specific information about the user across *all* chat conversations (e.g., threads) with that user!
With checkpointers alone, we cannot share information across threads. This motivates the need for the `Store` interface. As an illustration, we can define an `InMemoryStore` to store information about a user across threads. We simply compile our graph with a checkpointer, as before, and will our new `in_memory_store`.
With checkpointers alone, we cannot share information across threads. This motivates the need for the [`Store`](../reference/store.md#langgraph.store.base.BaseStore) interface. As an illustration, we can define an `InMemoryStore` to store information about a user across threads. We simply compile our graph with a checkpointer, as before, and with our new `in_memory_store` variable.
### Basic Usage
First, let's showcase this in isolation without using LangGraph.
```python
@@ -239,7 +242,7 @@ user_id = "1"
namespace_for_memory = (user_id, "memories")
```
We use the `store.put` to save memories to our namespace in the store. When we do this, we specify the namespace, as defined above, and a key-value pair for the memory: the key is simply a unique identifier for the memory (`memory_id`) and the value (a dictionary) is the memory itself.
We use the `store.put` method to save memories to our namespace in the store. When we do this, we specify the namespace, as defined above, and a key-value pair for the memory: the key is simply a unique identifier for the memory (`memory_id`) and the value (a dictionary) is the memory itself.
```python
memory_id = str(uuid.uuid4())
@@ -247,7 +250,7 @@ memory = {"food_preference" : "I like pizza"}
in_memory_store.put(namespace_for_memory, memory_id, memory)
```
We can read out memories in our namespace using `store.search`, which will return all memories for a given user as a list. The most recent memory is the last in the list.
We can read out memories in our namespace using the `store.search` method, which will return all memories for a given user as a list. The most recent memory is the last in the list.
```python
memories = in_memory_store.search(namespace_for_memory)
@@ -259,16 +262,66 @@ memories[-1].dict()
'updated_at': '2024-10-02T17:22:31.590605+00:00'}
```
Each memory type is a Python class with certain attributes. We can access it as a dictionary by converting via `.dict` as above.
Each memory type is a Python class ([`Item`](https://langchain-ai.github.io/langgraph/reference/store/#langgraph.store.base.Item)) with certain attributes. We can access it as a dictionary by converting via `.dict` as above.
The attributes it has are:
- `value`: The value (itself a dictionary) of this memory
- `key`: The UUID for this memory in this namespace
- `key`: A unique key for this memory in this namespace
- `namespace`: A list of strings, the namespace of this memory type
- `created_at`: Timestamp for when this memory was created
- `updated_at`: Timestamp for when this memory was updated
With this all in place, we use the `in_memory_store` in LangGraph. The `in_memory_store` works hand-in-hand with the checkpointer: the checkpointer saves state to threads, as discussed above, and the the `in_memory_store` allows us to store arbitrary information for access *across* threads. We compile the graph with both the checkpointer and the `in_memory_store` as follows.
### Semantic Search
Beyond simple retrieval, the store also supports semantic search, allowing you to find memories based on meaning rather than exact matches. To enable this, configure the store with an embedding model:
```python
store = InMemoryStore(
index={
"embed": "openai:text-embedding-3-small", # Embedding provider
"dims": 1536, # Embedding dimensions
"fields": ["food_preference", "$"] # Fields to embed
}
)
```
Now when searching, you can use natural language queries to find relevant memories:
```python
# Find memories about food preferences
memories = store.search(
namespace_for_memory,
query="What does the user like to eat?",
limit=3 # Return top 3 matches
)
```
You can control which parts of your memories get embedded by configuring the `fields` parameter or by specifying the `index` parameter when storing memories:
```python
# Store with specific fields to embed
store.put(
namespace_for_memory,
str(uuid.uuid4()),
{
"food_preference": "I love Italian cuisine",
"context": "Discussing dinner plans"
},
index=["food_preference"] # Only embed "food_preferences" field
)
# Store without embedding (still retrievable, but not searchable)
store.put(
namespace_for_memory,
str(uuid.uuid4()),
{"system_info": "Last updated: 2024-01-01"},
index=False
)
```
### Using in LangGraph
With this all in place, we use the `in_memory_store` in LangGraph. The `in_memory_store` works hand-in-hand with the checkpointer: the checkpointer saves state to threads, as discussed above, and the `in_memory_store` allows us to store arbitrary information for access *across* threads. We compile the graph with both the checkpointer and the `in_memory_store` as follows.
```python
from langgraph.checkpoint.memory import MemorySaver
@@ -296,7 +349,7 @@ for update in graph.stream(
print(update)
```
We can access the `in_memory_store` and the `user_id` in *any node* by passing `store: BaseStore` and `config: RunnableConfig` as node arguments. Just as we saw above, simply use the `put` method to save memories to the store.
We can access the `in_memory_store` and the `user_id` in *any node* by passing `store: BaseStore` and `config: RunnableConfig` as node arguments. Here's how we might use semantic search in a node to find relevant memories:
```python
def update_memory(state: MessagesState, config: RunnableConfig, *, store: BaseStore):
@@ -317,7 +370,7 @@ def update_memory(state: MessagesState, config: RunnableConfig, *, store: BaseSt
```
As we showed above, we can also access the store in any node and use `search` to get memories. Recall the the memories are returned as a list of objects that can be converted to a dictionary.
As we showed above, we can also access the store in any node and use the `store.search` method to get memories. Recall the the memories are returned as a list of objects that can be converted to a dictionary.
```python
memories[-1].dict()
@@ -332,12 +385,15 @@ We can access the memories and use them in our model call.
```python
def call_model(state: MessagesState, config: RunnableConfig, *, store: BaseStore):
# Get the user id from the config
user_id = config["configurable"]["user_id"]
# Get the memories for the user from the store
memories = store.search(("memories", user_id))
# Search based on the most recent message
memories = store.search(
namespace,
query=state["messages"][-1].content,
limit=3
)
info = "\n".join([d.value["memory"] for d in memories])
# ... Use memories in the model call
@@ -356,7 +412,7 @@ for update in graph.stream(
print(update)
```
When we use the LangGraph API, either locally (e.g., in LangGraph Studio) or with LangGraph Cloud, the memory store is available to use by default and does not need to be specified during graph compilation.
When we use the LangGraph API, either locally (e.g., in LangGraph Studio) or with LangGraph Cloud, the base store is available to use by default and does not need to be specified during graph compilation. For cloud deployments, semantic search is automatically configured based on your `langgraph.json` settings. See the [deployment guide](../deployment/semantic_search.md) for more details.
## Checkpointer libraries
@@ -405,4 +461,4 @@ Lastly, checkpointing also provides fault-tolerance and error recovery: if one o
#### Pending writes
Additionally, when a graph node fails mid-execution at a given superstep, LangGraph stores pending checkpoint writes from any other nodes that completed successfully at that superstep, so that whenever we resume graph execution from that superstep we don't re-run the successful nodes.
Additionally, when a graph node fails mid-execution at a given superstep, LangGraph stores pending checkpoint writes from any other nodes that completed successfully at that superstep, so that whenever we resume graph execution from that superstep we don't re-run the successful nodes.
+11 -3
View File
@@ -7,7 +7,7 @@
## Versions
There are two versions of the self hosted deployment: [Self-Hosted Enterprise](./deployment_options.md#self-hosted-enterprise) and [Self-Hosted Lite](./deployment_options.md#self-hosted-lite).
There are two versions of the self-hosted deployment: [Self-Hosted Enterprise](./deployment_options.md#self-hosted-enterprise) and [Self-Hosted Lite](./deployment_options.md#self-hosted-lite).
### Self-Hosted Lite
@@ -29,7 +29,15 @@ To use the Self-Hosted Enterprise version, you must acquire a license key that y
## How it works
- Deploy Redis and Postgres instances on your own infrastructure.
- Build the docker image for [LangGraph Server](./langgraph_server.md) using the [LangGraph CLI](./langgraph_cli.md)
- Build the docker image for [LangGraph Server](./langgraph_server.md) using the [LangGraph CLI](./langgraph_cli.md).
- Deploy a web server that will run the docker image and pass in the necessary environment variables.
See the [how-to guide](../how-tos/deploy-self-hosted.md)
For step-by-step instructions, see [How to set up a self-hosted deployment of LangGraph](../how-tos/deploy-self-hosted.md).
## Helm Chart
If you would like to deploy LangGraph Cloud on Kubernetes, you can use this [Helm chart](https://github.com/langchain-ai/helm/blob/main/charts/langgraph-cloud/README.md).
## Related
- [How to set up a self-hosted deployment of LangGraph](../how-tos/deploy-self-hosted.md).
+8 -16
View File
@@ -6,22 +6,14 @@
Templates are open source reference applications designed to help you get started quickly when building with LangGraph. They provide working examples of common agentic workflows that can be customized to your needs.
Templates can be accessed via [LangGraph Studio](langgraph_studio.md), or cloned directly from Github. You can download LangGraph Studio and see available templates [here](https://studio.langchain.com/).
Templates can be accessed via [LangGraph Studio (macOS only)](langgraph_studio.md), or cloned directly from Github. You can download LangGraph Studio and see available templates [here](https://studio.langchain.com/).
## Available templates
- **New LangGraph Project**: A simple, minimal chatbot with memory.
- [Python](https://github.com/langchain-ai/new-langgraph-project)
- [JS/TS](https://github.com/langchain-ai/new-langgraphjs-project)
- **ReAct Agent**: A simple agent that can be flexibly extended to many tools.
- [Python](https://github.com/langchain-ai/react-agent)
- [JS/TS](https://github.com/langchain-ai/react-agent-js)
- **Memory Agent**: A ReAct-style agent with an additional tool to store memories for use across conversational threads.
- [Python](https://github.com/langchain-ai/memory-agent)
- [JS/TS](https://github.com/langchain-ai/memory-agent-js)
- **Retrieval Agent**: An agent that includes a retrieval-based question-answering system.
- [Python](https://github.com/langchain-ai/retrieval-agent-template)
- [JS/TS](https://github.com/langchain-ai/retrieval-agent-template-js)
- **Data-enrichment Agent**: An agent that performs web searches and organizes its findings into a structured format.
- [Python](https://github.com/langchain-ai/data-enrichment)
- [JS/TS](https://github.com/langchain-ai/data-enrichment-js)
| Template | Description | Python | JS/TS |
|---------------------------|------------------------------------------------------------------------------------------|------------------------------------------------------------------|---------------------------------------------------------------------|
| **New LangGraph Project** | A simple, minimal chatbot with memory. | [Repo](https://github.com/langchain-ai/new-langgraph-project) | [Repo](https://github.com/langchain-ai/new-langgraphjs-project) |
| **ReAct Agent** | A simple agent that can be flexibly extended to many tools. | [Repo](https://github.com/langchain-ai/react-agent) | [Repo](https://github.com/langchain-ai/react-agent-js) |
| **Memory Agent** | A ReAct-style agent with an additional tool to store memories for use across threads. | [Repo](https://github.com/langchain-ai/memory-agent) | [Repo](https://github.com/langchain-ai/memory-agent-js) |
| **Retrieval Agent** | An agent that includes a retrieval-based question-answering system. | [Repo](https://github.com/langchain-ai/retrieval-agent-template) | [Repo](https://github.com/langchain-ai/retrieval-agent-template-js) |
| **Data-Enrichment Agent** | An agent that performs web searches and organizes its findings into a structured format. | [Repo](https://github.com/langchain-ai/data-enrichment) | [Repo](https://github.com/langchain-ai/data-enrichment-js) |
+332
View File
@@ -0,0 +1,332 @@
{
"cells": [
{
"cell_type": "markdown",
"id": "100c0c81-6a9f-4ba1-b1a8-42aae82b7172",
"metadata": {},
"source": [
"# How to integrate LangGraph with AutoGen, CrewAI, and other frameworks\n",
"\n",
"LangGraph is a framework for building agentic and multi-agent applications. This includes integrating with other agent frameworks.\n",
"\n",
"This guides shows how to integrate LangGraph with other frameworks. The framework we show off integrating with is AutoGen, but this can easily be done with other frameworks.\n",
"\n",
"At a high level, the way this works is by wrapping the other agent inside a LangGraph node. LangGraph nodes can be anything - arbitrary code. This makes it easy to define an AutoGen (or CrewAI, or LlamaIndex, or other framework) agent and then reference it inside your graph. This allows you to create multi-agent systems where some of the sub-agents are actually defined in other frameworks."
]
},
{
"cell_type": "markdown",
"id": "b189ceb2-132b-4c7b-81b4-c7b8b062f833",
"metadata": {},
"source": [
"## Setup"
]
},
{
"cell_type": "code",
"execution_count": null,
"id": "62417d3a-94f9-4a52-9962-12639d714966",
"metadata": {},
"outputs": [],
"source": [
"%pip install autogen bs4 langgraph langchain-openai langchain-community"
]
},
{
"cell_type": "code",
"execution_count": null,
"id": "d46da41d-0a71-4654-aec8-9e6ad8765236",
"metadata": {},
"outputs": [],
"source": [
"import getpass\n",
"import os\n",
"\n",
"\n",
"def _set_env(var: str):\n",
" if not os.environ.get(var):\n",
" os.environ[var] = getpass.getpass(f\"{var}: \")\n",
"\n",
"\n",
"_set_env(\"OPENAI_API_KEY\")\n",
"_set_env(\"TAVILY_API_KEY\")"
]
},
{
"cell_type": "markdown",
"id": "1926bbc3-6b06-41e0-9604-860a2bbf8fa3",
"metadata": {},
"source": [
"## Define AutoGen agent\n",
"\n",
"Here we define our AutoGen agent. From https://github.com/microsoft/autogen/blob/0.2/notebook/agentchat_web_info.ipynb"
]
},
{
"cell_type": "code",
"execution_count": null,
"id": "524de117-ff09-4b26-bfe8-a9f85a46ffd5",
"metadata": {},
"outputs": [],
"source": [
"import autogen\n",
"import os\n",
"\n",
"config_list = [{\"model\": \"gpt-4o\", \"api_key\": os.environ[\"OPENAI_API_KEY\"]}]\n",
"\n",
"llm_config = {\n",
" \"timeout\": 600,\n",
" \"cache_seed\": 42,\n",
" \"config_list\": config_list,\n",
" \"temperature\": 0,\n",
"}\n",
"\n",
"autogen_agent = autogen.AssistantAgent(\n",
" name=\"assistant\",\n",
" llm_config=llm_config,\n",
")\n",
"\n",
"user_proxy = autogen.UserProxyAgent(\n",
" name=\"user_proxy\",\n",
" human_input_mode=\"NEVER\",\n",
" max_consecutive_auto_reply=10,\n",
" is_termination_msg=lambda x: x.get(\"content\", \"\").rstrip().endswith(\"TERMINATE\"),\n",
" code_execution_config={\n",
" \"work_dir\": \"web\",\n",
" \"use_docker\": False,\n",
" }, # Please set use_docker=True if docker is available to run the generated code. Using docker is safer than running the generated code directly.\n",
" llm_config=llm_config,\n",
" system_message=\"Reply TERMINATE if the task has been solved at full satisfaction. Otherwise, reply CONTINUE, or the reason why the task is not solved yet.\",\n",
")"
]
},
{
"cell_type": "markdown",
"id": "8aa858e2-4acb-4f75-be20-b9ccbbcb5073",
"metadata": {},
"source": [
"---"
]
},
{
"cell_type": "markdown",
"id": "d6bc7b69-4a36-44dc-a501-7e17122cc385",
"metadata": {},
"source": [
"## Define LangGraph agent\n",
"\n",
"We now define our LangGraph agent. We will create a simple ReAct-style agent with a web search tool"
]
},
{
"cell_type": "code",
"execution_count": null,
"id": "a0fcdaac-8fbe-4589-8e61-8092165356cd",
"metadata": {},
"outputs": [],
"source": [
"from langgraph.graph import StateGraph, START, MessagesState\n",
"from langgraph.prebuilt import ToolNode, create_react_agent\n",
"from langchain_community.tools.tavily_search import TavilySearchResults\n",
"from langchain_openai import ChatOpenAI\n",
"from langchain_core.messages import HumanMessage, AIMessage\n",
"\n",
"model = ChatOpenAI(model=\"gpt-4o\")\n",
"tools = [TavilySearchResults(max_results=1)]\n",
"web_search_agent = create_react_agent(\n",
" model, tools, state_modifier=\"You are an agent specializing in web search\"\n",
")"
]
},
{
"cell_type": "markdown",
"id": "dcc478f5-4a35-43f8-bf59-9cb71289cd00",
"metadata": {},
"source": [
"## Create the multi-agent graph\n",
"\n",
"We will now create our multi-agent system combining the AutoGen agent with the LangGraph agent. We can do this by creating a graph that routes user query to the appropriate agent and executes the agent"
]
},
{
"cell_type": "code",
"execution_count": null,
"id": "d129e4e1-3766-429a-b806-cde3d8bc0469",
"metadata": {},
"outputs": [],
"source": [
"from typing import Literal, TypedDict\n",
"\n",
"\n",
"class Route(TypedDict):\n",
" \"\"\"Decide where to go next\"\"\"\n",
"\n",
" goto: Literal[\"web_search_assistant\", \"coding_assistant\"]\n",
"\n",
"\n",
"def route(state: MessagesState) -> Literal[\"web_search_assistant\", \"coding_assistant\"]:\n",
" messages = [\n",
" {\n",
" \"role\": \"system\",\n",
" \"content\": \"Based on the conversation so far, decide who to call next: web search assistant or coding assistant.\",\n",
" }\n",
" ] + state[\"messages\"]\n",
" response = model.with_structured_output(Route).invoke(messages)\n",
" return response[\"goto\"]\n",
"\n",
"\n",
"def call_autogen_agent(state: MessagesState):\n",
" last_message = state[\"messages\"][-1]\n",
" response = user_proxy.initiate_chat(autogen_agent, message=last_message.content)\n",
" # get the final response from the agent\n",
" content = response.chat_history[-1][\"content\"]\n",
" return {\"messages\": AIMessage(content=content)}\n",
"\n",
"\n",
"builder = StateGraph(MessagesState)\n",
"builder.add_conditional_edges(START, route)\n",
"builder.add_node(\"coding_assistant\", call_autogen_agent)\n",
"builder.add_node(\"web_search_assistant\", web_search_agent)\n",
"graph = builder.compile()"
]
},
{
"cell_type": "code",
"execution_count": 14,
"id": "c761fc05-e8b6-4905-a793-eb7522d20060",
"metadata": {},
"outputs": [
{
"data": {
"image/jpeg": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gHYSUNDX1BST0ZJTEUAAQEAAAHIAAAAAAQwAABtbnRyUkdCIFhZWiAH4AABAAEAAAAAAABhY3NwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAA9tYAAQAAAADTLQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAlkZXNjAAAA8AAAACRyWFlaAAABFAAAABRnWFlaAAABKAAAABRiWFlaAAABPAAAABR3dHB0AAABUAAAABRyVFJDAAABZAAAAChnVFJDAAABZAAAAChiVFJDAAABZAAAAChjcHJ0AAABjAAAADxtbHVjAAAAAAAAAAEAAAAMZW5VUwAAAAgAAAAcAHMAUgBHAEJYWVogAAAAAAAAb6IAADj1AAADkFhZWiAAAAAAAABimQAAt4UAABjaWFlaIAAAAAAAACSgAAAPhAAAts9YWVogAAAAAAAA9tYAAQAAAADTLXBhcmEAAAAAAAQAAAACZmYAAPKnAAANWQAAE9AAAApbAAAAAAAAAABtbHVjAAAAAAAAAAEAAAAMZW5VUwAAACAAAAAcAEcAbwBvAGcAbABlACAASQBuAGMALgAgADIAMAAxADb/2wBDAAMCAgMCAgMDAwMEAwMEBQgFBQQEBQoHBwYIDAoMDAsKCwsNDhIQDQ4RDgsLEBYQERMUFRUVDA8XGBYUGBIUFRT/2wBDAQMEBAUEBQkFBQkUDQsNFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBT/wAARCACVAY4DASIAAhEBAxEB/8QAHQABAAIDAQEBAQAAAAAAAAAAAAUGAwQHCAIBCf/EAEkQAAEEAQIDBQQFBwoEBwEAAAEAAgMEBQYRBxIhExUxlNMUIlRWCBY2QVEjMlVhdLLRNVJxcnN1gZOhswlCYrQzU4OFkaKx0v/EABkBAQEBAQEBAAAAAAAAAAAAAAABAgQDBf/EAC8RAQABAgIHBwUAAwAAAAAAAAABAhESUQMUMWKRktEEITNBcaGxEyNSYcEy4fD/2gAMAwEAAhEDEQA/AP6poiICIiAiIgIiICIiAiIgIiICIiAiIgIiICLSzGXgwlB9qcPkAIayKJvNJK8nZrGD73E9B/rsOqhBpabUQ7fUU0ksbx7uIhlLa0Q/B3LsZXfjzEt/Bo8T600RMYqptH/bFsmbGoMXUkLJ8lUheOhbJO1pH+BKxfWrC/pih5ln8Vir6M0/Uj7ODBY2Fn82OnG0f/ACy/VXC/oeh5Zn8Fv7P79l7j61YX9MUPMs/in1qwv6YoeZZ/FPqrhf0PQ8sz+CfVXC/oeh5Zn8E+z+/Y7j61YX9MUPMs/in1qwv6YoeZZ/FPqrhf0PQ8sz+CfVXC/oeh5Zn8E+z+/Y7j61YX9MUPMs/ivqPUuIleGMytJ7j4NbYYSf9V8/VXC/oeh5Zn8F8SaRwUzCyTC457T4tdUjI/8AxPs/v2TuSwcHAEEEHqCPvX6qy7RMGNcZ9PSnB2Ny7sYRvVlJ+58Phtv97OV36/FSWCzRy0U0c8BpZGs7s7VQu5uR33Oa7Yc7HDq12w3HQhrg5rc1URbFRN49y2SUREXigiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiCsTEZfiBFXeA6HD022w07/8Ajzukja78N2sjlH/qlWdVmo32PiNkg7fa/ja8kR26EwyStk6/qEsXT9asy6NNtpiNlo/373WRERc6Ob0PpC6EzNnOVsVl5spZw9ezZsNqY+1Ix7YDyy9k8RFsxa4hpERcdyBsoThv9JzTOs+EFfXmVbbwNZsMDrsMuPtubDJKdmRxOMINjckAOiDgSR+KpHCuDNYfinPp/R+E1ZiOH1qHIzZPG6oxxgqY206QOjdQmPV7JXvkcY2ue0A8w5SdhXtMZnW+E+jRpfSGP07rDT+X07PQxmo5amKf7V7EHvZYfj3EETu2Y080fMQ1+46+Ad4q/SB0Bc0Hk9ZR6hYNO4udta/ZkrTMkqSucxoZLC5gkYd5GfnNHRwPh1VT1p9LDS2mpNIyUq+TylDOZd+NfaZh747JjIDK6WJorkzg7xhvJuHBznNLgx23DMroXMZHRHHWnQ0rrKalnbWAt4xmoILFq5eiZLDHM4l5e8kdk4ljyHtZyktaPDv30i6WRrT8N9R0MNkM5U07qaO9fq4mu6xZbXdVsQmRkTfefyulZuGgnbc7dEHXaNyLI0q9qHn7GeNsrO0jdG7lcNxu1wDmnY+BAI+8LOtLC5RubxFLIMr2ajLULJhXuwuhnjDgDyvY7q1w32IPgVuoCrGoNsTqrAZKPZvtcjsZZ8ffY5j3xn9fK9uw/ASO/HrZ1WNYD2vKaYot3MkmRFh2w35WRRveXH8Bzcg/pcF0aD/O3lafhY2rOiIudBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEWKezDWDTNKyIOJDedwG5ALjt/gCf6AVX4NWWM7BDJgcZParWqUlmvkbg9mrB4O0cb2u/Le8eu4jI5Rvv1aCG7qPDS5FlW3SdHHlaEhmqvlJDHEtLXRvI68jmkg9DseV2xLQFhgv4rWeOv4m9WjkMkLq+Qw95rXODHgtcyRnUOY4EjcbtcPAkLLi8ZlGXYL2Ryz5ZPYo4JcfWiYyoJ995Jmbgybk9AHPIDR4bkk5s1prG6gEft1YSSR79nPG90c0f48kjCHN/wIXtTVTMYa+OS+qlD6NnCdpBHDfSwI8CMTACP/qvqH6OPCqtNHLFw50vHLG4OY9uJgBaR1BB5VPfUZ7ARDqTPQs+5vtbZNv8AF7HH/VPqTY+as9/nQ+ktfT0f5+0lozWhFV/qTY+as9/nQ+kn1JsfNWe/zofST6ej/P2ktGa0Iqv9SbHzVnv86H0k+pNj5qz3+dD6SfT0f5+0lozRea4C8N9R5W1k8roPTuRyNp5knt2sZDJLK4+LnOLdyf1laZ+jZwnPjw30sf8A2iD/APlWD6k2PmrPf50PpL8+o8zuj9T557fvb7RG3f8AxbGD/qn09H+ftJaM2zTqad4aadrY+hUqYPEQFza1CjAGN5nOLyyKJg3c5zi48rQSST0K+sHjrFnIzZzJRdhcmjENeqTuasG4dyuIJBkc7q/l6dGtBdyczsuJ0ji8PaNuKF894gg3Lkz7E+x8QHvJLQenut2HQdOgWzksbZuXMfPXydmg2tKXywQtjdHaYQQWSczSQPAgsLSCB1IJBk1U0xMUefmeiQRVypl85jhjq+YxYuyze0GzkMRsa8AZ1jLo3u7XeRvTZgk2cNidiCpPDZ+hqCjXt0LLZ4Z4hMwEFj+UkjcscA5vUEbEAggjxC8ESCIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICKByuqDDNbo4qjLlsvFUFqOAB0UDw53I0OsFpY0khxIG7g1pPKem+O1pq5nHXY8xkpHY+Z9d8NLHukqmHkG72umY8PkD3+I91paA0tILuYNm/q3HUpmwMfLkLPtkVGSDHxOsvgkeOYdqGA9k0N94ufygDbr1AOCH6x5OeN8oqYOvBfk5omk25LdVo2YebZghc53UgCTZoA3BceWZqUK1ASitXiriWR00giYG873fnOO3i4/eT1KzoILFaLxeMdj5pInZTI0O29nyeTd7Tbj7Ygyhsrt3MDtmgtbs3ZrQAA0ATqIgIiICIiAiIgIiICIiAiIgKLyumMZmZnWLFRovGrLTZfgJitRRSbc7Y5mbPZuQ0+64dWtPiARKIgrMlDUGBrSHG2os5DXoRw16GScY5pZ2HYvfaHN+c3xBjPvAHcAkLa+uFCvYuw5HtsQaYgMk9+Mw1nGYhrGxzn8m93OeQta4kOLdwOZvNOLBeo1snUlq3K8VurM0skgnYHse38C09CP6UGdFAWNNWK1mzaxGTno2LVuKxYZac+1A5rRyvYyNz9oudv/l8o5gHEEl3Mg1NPUtR1szjpMdLZvSVKclcuswzMA5o5HvawdlzN3Gz9gHAtDnbtLgn0XzHI2WNr2OD2OAc1zTuCD4EFfSAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiINe9frYyrJZuWYqlaPbnmneGMbudhuT0HUgKHGPvagkZLkDLjqTHWYX4xj2Pbbjd7kb5HAbt90OcGtI27Qc25b0x5uzFZ1jgMTJerM54bOQOOmrdo+yIXQtEjXnozs3zxn+cS5u3QFWRBr4/H1cTQrUaNaGlSrRthgrV4xHHFG0bNY1o6NaAAAB0AC2ERAREQEREBERAREQEREBERAREQEREBERAREQEREFbOnX6arNfpuNkFarWnEWAjDIas8rndo083ITEebmG7fd2kO7Ts3lmcdlK+TjkMEjHSQuEc8Ika58EnK1xjfykgOAc07b/eD4ELbVbs2Ysdr/HwC9WruyVGw51D2b8tZfE6HaUSj7mNeWlrvHtGkbcp3CyIiICIiAiIgIiICIiAi/HODGlziGtA3JJ6AKlHWGbywFjC4yica/rDYyFl8ckzfueI2xnlafEbncjxAXto9FVpb4ei2uuyKkd+6w+Awfm5vTTv3WHwGD83N6a9tVrzjjBZd0VI791h8Bg/NzemnfusPgMH5ub001WvOOMFl3RUjv3WHwGD83N6ad+6w+Awfm5vTTVa844wWXdFSO/dYfAYPzc3pp37rD4DB+bm9NNVrzjjBZd0VI791h8Bg/NzemnfusPgMH5ub001WvOOMFnlDiR/xDMrojj1c0e3htPblxdm3iG1vb2tmvyPmiFedjuxJY1zGOPIN+btmnf3Bv7dxstmfHVZbtdlS4+Jjp68cvatikIHM0P2HMAdxvsN9t9gvOOpfo/S6o4/YHLine truncated
"text/plain": [
"<IPython.core.display.Image object>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"from IPython.display import display, Image\n",
"\n",
"display(Image(graph.get_graph().draw_mermaid_png()))"
]
},
{
"cell_type": "markdown",
"id": "23d629c3-1d6b-40af-adf6-915e15657566",
"metadata": {},
"source": [
"## Run the graph\n",
"\n",
"We can now run the graph. We can see in the examples below how we first route to the appropriate agent, then respond with the subagent."
]
},
{
"cell_type": "code",
"execution_count": 15,
"id": "b528ddb9-ec12-433c-a174-33d94dc49d80",
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"\u001b[33muser_proxy\u001b[0m (to assistant):\n",
"\n",
"Find numbers between 10 and 30 in fibonacci sequence\n",
"\n",
"--------------------------------------------------------------------------------\n",
"\u001b[33massistant\u001b[0m (to user_proxy):\n",
"\n",
"To find numbers between 10 and 30 in the Fibonacci sequence, we can generate the Fibonacci sequence and check which numbers fall within this range. Here's a plan:\n",
"\n",
"1. Generate Fibonacci numbers starting from 0.\n",
"2. Continue generating until the numbers exceed 30.\n",
"3. Collect and print the numbers that are between 10 and 30.\n",
"\n",
"Let's implement this in Python:\n",
"\n",
"```python\n",
"# filename: fibonacci_range.py\n",
"\n",
"def fibonacci_sequence():\n",
" a, b = 0, 1\n",
" while a <= 30:\n",
" if 10 <= a <= 30:\n",
" print(a)\n",
" a, b = b, a + b\n",
"\n",
"fibonacci_sequence()\n",
"```\n",
"\n",
"Save this code in a file named `fibonacci_range.py` and execute it. It will print the Fibonacci numbers between 10 and 30. TERMINATE\n",
"\n",
"--------------------------------------------------------------------------------\n",
"{'coding_assistant': {'messages': AIMessage(content=\"To find numbers between 10 and 30 in the Fibonacci sequence, we can generate the Fibonacci sequence and check which numbers fall within this range. Here's a plan:\\n\\n1. Generate Fibonacci numbers starting from 0.\\n2. Continue generating until the numbers exceed 30.\\n3. Collect and print the numbers that are between 10 and 30.\\n\\nLet's implement this in Python:\\n\\n```python\\n# filename: fibonacci_range.py\\n\\ndef fibonacci_sequence():\\n a, b = 0, 1\\n while a <= 30:\\n if 10 <= a <= 30:\\n print(a)\\n a, b = b, a + b\\n\\nfibonacci_sequence()\\n```\\n\\nSave this code in a file named `fibonacci_range.py` and execute it. It will print the Fibonacci numbers between 10 and 30. TERMINATE\", additional_kwargs={}, response_metadata={}, id='e95a8aa1-5aa8-4ff2-ba74-2b2993ea0a5a')}}\n"
]
}
],
"source": [
"for chunk in graph.stream(\n",
" {\n",
" \"messages\": [\n",
" {\n",
" \"role\": \"user\",\n",
" \"content\": \"Find numbers between 10 and 30 in fibonacci sequence\",\n",
" }\n",
" ]\n",
" }\n",
"):\n",
" print(chunk)"
]
},
{
"cell_type": "code",
"execution_count": 16,
"id": "b120f9ba-f640-482b-a457-1893d6db5543",
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"(('web_search_assistant:d08ae326-b6b2-1749-e8ea-4d308f22d819',), {'agent': {'messages': [AIMessage(content='', additional_kwargs={'tool_calls': [{'id': 'call_wZ5w5uO733Cc4CvWbc4Axq5F', 'function': {'arguments': '{\"query\":\"current weather in New York City\"}', 'name': 'tavily_search_results_json'}, 'type': 'function'}], 'refusal': None}, response_metadata={'token_usage': {'completion_tokens': 23, 'prompt_tokens': 96, 'total_tokens': 119, 'completion_tokens_details': {'accepted_prediction_tokens': 0, 'audio_tokens': 0, 'reasoning_tokens': 0, 'rejected_prediction_tokens': 0}, 'prompt_tokens_details': {'audio_tokens': 0, 'cached_tokens': 0}}, 'model_name': 'gpt-4o-2024-08-06', 'system_fingerprint': 'fp_45cf54deae', 'finish_reason': 'tool_calls', 'logprobs': None}, id='run-0658af11-b90b-407c-a6a5-6a3b4a9f61e0-0', tool_calls=[{'name': 'tavily_search_results_json', 'args': {'query': 'current weather in New York City'}, 'id': 'call_wZ5w5uO733Cc4CvWbc4Axq5F', 'type': 'tool_call'}], usage_metadata={'input_tokens': 96, 'output_tokens': 23, 'total_tokens': 119, 'input_token_details': {'audio': 0, 'cache_read': 0}, 'output_token_details': {'audio': 0, 'reasoning': 0}})]}})\n",
"(('web_search_assistant:d08ae326-b6b2-1749-e8ea-4d308f22d819',), {'tools': {'messages': [ToolMessage(content='[{\"url\": \"https://www.weatherapi.com/\", \"content\": \"{\\'location\\': {\\'name\\': \\'New York\\', \\'region\\': \\'New York\\', \\'country\\': \\'United States of America\\', \\'lat\\': 40.714, \\'lon\\': -74.006, \\'tz_id\\': \\'America/New_York\\', \\'localtime_epoch\\': 1732021037, \\'localtime\\': \\'2024-11-19 07:57\\'}, \\'current\\': {\\'last_updated_epoch\\': 1732020300, \\'last_updated\\': \\'2024-11-19 07:45\\', \\'temp_c\\': 8.3, \\'temp_f\\': 46.9, \\'is_day\\': 1, \\'condition\\': {\\'text\\': \\'Sunny\\', \\'icon\\': \\'//cdn.weatherapi.com/weather/64x64/day/113.png\\', \\'code\\': 1000}, \\'wind_mph\\': 7.2, \\'wind_kph\\': 11.5, \\'wind_degree\\': 332, \\'wind_dir\\': \\'NNW\\', \\'pressure_mb\\': 1016.0, \\'pressure_in\\': 29.99, \\'precip_mm\\': 0.0, \\'precip_in\\': 0.0, \\'humidity\\': 60, \\'cloud\\': 0, \\'feelslike_c\\': 6.3, \\'feelslike_f\\': 43.4, \\'windchill_c\\': 4.3, \\'windchill_f\\': 39.8, \\'heatindex_c\\': 7.0, \\'heatindex_f\\': 44.5, \\'dewpoint_c\\': 2.7, \\'dewpoint_f\\': 36.8, \\'vis_km\\': 16.0, \\'vis_miles\\': 9.0, \\'uv\\': 0.0, \\'gust_mph\\': 10.0, \\'gust_kph\\': 16.2}}\"}]', name='tavily_search_results_json', id='e955ebe9-631f-4dd1-b0a4-ee6a3caeba9f', tool_call_id='call_wZ5w5uO733Cc4CvWbc4Axq5F', artifact={'query': 'current weather in New York City', 'follow_up_questions': None, 'answer': None, 'images': [], 'results': [{'title': 'Weather in New York City', 'url': 'https://www.weatherapi.com/', 'content': \"{'location': {'name': 'New York', 'region': 'New York', 'country': 'United States of America', 'lat': 40.714, 'lon': -74.006, 'tz_id': 'America/New_York', 'localtime_epoch': 1732021037, 'localtime': '2024-11-19 07:57'}, 'current': {'last_updated_epoch': 1732020300, 'last_updated': '2024-11-19 07:45', 'temp_c': 8.3, 'temp_f': 46.9, 'is_day': 1, 'condition': {'text': 'Sunny', 'icon': '//cdn.weatherapi.com/weather/64x64/day/113.png', 'code': 1000}, 'wind_mph': 7.2, 'wind_kph': 11.5, 'wind_degree': 332, 'wind_dir': 'NNW', 'pressure_mb': 1016.0, 'pressure_in': 29.99, 'precip_mm': 0.0, 'precip_in': 0.0, 'humidity': 60, 'cloud': 0, 'feelslike_c': 6.3, 'feelslike_f': 43.4, 'windchill_c': 4.3, 'windchill_f': 39.8, 'heatindex_c': 7.0, 'heatindex_f': 44.5, 'dewpoint_c': 2.7, 'dewpoint_f': 36.8, 'vis_km': 16.0, 'vis_miles': 9.0, 'uv': 0.0, 'gust_mph': 10.0, 'gust_kph': 16.2}}\", 'score': 0.9997275, 'raw_content': None}], 'response_time': 3.24})]}})\n",
"(('web_search_assistant:d08ae326-b6b2-1749-e8ea-4d308f22d819',), {'agent': {'messages': [AIMessage(content='The current weather in New York City is sunny with a temperature of 8.3°C (46.9°F). The wind is coming from the north-northwest at 7.2 mph (11.5 kph), and the humidity level is 60%. The weather feels slightly cooler at 6.3°C (43.4°F) due to the wind chill.', additional_kwargs={'refusal': None}, response_metadata={'token_usage': {'completion_tokens': 79, 'prompt_tokens': 535, 'total_tokens': 614, 'completion_tokens_details': {'accepted_prediction_tokens': 0, 'audio_tokens': 0, 'reasoning_tokens': 0, 'rejected_prediction_tokens': 0}, 'prompt_tokens_details': {'audio_tokens': 0, 'cached_tokens': 0}}, 'model_name': 'gpt-4o-2024-08-06', 'system_fingerprint': 'fp_159d8341cc', 'finish_reason': 'stop', 'logprobs': None}, id='run-43d275f1-aacb-44f4-bdd0-8233c3765699-0', usage_metadata={'input_tokens': 535, 'output_tokens': 79, 'total_tokens': 614, 'input_token_details': {'audio': 0, 'cache_read': 0}, 'output_token_details': {'audio': 0, 'reasoning': 0}})]}})\n",
"((), {'web_search_assistant': {'messages': [HumanMessage(content=\"what's the weather in nyc?\", additional_kwargs={}, response_metadata={}, id='756466d3-18ce-4b8e-b4fc-ee59932ce9f4'), AIMessage(content='', additional_kwargs={'tool_calls': [{'id': 'call_wZ5w5uO733Cc4CvWbc4Axq5F', 'function': {'arguments': '{\"query\":\"current weather in New York City\"}', 'name': 'tavily_search_results_json'}, 'type': 'function'}], 'refusal': None}, response_metadata={'token_usage': {'completion_tokens': 23, 'prompt_tokens': 96, 'total_tokens': 119, 'completion_tokens_details': {'accepted_prediction_tokens': 0, 'audio_tokens': 0, 'reasoning_tokens': 0, 'rejected_prediction_tokens': 0}, 'prompt_tokens_details': {'audio_tokens': 0, 'cached_tokens': 0}}, 'model_name': 'gpt-4o-2024-08-06', 'system_fingerprint': 'fp_45cf54deae', 'finish_reason': 'tool_calls', 'logprobs': None}, id='run-0658af11-b90b-407c-a6a5-6a3b4a9f61e0-0', tool_calls=[{'name': 'tavily_search_results_json', 'args': {'query': 'current weather in New York City'}, 'id': 'call_wZ5w5uO733Cc4CvWbc4Axq5F', 'type': 'tool_call'}], usage_metadata={'input_tokens': 96, 'output_tokens': 23, 'total_tokens': 119, 'input_token_details': {'audio': 0, 'cache_read': 0}, 'output_token_details': {'audio': 0, 'reasoning': 0}}), ToolMessage(content='[{\"url\": \"https://www.weatherapi.com/\", \"content\": \"{\\'location\\': {\\'name\\': \\'New York\\', \\'region\\': \\'New York\\', \\'country\\': \\'United States of America\\', \\'lat\\': 40.714, \\'lon\\': -74.006, \\'tz_id\\': \\'America/New_York\\', \\'localtime_epoch\\': 1732021037, \\'localtime\\': \\'2024-11-19 07:57\\'}, \\'current\\': {\\'last_updated_epoch\\': 1732020300, \\'last_updated\\': \\'2024-11-19 07:45\\', \\'temp_c\\': 8.3, \\'temp_f\\': 46.9, \\'is_day\\': 1, \\'condition\\': {\\'text\\': \\'Sunny\\', \\'icon\\': \\'//cdn.weatherapi.com/weather/64x64/day/113.png\\', \\'code\\': 1000}, \\'wind_mph\\': 7.2, \\'wind_kph\\': 11.5, \\'wind_degree\\': 332, \\'wind_dir\\': \\'NNW\\', \\'pressure_mb\\': 1016.0, \\'pressure_in\\': 29.99, \\'precip_mm\\': 0.0, \\'precip_in\\': 0.0, \\'humidity\\': 60, \\'cloud\\': 0, \\'feelslike_c\\': 6.3, \\'feelslike_f\\': 43.4, \\'windchill_c\\': 4.3, \\'windchill_f\\': 39.8, \\'heatindex_c\\': 7.0, \\'heatindex_f\\': 44.5, \\'dewpoint_c\\': 2.7, \\'dewpoint_f\\': 36.8, \\'vis_km\\': 16.0, \\'vis_miles\\': 9.0, \\'uv\\': 0.0, \\'gust_mph\\': 10.0, \\'gust_kph\\': 16.2}}\"}]', name='tavily_search_results_json', id='e955ebe9-631f-4dd1-b0a4-ee6a3caeba9f', tool_call_id='call_wZ5w5uO733Cc4CvWbc4Axq5F', artifact={'query': 'current weather in New York City', 'follow_up_questions': None, 'answer': None, 'images': [], 'results': [{'title': 'Weather in New York City', 'url': 'https://www.weatherapi.com/', 'content': \"{'location': {'name': 'New York', 'region': 'New York', 'country': 'United States of America', 'lat': 40.714, 'lon': -74.006, 'tz_id': 'America/New_York', 'localtime_epoch': 1732021037, 'localtime': '2024-11-19 07:57'}, 'current': {'last_updated_epoch': 1732020300, 'last_updated': '2024-11-19 07:45', 'temp_c': 8.3, 'temp_f': 46.9, 'is_day': 1, 'condition': {'text': 'Sunny', 'icon': '//cdn.weatherapi.com/weather/64x64/day/113.png', 'code': 1000}, 'wind_mph': 7.2, 'wind_kph': 11.5, 'wind_degree': 332, 'wind_dir': 'NNW', 'pressure_mb': 1016.0, 'pressure_in': 29.99, 'precip_mm': 0.0, 'precip_in': 0.0, 'humidity': 60, 'cloud': 0, 'feelslike_c': 6.3, 'feelslike_f': 43.4, 'windchill_c': 4.3, 'windchill_f': 39.8, 'heatindex_c': 7.0, 'heatindex_f': 44.5, 'dewpoint_c': 2.7, 'dewpoint_f': 36.8, 'vis_km': 16.0, 'vis_miles': 9.0, 'uv': 0.0, 'gust_mph': 10.0, 'gust_kph': 16.2}}\", 'score': 0.9997275, 'raw_content': None}], 'response_time': 3.24}), AIMessage(content='The current weather in New York City is sunny with a temperature of 8.3°C (46.9°F). The wind is coming from the north-northwest at 7.2 mph (11.5 kph), and the humidity level is 60%. The weather feels slightly cooler at 6.3°C (43.4°F) due to the wind chill.', additional_kwargs={'refusal': None}, response_metadata={'token_usage': {'completion_tokens': 79, 'prompt_tokens': 535, 'total_tokens': 614, 'completion_tokens_details': {'accepted_prediction_tokens': 0, 'audio_tokens': 0, 'reasoning_tokens': 0, 'rejected_prediction_tokens': 0}, 'prompt_tokens_details': {'audio_tokens': 0, 'cached_tokens': 0}}, 'model_name': 'gpt-4o-2024-08-06', 'system_fingerprint': 'fp_159d8341cc', 'finish_reason': 'stop', 'logprobs': None}, id='run-43d275f1-aacb-44f4-bdd0-8233c3765699-0', usage_metadata={'input_tokens': 535, 'output_tokens': 79, 'total_tokens': 614, 'input_token_details': {'audio': 0, 'cache_read': 0}, 'output_token_details': {'audio': 0, 'reasoning': 0}})]}})\n"
]
}
],
"source": [
"for chunk in graph.stream(\n",
" {\"messages\": [{\"role\": \"user\", \"content\": \"what's the weather in nyc?\"}]},\n",
" subgraphs=True,\n",
"):\n",
" print(chunk)"
]
}
],
"metadata": {
"kernelspec": {
"display_name": "Python 3 (ipykernel)",
"language": "python",
"name": "python3"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.12.3"
}
},
"nbformat": 4,
"nbformat_minor": 5
}
@@ -0,0 +1,171 @@
{
"cells": [
{
"cell_type": "markdown",
"id": "8381b6e0-29a6-48c5-b451-5d2549351249",
"metadata": {},
"source": [
"# How to use LangGraph Platform to deploy CrewAI, AutoGen, and other frameworks\n",
"\n",
"[LangGraph Platform](https://langchain-ai.github.io/langgraph/concepts/langgraph_platform/) provides infrastructure for deploying agents. This integrates seamlessly with LangGraph, but can also work with other frameworks. The way to make this work is to wrap the agent in a single LangGraph node, and have that be the entire graph.\n",
"\n",
"Doing so will allow you to deploy to LangGraph Platform, and allows you to get a lot of the [benefits](https://langchain-ai.github.io/langgraph/concepts/langgraph_platform/). You get horizontally scalable infrastructure, a task queue to handle bursty operations, a persistence layer to power short term memory, and long term memory support.\n",
"\n",
"In this guide we show how to do this with an AutoGen agent, but this method should work for agents defined in other frameworks like CrewAI, LlamaIndex, and others as well."
]
},
{
"cell_type": "markdown",
"id": "1113cb16-b538-448c-924c-85731ce96ebd",
"metadata": {},
"source": [
"## Setup"
]
},
{
"cell_type": "code",
"execution_count": 10,
"id": "f05993fa-9d03-4f45-bc13-0a8d87260d86",
"metadata": {
"scrolled": true
},
"outputs": [],
"source": [
"%pip install autogen langgraph"
]
},
{
"cell_type": "code",
"execution_count": null,
"id": "f4e0ca12-1714-4776-a30a-9527e519799b",
"metadata": {},
"outputs": [],
"source": [
"import getpass\n",
"import os\n",
"\n",
"\n",
"def _set_env(var: str):\n",
" if not os.environ.get(var):\n",
" os.environ[var] = getpass.getpass(f\"{var}: \")\n",
"\n",
"\n",
"_set_env(\"OPENAI_API_KEY\")"
]
},
{
"cell_type": "markdown",
"id": "1926bbc3-6b06-41e0-9604-860a2bbf8fa3",
"metadata": {},
"source": [
"## Define autogen agent\n",
"\n",
"Here we define our AutoGen agent. From https://github.com/microsoft/autogen/blob/0.2/notebook/agentchat_web_info.ipynb"
]
},
{
"cell_type": "code",
"execution_count": null,
"id": "d4a14dc7-d565-4207-8788-525f85b9fb27",
"metadata": {},
"outputs": [],
"source": [
"import autogen\n",
"import os\n",
"\n",
"config_list = [{\"model\": \"gpt-4o\", \"api_key\": os.environ[\"OPENAI_API_KEY\"]}]\n",
"\n",
"llm_config = {\n",
" \"timeout\": 600,\n",
" \"cache_seed\": 42,\n",
" \"config_list\": config_list,\n",
" \"temperature\": 0,\n",
"}\n",
"\n",
"autogen_agent = autogen.AssistantAgent(\n",
" name=\"assistant\",\n",
" llm_config=llm_config,\n",
")\n",
"\n",
"user_proxy = autogen.UserProxyAgent(\n",
" name=\"user_proxy\",\n",
" human_input_mode=\"NEVER\",\n",
" max_consecutive_auto_reply=10,\n",
" is_termination_msg=lambda x: x.get(\"content\", \"\").rstrip().endswith(\"TERMINATE\"),\n",
" code_execution_config={\n",
" \"work_dir\": \"web\",\n",
" \"use_docker\": False,\n",
" }, # Please set use_docker=True if docker is available to run the generated code. Using docker is safer than running the generated code directly.\n",
" llm_config=llm_config,\n",
" system_message=\"Reply TERMINATE if the task has been solved at full satisfaction. Otherwise, reply CONTINUE, or the reason why the task is not solved yet.\",\n",
")"
]
},
{
"cell_type": "markdown",
"id": "b1170836-f23e-4e4c-ab83-ce791cd7fbd2",
"metadata": {},
"source": [
"## Wrap in LangGraph\n",
"\n",
"We now wrap the AutoGen agent in a single LangGraph node, and make that the entire graph.\n",
"The main thing this involves is defining an Input and Output schema for the node, which you would need to do if deploying this manually, so it's no extra work"
]
},
{
"cell_type": "code",
"execution_count": 11,
"id": "7b417c16-ff4e-4d5c-a9a9-0aaeeef6ede5",
"metadata": {},
"outputs": [],
"source": [
"from langgraph.graph import StateGraph, MessagesState\n",
"\n",
"\n",
"def call_autogen_agent(state: MessagesState):\n",
" last_message = state[\"messages\"][-1]\n",
" response = user_proxy.initiate_chat(autogen_agent, message=last_message.content)\n",
" # get the final response from the agent\n",
" content = response.chat_history[-1][\"content\"]\n",
" return {\"messages\": {\"role\": \"assistant\", \"content\": content}}\n",
"\n",
"\n",
"graph = StateGraph(MessagesState)\n",
"graph.add_node(call_autogen_agent)\n",
"graph.set_entry_point(\"call_autogen_agent\")\n",
"graph = graph.compile()"
]
},
{
"cell_type": "markdown",
"id": "f6a18377-ac29-478f-a76a-b213f1a3c85d",
"metadata": {},
"source": [
"## Deploy with LangGraph Platform\n",
"\n",
"You can now deploy this as you normally would with LangGraph Platform. See [these instructions](https://langchain-ai.github.io/langgraph/concepts/deployment_options/) for more details."
]
}
],
"metadata": {
"kernelspec": {
"display_name": "Python 3 (ipykernel)",
"language": "python",
"name": "python3"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.12.3"
}
},
"nbformat": 4,
"nbformat_minor": 5
}
+1 -1
View File
@@ -345,7 +345,7 @@
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.11.4"
"version": "3.11.1"
}
},
"nbformat": 4,
@@ -41,6 +41,9 @@
" <p>\n",
" Support for the <code><a href=\"https://langchain-ai.github.io/langgraph/reference/store/#langgraph.store.base.BaseStore\">Store</a></code> API that is used in this guide was added in LangGraph <code>v0.2.32</code>.\n",
" </p>\n",
" <p>\n",
" Support for <b>index</b> and <b>query</b> arguments of the <code><a href=\"https://langchain-ai.github.io/langgraph/reference/store/#langgraph.store.base.BaseStore\">Store</a></code> API that is used in this guide was added in LangGraph <code>v0.2.54</code>.\n",
" </p>\n",
"</div>\n",
"\n",
"## Setup\n",
@@ -114,7 +117,7 @@
"\n",
"Importantly, to determine the user, we will be passing `user_id` via the config keyword argument of the node function.\n",
"\n",
"Let's first define an `InMemoryStore` which is already populated with some memories about the users."
"Let's first define an `InMemoryStore` already populated with some memories about the users."
]
},
{
@@ -125,8 +128,14 @@
"outputs": [],
"source": [
"from langgraph.store.memory import InMemoryStore\n",
"from langchain_openai import OpenAIEmbeddings\n",
"\n",
"in_memory_store = InMemoryStore()"
"in_memory_store = InMemoryStore(\n",
" index={\n",
" \"embed\": OpenAIEmbeddings(model=\"text-embedding-3-small\"),\n",
" \"dims\": 1536,\n",
" }\n",
")"
]
},
{
@@ -163,7 +172,7 @@
"def call_model(state: MessagesState, config: RunnableConfig, *, store: BaseStore):\n",
" user_id = config[\"configurable\"][\"user_id\"]\n",
" namespace = (\"memories\", user_id)\n",
" memories = store.search(namespace)\n",
" memories = store.search(namespace, query=str(state[\"messages\"][-1].content))\n",
" info = \"\\n\".join([d.value[\"data\"] for d in memories])\n",
" system_msg = f\"You are a helpful assistant talking to the user. User info: {info}\"\n",
"\n",
+7 -3
View File
@@ -17,14 +17,18 @@ You will need to do the following:
2. Build a docker image with the [LangGraph Server](../concepts/langgraph_server.md) using the [LangGraph CLI](../concepts/langgraph_cli.md).
3. Deploy a web server that will run the docker image and pass in the necessary environment variables.
## Helm Chart
If you would like to deploy LangGraph Cloud on Kubernetes, you can use this [Helm chart](https://github.com/langchain-ai/helm/blob/main/charts/langgraph-cloud/README.md).
## Environment Variables
You will eventually need to pass in the following environment variables to the LangGraph Deploy server:
- `REDIS_URI`: Connection details to a Redis instance. Redis will be used as a pub-sub broker to enable streaming real time output from background runs.
- `DATABASE_URI`: Postgres connection details. Postgres will be used to store assistants, threads, runs, persist thread state and long term memory, and to manage the state of the background task queue with 'exactly once' semantics.
- `LANGSMITH_API_KEY`: (If using [Self-Hosted Lite]) LangSmith API key. This will be used to authenticate ONCE at server start up.
- `LANGGRAPH_CLOUD_LICENSE_KEY`: (If using Self-Hosted Enterprise) LangGraph Platform license key. This will be used to authenticate ONCE at server start up.
- `LANGSMITH_API_KEY`: (If using [Self-Hosted Lite](../concepts/deployment_options.md#self-hosted-lite)) LangSmith API key. This will be used to authenticate ONCE at server start up.
- `LANGGRAPH_CLOUD_LICENSE_KEY`: (If using [Self-Hosted Enterprise](../concepts/deployment_options.md#self-hosted-enterprise)) LangGraph Platform license key. This will be used to authenticate ONCE at server start up.
## Build the Docker Image
@@ -70,7 +74,7 @@ If you want to run this quickly without setting up a separate Redis and Postgres
* You need to replace `my-image` with the name of the image you built in the previous step (from `langgraph build`).
and you should provide appropriate values for `REDIS_URI`, `DATABASE_URI`, and `LANGSMITH_API_KEY`.
* If your application requires additional environment variables, you can pass them in a similar way.
* If using Self-Hosted Enterprise, you must provide `LANGGRAPH_CLOUD_LICENSE_KEY` as an additional environment variable.
* If using [Self-Hosted Enterprise](../concepts/deployment_options.md#self-hosted-enterprise), you must provide `LANGGRAPH_CLOUD_LICENSE_KEY` as an additional environment variable.
### Using Docker Compose
+15 -12
View File
@@ -39,8 +39,9 @@ LangGraph makes it easy to manage conversation [memory](../concepts/memory.md) i
- [How to manage conversation history](memory/manage-conversation-history.ipynb)
- [How to delete messages](memory/delete-messages.ipynb)
- [How to add summary conversation memory](memory/add-summary-conversation-history.ipynb)
- [Add long-term memory (cross-thread)](cross-thread-persistence.ipynb)
### Human in the Loop
### Human-in-the-loop
[Human-in-the-loop](../concepts/human_in_the_loop.md) functionality allows
you to involve humans in the decision-making process of your graph. These how-to guides show how to implement human-in-the-loop workflows in your graph.
@@ -70,7 +71,7 @@ you to involve humans in the decision-making process of your graph. These how-to
### Tool calling
[Tool calling](https://python.langchain.com/docs/concepts/tool_calling/) is a type of chat model API that accepts tool schemas, along with messages, as input and returns invocations of those tools as part of the output message.
[Tool calling](https://python.langchain.com/docs/concepts/tool_calling/) is a type of chat model API that accepts tool schemas, along with messages, as input and returns invocations of those tools as part of the output message.
These how-to guides show common patterns for tool calling with LangGraph:
@@ -99,11 +100,11 @@ These how-to guides show common patterns for tool calling with LangGraph:
- [How to run graph asynchronously](async.ipynb)
- [How to visualize your graph](visualization.ipynb)
- [How to add runtime configuration to your graph](configuration.ipynb)
- [How to use a Pydantic model as your state](state-model.ipynb)
- [How to add node retries](node-retries.ipynb)
- [How to force function calling agent to structure output](react-agent-structured-output.ipynb)
- [How to pass custom LangSmith run ID for graph runs](run-id-langsmith.ipynb)
- [How to return state before hitting recursion limit](return-when-recursion-limit-hits.ipynb)
- [How to integrate LangGraph with AutoGen, CrewAI, and other frameworks](autogen-integration.ipynb)
### Prebuilt ReAct Agent
@@ -123,7 +124,7 @@ These guides show how to use the prebuilt ReAct agent:
This section includes how-to guides for LangGraph Platform.
LangGraph Platform is a commercial solution for deploying agentic applications in production, built on the open-source LangGraph framework.
LangGraph Platform is a commercial solution for deploying agentic applications in production, built on the open-source LangGraph framework.
The LangGraph Platform offers a few different deployment options described in the [deployment options guide](../concepts/deployment_options.md).
@@ -139,9 +140,11 @@ Learn how to set up your app for deployment to LangGraph Platform:
- [How to set up app for deployment (requirements.txt)](../cloud/deployment/setup.md)
- [How to set up app for deployment (pyproject.toml)](../cloud/deployment/setup_pyproject.md)
- [How to set up app for deployment (JavaScript)](../cloud/deployment/setup_javascript.md)
- [How to add semantic search](../cloud/deployment/semantic_search.md)
- [How to customize Dockerfile](../cloud/deployment/custom_docker.md)
- [How to test locally](../cloud/deployment/test_locally.md)
- [How to rebuild graph at runtime](../cloud/deployment/graph_rebuild.md)
- [How to use LangGraph Platform to deploy CrewAI, AutoGen, and other frameworks](autogen-langgraph-platform.ipynb)
### Deployment
@@ -149,7 +152,8 @@ LangGraph applications can be deployed using LangGraph Cloud, which provides a r
- [How to deploy to LangGraph cloud](../cloud/deployment/cloud.md)
- [How to deploy to a self-hosted environment](./deploy-self-hosted.md)
- [How to interact with the deployment using RemoteGraph](./use-remote-graph.md)
- [How to interact with the deployment using RemoteGraph](./use-remote-graph.md)
### Assistants
[Assistants](../concepts/assistants.md) is a configured instance of a template.
@@ -164,7 +168,7 @@ LangGraph applications can be deployed using LangGraph Cloud, which provides a r
### Runs
LangGraph Cloud supports multiple types of runs besides streaming runs.
LangGraph Platform supports multiple types of runs besides streaming runs.
- [How to run an agent in the background](../cloud/how-tos/background_run.md)
- [How to run multiple agents in the same thread](../cloud/how-tos/same-thread.md)
@@ -184,7 +188,7 @@ Streaming the results of your LLM application is vital for ensuring a good user
### Human-in-the-loop
When creating complex graphs, leaving every decision up to the LLM can be dangerous, especially when the decisions involve invoking certain tools or accessing specific documents. To remedy this, LangGraph allows you to insert human-in-the-loop behavior to ensure your graph does not have undesired outcomes. Read more about the different ways you can add human-in-the-loop capabilities to your LangGraph Cloud projects in these how-to guides:
When designing complex graphs, relying entirely on the LLM for decision-making can be risky, particularly when it involves tools that interact with files, APIs, or databases. These interactions may lead to unintended data access or modifications, depending on the use case. To mitigate these risks, LangGraph allows you to integrate human-in-the-loop behavior, ensuring your LLM applications operate as intended without undesirable outcomes.
- [How to add a breakpoint](../cloud/how-tos/human_in_the_loop_breakpoint.md)
- [How to wait for user input](../cloud/how-tos/human_in_the_loop_user_input.md)
@@ -194,7 +198,7 @@ When creating complex graphs, leaving every decision up to the LLM can be danger
### Double-texting
Graph execution can take a while, and sometimes users may change their mind about the input they wanted to send before their original input has finished running. For example, a user might notice a typo in their original request and will edit the prompt and resend it. Deciding what to do in these cases is important for ensuring a smooth user experience and preventing your graphs from behaving in unexpected ways. The following how-to guides provide information on the various options LangGraph Cloud gives you for dealing with double-texting:
Graph execution can take a while, and sometimes users may change their mind about the input they wanted to send before their original input has finished running. For example, a user might notice a typo in their original request and will edit the prompt and resend it. Deciding what to do in these cases is important for ensuring a smooth user experience and preventing your graphs from behaving in unexpected ways.
- [How to use the interrupt option](../cloud/how-tos/interrupt_concurrent.md)
- [How to use the rollback option](../cloud/how-tos/rollback_concurrent.md)
@@ -214,8 +218,9 @@ Graph execution can take a while, and sometimes users may change their mind abou
LangGraph Studio is a built-in UI for visualizing, testing, and debugging your agents.
- [How to connect to a LangGraph Cloud deployment](../cloud/how-tos/test_deployment.md)
- [How to connect to a local deployment](../cloud/how-tos/test_local_deployment.md)
- [How to test your graph in LangGraph Studio](../cloud/how-tos/invoke_studio.md)
- [How to connect to a local dev server](../how-tos/local-studio.md)
- [How to connect to a local deployment (Docker)](../cloud/how-tos/test_local_deployment.md)
- [How to test your graph in LangGraph Studio (MacOS only)](../cloud/how-tos/invoke_studio.md)
- [How to interact with threads in LangGraph Studio](../cloud/how-tos/threads_studio.md)
## Troubleshooting
@@ -227,5 +232,3 @@ These are the guides for resolving common errors you may find while building wit
- [INVALID_GRAPH_NODE_RETURN_VALUE](../troubleshooting/errors/INVALID_GRAPH_NODE_RETURN_VALUE.md)
- [MULTIPLE_SUBGRAPHS](../troubleshooting/errors/MULTIPLE_SUBGRAPHS.md)
- [INVALID_CHAT_HISTORY](../troubleshooting/errors/INVALID_CHAT_HISTORY.md)
+86
View File
@@ -0,0 +1,86 @@
# How to connect a local agent to LangGraph Studio
This guide shows you how to connect your local agent to [LangGraph Studio](../concepts/langgraph_studio.md) for visualization, interaction, and debugging.
## Connection Options
There are two ways to connect your local agent to LangGraph Studio:
- [LangGraph Desktop](../concepts/langgraph_studio.md#desktop-app): Application, Mac only, requires Docker
- [Development Server](../concepts/langgraph_studio.md#dev-server): Python package, all platforms, no Docker
In this guide we will cover how to use the development server as that is generally an easier and better experience.
## Setup your application
First, you will need to setup your application in the proper format.
This means defining a `langgraph.json` file which contains paths to your agent(s).
See [this guide](../concepts/application_structure.md) for information on how to do so.
## Install langgraph-cli
You will need to install [`langgraph-cli`](../cloud/reference/cli.md#langgraph-cli) (version `0.1.55` or higher).
You will need to make sure to install the `inmem` extras.
```shell
pip install "langgraph-cli[inmem]==0.1.55"
```
## Run the development server
1. Navigate to your project directory (where `langgraph.json` is located)
2. Start the server:
```bash
langgraph dev
```
This will look for the `langgraph.json` file in your current directory.
In there, it will find the paths to the graph(s), and start those up.
It will then automatically connect to the cloud-hosted studio.
## Use the studio
After connecting to the studio, a browser window should automatically pop up.
This will use the cloud hosted studio UI to connect to your local development server.
Your graph is still running locally, the UI is connecting to visualizing the agent and threads that are defined locally.
The graph will always use the most up-to-date code, so you will be able to change the underlying code and have it automatically reflected in the studio.
This is useful for debugging workflows.
You can run your graph in the UI until it messes up, go in and change your code, and then rerun from the node that failed.
# (Optional) Attach a debugger
For step-by-step debugging with breakpoints and variable inspection:
```bash
# Install debugpy package
pip install debugpy
# Start server with debugging enabled
langgraph dev --debug-port 5678
```
Then attach your preferred debugger:
=== "VS Code"
Add this configuration to `launch.json`:
```json
{
"name": "Attach to LangGraph",
"type": "debugpy",
"request": "attach",
"connect": {
"host": "0.0.0.0",
"port": 5678
}
}
```
Specify the port number you chose in the previous step.
=== "PyCharm"
1. Go to Run → Edit Configurations
2. Click + and select "Python Debug Server"
3. Set IDE host name: `localhost`
4. Set port: `5678` (or the port number you chose in the previous step)
5. Click "OK" and start debugging
@@ -0,0 +1,424 @@
{
"cells": [
{
"cell_type": "markdown",
"metadata": {},
"source": [
"# How to add semantic search to your agent's memory\n",
"\n",
"This guide shows how to enable semantic search in your agent's memory store. This lets search for items in the store by semantic similarity.\n",
"\n",
"First, install this guide's prerequisites."
]
},
{
"cell_type": "code",
"execution_count": 4,
"metadata": {},
"outputs": [],
"source": [
"%%capture --no-stderr\n",
"%pip install -U langgraph langchain-openai langchain"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"import getpass\n",
"import os\n",
"\n",
"\n",
"def _set_env(var: str):\n",
" if not os.environ.get(var):\n",
" os.environ[var] = getpass.getpass(f\"{var}: \")\n",
"\n",
"\n",
"_set_env(\"OPENAI_API_KEY\")"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Next, create the store."
]
},
{
"cell_type": "code",
"execution_count": 25,
"metadata": {},
"outputs": [],
"source": [
"from langchain.embeddings import init_embeddings\n",
"from langgraph.store.memory import InMemoryStore\n",
"\n",
"# Create store with semantic search enabled\n",
"embeddings = init_embeddings(\"openai:text-embedding-3-small\")\n",
"store = InMemoryStore(\n",
" index={\n",
" \"embed\": embeddings,\n",
" \"dims\": 1536,\n",
" }\n",
")"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Now let's store some memories:"
]
},
{
"cell_type": "code",
"execution_count": 26,
"metadata": {},
"outputs": [],
"source": [
"# Store some memories\n",
"store.put((\"user_123\", \"memories\"), \"1\", {\"text\": \"I love pizza\"})\n",
"store.put((\"user_123\", \"memories\"), \"2\", {\"text\": \"I prefer Italian food\"})\n",
"store.put((\"user_123\", \"memories\"), \"3\", {\"text\": \"I don't like spicy food\"})\n",
"store.put((\"user_123\", \"memories\"), \"3\", {\"text\": \"I am studying econometrics\"})\n",
"store.put((\"user_123\", \"memories\"), \"3\", {\"text\": \"I am a plumber\"})"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Search memories using natural language:"
]
},
{
"cell_type": "code",
"execution_count": 27,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Memory: I prefer Italian food (similarity: 0.46482669521168163)\n",
"Memory: I love pizza (similarity: 0.35514845174380766)\n",
"Memory: I am a plumber (similarity: 0.155698702336571)\n"
]
}
],
"source": [
"# Find memories about food preferences\n",
"memories = store.search((\"user_123\", \"memories\"), query=\"I like food?\", limit=5)\n",
"\n",
"for memory in memories:\n",
" print(f'Memory: {memory.value[\"text\"]} (similarity: {memory.score})')"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Using in your agent\n",
"\n",
"Add semantic search to any node by injecting the store:"
]
},
{
"cell_type": "code",
"execution_count": 40,
"metadata": {},
"outputs": [],
"source": [
"import uuid\n",
"from typing import Optional\n",
"\n",
"from langchain.chat_models import init_chat_model\n",
"from langchain_core.tools import InjectedToolArg\n",
"from langgraph.store.base import BaseStore\n",
"from typing_extensions import Annotated\n",
"\n",
"from langgraph.prebuilt import create_react_agent\n",
"\n",
"\n",
"def add_memories(state, *, store: BaseStore):\n",
" # Search based on user's last message\n",
" items = store.search(\n",
" (\"user_123\", \"memories\"), query=state[\"messages\"][-1].content, limit=2\n",
" )\n",
" memories = \"\\n\".join(item.value[\"text\"] for item in items)\n",
" memories = f\"## Memories of user\\n{memories}\" if memories else \"\"\n",
" return [\n",
" {\"role\": \"system\", \"content\": f\"You are a helpful assistant.\\n{memories}\"}\n",
" ] + state[\"messages\"]\n",
"\n",
"\n",
"def upsert_memory(\n",
" content: str,\n",
" *,\n",
" memory_id: Optional[uuid.UUID] = None,\n",
" store: Annotated[BaseStore, InjectedToolArg],\n",
"):\n",
" \"\"\"Upsert a memory in the database.\"\"\"\n",
" mem_id = memory_id or uuid.uuid4()\n",
" store.put(\n",
" (\"user_123\", \"memories\"),\n",
" key=str(mem_id),\n",
" value={\"text\": content},\n",
" )\n",
" return f\"Stored memory {mem_id}\"\n",
"\n",
"\n",
"agent = create_react_agent(\n",
" init_chat_model(\"openai:gpt-4o-mini\"),\n",
" tools=[upsert_memory],\n",
" state_modifier=add_memories,\n",
" store=store,\n",
")"
]
},
{
"cell_type": "code",
"execution_count": 44,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"What are you in the mood for? Since you love Italian food and pizza, would you like some recommendations for a delicious pizza or a different Italian dish?"
]
}
],
"source": [
"async for message, metadata in agent.astream(\n",
" input={\"messages\": [{\"role\": \"user\", \"content\": \"I'm hungry\"}]},\n",
" stream_mode=\"messages\",\n",
"):\n",
" print(message.content, end=\"\")"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Advanced Usage\n",
"\n",
"#### Multi-vector indexing\n",
"\n",
"Store and search different aspects of memories separately to improve recall or omit certain fields from being indexed."
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"# Configure store to embed both memory content and emotional context\n",
"store = InMemoryStore(\n",
" index={\"embed\": embeddings, \"dims\": 1536, \"fields\": [\"memory\", \"emotional_context\"]}\n",
")\n",
"# Store memories with different content/emotion pairs\n",
"store.put(\n",
" (\"user_123\", \"memories\"),\n",
" \"mem1\",\n",
" {\n",
" \"memory\": \"Had pizza with friends at Mario's\",\n",
" \"emotional_context\": \"felt happy and connected\",\n",
" \"this_isnt_indexed\": \"I prefer ravioli though\",\n",
" },\n",
")\n",
"store.put(\n",
" (\"user_123\", \"memories\"),\n",
" \"mem2\",\n",
" {\n",
" \"memory\": \"Ate alone at home\",\n",
" \"emotional_context\": \"felt a bit lonely\",\n",
" \"this_isnt_indexed\": \"I like pie\",\n",
" },\n",
")\n",
"\n",
"# Search focusing on emotional state - matches mem2\n",
"results = store.search(\n",
" (\"user_123\", \"memories\"), query=\"times they felt isolated\", limit=1\n",
")\n",
"print(\"Expect mem 2\")\n",
"for r in results:\n",
" print(f\"Item: {r.key}; Score ({r.score})\")\n",
" print(f\"Memory: {r.value['memory']}\")\n",
" print(f\"Emotion: {r.value['emotional_context']}\\n\")\n",
"\n",
"# Search focusing on social eating - matches mem1\n",
"print(\"Expect mem1\")\n",
"results = store.search((\"user_123\", \"memories\"), query=\"fun pizza\", limit=1)\n",
"for r in results:\n",
" print(f\"Item: {r.key}; Score ({r.score})\")\n",
" print(f\"Memory: {r.value['memory']}\")\n",
" print(f\"Emotion: {r.value['emotional_context']}\\n\")\n",
"\n",
"print(\"Expect random lower score (ravioli not indexed)\")\n",
"results = store.search((\"user_123\", \"memories\"), query=\"ravioli\", limit=1)\n",
"for r in results:\n",
" print(f\"Item: {r.key}; Score ({r.score})\")\n",
" print(f\"Memory: {r.value['memory']}\")\n",
" print(f\"Emotion: {r.value['emotional_context']}\\n\")"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"#### Override fields at storage time\n",
"You can override which fields to embed when storing a specific memory using `put(..., index=[...fields])`, regardless of the store's default configuration."
]
},
{
"cell_type": "code",
"execution_count": 57,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Expect mem1\n",
"Item: mem1; Score (0.3374698138722726)\n",
"Memory: I love spicy food\n",
"Context: At a Thai restaurant\n",
"\n",
"Expect mem2\n",
"Item: mem2; Score (0.3679447999059255)\n",
"Memory: The restaurant was too loud\n",
"Context: Dinner at an Italian place\n",
"\n"
]
}
],
"source": [
"embeddings = init_embeddings(\"openai:text-embedding-3-small\")\n",
"store = InMemoryStore(\n",
" index={\n",
" \"embed\": embeddings,\n",
" \"dims\": 1536,\n",
" \"fields\": [\"memory\"],\n",
" } # Default to embed memory field\n",
")\n",
"\n",
"# Store one memory with default indexing\n",
"store.put(\n",
" (\"user_123\", \"memories\"),\n",
" \"mem1\",\n",
" {\"memory\": \"I love spicy food\", \"context\": \"At a Thai restaurant\"},\n",
")\n",
"\n",
"# Store another overriding which fields to embed\n",
"store.put(\n",
" (\"user_123\", \"memories\"),\n",
" \"mem2\",\n",
" {\"memory\": \"The restaurant was too loud\", \"context\": \"Dinner at an Italian place\"},\n",
" index=[\"context\"], # Override: only embed the context\n",
")\n",
"\n",
"# Search about food - matches mem1 (using default field)\n",
"print(\"Expect mem1\")\n",
"results = store.search(\n",
" (\"user_123\", \"memories\"), query=\"what food do they like\", limit=1\n",
")\n",
"for r in results:\n",
" print(f\"Item: {r.key}; Score ({r.score})\")\n",
" print(f\"Memory: {r.value['memory']}\")\n",
" print(f\"Context: {r.value['context']}\\n\")\n",
"\n",
"# Search about restaurant atmosphere - matches mem2 (using overridden field)\n",
"print(\"Expect mem2\")\n",
"results = store.search(\n",
" (\"user_123\", \"memories\"), query=\"restaurant environment\", limit=1\n",
")\n",
"for r in results:\n",
" print(f\"Item: {r.key}; Score ({r.score})\")\n",
" print(f\"Memory: {r.value['memory']}\")\n",
" print(f\"Context: {r.value['context']}\\n\")"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"#### Disable Indexing for Specific Memories\n",
"\n",
"Some memories shouldn't be searchable by content. You can disable indexing for these while still storing them using \n",
"`put(..., index=False)`. Example:"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"store = InMemoryStore(index={\"embed\": embeddings, \"dims\": 1536, \"fields\": [\"memory\"]})\n",
"\n",
"# Store a normal indexed memory\n",
"store.put(\n",
" (\"user_123\", \"memories\"),\n",
" \"mem1\",\n",
" {\"memory\": \"I love chocolate ice cream\", \"type\": \"preference\"},\n",
")\n",
"\n",
"# Store a system memory without indexing\n",
"store.put(\n",
" (\"user_123\", \"memories\"),\n",
" \"mem2\",\n",
" {\"memory\": \"User completed onboarding\", \"type\": \"system\"},\n",
" index=False, # Disable indexing entirely\n",
")\n",
"\n",
"# Search about food preferences - finds mem1\n",
"print(\"Expect mem1\")\n",
"results = store.search((\"user_123\", \"memories\"), query=\"what food preferences\", limit=1)\n",
"for r in results:\n",
" print(f\"Item: {r.key}; Score ({r.score})\")\n",
" print(f\"Memory: {r.value['memory']}\")\n",
" print(f\"Type: {r.value['type']}\\n\")\n",
"\n",
"# Search about onboarding - won't find mem2 (not indexed)\n",
"print(\"Expect low score (mem2 not indexed)\")\n",
"results = store.search((\"user_123\", \"memories\"), query=\"onboarding status\", limit=1)\n",
"for r in results:\n",
" print(f\"Item: {r.key}; Score ({r.score})\")\n",
" print(f\"Memory: {r.value['memory']}\")\n",
" print(f\"Type: {r.value['type']}\\n\")"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": []
}
],
"metadata": {
"kernelspec": {
"display_name": "Python 3 (ipykernel)",
"language": "python",
"name": "python3"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.11.2"
}
},
"nbformat": 4,
"nbformat_minor": 4
}
+7
View File
@@ -3,6 +3,13 @@ title: Reference
description: API reference for LangGraph
---
<style>
.md-sidebar {
display: block !important;
}
</style>
# Reference
Welcome to the LangGraph API reference! This reference provides detailed information about the LangGraph API, including classes, methods, and other components.
@@ -102,7 +102,7 @@
"from langchain_community.document_loaders.recursive_url_loader import RecursiveUrlLoader\n",
"\n",
"# LCEL docs\n",
"url = \"https://python.langchain.com/docs/concepts/#langchain-expression-language-lcel\"\n",
"url = \"https://python.langchain.com/docs/concepts/lcel/\"\n",
"loader = RecursiveUrlLoader(\n",
" url=url, max_depth=20, extractor=lambda x: Soup(x, \"html.parser\").text\n",
")\n",
@@ -35,7 +35,7 @@
"outputs": [],
"source": [
"%%capture --no-stderr\n",
"% pip install -U langgraph langchain-community langchain-anthropic tavily-python pandas"
"%pip install -U langgraph langchain-community langchain-anthropic tavily-python pandas openai"
]
},
{
@@ -55,6 +55,7 @@
"\n",
"\n",
"_set_env(\"ANTHROPIC_API_KEY\")\n",
"_set_env(\"OPENAI_API_KEY\")\n",
"_set_env(\"TAVILY_API_KEY\")"
]
},
@@ -85,7 +86,9 @@
"cell_type": "code",
"execution_count": 21,
"id": "71638c2a-5038-439e-907a-de2bb548db34",
"metadata": {"hide_from_vcr": true},
"metadata": {
"hide_from_vcr": true
},
"outputs": [],
"source": [
"import os\n",
@@ -176,7 +179,9 @@
"cell_type": "code",
"execution_count": 22,
"id": "654e2f81",
"metadata": {"hide_from_vcr": true},
"metadata": {
"hide_from_vcr": true
},
"outputs": [],
"source": [
"import re\n",
+10 -12
View File
@@ -6,25 +6,23 @@ title: Tutorials
# Tutorials
Welcome to the LangGraph Tutorials! These notebooks introduce LangGraph through building various language agents and applications.
New to LangGraph or LLM app development? Read this material to get up and running building your first applications.
## Quick Start
## Get Started 🚀 {#quick-start}
Learn the basics of LangGraph through a comprehensive quick start in which you will build an agent from scratch.
- [LangGraph Quickstart](introduction.ipynb): Build a chatbot that can use tools and keep track of conversation history. Add human-in-the-loop capabilities and explore how time-travel works.
- [LangGraph Server Quickstart](langgraph-platform/local-server.md): Launch a LangGraph server locally and interact with it using the REST API and LangGraph Studio Web UI.
- [LangGraph Cloud QuickStart](../cloud/quick_start.md): Deploy a LangGraph app using LangGraph Cloud.
- [Quick Start](introduction.ipynb): In this tutorial, you will build a support chatbot using LangGraph.
- [LangGraph Cloud Quick Start](../cloud/quick_start.md): In this tutorial, you will build and deploy an agent to LangGraph Cloud.
## Use cases 🛠️
## Use cases
Learn from example implementations of graphs designed for specific scenarios and that implement common design patterns.
Explore practical implementations tailored for specific scenarios:
### Chatbots
- [Customer Support](customer-support/customer-support.ipynb): Build a customer support chatbot to manage flights, hotel reservations, car rentals, and other tasks
- [Prompt Generation from User Requirements](chatbots/information-gather-prompting.ipynb): Build an information gathering chatbot
- [Code Assistant](code_assistant/langgraph_code_assistant.ipynb): Build a code analysis and generation assistant
- [Customer Support](customer-support/customer-support.ipynb): Build a multi-functional support bot for flights, hotels, and car rentals.
- [Prompt Generation from User Requirements](chatbots/information-gather-prompting.ipynb): Build an information gathering chatbot.
- [Code Assistant](code_assistant/langgraph_code_assistant.ipynb): Build a code analysis and generation assistant.
### RAG
+47 -40
View File
@@ -5,21 +5,21 @@
"id": "4a1aae78-88a6-4133-b905-7e46c8e3772f",
"metadata": {},
"source": [
"# Quick Start\n",
"# 🚀 LangGraph Quick Start\n",
"\n",
"In this comprehensive quick start, we will build a support chatbot in LangGraph that can:\n",
"In this tutorial, we will build a support chatbot in LangGraph that can:\n",
"\n",
"- Answer common questions by searching the web\n",
"- Maintain conversation state across calls\n",
"- Route complex queries to a human for review\n",
"- Use custom state to control its behavior\n",
"- Rewind and explore alternative conversation paths\n",
"✅ **Answer common questions** by searching the web \n",
"✅ **Maintain conversation state** across calls \n",
"✅ **Route complex queries** to a human for review \n",
"✅ **Use custom state** to control its behavior \n",
"✅ **Rewind and explore** alternative conversation paths \n",
"\n",
"We'll start with a basic chatbot and progressively add more sophisticated capabilities, introducing key LangGraph concepts along the way.\n",
"We'll start with a **basic chatbot** and progressively add more sophisticated capabilities, introducing key LangGraph concepts along the way. Let’s dive in! 🌟\n",
"\n",
"## Setup\n",
"\n",
"First, install the required packages:"
"First, install the required packages and configure your environment:"
]
},
{
@@ -33,14 +33,6 @@
"%pip install -U langgraph langsmith langchain_anthropic"
]
},
{
"cell_type": "markdown",
"id": "a6d1e870-1bc0-4d44-86c0-96681ccf6113",
"metadata": {},
"source": [
"Next, set your API keys:"
]
},
{
"cell_type": "code",
"execution_count": 2,
@@ -120,27 +112,24 @@
]
},
{
"attachments": {},
"cell_type": "markdown",
"id": "31c755cd-8994-4867-bdff-96a55d7beae7",
"id": "c08c41da-0855-49d3-9a3d-b7eb94413367",
"metadata": {},
"source": [
"<div class=\"admonition tip\">\n",
" <p class=\"admonition-title\">Note</p>\n",
" <p>\n",
" The first thing you do when you define a graph is define the <code>State</code> of the graph. The <code>State</code> consists of the schema of the graph as well as <a href=\"https://langchain-ai.github.io/langgraph/concepts/low_level/#reducers\">reducer functions</a> which specify how to apply updates to the state. In our example <code>State</code> is a <code>TypedDict</code> with a single key: <code>messages</code>. The <code>messages</code> key is annotated with the <a href=\"https://langchain-ai.github.io/langgraph/reference/graphs/#langgraph.graph.message.add_messages\"><code>add_messages</code></a> reducer function, which tells LangGraph to append new messages to the existing list, rather than overwriting it. State keys without an annotation will be overwritten by each update, storing the most recent value. Check out <a href=\"https://langchain-ai.github.io/langgraph/reference/graphs/#langgraph.graph.message.add_messages\">this conceptual guide</a> to learn more about state, reducers and other low-level concepts.\n",
" </p>\n",
"</div>"
]
},
{
"cell_type": "markdown",
"id": "4137feed-746e-4c72-a34a-f7a699ad5dcf",
"metadata": {},
"source": [
"So now our graph knows two things:\n",
"Our graph can now handle two key tasks:\n",
"\n",
"1. Each `node` can receive the current `State` as input and output an update to the state.\n",
"2. Updates to `messages` will be appended to the existing list rather than overwriting it, thanks to the prebuilt [`add_messages`](https://langchain-ai.github.io/langgraph/reference/graphs/?h=add+messages#add_messages) function used with the `Annotated` syntax.\n",
"\n",
"------\n",
"\n",
"!!! tip \"Concept\"\n",
"\n",
" When defining a graph, the first step is to define its `State`. The `State` includes the graph's schema and [reducer functions](https://langchain-ai.github.io/langgraph/concepts/low_level/#reducers) that handle state updates. In our example, `State` is a `TypedDict` with one key: `messages`. The [`add_messages`](https://langchain-ai.github.io/langgraph/reference/graphs/#langgraph.graph.message.add_messages) reducer function is used to append new messages to the list instead of overwriting it. Keys without a reducer annotation will overwrite previous values. Learn more about state, reducers, and related concepts in [this guide](https://langchain-ai.github.io/langgraph/reference/graphs/#langgraph.graph.message.add_messages).\n",
"\n",
"---------\n",
"\n",
"1. Every `node` we define will receive the current `State` as input and return a value that updates that state.\n",
"2. `messages` will be _appended_ to the current list, rather than directly overwritten. This is communicated via the prebuilt [`add_messages`](https://langchain-ai.github.io/langgraph/reference/graphs/?h=add+messages#add_messages) function in the `Annotated` syntax.\n",
"\n",
"Next, add a \"`chatbot`\" node. Nodes represent units of work. They are typically regular python functions."
]
@@ -365,7 +354,7 @@
"id": "f22c5d4a-3134-413c-81fe-dd9752fbeb66",
"metadata": {},
"source": [
"## Part 2: Enhancing the Chatbot with Tools\n",
"## Part 2: 🛠️ Enhancing the Chatbot with Tools\n",
"\n",
"To handle queries our chatbot can't answer \"from memory\", we'll integrate a web search tool. Our bot can use this tool to find relevant information and provide better responses.\n",
"\n",
@@ -2046,7 +2035,7 @@
"\n",
"So far, we've relied on a simple state (it's just a list of messages!). You can go far with this simple state, but if you want to define complex behavior without relying on the message list, you can add additional fields to the state. In this section, we will extend our chat bot with a new node to illustrate this.\n",
"\n",
"In the examples above, we involved a human deterministically: the graph __always__ interrupted whenever an tool was invoked. Suppose we wanted our chat bot to have the choice of relying on a human.\n",
"In the examples above, we involved a human deterministically: the graph __always__ interrupted whenever a tool was invoked. Suppose we wanted our chat bot to have the choice of relying on a human.\n",
"\n",
"One way to do this is to create a passthrough \"human\" node, before which the graph will always stop. We will only execute this node if the LLM invokes a \"human\" tool. For our convenience, we will include an \"ask_human\" flag in our graph state that we will flip if the LLM calls this tool.\n",
"\n",
@@ -3136,11 +3125,29 @@
"id": "e584d57f-5aad-4507-815f-0b2e4b64b791",
"metadata": {},
"source": [
"## Conclusion\n",
"## Next Steps\n",
"\n",
"Congrats! You've completed the intro tutorial and built a chat bot in LangGraph that supports tool calling, persistent memory, human-in-the-loop interactivity, and even time-travel!\n",
"Take your journey further by exploring deployment and advanced features:\n",
"\n",
"The [LangGraph documentation](https://langchain-ai.github.io/langgraph/) is a great resource for diving deeper into the library's capabilities."
"### Server Quickstart\n",
"\n",
"- **[LangGraph Server Quickstart](../langgraph-platform/local-server)**: Launch a LangGraph server locally and interact with it using the REST API and LangGraph Studio Web UI.\n",
"\n",
"### LangGraph Cloud\n",
"\n",
"- **[LangGraph Cloud QuickStart](../../cloud/quick_start)**: Deploy your LangGraph app using LangGraph Cloud.\n",
"\n",
"### LangGraph Framework\n",
"\n",
"- **[LangGraph Concepts](../../concepts)**: Learn the foundational concepts of LangGraph. \n",
"- **[LangGraph How-to Guides](../../how-tos)**: Guides for common tasks with LangGraph.\n",
"\n",
"### LangGraph Platform\n",
"\n",
"Expand your knowledge with these resources:\n",
"\n",
"- **[LangGraph Platform Concepts](../../concepts#langgraph-platform)**: Understand the foundational concepts of the LangGraph Platform. \n",
"- **[LangGraph Platform How-to Guides](../../how-tos#langgraph-platform)**: Guides for common tasks with LangGraph Platform. "
]
}
],
@@ -3160,7 +3167,7 @@
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.11.9"
"version": "3.11.4"
}
},
"nbformat": 4,
@@ -0,0 +1,253 @@
# Quick Start: Launch Local LangGraph Server
This is a quick start guide to help you get a LangGraph app up and running locally.
!!! info "Requirements"
- Python >= 3.11
- [LangGraph CLI](https://langchain-ai.github.io/langgraph/cloud/reference/cli/): Requires langchain-cli[inmem] >= 0.1.58
## Install the LangGraph CLI
```bash
pip install "langgraph-cli[inmem]==0.1.58" python-dotenv
```
## 🌱 Create a LangGraph App
Create a new app from the `react-agent` template. This template is a simple agent that can be flexibly extended to many tools.
=== "Python Server"
```shell
langgraph new path/to/your/app --template react-agent-python
```
=== "Node Server"
```shell
langgraph new path/to/your/app --template react-agent-js
```
!!! tip "Additional Templates"
If you use `langgraph new` without specifying a template, you will be presented with an interactive menu that will allow you to choose from a list of available templates.
## Install Dependencies
In the root of your new LangGraph app, install the dependencies in `edit` mode so your local changes are used by the server:
```shell
pip install -e .
```
## Create a `.env` file
You will find a `.env.example` in the root of your new LangGraph app. Create
a `.env` file in the root of your new LangGraph app and copy the contents of the `.env.example` file into it, filling in the necessary API keys:
```bash
LANGSMITH_API_KEY=lsv2...
TAVILY_API_KEY=tvly-...
ANTHROPIC_API_KEY=sk-
OPENAI_API_KEY=sk-...
```
<details><summary>Get API Keys</summary>
<ul>
<li> <b>LANGSMITH_API_KEY</b>: Go to the <a href="https://smith.langchain.com/settings">LangSmith Settings page</a>. Then clck <b>Create API Key</b>.
</li>
<li>
<b>ANTHROPIC_API_KEY</b>: Get an API key from <a href="https://console.anthropic.com/">Anthropic</a>.
</li>
<li>
<b>OPENAI_API_KEY</b>: Get an API key from <a href="https://openai.com/">OpenAI</a>.
</li>
<li>
<b>TAVILY_API_KEY</b>: Get an API key on the <a href="https://app.tavily.com/">Tavily website</a>.
</li>
</ul>
</details>
## 🚀 Launch LangGraph Server
```shell
langgraph dev
```
This will start up the LangGraph API server locally. If this runs successfully, you should see something like:
> Ready!
>
> - API: [http://localhost:8123](http://localhost:8123/)
>
> - Docs: http://localhost:8123/docs
>
> - LangGraph Studio Web UI: https://smith.langchain.com/studio/?baseUrl=http://127.0.0.1:8123
!!! note "In-Memory Mode"
The `langgraph dev` command starts LangGraph Server in an in-memory mode. This mode is suitable for development and testing purposes. For production use, you should deploy LangGraph Server with access to a persistent storage backend.
If you want to test your application with a persistent storage backend, you can use the `langgraph up` command instead of `langgraph dev`. You will
need to have `docker` installed on your machine to use this command.
## LangGraph Studio Web UI
Test your graph in the LangGraph Studio Web UI by visiting the URL provided in the output of the `langgraph up` command.
> - LangGraph Studio Web UI: https://smith.langchain.com/studio/?baseUrl=http://127.0.0.1:8123
!!! warning "Safari Compatibility"
Currently, LangGraph Studio Web does not support Safari when running a server locally.
## Test the API
=== "Python SDK (Async)"
**Install the LangGraph Python SDK**
```shell
pip install langgraph-sdk
```
**Send a message to the assistant (threadless run)**
```python
from langgraph_sdk import get_client
client = get_client(url="http://localhost:8123")
async for chunk in client.runs.stream(
None, # Threadless run
"agent", # Name of assistant. Defined in langgraph.json.
input={
"messages": [{
"role": "human",
"content": "What is LangGraph?",
}],
},
stream_mode="updates",
):
print(f"Receiving new event of type: {chunk.event}...")
print(chunk.data)
print("\n\n")
```
=== "Python SDK (Sync)"
**Install the LangGraph Python SDK**
```shell
pip install langgraph-sdk
```
**Send a message to the assistant (threadless run)**
```python
from langgraph_sdk import get_sync_client
client = get_sync_client(url="http://localhost:8123")
for chunk in client.runs.stream(
None, # Threadless run
"agent", # Name of assistant. Defined in langgraph.json.
input={
"messages": [{
"role": "human",
"content": "What is LangGraph?",
}],
},
stream_mode="updates",
):
print(f"Receiving new event of type: {chunk.event}...")
print(chunk.data)
print("\n\n")
```
=== "Javascript SDK"
**Install the LangGraph JS SDK**
```shell
npm install @langchain/langgraph-sdk
```
**Send a message to the assistant (threadless run)**
```js
const { Client } = await import("@langchain/langgraph-sdk");
// only set the apiUrl if you changed the default port when calling langgraph up
const client = new Client({ apiUrl: "http://localhost:8123"});
const streamResponse = client.runs.stream(
null, // Threadless run
"agent", // Assistant ID
{
input: {
"messages": [
{ "role": "user", "content": "What is LangGraph?"}
]
},
streamMode: "messages",
}
);
for await (const chunk of streamResponse) {
console.log(`Receiving new event of type: ${chunk.event}...`);
console.log(JSON.stringify(chunk.data));
console.log("\n\n");
}
```
=== "Rest API"
```bash
curl -s --request POST \
--url "http://localhost:8123/runs/stream" \
--header 'Content-Type: application/json' \
--data "{
\"assistant_id\": \"agent\",
\"input\": {
\"messages\": [
{
\"role\": \"human\",
\"content\": \"What is LangGraph?\"
}
]
},
\"stream_mode\": \"updates\"
}"
```
!!! tip "Auth"
If you're connecting to a remote server, you will need to provide a LangSmith
API Key for authorization. Please see the API Reference for the clients
for more information.
## Next Steps
Now that you have a LangGraph app running locally, take your journey further by exploring deployment and advanced features:
### 🌐 Deploy to LangGraph Cloud
- **[LangGraph Cloud QuickStart](../../cloud/quick_start.md)**: Deploy your LangGraph app using LangGraph Cloud.
### 📚 Learn More about LangGraph Platform
Expand your knowledge with these resources:
- **[LangGraph Platform Concepts](../../concepts/index.md#langgraph-platform)**: Understand the foundational concepts of the LangGraph Platform.
- **[LangGraph Platform How-to Guides](../../how-tos/index.md#langgraph-platform)**: Discover step-by-step guides to build and deploy applications.
### 🛠️ Developer References
Access detailed documentation for development and API usage:
- **[LangGraph Server API Reference](../../cloud/reference/api/api_ref.html)**: Explore the LangGraph Server API documentation.
- **[Python SDK Reference](../../cloud/reference/sdk/python_sdk_ref.md)**: Explore the Python SDK API Reference.
- **[JS/TS SDK Reference](../../cloud/reference/sdk/js_ts_sdk_ref.md)**: Explore the Python SDK API Reference.
@@ -35,12 +35,12 @@
"outputs": [],
"source": [
"%%capture --no-stderr\n",
"%pip install -U langgraph langchain langchain_openai langchain_experimental langsmith pandas"
"%pip install -U langgraph langchain_community langchain_anthropic langchain_experimental"
]
},
{
"cell_type": "code",
"execution_count": 1,
"execution_count": null,
"id": "30c2f3de-c730-4aec-85a6-af2c2f058803",
"metadata": {},
"outputs": [],
@@ -54,7 +54,7 @@
" os.environ[var] = getpass.getpass(f\"Please provide your {var}\")\n",
"\n",
"\n",
"_set_if_undefined(\"OPENAI_API_KEY\")\n",
"_set_if_undefined(\"ANTHROPIC_API_KEY\")\n",
"_set_if_undefined(\"TAVILY_API_KEY\")"
]
},
@@ -83,7 +83,7 @@
},
{
"cell_type": "code",
"execution_count": 1,
"execution_count": 3,
"id": "f04c6778-403b-4b49-9b93-678e910d5cec",
"metadata": {},
"outputs": [],
@@ -91,45 +91,27 @@
"from typing import Annotated\n",
"\n",
"from langchain_community.tools.tavily_search import TavilySearchResults\n",
"from langchain_experimental.tools import PythonREPLTool\n",
"from langchain_core.tools import tool\n",
"from langchain_experimental.utilities import PythonREPL\n",
"\n",
"tavily_tool = TavilySearchResults(max_results=5)\n",
"\n",
"# This executes code locally, which can be unsafe\n",
"python_repl_tool = PythonREPLTool()"
]
},
{
"cell_type": "markdown",
"id": "d58d1e85-22d4-4c22-9062-72a346a0d709",
"metadata": {},
"source": [
"## Helper Utilities"
]
},
{
"cell_type": "markdown",
"id": "b7c302b0-cd57-4913-986f-5dc7d6d77386",
"metadata": {},
"source": [
"Define a helper function that we will use to create the nodes in the graph - it takes care of converting the agent response to a human message. This is important because that is how we will add it the global state of the graph"
]
},
{
"cell_type": "code",
"execution_count": 2,
"id": "80862241-a1a7-4726-bce5-f867b233832e",
"metadata": {},
"outputs": [],
"source": [
"from langchain_core.messages import HumanMessage\n",
"repl = PythonREPL()\n",
"\n",
"\n",
"def agent_node(state, agent, name):\n",
" result = agent.invoke(state)\n",
" return {\n",
" \"messages\": [HumanMessage(content=result[\"messages\"][-1].content, name=name)]\n",
" }"
"@tool\n",
"def python_repl_tool(\n",
" code: Annotated[str, \"The python code to execute to generate your chart.\"],\n",
"):\n",
" \"\"\"Use this to execute python code and do math. If you want to see the output of a value,\n",
" you should print it out with `print(...)`. This is visible to the user.\"\"\"\n",
" try:\n",
" result = repl.run(code)\n",
" except BaseException as e:\n",
" return f\"Failed to execute. Error: {repr(e)}\"\n",
" result_str = f\"Successfully executed:\\n```python\\n{code}\\n```\\nStdout: {result}\"\n",
" return result_str"
]
},
{
@@ -139,57 +121,77 @@
"source": [
"### Create Agent Supervisor\n",
"\n",
"It will use function calling to choose the next worker node OR finish processing."
"It will use LLM with structured output to choose the next worker node OR finish processing."
]
},
{
"cell_type": "code",
"execution_count": 3,
"execution_count": 4,
"id": "f16c289b-10b0-47a8-a675-0bb54d299236",
"metadata": {},
"outputs": [],
"source": [
"from langgraph.graph import MessagesState"
]
},
{
"cell_type": "code",
"execution_count": 5,
"id": "4a3baabf-18cb-415c-9473-d0546cf58b8b",
"metadata": {},
"outputs": [],
"source": [
"# The agent state is the input to each node in the graph\n",
"class AgentState(MessagesState):\n",
" # The 'next' field indicates where to route to next\n",
" next: str"
]
},
{
"cell_type": "code",
"execution_count": 6,
"id": "311f0a58-b425-4496-adac-dc4cd8ffb912",
"metadata": {},
"outputs": [],
"source": [
"from langchain_core.prompts import ChatPromptTemplate, MessagesPlaceholder\n",
"from langchain_openai import ChatOpenAI\n",
"from pydantic import BaseModel\n",
"from typing import Literal\n",
"from typing_extensions import TypedDict\n",
"\n",
"from langchain_anthropic import ChatAnthropic\n",
"\n",
"members = [\"researcher\", \"coder\"]\n",
"# Our team supervisor is an LLM node. It just picks the next agent to process\n",
"# and decides when the work is completed\n",
"options = members + [\"FINISH\"]\n",
"\n",
"members = [\"Researcher\", \"Coder\"]\n",
"system_prompt = (\n",
" \"You are a supervisor tasked with managing a conversation between the\"\n",
" \" following workers: {members}. Given the following user request,\"\n",
" f\" following workers: {members}. Given the following user request,\"\n",
" \" respond with the worker to act next. Each worker will perform a\"\n",
" \" task and respond with their results and status. When finished,\"\n",
" \" respond with FINISH.\"\n",
")\n",
"# Our team supervisor is an LLM node. It just picks the next agent to process\n",
"# and decides when the work is completed\n",
"options = [\"FINISH\"] + members\n",
"\n",
"\n",
"class routeResponse(BaseModel):\n",
"class Router(TypedDict):\n",
" \"\"\"Worker to route to next. If no workers needed, route to FINISH.\"\"\"\n",
"\n",
" next: Literal[*options]\n",
"\n",
"\n",
"prompt = ChatPromptTemplate.from_messages(\n",
" [\n",
" (\"system\", system_prompt),\n",
" MessagesPlaceholder(variable_name=\"messages\"),\n",
" (\n",
" \"system\",\n",
" \"Given the conversation above, who should act next?\"\n",
" \" Or should we FINISH? Select one of: {options}\",\n",
" ),\n",
" ]\n",
").partial(options=str(options), members=\", \".join(members))\n",
"llm = ChatAnthropic(model=\"claude-3-5-sonnet-latest\")\n",
"\n",
"\n",
"llm = ChatOpenAI(model=\"gpt-4o\")\n",
"def supervisor_node(state: AgentState) -> AgentState:\n",
" messages = [\n",
" {\"role\": \"system\", \"content\": system_prompt},\n",
" ] + state[\"messages\"]\n",
" response = llm.with_structured_output(Router).invoke(messages)\n",
" next_ = response[\"next\"]\n",
" if next_ == \"FINISH\":\n",
" next_ = END\n",
"\n",
"\n",
"def supervisor_agent(state):\n",
" supervisor_chain = prompt | llm.with_structured_output(routeResponse)\n",
" return supervisor_chain.invoke(state)"
" return {\"next\": next_}"
]
},
{
@@ -204,42 +206,57 @@
},
{
"cell_type": "code",
"execution_count": 4,
"execution_count": 7,
"id": "6a430af7-8fce-4e66-ba9e-d940c1bc48e8",
"metadata": {},
"outputs": [],
"outputs": [
{
"data": {
"text/plain": [
"<langgraph.graph.state.StateGraph at 0x10abb3a50>"
]
},
"execution_count": 7,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"import functools\n",
"import operator\n",
"from typing import Sequence\n",
"from typing_extensions import TypedDict\n",
"\n",
"from langchain_core.messages import BaseMessage\n",
"\n",
"from langgraph.graph import END, StateGraph, START\n",
"from langchain_core.messages import HumanMessage\n",
"from langgraph.graph import StateGraph, START, END\n",
"from langgraph.prebuilt import create_react_agent\n",
"\n",
"\n",
"# The agent state is the input to each node in the graph\n",
"class AgentState(TypedDict):\n",
" # The annotation tells the graph that new messages will always\n",
" # be added to the current states\n",
" messages: Annotated[Sequence[BaseMessage], operator.add]\n",
" # The 'next' field indicates where to route to next\n",
" next: str\n",
"research_agent = create_react_agent(\n",
" llm, tools=[tavily_tool], state_modifier=\"You are a researcher. DO NOT do any math.\"\n",
")\n",
"\n",
"\n",
"research_agent = create_react_agent(llm, tools=[tavily_tool])\n",
"research_node = functools.partial(agent_node, agent=research_agent, name=\"Researcher\")\n",
"def research_node(state: AgentState) -> AgentState:\n",
" result = research_agent.invoke(state)\n",
" return {\n",
" \"messages\": [\n",
" HumanMessage(content=result[\"messages\"][-1].content, name=\"researcher\")\n",
" ]\n",
" }\n",
"\n",
"# NOTE: THIS PERFORMS ARBITRARY CODE EXECUTION. PROCEED WITH CAUTION\n",
"\n",
"# NOTE: THIS PERFORMS ARBITRARY CODE EXECUTION, WHICH CAN BE UNSAFE WHEN NOT SANDBOXED\n",
"code_agent = create_react_agent(llm, tools=[python_repl_tool])\n",
"code_node = functools.partial(agent_node, agent=code_agent, name=\"Coder\")\n",
"\n",
"workflow = StateGraph(AgentState)\n",
"workflow.add_node(\"Researcher\", research_node)\n",
"workflow.add_node(\"Coder\", code_node)\n",
"workflow.add_node(\"supervisor\", supervisor_agent)"
"\n",
"def code_node(state: AgentState) -> AgentState:\n",
" result = code_agent.invoke(state)\n",
" return {\n",
" \"messages\": [HumanMessage(content=result[\"messages\"][-1].content, name=\"coder\")]\n",
" }\n",
"\n",
"\n",
"builder = StateGraph(AgentState)\n",
"builder.add_edge(START, \"supervisor\")\n",
"builder.add_node(\"supervisor\", supervisor_node)\n",
"builder.add_node(\"researcher\", research_node)\n",
"builder.add_node(\"coder\", code_node)"
]
},
{
@@ -252,23 +269,53 @@
},
{
"cell_type": "code",
"execution_count": 5,
"execution_count": 8,
"id": "14778e86-077b-4e6a-893c-400e59b0cdbf",
"metadata": {},
"outputs": [],
"source": [
"for member in members:\n",
" # We want our workers to ALWAYS \"report back\" to the supervisor when done\n",
" workflow.add_edge(member, \"supervisor\")\n",
" builder.add_edge(member, \"supervisor\")\n",
"\n",
"# The supervisor populates the \"next\" field in the graph state\n",
"# which routes to a node or finishes\n",
"conditional_map = {k: k for k in members}\n",
"conditional_map[\"FINISH\"] = END\n",
"workflow.add_conditional_edges(\"supervisor\", lambda x: x[\"next\"], conditional_map)\n",
"builder.add_conditional_edges(\"supervisor\", lambda state: state[\"next\"])\n",
"# Finally, add entrypoint\n",
"workflow.add_edge(START, \"supervisor\")\n",
"builder.add_edge(START, \"supervisor\")\n",
"\n",
"graph = workflow.compile()"
"graph = builder.compile()"
]
},
{
"cell_type": "code",
"execution_count": 9,
"id": "fb2cf698-c42b-49ba-8ade-585d207a3daa",
"metadata": {},
"outputs": [],
"source": [
"from IPython.display import display, Image"
]
},
{
"cell_type": "code",
"execution_count": 10,
"id": "f4992dcb-33c5-4fef-b4e3-09c303737342",
"metadata": {},
"outputs": [
{
"data": {
"image/png": "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 truncated
"text/plain": [
"<IPython.core.display.Image object>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"display(Image(graph.get_graph().draw_mermaid_png()))"
]
},
{
@@ -283,7 +330,7 @@
},
{
"cell_type": "code",
"execution_count": 6,
"execution_count": 11,
"id": "56ba78e9-d9c1-457c-a073-d606d5d3e013",
"metadata": {},
"outputs": [
@@ -291,7 +338,7 @@
"name": "stdout",
"output_type": "stream",
"text": [
"{'supervisor': {'next': 'Coder'}}\n",
"((), {'supervisor': {'next': 'coder'}})\n",
"----\n"
]
},
@@ -306,9 +353,62 @@
"name": "stdout",
"output_type": "stream",
"text": [
"{'Coder': {'messages': [HumanMessage(content='The code to print \"Hello, World!\" in the terminal has been executed successfully. Here is the output:\\n\\n```\\nHello, World!\\n```', additional_kwargs={}, response_metadata={}, name='Coder')]}}\n",
"(('coder:a0c2a6de-4a2d-3573-4049-cba490183bc1',), {'agent': {'messages': [AIMessage(content=[{'text': \"I'll help you calculate the square root of 42 using Python.\", 'type': 'text'}, {'id': 'toolu_011Nsa2En2Qk1SsYBdG6zveY', 'input': {'code': 'import math\\nprint(math.sqrt(42))'}, 'name': 'python_repl_tool', 'type': 'tool_use'}], additional_kwargs={}, response_metadata={'id': 'msg_016CdBcK9JKm39tsuGH6skhN', 'model': 'claude-3-5-sonnet-20241022', 'stop_reason': 'tool_use', 'stop_sequence': None, 'usage': {'input_tokens': 435, 'output_tokens': 82}}, id='run-f9be84c7-1569-4f53-9063-b1244339755b-0', tool_calls=[{'name': 'python_repl_tool', 'args': {'code': 'import math\\nprint(math.sqrt(42))'}, 'id': 'toolu_011Nsa2En2Qk1SsYBdG6zveY', 'type': 'tool_call'}], usage_metadata={'input_tokens': 435, 'output_tokens': 82, 'total_tokens': 517, 'input_token_details': {}})]}})\n",
"----\n",
"{'supervisor': {'next': 'FINISH'}}\n",
"(('coder:a0c2a6de-4a2d-3573-4049-cba490183bc1',), {'tools': {'messages': [ToolMessage(content='Successfully executed:\\n```python\\nimport math\\nprint(math.sqrt(42))\\n```\\nStdout: 6.48074069840786\\n', name='python_repl_tool', id='8b6bd229-5c63-43a4-9d63-e3b4a8468e21', tool_call_id='toolu_011Nsa2En2Qk1SsYBdG6zveY')]}})\n",
"----\n",
"(('coder:a0c2a6de-4a2d-3573-4049-cba490183bc1',), {'agent': {'messages': [AIMessage(content='The square root of 42 is approximately 6.4807 (rounded to 4 decimal places).', additional_kwargs={}, response_metadata={'id': 'msg_01QYQtz84F1Mgqyp2ecw4TEu', 'model': 'claude-3-5-sonnet-20241022', 'stop_reason': 'end_turn', 'stop_sequence': None, 'usage': {'input_tokens': 561, 'output_tokens': 28}}, id='run-b9dfff5d-f1c4-44d6-98d7-80f0e8548bcd-0', usage_metadata={'input_tokens': 561, 'output_tokens': 28, 'total_tokens': 589, 'input_token_details': {}})]}})\n",
"----\n",
"((), {'coder': {'messages': [HumanMessage(content='The square root of 42 is approximately 6.4807 (rounded to 4 decimal places).', additional_kwargs={}, response_metadata={}, name='coder')]}})\n",
"----\n",
"((), {'supervisor': {'next': '__end__'}})\n",
"----\n"
]
}
],
"source": [
"for s in graph.stream(\n",
" {\"messages\": [(\"user\", \"What's the square root of 42?\")]}, subgraphs=True\n",
"):\n",
" print(s)\n",
" print(\"----\")"
]
},
{
"cell_type": "code",
"execution_count": 12,
"id": "45a92dfd-0e11-47f5-aad4-b68d24990e34",
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"((), {'supervisor': {'next': 'researcher'}})\n",
"----\n",
"(('researcher:7daea379-a5b6-6d3d-ef85-fffc96d7472e',), {'agent': {'messages': [AIMessage(content=[{'text': \"I'll help you search for the GDP data of New York and California using the search tool. Then I'll note the values, but as instructed, I won't perform the mathematical calculation myself.\", 'type': 'text'}, {'id': 'toolu_01S9hPD5nFsW1A2nE4fwCvRc', 'input': {'query': 'latest GDP of New York state 2023'}, 'name': 'tavily_search_results_json', 'type': 'tool_use'}], additional_kwargs={}, response_metadata={'id': 'msg_01RetKetMGpP2Q51w4R8N81e', 'model': 'claude-3-5-sonnet-20241022', 'stop_reason': 'tool_use', 'stop_sequence': None, 'usage': {'input_tokens': 442, 'output_tokens': 107}}, id='run-6e738192-18ae-4c1a-bbc0-f8b8509fe656-0', tool_calls=[{'name': 'tavily_search_results_json', 'args': {'query': 'latest GDP of New York state 2023'}, 'id': 'toolu_01S9hPD5nFsW1A2nE4fwCvRc', 'type': 'tool_call'}], usage_metadata={'input_tokens': 442, 'output_tokens': 107, 'total_tokens': 549, 'input_token_details': {}})]}})\n",
"----\n",
"(('researcher:7daea379-a5b6-6d3d-ef85-fffc96d7472e',), {'tools': {'messages': [ToolMessage(content='[{\"url\": \"https://usafacts.org/metrics/gross-domestic-product-gdp-by-state-new-york/\", \"content\": \"Gross domestic product (GDP) state — New York (dollars) Adjustment. None. Adjustment. Frequency. Yearly. Frequency. In 2022 (most recent), Gross domestic product (GDP) was $2,053,179,700,000 in the United States for New York (state). ... August 25, 2023. Suggested citation: Explore in... Less detail\"}, {\"url\": \"https://www.osc.ny.gov/reports/finance/2023-fcr/economic-and-demographic-trends\", \"content\": \"These include, but are not limited to:\\\\nBecause Google Translate™ is intellectual property owned by Google Inc., you must use Google Translate™ in accord with the Google license agreement, which includes potential liability for misuse: Google Terms of Service.\\\\nOffice of the NEW YORK\\\\nSTATE COMPTROLLER\\\\nNYS Comptroller Thomas P. DiNapoli\\\\nMain navigation\\\\nGET to KnowNew York State ComptrollerThomas P. DiNapoli\\\\nRead BIO\\\\nGET to KnowNew York State ComptrollerThomas P. DiNapoli\\\\nMenu\\\\nEconomic and Demographic Trends\\\\n2023 Financial Condition Report For Fiscal Year Ended March 31, 2023\\\\nEmployment Still Below Pre- Pandemic Levels in 2022\\\\nNew York Ranked 45th Nationwide for Personal Income Growth in 2022\\\\nNYS GDP Nearly $1.6 Trillion in 2022\\\\nA state’s Gross Domestic Product (GDP) is the value of production originating from all industries in the state, as defined by the U.S. Bureau of Economic Analysis.\\\\n The State of New York, its officers, employees, and/or agents are not liable to you, or to third parties, for damages or losses of any kind arising out of, or in connection with, the use or performance of such information. New York’s Population Continued to Decline in 2022\\\\nBook traversal links for Economic and Demographic Trends\\\\nTell us more about you to receive content related to your area or interests.\\\\n The Office of the State Comptroller does not warrant, promise, assure or guarantee the accuracy of the translations provided.\"}, {\"url\": \"https://www.statista.com/statistics/188087/gdp-of-the-us-federal-state-of-new-york-since-1997/\", \"content\": \"Industry Overview\\\\nDigital & Trend reports\\\\nOverview and forecasts on trending topics\\\\nIndustry & Market reports\\\\nIndustry and market insights and forecasts\\\\nCompanies & Products reports\\\\nKey figures and rankings about companies and products\\\\nConsumer & Brand reports\\\\nConsumer and brand insights and preferences in various industries\\\\nPolitics & Society reports\\\\nDetailed information about political and social topics\\\\nCountry & Region reports\\\\nAll key figures about countries and regions\\\\nMarket forecast and expert KPIs for 1000+ markets in 190+ countries & territories\\\\nInsights on consumer attitudes and behavior worldwide\\\\nBusiness information on 100m+ public and private companies\\\\nExplore Company Insights\\\\nDetailed information for 39,000+ online stores and marketplaces\\\\nDirectly accessible data for 170 industries from 150+ countries\\\\nand over 1\\xa0Mio. facts.\\\\n Transforming data into design:\\\\nStatista Content & Design\\\\nStrategy and business building for the data-driven economy:\\\\nU.S. real GDP of New York 2000-2022\\\\nReal gross domestic product of New York in the United States\\\\nfrom 2000 to 2022\\\\n(in billion U.S. dollars)\\\\nAdditional Information\\\\nShow sources information\\\\nShow publisher information\\\\nUse Ask Statista Research Service\\\\nMarch 2023\\\\nUnited States\\\\n2000 to 2022\\\\nData presented here is in 2012 chained U.S. dollars.\\\\n Statistics on\\\\n\\\\\"\\\\nNew York\\\\n\\\\\"\\\\nOther statistics that may interest you New York\\\\nPopulation\\\\nEconomy\\\\nEmployment & Earnings\\\\nState & Local Government\\\\nNew York City\\\\nFurther related statistics\\\\nFurther Content: You might find this interesting as well\\\\nStatistics\\\\nTopics Other statistics on the topic\\\\nEconomy\\\\nU.S. real gross domestic product 2022, by state\\\\nPolitics & Government\\\\nU.S. state and local government outstanding debt 2021, by state\\\\nDemographics\\\\nResident population in New York 1960-2022\\\\nEconomy\\\\nU.S. New York metro area GDP 2001-2022\\\\nYou only have access to basic statistics.\\\\n Customized Research & Analysis projects:\\\\nGet quick analyses with our professional research service\\\\nThe best of the best: the portal for top lists & rankings:\\\\n\"}, {\"url\": \"https://www.statista.com/statistics/306777/new-york-gdp-growth/\", \"content\": \"Industry Overview\\\\nDigital & Trend reports\\\\nOverview and forecasts on trending topics\\\\nIndustry & Market reports\\\\nIndustry and market insights and forecasts\\\\nCompanies & Products reports\\\\nKey figures and rankings about companies and products\\\\nConsumer & Brand reports\\\\nConsumer and brand insights anLine truncated
"----\n",
"(('researcher:7daea379-a5b6-6d3d-ef85-fffc96d7472e',), {'agent': {'messages': [AIMessage(content=[{'id': 'toolu_015fdnpWUiuEshsEwn2nBJ1g', 'input': {'query': 'latest GDP of California state 2023'}, 'name': 'tavily_search_results_json', 'type': 'tool_use'}], additional_kwargs={}, response_metadata={'id': 'msg_01Cksgb2aaqcD2bPtam5HDPF', 'model': 'claude-3-5-sonnet-20241022', 'stop_reason': 'tool_use', 'stop_sequence': None, 'usage': {'input_tokens': 2534, 'output_tokens': 66}}, id='run-11d924ba-a494-49d6-b649-ac961e31c79c-0', tool_calls=[{'name': 'tavily_search_results_json', 'args': {'query': 'latest GDP of California state 2023'}, 'id': 'toolu_015fdnpWUiuEshsEwn2nBJ1g', 'type': 'tool_call'}], usage_metadata={'input_tokens': 2534, 'output_tokens': 66, 'total_tokens': 2600, 'input_token_details': {}})]}})\n",
"----\n",
"(('researcher:7daea379-a5b6-6d3d-ef85-fffc96d7472e',), {'tools': {'messages': [ToolMessage(content='[{\"url\": \"https://www.gov.ca.gov/2024/04/16/california-remains-the-worlds-5th-largest-economy/\", \"content\": \"California remains the 5th largest economy in the world since 2017. California is the 5th largest economy in the world for the seventh consecutive year, with a nominal GDP of nearly $3.9 trillion in 2023 and a growth rate of 6.1% since the year prior, according to the U.S. Bureau of Economic Analysis (BEA). On a per capita basis, California is\"}, {\"url\": \"https://usafacts.org/metrics/gross-domestic-product-gdp-by-state-california/\", \"content\": \"USAFacts -- In 2022 (most recent), Gross domestic product (GDP) was 3598102700000.0 in the United States for California (state). This increased by 224,862,000,000 or 6.67% from 2021. Highest: 3,598,102,700,000 in 2022.\"}, {\"url\": \"https://www.statista.com/statistics/187834/gdp-of-the-us-federal-state-of-california-since-1997/\", \"content\": \"Industry Overview\\\\nDigital & Trend reports\\\\nOverview and forecasts on trending topics\\\\nIndustry & Market reports\\\\nIndustry and market insights and forecasts\\\\nCompanies & Products reports\\\\nKey figures and rankings about companies and products\\\\nConsumer & Brand reports\\\\nConsumer and brand insights and preferences in various industries\\\\nPolitics & Society reports\\\\nDetailed information about political and social topics\\\\nCountry & Region reports\\\\nAll key figures about countries and regions\\\\nMarket forecast and expert KPIs for 1000+ markets in 190+ countries & territories\\\\nInsights on consumer attitudes and behavior worldwide\\\\nBusiness information on 100m+ public and private companies\\\\nExplore Company Insights\\\\nDetailed information for 39,000+ online stores and marketplaces\\\\nDirectly accessible data for 170 industries from 150+ countries\\\\nand over 1\\xa0Mio. facts.\\\\n Statistics on\\\\n\\\\\"\\\\nCalifornia\\\\n\\\\\"\\\\nOther statistics that may interest you California\\\\nPopulation\\\\nEconomy\\\\nEmployment & Earnings\\\\nState & Local Government\\\\nMetro Areas\\\\nFurther related statistics\\\\nFurther Content: You might find this interesting as well\\\\nStatistics\\\\nTopics Other statistics on the topicCalifornia\\\\nEconomy\\\\nU.S. leading companies headquartered in California 2023, by number of employees\\\\nEconomy\\\\nU.S. average annual wages in California 2018-2026\\\\nEconomy\\\\nU.S. California fastest growing private companies 2023, by three year growth rate\\\\nResidential Real Estate\\\\nHourly wages needed to afford a two-bedroom apartment in California 2021-23, by metro\\\\nYou only have access to basic statistics.\\\\n Additional Information\\\\nShow sources information\\\\nShow publisher information\\\\nUse Ask Statista Research Service\\\\nMarch 2023\\\\nUnited States\\\\n2000 to 2022\\\\nData presented here is in 2012 chained U.S. dollars.\\\\n Transforming data into design:\\\\nStatista Content & Design\\\\nStrategy and business building for the data-driven economy:\\\\nU.S. real GDP of California 2000-2022\\\\nReal gross domestic product of California in the United States from 2000 to 2022\\\\n(in billion U.S. dollars)\\\\n\"}, {\"url\": \"https://www.bea.gov/news/2024/gross-domestic-product-state-and-personal-income-state-4th-quarter-2023-and-preliminary\", \"content\": \"Real gross domestic product (GDP) increased in all 50 states and the District of Columbia in the fourth quarter of 2023, with the percent change ranging from 6.7 percent in Nevada to 0.2 percent in Nebraska (table 1), according to statistics released today by the U.S. Bureau of Economic Analysis (BEA). Current-dollar GDP increased in 49 states and the District of Columbia.\"}, {\"url\": \"https://www.bea.gov/news/2023/gross-domestic-product-state-and-personal-income-state-1st-quarter-2023\", \"content\": \"Real gross domestic product (GDP) increased in all 50 states and the District of Columbia in the first quarter of 2023, with the percent change ranging from 12.4 percent in North Dakota to 0.1 percent in Rhode Island and Alabama (table 1), according to statistics released today by the U.S. Bureau of Economic Analysis (BEA). Current-dollar GDP increased in 47 states and the District of Columbia\"}]', name='tavily_search_results_json', id='77de7955-ba39-4db3-9460-1a2bd7f602fb', tool_call_id='toolu_015fdnpWUiuEshsEwn2nBJ1g', artifact={'query': 'latest GDP of California state 2023', 'follow_up_questions': None, 'answer': None, 'images': [], 'results': [{'title': \"California Remains the World's 5th Largest Economy\", 'url': 'https://www.gov.ca.gov/2024/04/16/california-remains-the-worlds-5th-largest-economy/', 'content': 'California remains the 5th largest economy in the world since 2017. California is the 5th largest economy in the world for the seventh consecutive year, with a nominal GDP of nearly $3.9 trillion in 2023 and a growth rate of 6.1% sLine truncated
"----\n",
"(('researcher:7daea379-a5b6-6d3d-ef85-fffc96d7472e',), {'agent': {'messages': [AIMessage(content=\"Based on the search results, I can provide you with the latest GDP figures for both states:\\n\\nNew York:\\n- GDP: $2.053 trillion (2022 figures)\\n\\nCalifornia:\\n- GDP: $3.9 trillion (2023 figures)\\n\\nAs instructed, I won't calculate the average, but I've provided you with the most recent GDP figures for both states. Note that the figures are from different years (2022 for NY and 2023 for CA), which should be considered when calculating the average.\", additional_kwargs={}, response_metadata={'id': 'msg_013yuy2PoBUNSGNDCYXvUL27', 'model': 'claude-3-5-sonnet-20241022', 'stop_reason': 'end_turn', 'stop_sequence': None, 'usage': {'input_tokens': 3748, 'output_tokens': 120}}, id='run-d775159b-c114-4db5-b425-416f0f2f957c-0', usage_metadata={'input_tokens': 3748, 'output_tokens': 120, 'total_tokens': 3868, 'input_token_details': {}})]}})\n",
"----\n",
"((), {'researcher': {'messages': [HumanMessage(content=\"Based on the search results, I can provide you with the latest GDP figures for both states:\\n\\nNew York:\\n- GDP: $2.053 trillion (2022 figures)\\n\\nCalifornia:\\n- GDP: $3.9 trillion (2023 figures)\\n\\nAs instructed, I won't calculate the average, but I've provided you with the most recent GDP figures for both states. Note that the figures are from different years (2022 for NY and 2023 for CA), which should be considered when calculating the average.\", additional_kwargs={}, response_metadata={}, name='researcher')]}})\n",
"----\n",
"((), {'supervisor': {'next': 'coder'}})\n",
"----\n",
"(('coder:2c47a596-d75b-143e-9b4a-a99f78779aec',), {'agent': {'messages': [AIMessage(content=[{'text': \"I'll help calculate the average GDP between New York ($2.053 trillion) and California ($3.9 trillion).\", 'type': 'text'}, {'id': 'toolu_019yGU4aBc9H73jfRWr1iKtf', 'input': {'code': 'ny_gdp = 2.053\\nca_gdp = 3.9\\n\\naverage_gdp = (ny_gdp + ca_gdp) / 2\\n\\nprint(f\"New York GDP: ${ny_gdp} trillion\")\\nprint(f\"California GDP: ${ca_gdp} trillion\")\\nprint(f\"Average GDP: ${average_gdp:.3f} trillion\")'}, 'name': 'python_repl_tool', 'type': 'tool_use'}], additional_kwargs={}, response_metadata={'id': 'msg_01PGbexsWGaf4LQbKDH8toJs', 'model': 'claude-3-5-sonnet-20241022', 'stop_reason': 'tool_use', 'stop_sequence': None, 'usage': {'input_tokens': 558, 'output_tokens': 175}}, id='run-355dc875-adcc-436c-b0f3-675dc1c099bd-0', tool_calls=[{'name': 'python_repl_tool', 'args': {'code': 'ny_gdp = 2.053\\nca_gdp = 3.9\\n\\naverage_gdp = (ny_gdp + ca_gdp) / 2\\n\\nprint(f\"New York GDP: ${ny_gdp} trillion\")\\nprint(f\"California GDP: ${ca_gdp} trillion\")\\nprint(f\"Average GDP: ${average_gdp:.3f} trillion\")'}, 'id': 'toolu_019yGU4aBc9H73jfRWr1iKtf', 'type': 'tool_call'}], usage_metadata={'input_tokens': 558, 'output_tokens': 175, 'total_tokens': 733, 'input_token_details': {}})]}})\n",
"----\n",
"(('coder:2c47a596-d75b-143e-9b4a-a99f78779aec',), {'tools': {'messages': [ToolMessage(content='Successfully executed:\\n```python\\nny_gdp = 2.053\\nca_gdp = 3.9\\n\\naverage_gdp = (ny_gdp + ca_gdp) / 2\\n\\nprint(f\"New York GDP: ${ny_gdp} trillion\")\\nprint(f\"California GDP: ${ca_gdp} trillion\")\\nprint(f\"Average GDP: ${average_gdp:.3f} trillion\")\\n```\\nStdout: New York GDP: $2.053 trillion\\nCalifornia GDP: $3.9 trillion\\nAverage GDP: $2.976 trillion\\n', name='python_repl_tool', id='39106042-eb3e-485c-8d62-bb2f572fbf8b', tool_call_id='toolu_019yGU4aBc9H73jfRWr1iKtf')]}})\n",
"----\n",
"(('coder:2c47a596-d75b-143e-9b4a-a99f78779aec',), {'agent': {'messages': [AIMessage(content=\"Based on the calculations:\\n- New York's GDP: $2.053 trillion (2022)\\n- California's GDP: $3.9 trillion (2023)\\n- The average GDP between the two states is $2.976 trillion\\n\\nNote: As mentioned earlier, these GDP figures are from different years (2022 for NY and 2023 for CA), which should be taken into consideration when interpreting the average.\", additional_kwargs={}, response_metadata={'id': 'msg_016GGgrPRH3psSoWUw7TzTQu', 'model': 'claude-3-5-sonnet-20241022', 'stop_reason': 'end_turn', 'stop_sequence': None, 'usage': {'input_tokens': 877, 'output_tokens': 98}}, id='run-55436cea-0fab-4fa3-a691-3a80a0afb431-0', usage_metadata={'input_tokens': 877, 'output_tokens': 98, 'total_tokens': 975, 'input_token_details': {}})]}})\n",
"----\n",
"((), {'coder': {'messages': [HumanMessage(content=\"Based on the calculations:\\n- New York's GDP: $2.053 trillion (2022)\\n- California's GDP: $3.9 trillion (2023)\\n- The average GDP between the two states is $2.976 trillion\\n\\nNote: As mentioned earlier, these GDP figures are from different years (2022 for NY and 2023 for CA), which should be taken into consideration when interpreting the average.\", additional_kwargs={}, response_metadata={}, name='coder')]}})\n",
"----\n",
"((), {'supervisor': {'next': '__end__'}})\n",
"----\n"
]
}
@@ -317,46 +417,16 @@
"for s in graph.stream(\n",
" {\n",
" \"messages\": [\n",
" HumanMessage(content=\"Code hello world and print it to the terminal\")\n",
" (\n",
" \"user\",\n",
" \"Find the latest GDP of New York and California, then calculate the average\",\n",
" )\n",
" ]\n",
" }\n",
" },\n",
" subgraphs=True,\n",
"):\n",
" if \"__end__\" not in s:\n",
" print(s)\n",
" print(\"----\")"
]
},
{
"cell_type": "code",
"execution_count": 7,
"id": "45a92dfd-0e11-47f5-aad4-b68d24990e34",
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"{'supervisor': {'next': 'Researcher'}}\n",
"----\n",
"{'Researcher': {'messages': [HumanMessage(content='### Research Report on Pikas\\n\\n#### Introduction\\nPikas are small, herbivorous mammals belonging to the family Ochotonidae, closely related to rabbits and hares. These animals are known for their distinctive high-pitched calls and are often found in cold, mountainous regions across Asia, North America, and parts of Europe.\\n\\n#### Habitat and Behavior\\nPikas primarily inhabit talus slopes and alpine meadows, often at elevations ranging from 2,500 to over 13,000 feet. These environments provide the necessary rock crevices and vegetation required for their survival. Pikas are diurnal and exhibit two main foraging behaviors: direct consumption of plants and the collection of vegetation into \"haypiles\" for winter storage. Unlike many small mammals, pikas do not hibernate and remain active throughout the winter, relying on these haypiles for sustenance.\\n\\n#### Diet and Feeding Habits\\nPikas are generalist herbivores, feeding on a variety of grasses, forbs, and small shrubs. They have a highly developed behavior known as \"haying,\" where they collect and store plant material during the summer months to ensure a food supply during the harsh winter. This behavior is crucial for their survival, as the stored hay provides the necessary nutrients when fresh vegetation is scarce.\\n\\n#### Reproduction and Lifecycle\\nPikas have a relatively short lifespan, averaging around three years. They typically breed once or twice a year, with a gestation period of roughly 30 days. Females usually give birth to litters of two to six young. The young are weaned and become independent within a month, reaching sexual maturity by the following spring.\\n\\n#### Conservation Status\\nThe conservation status of pikas varies by region and species. The American pika (Ochotona princeps), found in the mountains of western North America, is particularly vulnerable to climate change. Rising temperatures and reduced snowpack threaten their habitat, forcing pikas to move to higher elevations or face local extirpation. Despite these challenges, the American pika is not currently listed under the US Endangered Species Act, although several studies indicate localized population declines.\\n\\n#### Conclusion\\nPikas are fascinating creatures that play a vital role in their alpine ecosystems. Their unique behaviors, such as haying, and their sensitivity to climate change make them important indicators of environmental health. Continued research and conservation efforts are essential to ensure the survival of these small but significant mammals in the face of global climatic shifts.\\n\\n#### References\\n1. Wikipedia - Pika: [Link](https://en.wikipedia.org/wiki/Pika)\\n2. Wikipedia - American Pika: [Link](https://en.wikipedia.org/wiki/American_pika)\\n3. Animal Spot - American Pika: [Link](https://www.animalspot.net/american-pika.html)\\n4. Animalia - American Pika: [Link](https://animalia.bio/index.php/american-pika)\\n5. National Park Service - Pikas Resource Brief: [Link](https://www.nps.gov/articles/pikas-brief.htm)\\n6. Alaska Department of Fish and Game - Pikas: [Link](https://www.adfg.alaska.gov/static/education/wns/pikas.pdf)\\n7. NatureMapping Foundation - American Pika: [Link](http://naturemappingfoundation.org/natmap/facts/american_pika_712.html)\\n8. USDA Forest Service - Conservation Status of Pikas: [Link](https://www.fs.usda.gov/psw/publications/millar/psw_2022_millar002.pdf)', additional_kwargs={}, response_metadata={}, name='Researcher')]}}\n",
"----\n",
"{'supervisor': {'next': 'Coder'}}\n",
"----\n",
"{'Coder': {'messages': [HumanMessage(content='### Research Report on Pikas\\n\\n#### Introduction\\nPikas are small, herbivorous mammals belonging to the family Ochotonidae, closely related to rabbits and hares. These animals are known for their distinctive high-pitched calls and are often found in cold, mountainous regions across Asia, North America, and parts of Europe.\\n\\n#### Habitat and Behavior\\nPikas primarily inhabit talus slopes and alpine meadows, often at elevations ranging from 2,500 to over 13,000 feet. These environments provide the necessary rock crevices and vegetation required for their survival. Pikas are diurnal and exhibit two main foraging behaviors: direct consumption of plants and the collection of vegetation into \"haypiles\" for winter storage. Unlike many small mammals, pikas do not hibernate and remain active throughout the winter, relying on these haypiles for sustenance.\\n\\n#### Diet and Feeding Habits\\nPikas are generalist herbivores, feeding on a variety of grasses, forbs, and small shrubs. They have a highly developed behavior known as \"haying,\" where they collect and store plant material during the summer months to ensure a food supply during the harsh winter. This behavior is crucial for their survival, as the stored hay provides the necessary nutrients when fresh vegetation is scarce.\\n\\n#### Reproduction and Lifecycle\\nPikas have a relatively short lifespan, averaging around three years. They typically breed once or twice a year, with a gestation period of roughly 30 days. Females usually give birth to litters of two to six young. The young are weaned and become independent within a month, reaching sexual maturity by the following spring.\\n\\n#### Conservation Status\\nThe conservation status of pikas varies by region and species. The American pika (Ochotona princeps), found in the mountains of western North America, is particularly vulnerable to climate change. Rising temperatures and reduced snowpack threaten their habitat, forcing pikas to move to higher elevations or face local extirpation. Despite these challenges, the American pika is not currently listed under the US Endangered Species Act, although several studies indicate localized population declines.\\n\\n#### Conclusion\\nPikas are fascinating creatures that play a vital role in their alpine ecosystems. Their unique behaviors, such as haying, and their sensitivity to climate change make them important indicators of environmental health. Continued research and conservation efforts are essential to ensure the survival of these small but significant mammals in the face of global climatic shifts.\\n\\n#### References\\n1. Wikipedia - Pika: [Link](https://en.wikipedia.org/wiki/Pika)\\n2. Wikipedia - American Pika: [Link](https://en.wikipedia.org/wiki/American_pika)\\n3. Animal Spot - American Pika: [Link](https://www.animalspot.net/american-pika.html)\\n4. Animalia - American Pika: [Link](https://animalia.bio/index.php/american-pika)\\n5. National Park Service - Pikas Resource Brief: [Link](https://www.nps.gov/articles/pikas-brief.htm)\\n6. Alaska Department of Fish and Game - Pikas: [Link](https://www.adfg.alaska.gov/static/education/wns/pikas.pdf)\\n7. NatureMapping Foundation - American Pika: [Link](http://naturemappingfoundation.org/natmap/facts/american_pika_712.html)\\n8. USDA Forest Service - Conservation Status of Pikas: [Link](https://www.fs.usda.gov/psw/publications/millar/psw_2022_millar002.pdf)', additional_kwargs={}, response_metadata={}, name='Coder')]}}\n",
"----\n",
"{'supervisor': {'next': 'FINISH'}}\n",
"----\n"
]
}
],
"source": [
"for s in graph.stream(\n",
" {\"messages\": [HumanMessage(content=\"Write a brief research report on pikas.\")]},\n",
" {\"recursion_limit\": 100},\n",
"):\n",
" if \"__end__\" not in s:\n",
" print(s)\n",
" print(\"----\")"
" print(s)\n",
" print(\"----\")"
]
}
],
@@ -2,8 +2,8 @@
"cells": [
{
"attachments": {
"50a6ed47-ace3-428e-8dcf-a13ec56c11d6.png": {
"image/png": "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 truncated
"d98ed25c-51cb-441f-a6f4-016921d59fc3.png": {
"image/png": "iVBORw0KGgoAAAANSUhEUgAABaIAAAP8CAIAAAA7q14UAAAAAXNSR0IArs4c6QAAAERlWElmTU0AKgAAAAgAAYdpAAQAAAABAAAAGgAAAAAAA6ABAAMAAAABAAEAAKACAAQAAAABAAAFoqADAAQAAAABAAAD/AAAAADsXbjNAABAAElEQVR4AezdecAkRX03cFfwDhgVFRBY1JgoEI1HfPbxgnjiAV7AridiNB4R3UVNBPGViEcC6q6Jxmg8Iom6C14QQRAUJcrugxfegKKugopX5BDEa9+vlGmGeY6dZ545uns+zx9rT091ddWn5nmkf/OrqmVbtmy5nh8CBAgQIECAAAECBAgQIECAQPMFrt/8LugBAQIECBAgQIAAAQIECBAgQOD3AsIcPgcECBAgQIAAAQIECBAgQIBASwSEOVoykLpBgAABAgQIECBAgAABAgQICHP4DBAgQIAAAQIECBAgQIAAAQItERDmaMlA6gYBAgQIECBAgAABAgQIECAgzOEzQIAAAQIECBAgQIAAAQIECLREQJijJQOpGwQIECBAgAABAgQIECBAgIAwh88AAQIECBAgQIAAAQIECBAg0BIBYY6WDKRuECBAgAABAgQIECBAgAABAsIcPgMECBAgQIAAAQIECBAgQIBASwSEOVoykLpBgAABAgQIECBAgAABAgQICHP4DBAgQIAAAQIECBAgQIAAAQItERDmaMlA6gYBAgQIECBAgAABAgQIECAgzOEzQIAAAQIECBAgQIAAAQIECLREQJijJQOpGwQIECBAgAABAgQIECBAgIAwh88AAQIECBAgQIAAAQIECBAg0BIBYY6WDKRuECBAgAABAgQIECBAgAABAsIcPgMECBAgQIAAAQIECBAgQIBASwSEOVoykLpBgAABAgQIECBAgAABAgQICHP4DBAgQIAAAQIECBAgQIAAAQItERDmaMlA6gYBAgQIECBAgAABAgQIECAgzOEzQIAAAQIECBAgQIAAAQIECLREQJijJQOpGwQIECBAgAABAgQIECBAgIAwh88AAQIECBAgQIAAAQIECBAg0BIBYY6WDKRuECBAgAABAgQIECBAgAABAsIcPgMECBAgQIAAAQIECBAgQIBASwSEOVoykLpBgAABAgQIECBAgAABAgQICHP4DBAgQIAAAQIECBAgQIAAAQItERDmaMlA6gYBAgQIECBAgAABAgQIECAgzOEzQIAAAQIECBAgQIAAAQIECLREQJijJQOpGwQIECBAgAABAgQIECBAgIAwh88AAQIECBAgQIAAAQIECBAg0BIBYY6WDKRuECBAgAABAgQIECBAgAABAsIcPgMECBAgQIAAAQIECBAgQIBASwSEOVoykLpBgAABAgQIECBAgAABAgQICHP4DBAgQIAAAQIECBAgQIAAAQItERDmaMlA6gYBAgQIECBAgAABAgQIECAgzOEzQIAAAQIECBAgQIAAAQIECLREQJijJQOpGwQIECBAgAABAgQIECBAgIAwh88AAQIECBAgQIAAAQIECBAg0BIBYY6WDKRuECBAgAABAgQIECBAgAABAsIcPgMECBAgQIAAAQIECBAgQIBASwSEOVoykLpBgAABAgQIECBAgAABAgQICHP4DBAgQIAAAQIECBAgQIAAAQItERDmaMlA6gYBAgQIECBAgAABAgQIECAgzOEzQIAAAQIECBAgQIAAAQIECLREQJijJQOpGwQIECBAgAABAgQIECBAgIAwh88AAQIECBAgQIAAAQIECBAg0BIBYY6WDKRuECBAgAABAgQIECBAgAABAsIcPgMECBAgQIAAAQIECBAgQIBASwSEOVoykLpBgAABAgQIECBAgAABAgQICHP4DBAgQIAAAQIECBAgQIAAAQItERDmaMlA6gYBAgQIECBAgAABAgQIECAgzOEzQIAAAQIECBAgQIAAAQIECLREQJijJQOpGwQIECBAgAABAgQIECBAgMC2CAgQIECAwCQIbNq0qXRz48aNLevvzMxM3z2amprq+1oXEhiXwPT0dG69YsWKcTXAfQkQIECgzgLLtmzZUuf2aRsBAgQIEOhPIHGNdevWlWsT2ijPRXmqLwf91Tn7quYGTZYSHJnt4EyjBcYS7Vrsb2L1u1Y+utXL1atXBz+1iXo0+kOo8QQIEBiggDDHADFVRYAAAQK1EOgMcJRHIM8/tRgYjSAwUIH8ppdgRxXQzO/7mjVrBnoTlREgQIBA8wSEOZo3ZlpMgAABAnMKlOhGHnvyvW6edoQ25lRykkArBdauXZt+lXiHYEcrh1inCBAg0LuAtTl6t1KSAAECBOorkIecPOHk8SY/Ahz1HSctIzAcgc4kjhLsMI1lONJqJUCAQAMEZHM0YJA0kQABAgQWFli1alUKrF+/fuFi3iVAYBIEStAzPd2wYYOg5ySMuD4SIECgS8CGsl0gXhIgQIBAkwQyUWX58uVZQFGMo0nDpq0EhimQzI7Nmzcnm2PlypX5EzHMW6mbAAECBOooIJujjqOiTQQIECDQi0C+s82eC2ap9GKlDIEJFEieVxbrkdMxgUOvywQITLiAbI4J/wDoPgECBJoqkC9pE+NIEoek9KYOoXYTGLJAYqC5Q7UPy5DvpnoCBAgQqIuAMEddRkI7CBAgQGBRAklHL88wi7pKYQIEJkcgMdCkciShw9SVyRl0PSVAgEAETFrxMSBAgACB5gmUzSM791ZoXh+0mACBkQhYongkzG5CgACBGgkIc9RoMDSFAAECBHoREOPoRUkZAgQqgSxUnOQvgdEKxAEBAgTaLSDM0e7x1TsCBAi0TSDJ55mukm0U2tYx/SFAYGgCZYtZfzeGBqxiAgQI1EvA2hz1Gg+tIUCAAIGFBTLN3pIcCxN5lwCBLoGSx2GFji4WLwkQINBWAdkcbR1Z/SJAgEA7BZJ87ivZdg6tXhEYpoAVOoapq24CBAjUS0A2R73GQ2sIECBAYAGBZJ5L5VjAx1sECMwn4E/HfDLOEyBAoH0CwhztG1M9IkCAQGsF1q1b19q+6RgBAkMWyJS3Id9B9QQIECBQCwFhjloMg0YQIECAwFYFyrx6eyVsFUoBAgRmC6xYsWJ6etryHLNlnCFAgED7BIQ52jemekSAAIF2Clh8tJ3jqlcERiggI2yE2G5FgACBsQkIc4yN3o0JECBAYFECMzMz+TJ2UZcoTIAAgUrA8hwVhQMCBAi0W0CYo93jq3cECBBoj4B59e0ZSz0hQIAAAQIECAxNQJhjaLQqJkCAAIFBC2R2/aCrVB8BApMi4A/IpIy0fhIgMPECwhwT/xEAQIAAgSYIZOFAM1aaMFDaSKDWApLCaj08GkeAAIEBCQhzDAhSNQQIECAwZIGpqakh30H1BAgQIECAAAECjRcQ5mj8EOoAAQIEJkHAd7CTMMr6SGDYApLChi2sfgIECNRBQJijDqOgDQQIECBAgAABAgQIECBAgMAABIQ5BoCoCgIECBAYgYCvYUeA7BYEWi+QhX5a30cdJECAwIQLCHNM+AdA9wkQIECAAAECBAgQIECAQHsEhDnaM5Z6QoAAAQIECBAgQIAAAQIEJlxAmGPCPwC6T4AAAQIECBAgQIAAAQIE2iMgzNGesdQTAgQIECBAgAABAgQIECAw4QLCHBP+AdB9AgQIECBAgAABAgQIECDQHgFhjvaMpZ4QIECAAAECBAgQIECAAIEJFxDmmPAPgO4TIECAAAECBAgQIECAAIH2CAhztGcs9YQAAQIECBAgQIAAAQIECEy4gDDHhH8AdJ8AAQIECBAgQIAAAQIECLRHQJijPWOpJwQIEGi3wMaNG9vdQb0jQIAAAQIECBBYuoAwx9IN1UCAAAECBAgQIECAAAECBAjUQkCYoxbDoBEECBAgQIAAAQIECBAgQIDA0gWEOZZuqAYCBAgQIECAAAECBAgQIECgFgLCHLUYBo0gQIAAAQIECBAgQIAAAQIEli4gzLF0QzUQIECAAAECBAgQIECAAAECtRAQ5qjFMGgEAQIECBAgQIAAAQIECBAgsHQBYY6lG6qBAAECBAgQIECAAAECBAgQqIWAMEcthkEjCBAgQIAAAQIECBAgQIAAgaULCHMs3VANBAgQIECAAAECBAgQIECAQC0EhDlqMQwaQYAAAQIECBAgQIAAAQIECCxdQJhj6YZqIECAAAECBAgQIECAAAECBGohIMxRi2HQCAIECBAgQIAAAQIECBAgQGDpAsIcSzdUAwECBAgQIECAAAECBAgQIFALAWGOWgyDRhAgQIAAAQIECBAgQIAAAQJLFxDmWLqhGggQIECAAAECBAgQIECAAIFaCAhz1GIYNIIAAQIEtiowMzOz1TIKECBAgAABAgQITLiAMMeEfwB0nwABAgQIECBAgAABAgQItEdAmKM9Y6knBAgQIECAAAECBAgQIEBgwgWEOSb8A6D7BAgQIECAAAECBAgQIECgPQLCHO0ZSz0hQIAAAQIECBBYWGDFihULF/AuAQIECDRdQJij6SOo/QQIECBAYGACW7ZsOf7441/96lf/8pe/XKDSX/3qV695zWvWrVv3wx/+cIFi3iJAgAABAgQIjF5g29Hf0h0JECBAgACBegqcfvrpL37xi9O2HXfc8elPf/p8jTzzzDP/7d/+Le9m+5v3vve98xVzngABAgQIECAwegHZHKM3d0cCBAgQIFBTga985SulZT/60Y8WaOIuu+xS3j377LOT2bFASW8RIECAAAECBEYsIMwxYnC3I0CAAAEC9RU45ZRTSuP222+/BVq55557Vu9effXV1bEDAgQIECBAgMDYBYQ5xj4EGkCAAAECBGoh8M1vfvMb3/hGmrLXXnt1BjJmN64zg+Oyyy6bXSBnsszH97///Ysuuug3v/nNnAWcJECAAAECBAgMQ8DaHMNQVScBAgQIEGiewKmnnloafdBBBy3c+iuuuKIqcIMb3KA6zkECJR/96Ec//vGPf/azLine truncated
}
},
"cell_type": "markdown",
@@ -22,7 +22,7 @@
"\n",
"To do this, let's build a simple research assistant! The graph will look something like the following:\n",
"\n",
"![diagram](attachment:50a6ed47-ace3-428e-8dcf-a13ec56c11d6.png)\n",
"![diagram](attachment:d98ed25c-51cb-441f-a6f4-016921d59fc3.png)\n",
"\n",
"This notebook is inspired by the paper [AutoGen: Enabling Next-Gen LLM Applications via Multi-Agent Conversation](https://arxiv.org/abs/2308.08155), by Wu, et. al. In the rest of this notebook, you will:\n",
"\n",
@@ -49,12 +49,12 @@
"outputs": [],
"source": [
"%%capture --no-stderr\n",
"%pip install -U langgraph langchain langchain_openai langchain_experimental"
"%pip install -U langgraph langchain_community langchain_anthropic langchain_experimental"
]
},
{
"cell_type": "code",
"execution_count": 2,
"execution_count": null,
"id": "30c2f3de-c730-4aec-85a6-af2c2f058803",
"metadata": {
"ExecuteTime": {
@@ -108,7 +108,7 @@
},
{
"cell_type": "code",
"execution_count": 16,
"execution_count": null,
"id": "4024eb89-843d-4cc3-ab3f-e1eb4d031179",
"metadata": {
"ExecuteTime": {
@@ -155,7 +155,7 @@
},
{
"cell_type": "code",
"execution_count": 17,
"execution_count": 4,
"id": "f20a18ca-2709-4c12-84f3-88678591a9fa",
"metadata": {
"ExecuteTime": {
@@ -190,7 +190,7 @@
"\n",
"@tool\n",
"def read_document(\n",
" file_name: Annotated[str, \"File path to save the document.\"],\n",
" file_name: Annotated[str, \"File path to read the document from.\"],\n",
" start: Annotated[Optional[int], \"The start line. Default is 0\"] = None,\n",
" end: Annotated[Optional[int], \"The end line. Default is None\"] = None,\n",
") -> str:\n",
@@ -246,7 +246,7 @@
"\n",
"\n",
"@tool\n",
"def python_repl(\n",
"def python_repl_tool(\n",
" code: Annotated[str, \"The python code to execute to generate your chart.\"],\n",
"):\n",
" \"\"\"Use this to execute python code. If you want to see the output of a value,\n",
@@ -275,7 +275,7 @@
},
{
"cell_type": "code",
"execution_count": 18,
"execution_count": 5,
"id": "e09fb60f-1aac-455b-b67d-8d2e4ccfd747",
"metadata": {
"ExecuteTime": {
@@ -285,68 +285,47 @@
},
"outputs": [],
"source": [
"from typing import List, Optional\n",
"from langchain.output_parsers.openai_functions import JsonOutputFunctionsParser\n",
"from langchain_core.prompts import ChatPromptTemplate, MessagesPlaceholder\n",
"from langchain_openai import ChatOpenAI\n",
"from typing import List, Optional, Literal\n",
"from langchain_core.language_models.chat_models import BaseChatModel\n",
"\n",
"from langgraph.graph import END, StateGraph, START\n",
"from langgraph.graph import StateGraph, MessagesState, START, END\n",
"from langchain_core.messages import HumanMessage, trim_messages\n",
"\n",
"llm = ChatOpenAI(model=\"gpt-4o-mini\")\n",
"\n",
"trimmer = trim_messages(\n",
" max_tokens=100000,\n",
" strategy=\"last\",\n",
" token_counter=llm,\n",
" include_system=True,\n",
")\n",
"# The agent state is the input to each node in the graph\n",
"class AgentState(MessagesState):\n",
" # The 'next' field indicates where to route to next\n",
" next: str\n",
"\n",
"\n",
"def agent_node(state, agent, name):\n",
" result = agent.invoke(state)\n",
" return {\n",
" \"messages\": [HumanMessage(content=result[\"messages\"][-1].content, name=name)]\n",
" }\n",
"\n",
"\n",
"def create_team_supervisor(llm: ChatOpenAI, system_prompt, members) -> str:\n",
" \"\"\"An LLM-based router.\"\"\"\n",
"def make_supervisor_node(llm: BaseChatModel, members: list[str]) -> str:\n",
" options = [\"FINISH\"] + members\n",
" function_def = {\n",
" \"name\": \"route\",\n",
" \"description\": \"Select the next role.\",\n",
" \"parameters\": {\n",
" \"title\": \"routeSchema\",\n",
" \"type\": \"object\",\n",
" \"properties\": {\n",
" \"next\": {\n",
" \"title\": \"Next\",\n",
" \"anyOf\": [\n",
" {\"enum\": options},\n",
" ],\n",
" },\n",
" },\n",
" \"required\": [\"next\"],\n",
" },\n",
" }\n",
" prompt = ChatPromptTemplate.from_messages(\n",
" [\n",
" (\"system\", system_prompt),\n",
" MessagesPlaceholder(variable_name=\"messages\"),\n",
" (\n",
" \"system\",\n",
" \"Given the conversation above, who should act next?\"\n",
" \" Or should we FINISH? Select one of: {options}\",\n",
" ),\n",
" ]\n",
" ).partial(options=str(options), team_members=\", \".join(members))\n",
" return (\n",
" prompt\n",
" | trimmer\n",
" | llm.bind_functions(functions=[function_def], function_call=\"route\")\n",
" | JsonOutputFunctionsParser()\n",
" )"
" system_prompt = (\n",
" \"You are a supervisor tasked with managing a conversation between the\"\n",
" f\" following workers: {members}. Given the following user request,\"\n",
" \" respond with the worker to act next. Each worker will perform a\"\n",
" \" task and respond with their results and status. When finished,\"\n",
" \" respond with FINISH.\"\n",
" )\n",
"\n",
" class Router(TypedDict):\n",
" \"\"\"Worker to route to next. If no workers needed, route to FINISH.\"\"\"\n",
"\n",
" next: Literal[*options]\n",
"\n",
" def supervisor_node(state: MessagesState) -> MessagesState:\n",
" \"\"\"An LLM-based router.\"\"\"\n",
" messages = [\n",
" {\"role\": \"system\", \"content\": system_prompt},\n",
" ] + state[\"messages\"]\n",
" response = llm.with_structured_output(Router).invoke(messages)\n",
" next_ = response[\"next\"]\n",
" if next_ == \"FINISH\":\n",
" next_ = END\n",
"\n",
" return {\"next\": next_}\n",
"\n",
" return supervisor_node"
]
},
{
@@ -365,7 +344,7 @@
},
{
"cell_type": "code",
"execution_count": 19,
"execution_count": 6,
"id": "53db0c78-e357-48ba-ae5f-3fc04735a3b7",
"metadata": {
"ExecuteTime": {
@@ -375,43 +354,37 @@
},
"outputs": [],
"source": [
"import functools\n",
"import operator\n",
"\n",
"from langchain_core.messages import BaseMessage, HumanMessage\n",
"from langchain_openai.chat_models import ChatOpenAI\n",
"from langchain_core.messages import HumanMessage\n",
"from langchain_openai import ChatOpenAI\n",
"from langgraph.prebuilt import create_react_agent\n",
"\n",
"\n",
"# ResearchTeam graph state\n",
"class ResearchTeamState(TypedDict):\n",
" # A message is added after each team member finishes\n",
" messages: Annotated[List[BaseMessage], operator.add]\n",
" # The team members are tracked so they are aware of\n",
" # the others' skill-sets\n",
" team_members: List[str]\n",
" # Used to route work. The supervisor calls a function\n",
" # that will update this every time it makes a decision\n",
" next: str\n",
"\n",
"\n",
"llm = ChatOpenAI(model=\"gpt-4o\")\n",
"\n",
"search_agent = create_react_agent(llm, tools=[tavily_tool])\n",
"search_node = functools.partial(agent_node, agent=search_agent, name=\"Search\")\n",
"\n",
"research_agent = create_react_agent(llm, tools=[scrape_webpages])\n",
"research_node = functools.partial(agent_node, agent=research_agent, name=\"WebScraper\")\n",
"\n",
"supervisor_agent = create_team_supervisor(\n",
" llm,\n",
" \"You are a supervisor tasked with managing a conversation between the\"\n",
" \" following workers: Search, WebScraper. Given the following user request,\"\n",
" \" respond with the worker to act next. Each worker will perform a\"\n",
" \" task and respond with their results and status. When finished,\"\n",
" \" respond with FINISH.\",\n",
" [\"Search\", \"WebScraper\"],\n",
")"
"def search_node(state: AgentState) -> AgentState:\n",
" result = search_agent.invoke(state)\n",
" return {\n",
" \"messages\": [\n",
" HumanMessage(content=result[\"messages\"][-1].content, name=\"search\")\n",
" ]\n",
" }\n",
"\n",
"\n",
"web_scraper_agent = create_react_agent(llm, tools=[scrape_webpages])\n",
"\n",
"\n",
"def web_scraper_node(state: AgentState) -> AgentState:\n",
" result = web_scraper_agent.invoke(state)\n",
" return {\n",
" \"messages\": [\n",
" HumanMessage(content=result[\"messages\"][-1].content, name=\"web_scraper\")\n",
" ]\n",
" }\n",
"\n",
"\n",
"research_supervisor_node = make_supervisor_node(llm, [\"search\", \"web_scraper\"])"
]
},
{
@@ -424,7 +397,7 @@
},
{
"cell_type": "code",
"execution_count": 20,
"execution_count": 7,
"id": "1a7a1260-d9f6-4011-b2b1-13fab5126997",
"metadata": {
"ExecuteTime": {
@@ -434,41 +407,25 @@
},
"outputs": [],
"source": [
"research_graph = StateGraph(ResearchTeamState)\n",
"research_graph.add_node(\"Search\", search_node)\n",
"research_graph.add_node(\"WebScraper\", research_node)\n",
"research_graph.add_node(\"supervisor\", supervisor_agent)\n",
"research_builder = StateGraph(MessagesState)\n",
"research_builder.add_node(\"supervisor\", research_supervisor_node)\n",
"research_builder.add_node(\"search\", search_node)\n",
"research_builder.add_node(\"web_scraper\", web_scraper_node)\n",
"\n",
"# Define the control flow\n",
"research_graph.add_edge(\"Search\", \"supervisor\")\n",
"research_graph.add_edge(\"WebScraper\", \"supervisor\")\n",
"research_graph.add_conditional_edges(\n",
" \"supervisor\",\n",
" lambda x: x[\"next\"],\n",
" {\"Search\": \"Search\", \"WebScraper\": \"WebScraper\", \"FINISH\": END},\n",
")\n",
"research_builder.add_edge(START, \"supervisor\")\n",
"# We want our workers to ALWAYS \"report back\" to the supervisor when done\n",
"research_builder.add_edge(\"search\", \"supervisor\")\n",
"research_builder.add_edge(\"web_scraper\", \"supervisor\")\n",
"# Add the edges where routing applies\n",
"research_builder.add_conditional_edges(\"supervisor\", lambda state: state[\"next\"])\n",
"\n",
"\n",
"research_graph.add_edge(START, \"supervisor\")\n",
"chain = research_graph.compile()\n",
"\n",
"\n",
"# The following functions interoperate between the top level graph state\n",
"# and the state of the research sub-graph\n",
"# this makes it so that the states of each graph don't get intermixed\n",
"def enter_chain(message: str):\n",
" results = {\n",
" \"messages\": [HumanMessage(content=message)],\n",
" }\n",
" return results\n",
"\n",
"\n",
"research_chain = enter_chain | chain"
"research_graph = research_builder.compile()"
]
},
{
"cell_type": "code",
"execution_count": 21,
"execution_count": 8,
"id": "110f59bed6134685",
"metadata": {
"ExecuteTime": {
@@ -479,7 +436,7 @@
"outputs": [
{
"data": {
"image/jpeg": "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 truncated
"image/png": "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 truncated
"text/plain": [
"<IPython.core.display.Image object>"
]
@@ -491,7 +448,7 @@
"source": [
"from IPython.display import Image, display\n",
"\n",
"display(Image(chain.get_graph(xray=True).draw_mermaid_png()))"
"display(Image(research_graph.get_graph().draw_mermaid_png()))"
]
},
{
@@ -504,7 +461,7 @@
},
{
"cell_type": "code",
"execution_count": 7,
"execution_count": 9,
"id": "912b0604-a178-4246-a36f-2dedae606680",
"metadata": {
"ExecuteTime": {
@@ -517,22 +474,26 @@
"name": "stdout",
"output_type": "stream",
"text": [
"{'supervisor': {'next': 'Search'}}\n",
"{'supervisor': {'next': 'search'}}\n",
"---\n",
"{'Search': {'messages': [HumanMessage(content='Taylor Swift\\'s next tour is called \"The Eras Tour,\" which is scheduled to hit U.S. stadiums beginning in March 2023 and running into August, with international dates set to be revealed later. The tour has already started with some shows, including the kickoff on March 18, 2023, in Glendale, AZ. The U.S. leg is set to wrap up in Los Angeles at SoFi Stadium on August 9, 2023.\\n\\nFor specific dates and locations, you may want to check Taylor Swift\\'s official website or trusted ticketing platforms, as the tour dates and details are subject to change.', name='Search')]}}\n",
"{'search': {'messages': [HumanMessage(content=\"Taylor Swift's next tour is The Eras Tour, which includes both U.S. and international dates. She announced additional U.S. dates for 2024. You can find more details about the tour and ticket information on platforms like Ticketmaster and official announcements.\", additional_kwargs={}, response_metadata={}, name='search', id='4df8687b-50a8-4342-aad5-680732c4a10f')]}}\n",
"---\n",
"{'supervisor': {'next': 'FINISH'}}\n",
"{'supervisor': {'next': 'web_scraper'}}\n",
"---\n",
"{'web_scraper': {'messages': [HumanMessage(content='Taylor Swift\\'s next tour is \"The Eras Tour.\" Here are some of the upcoming international dates for 2024 that were listed on Ticketmaster:\\n\\n1. **Toronto, ON, Canada** at Rogers Centre\\n - November 21, 2024\\n - November 22, 2024\\n - November 23, 2024\\n\\n2. **Vancouver, BC, Canada** at BC Place\\n - December 6, 2024\\n - December 7, 2024\\n - December 8, 2024\\n\\nFor the most current information and additional dates, you can check platforms like Ticketmaster or Taylor Swift\\'s [official website](https://www.taylorswift.com/events).', additional_kwargs={}, response_metadata={}, name='web_scraper', id='27524ebc-d179-4733-831d-ee10a58a2528')]}}\n",
"---\n",
"{'supervisor': {'next': '__end__'}}\n",
"---\n"
]
}
],
"source": [
"for s in research_chain.stream(\n",
" \"when is Taylor Swift's next tour?\", {\"recursion_limit\": 100}\n",
"for s in research_graph.stream(\n",
" {\"messages\": [(\"user\", \"when is Taylor Swift's next tour?\")]},\n",
" {\"recursion_limit\": 100},\n",
"):\n",
" if \"__end__\" not in s:\n",
" print(s)\n",
" print(\"---\")"
" print(s)\n",
" print(\"---\")"
]
},
{
@@ -549,7 +510,7 @@
},
{
"cell_type": "code",
"execution_count": 22,
"execution_count": 10,
"id": "1bcdbf44-9481-430c-8429-fa142ed8a626",
"metadata": {
"ExecuteTime": {
@@ -559,75 +520,62 @@
},
"outputs": [],
"source": [
"import operator\n",
"from pathlib import Path\n",
"\n",
"\n",
"# Document writing team graph state\n",
"class DocWritingState(TypedDict):\n",
" # This tracks the team's conversation internally\n",
" messages: Annotated[List[BaseMessage], operator.add]\n",
" # This provides each worker with context on the others' skill sets\n",
" team_members: str\n",
" # This is how the supervisor tells langgraph who to work next\n",
" next: str\n",
" # This tracks the shared directory state\n",
" current_files: str\n",
"\n",
"\n",
"# This will be run before each worker agent begins work\n",
"# It makes it so they are more aware of the current state\n",
"# of the working directory.\n",
"def prelude(state):\n",
" written_files = []\n",
" if not WORKING_DIRECTORY.exists():\n",
" WORKING_DIRECTORY.mkdir()\n",
" try:\n",
" written_files = [\n",
" f.relative_to(WORKING_DIRECTORY) for f in WORKING_DIRECTORY.rglob(\"*\")\n",
" ]\n",
" except Exception:\n",
" pass\n",
" if not written_files:\n",
" return {**state, \"current_files\": \"No files written.\"}\n",
" return {\n",
" **state,\n",
" \"current_files\": \"\\nBelow are files your team has written to the directory:\\n\"\n",
" + \"\\n\".join([f\" - {f}\" for f in written_files]),\n",
" }\n",
"\n",
"\n",
"llm = ChatOpenAI(model=\"gpt-4o\")\n",
"\n",
"doc_writer_agent = create_react_agent(\n",
" llm, tools=[write_document, edit_document, read_document]\n",
")\n",
"# Injects current directory working state before each call\n",
"context_aware_doc_writer_agent = prelude | doc_writer_agent\n",
"doc_writing_node = functools.partial(\n",
" agent_node, agent=context_aware_doc_writer_agent, name=\"DocWriter\"\n",
")\n",
"\n",
"note_taking_agent = create_react_agent(llm, tools=[create_outline, read_document])\n",
"context_aware_note_taking_agent = prelude | note_taking_agent\n",
"note_taking_node = functools.partial(\n",
" agent_node, agent=context_aware_note_taking_agent, name=\"NoteTaker\"\n",
")\n",
"\n",
"chart_generating_agent = create_react_agent(llm, tools=[read_document, python_repl])\n",
"context_aware_chart_generating_agent = prelude | chart_generating_agent\n",
"chart_generating_node = functools.partial(\n",
" agent_node, agent=context_aware_note_taking_agent, name=\"ChartGenerator\"\n",
")\n",
"\n",
"doc_writing_supervisor = create_team_supervisor(\n",
" llm,\n",
" \"You are a supervisor tasked with managing a conversation between the\"\n",
" \" following workers: {team_members}. Given the following user request,\"\n",
" \" respond with the worker to act next. Each worker will perform a\"\n",
" \" task and respond with their results and status. When finished,\"\n",
" \" respond with FINISH.\",\n",
" [\"DocWriter\", \"NoteTaker\", \"ChartGenerator\"],\n",
" tools=[write_document, edit_document, read_document],\n",
" state_modifier=(\n",
" \"You can read, write and edit documents based on note-taker's outlines. \"\n",
" \"Don't ask follow-up questions.\"\n",
" ),\n",
")\n",
"\n",
"\n",
"def doc_writing_node(state: AgentState) -> AgentState:\n",
" result = doc_writer_agent.invoke(state)\n",
" return {\n",
" \"messages\": [\n",
" HumanMessage(content=result[\"messages\"][-1].content, name=\"doc_writer\")\n",
" ]\n",
" }\n",
"\n",
"\n",
"note_taking_agent = create_react_agent(\n",
" llm,\n",
" tools=[create_outline, read_document],\n",
" state_modifier=(\n",
" \"You can read documents and create outlines for the document writer. \"\n",
" \"Don't ask follow-up questions.\"\n",
" ),\n",
")\n",
"\n",
"\n",
"def note_taking_node(state: AgentState) -> AgentState:\n",
" result = note_taking_agent.invoke(state)\n",
" return {\n",
" \"messages\": [\n",
" HumanMessage(content=result[\"messages\"][-1].content, name=\"note_taker\")\n",
" ]\n",
" }\n",
"\n",
"\n",
"chart_generating_agent = create_react_agent(\n",
" llm, tools=[read_document, python_repl_tool]\n",
")\n",
"\n",
"\n",
"def chart_generating_node(state: AgentState) -> AgentState:\n",
" result = chart_generating_agent.invoke(state)\n",
" return {\n",
" \"messages\": [\n",
" HumanMessage(content=result[\"messages\"][-1].content, name=\"chart_generator\")\n",
" ]\n",
" }\n",
"\n",
"\n",
"doc_writing_supervisor_node = make_supervisor_node(\n",
" llm, [\"doc_writer\", \"note_taker\", \"chart_generator\"]\n",
")"
]
},
@@ -641,7 +589,7 @@
},
{
"cell_type": "code",
"execution_count": 23,
"execution_count": 11,
"id": "9c5c644f-8966-4d2e-98d2-80d73520e9fe",
"metadata": {
"ExecuteTime": {
@@ -651,56 +599,28 @@
},
"outputs": [],
"source": [
"# Create the graph here:\n",
"# Note that we have unrolled the loop for the sake of this doc\n",
"authoring_graph = StateGraph(DocWritingState)\n",
"authoring_graph.add_node(\"DocWriter\", doc_writing_node)\n",
"authoring_graph.add_node(\"NoteTaker\", note_taking_node)\n",
"authoring_graph.add_node(\"ChartGenerator\", chart_generating_node)\n",
"authoring_graph.add_node(\"supervisor\", doc_writing_supervisor)\n",
"\n",
"# Add the edges that always occur\n",
"authoring_graph.add_edge(\"DocWriter\", \"supervisor\")\n",
"authoring_graph.add_edge(\"NoteTaker\", \"supervisor\")\n",
"authoring_graph.add_edge(\"ChartGenerator\", \"supervisor\")\n",
"# Create the graph here\n",
"paper_writing_builder = StateGraph(AgentState)\n",
"paper_writing_builder.add_node(\"supervisor\", doc_writing_supervisor_node)\n",
"paper_writing_builder.add_node(\"doc_writer\", doc_writing_node)\n",
"paper_writing_builder.add_node(\"note_taker\", note_taking_node)\n",
"paper_writing_builder.add_node(\"chart_generator\", chart_generating_node)\n",
"\n",
"# Define the control flow\n",
"paper_writing_builder.add_edge(START, \"supervisor\")\n",
"# We want our workers to ALWAYS \"report back\" to the supervisor when done\n",
"paper_writing_builder.add_edge(\"doc_writer\", \"supervisor\")\n",
"paper_writing_builder.add_edge(\"note_taker\", \"supervisor\")\n",
"paper_writing_builder.add_edge(\"chart_generator\", \"supervisor\")\n",
"# Add the edges where routing applies\n",
"authoring_graph.add_conditional_edges(\n",
" \"supervisor\",\n",
" lambda x: x[\"next\"],\n",
" {\n",
" \"DocWriter\": \"DocWriter\",\n",
" \"NoteTaker\": \"NoteTaker\",\n",
" \"ChartGenerator\": \"ChartGenerator\",\n",
" \"FINISH\": END,\n",
" },\n",
")\n",
"paper_writing_builder.add_conditional_edges(\"supervisor\", lambda state: state[\"next\"])\n",
"\n",
"authoring_graph.add_edge(START, \"supervisor\")\n",
"chain = authoring_graph.compile()\n",
"\n",
"\n",
"# The following functions interoperate between the top level graph state\n",
"# and the state of the research sub-graph\n",
"# this makes it so that the states of each graph don't get intermixed\n",
"def enter_chain(message: str, members: List[str]):\n",
" results = {\n",
" \"messages\": [HumanMessage(content=message)],\n",
" \"team_members\": \", \".join(members),\n",
" }\n",
" return results\n",
"\n",
"\n",
"# We reuse the enter/exit functions to wrap the graph\n",
"authoring_chain = (\n",
" functools.partial(enter_chain, members=authoring_graph.nodes)\n",
" | authoring_graph.compile()\n",
")"
"paper_writing_graph = paper_writing_builder.compile()"
]
},
{
"cell_type": "code",
"execution_count": 24,
"execution_count": 12,
"id": "58e7d1e48a9c39a5",
"metadata": {
"ExecuteTime": {
@@ -711,7 +631,7 @@
"outputs": [
{
"data": {
"image/jpeg": "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ERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQFzzjyAeHY3c1v+esN1cN/wDnOr0XQ1zzjzt5uxuSB5aw3cN/+dKqDoaIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiKA1BqWbH22Y/HVGX8m+PtiyWUxRRR7kBz3hriNyCAACTse4Akd0UVWk8tIn0VJOc1hudqGEI9W9ub+Gvzy7rD8Qwfyub+GtPotesbwty7oqR5d1h+IYP5XN/DTy7rD8Qwfyub+GnotesbwXLuvI/hy+E/PwUkw2m59HS5ahkzUyUWWF0RMEla4yV8HIYnddomelv07Tfbp19A+XdYfiGD+Vzfw1yvwieCmS8I/R1TA5uviaLqlxluC7WsSOlj26PYN4u57SQfz7HrtsnotesbwXOieD9xXv8beGWP1jd027S8WRe91Sm+34y6SAHlEpPIzl5nB2w2PQA7+l06Oue4ifUuBxNLGY/EYGrQpQMrV4I7c3LHGxoa1o+x9wAAW35d1h+IYP5XN/DT0WvWN4Ll3RUjy7rD8Qwfyub+Gnl3WH4hg/lc38NPRa9Y3guXdFSPLusPxDB/K5v4a/RqDV0R534rDTtHUxx3pWOI/MTERv+n+sd6ei16xvBcuyLQwmZr57HR3Kwe1ri5jo5W8r43tJDmOHqIIIPq6dCRsVvrJVE0zMTmgiIoCIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgKik78R8/+ahRG/wDtWf8A1/Sr0qIf5R9QfqFH96wtvDff9nzh1GUphERezkREQEREBEUS3VWLfqqTTYsk5qOk3IOrdk/YQOe6MP59uX4zXDbffpvtsoJZERUEREGnw4P2DPj1DLz7D+hh/wDNW9VDhx9p1B+15/3WK3rNxXrqnVWYiIsrkREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBUQ/wAo+oP1Cj+9YV7VEP8AKPqD9Qo/vWFt4b7/ALPnDqMpTC8+eECc5pnW1PVuVyWpIuGtLHsZaOl8ka0uOsiYl1qeEbGxEWFjSPS5Q1x5DvuvQao2teCWi+IuahyuosL5SuRxMr+lamZFLEx5e1ksTXhkrQ5zjs9rh1K9KovjBy5bd1Line truncated
"image/png": "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 truncated
"text/plain": [
"<IPython.core.display.Image object>"
]
@@ -723,12 +643,12 @@
"source": [
"from IPython.display import Image, display\n",
"\n",
"display(Image(chain.get_graph().draw_mermaid_png()))"
"display(Image(paper_writing_graph.get_graph().draw_mermaid_png()))"
]
},
{
"cell_type": "code",
"execution_count": 12,
"execution_count": 14,
"id": "9860fd46-c24d-40a5-a6ba-e8fddcd43369",
"metadata": {
"ExecuteTime": {
@@ -741,23 +661,33 @@
"name": "stdout",
"output_type": "stream",
"text": [
"{'supervisor': {'next': 'NoteTaker'}}\n",
"{'supervisor': {'next': 'note_taker'}}\n",
"---\n",
"{'NoteTaker': {'messages': [HumanMessage(content='The poem has been written and saved to \"poem.txt\".', name='NoteTaker')]}}\n",
"{'note_taker': {'messages': [HumanMessage(content='The outline for the poem about cats has been created and saved as \"cats_poem_outline.txt\".', additional_kwargs={}, response_metadata={}, name='note_taker', id='14a5d8ca-9092-416f-96ee-ba16686e8658')]}}\n",
"---\n",
"{'supervisor': {'next': 'FINISH'}}\n",
"{'supervisor': {'next': 'doc_writer'}}\n",
"---\n",
"{'doc_writer': {'messages': [HumanMessage(content='The poem about cats has been written and saved as \"cats_poem.txt\".', additional_kwargs={}, response_metadata={}, name='doc_writer', id='c4e31a94-63ae-4632-9e80-1166f3f138b2')]}}\n",
"---\n",
"{'supervisor': {'next': '__end__'}}\n",
"---\n"
]
}
],
"source": [
"for s in authoring_chain.stream(\n",
" \"Write an outline for poem and then write the poem to disk.\",\n",
"for s in paper_writing_graph.stream(\n",
" {\n",
" \"messages\": [\n",
" (\n",
" \"user\",\n",
" \"Write an outline for poem about cats and then write the poem to disk.\",\n",
" )\n",
" ]\n",
" },\n",
" {\"recursion_limit\": 100},\n",
"):\n",
" if \"__end__\" not in s:\n",
" print(s)\n",
" print(\"---\")"
" print(s)\n",
" print(\"---\")"
]
},
{
@@ -774,35 +704,21 @@
},
{
"cell_type": "code",
"execution_count": 13,
"id": "95ae7e52-92ed-41a3-88c4-21b6d7c8b041",
"metadata": {
"ExecuteTime": {
"end_time": "2024-05-15T08:19:55.454047Z",
"start_time": "2024-05-15T08:19:53.725466Z"
}
},
"execution_count": 15,
"id": "8cbfbe34-43f5-4a3d-8e9b-6a1d9b339aec",
"metadata": {},
"outputs": [],
"source": [
"from langchain_core.messages import BaseMessage\n",
"from langchain_openai.chat_models import ChatOpenAI\n",
"\n",
"llm = ChatOpenAI(model=\"gpt-4o\")\n",
"\n",
"supervisor_node = create_team_supervisor(\n",
" llm,\n",
" \"You are a supervisor tasked with managing a conversation between the\"\n",
" \" following teams: {team_members}. Given the following user request,\"\n",
" \" respond with the worker to act next. Each worker will perform a\"\n",
" \" task and respond with their results and status. When finished,\"\n",
" \" respond with FINISH.\",\n",
" [\"ResearchTeam\", \"PaperWritingTeam\"],\n",
")"
"teams_supervisor_node = make_supervisor_node(llm, [\"research_team\", \"writing_team\"])"
]
},
{
"cell_type": "code",
"execution_count": 25,
"execution_count": 16,
"id": "4880e573-612f-4d24-97c1-2079382a4a2f",
"metadata": {
"ExecuteTime": {
@@ -812,49 +728,43 @@
},
"outputs": [],
"source": [
"# Top-level graph state\n",
"class State(TypedDict):\n",
" messages: Annotated[List[BaseMessage], operator.add]\n",
" next: str\n",
"def call_research_team(state: AgentState) -> AgentState:\n",
" response = research_graph.invoke({\"messages\": state[\"messages\"][-1]})\n",
" return {\n",
" \"messages\": [\n",
" HumanMessage(content=response[\"messages\"][-1].content, name=\"research_team\")\n",
" ]\n",
" }\n",
"\n",
"\n",
"def get_last_message(state: State) -> str:\n",
" return state[\"messages\"][-1].content\n",
"\n",
"\n",
"def join_graph(response: dict):\n",
" return {\"messages\": [response[\"messages\"][-1]]}\n",
"def call_paper_writing_team(state: AgentState) -> AgentState:\n",
" response = paper_writing_graph.invoke({\"messages\": state[\"messages\"][-1]})\n",
" return {\n",
" \"messages\": [\n",
" HumanMessage(content=response[\"messages\"][-1].content, name=\"writing_team\")\n",
" ]\n",
" }\n",
"\n",
"\n",
"# Define the graph.\n",
"super_graph = StateGraph(State)\n",
"# First add the nodes, which will do the work\n",
"super_graph.add_node(\"ResearchTeam\", get_last_message | research_chain | join_graph)\n",
"super_graph.add_node(\n",
" \"PaperWritingTeam\", get_last_message | authoring_chain | join_graph\n",
")\n",
"super_graph.add_node(\"supervisor\", supervisor_node)\n",
"super_builder = StateGraph(AgentState)\n",
"super_builder.add_node(\"supervisor\", teams_supervisor_node)\n",
"super_builder.add_node(\"research_team\", call_research_team)\n",
"super_builder.add_node(\"writing_team\", call_paper_writing_team)\n",
"\n",
"# Define the graph connections, which controls how the logic\n",
"# propagates through the program\n",
"super_graph.add_edge(\"ResearchTeam\", \"supervisor\")\n",
"super_graph.add_edge(\"PaperWritingTeam\", \"supervisor\")\n",
"super_graph.add_conditional_edges(\n",
" \"supervisor\",\n",
" lambda x: x[\"next\"],\n",
" {\n",
" \"PaperWritingTeam\": \"PaperWritingTeam\",\n",
" \"ResearchTeam\": \"ResearchTeam\",\n",
" \"FINISH\": END,\n",
" },\n",
")\n",
"super_graph.add_edge(START, \"supervisor\")\n",
"super_graph = super_graph.compile()"
"# Define the control flow\n",
"super_builder.add_edge(START, \"supervisor\")\n",
"# We want our teams to ALWAYS \"report back\" to the top-level supervisor when done\n",
"super_builder.add_edge(\"research_team\", \"supervisor\")\n",
"super_builder.add_edge(\"writing_team\", \"supervisor\")\n",
"# Add the edges where routing applies\n",
"super_builder.add_conditional_edges(\"supervisor\", lambda state: state[\"next\"])\n",
"super_graph = super_builder.compile()"
]
},
{
"cell_type": "code",
"execution_count": 26,
"execution_count": 17,
"id": "270ff3ae26cd42ff",
"metadata": {
"ExecuteTime": {
@@ -865,7 +775,7 @@
"outputs": [
{
"data": {
"image/jpeg": "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NZLT2b0/ltNYqnjLkeXoPrskljj7NxhefRlbvHvzMJGzm/OtvICjdR4dufwluiXBkkjeaGQ7/wAlK0h0cg29bXta4fSApJee/dixtGzbndywV43SyOHqa0En/wBgtUTMVRNPNYeLSuYOodM4rJloY+3Vjmc0fkuc0Ej+47hSqgNAUJcZonCV52lk7akZkaRsWvI3cNvoJKn1u7FMXKop5YyTzERFyQREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREGK1Wiu1pa88bZoJWGOSN43a5pGxBHzEKuYrJHSzocNl5S2Fu0VDIyn0LDO5sb3HumHdsfjjZzdzztZaFht1IL9aSvahjs15W8r4pWBzHj5iD0IXWiuIjdq5Sqnai4HcPNXZmxls3ojAZfKWeXtrl3HRSyycrQ1vM5zSTs1oH6gFHHwbeFDg0HhvpYho2AOJg6Dv/o/SVYToCpAf+j8llsUzffsqt57ox+pknM1o+gAD6F+fAmx7VZ7/Gh/CW9y3PKvrH/phGr36V0bgdDYvybp3D0cHj+0MviuPrthj5ztu7laANzsOv0KZVX+BNj2qz3+ND+EnwJse1We/wAaH8JOHb/H8pMI1WhFqzGY7LW+Keo9PyapzHk6hh8ZehLZYe17Wea8yTm/k/i7Votug683U+q1/Amx7VZ7/Gh/CTh2/wAfykwjVl1jw40rxCZVZqfTmL1CyqXGBuTqMnERdtzFvMDtvyjfb5gq2PBu4UhhYOHGlwwkEt8kwbEjfY/F+k/vU/8AAmx7VZ7/ABofwkGibAPypzx//tD+EnDt/j+UmEasWk+FGieHtye/pvSuF09aliMUtjH0o67nR7hxa5zQOm4B2+hfVmZmvJGVau0mno3tfZtj4lxzSHNiiP5TNx6b/ikDkHNu/kyR8PsbK5rsjYv5rbqI8jbfJF/fECIz/e0qysY2Noa0BrQNgANgAm9RbzonGemH9/Rco5PpERedkREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERBr/Blvn71mATz/AAbwe49W3jOV29f6/UP1n1bAWv8AB7+frWfVu3wbwnQBvN/1nK9/r2/X079vWtgICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiINe4IDz/a1PO0n4NYP0QPSH+lZbqTt3H9fqPd69hLXuC28/8ArXqeb4NYPcco228ay3r9fr6fathICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIi/CQ0Ek7Ad5KD9RUp2sM1lgLGExtJ2Nd1hsX7L43zt9T2sbGdmnvBJ3I67DdfPl3WH5hg/e5vw17PC3PPCP1hcF3RUjy7rD8wwfvc34aeXdYfmGD97m/DTwtesdYMF3XmyUtmvjrUtKuy5cZE90FeSXsmyyAHlaX7HlBOw32O2++xVR8u6w/MMH73N+Gnl3WH5hg/e5vw08LXrHWDByFwx8PK3q/wlfIo4Z26mTz7sdp6eA5MOfR8XsWjLM4dgC4NbZcS0kbCI9RzFd6LmnTPg/TaW4/Z/ivVx+GOYytfsxUNiQRV5XbCaZh7LfmkAG//mf/AEum3/LusPzDB+9zfhp4WvWOsGC7oqR5d1h+YYP3ub8NPLusPzDB+9zfhp4WvWOsGC7oqR5d1h+YYP3ub8NPLusPzDB+9zfhp4WvWOsGC7oqjR1bk6duCLO0KteCxI2GO3RsOlY2RxAa17XMaWhxOwcCRvsDtuFblwuW6rc4VGGAiIuSCIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAo/UJLcBkiDsRWlII/8hUgo7UXyfyf7LL/AVuj78LHNV9JADSuGAAA8Sh6D/dtUsorSfyVw37FD/AFKr6lz79XqTzERFzQREQERfE0rYInyPPKxjS5x232A70H2ijNM6lx2sdP4/N4iwbeMvwtnrTmN0fOw9x5XAOH6iAVJoCIiCva8O2mpSO8WKxH0Ht41sRa7198mJv8Af1v8+NbEXPaPZUes/RryERF4GRERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAUdqL5P5P9ll/gKkVHai+T+T/ZZf4Ct0ffj1WOasaT+SuG/Yof4ApC2yaSpMyvIIZ3McI5HN5gx23QkevY+pR+k/krhv2KH+AKSmhZYhfFIOaN7S1w+cHvX1Ln36vUnm4xzOf1Jw94RcR8Hns7q6lxOqaeGRfanzL7NSzGJwx1yi9pBhHM4Ax7MLQQNj3ra3HPU+VxXEapVx+WuU67tEaguGGtZexhljFfspeVp25m7u5Xd43OxV5014Line truncated
"image/png": "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 truncated
"text/plain": [
"<IPython.core.display.Image object>"
]
@@ -882,7 +792,7 @@
},
{
"cell_type": "code",
"execution_count": 16,
"execution_count": 22,
"id": "6b8badbf-d728-44bd-a2a7-5b4e587c92fe",
"metadata": {
"ExecuteTime": {
@@ -895,191 +805,19 @@
"name": "stdout",
"output_type": "stream",
"text": [
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"{'supervisor': {'next': 'research_team'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content=\"Unfortunately, the information obtained from the U.S. Fish & Wildlife Service web pages does not provide additional detailed information on the conservation status, size, or lifespan of the North American sturgeon species beyond what was already included in the initial research report. These pages primarily contain placeholders for the species' profiles without specific information on the topics of interest.\\n\\nBased on the information available, the research report provided earlier remains the most comprehensive summary of the North American sturgeon, including an overview of the species, their conservation status, size, lifespan, conservation efforts, and a chart summarizing key data for each species. Further details would require access to additional sources or in-depth research reports that are not currently available in the provided documents.\", name='WebScraper')]}}\n",
"{'research_team': {'messages': [HumanMessage(content=\"**AI Agents Overview 2023**\\n\\nAI agents are sophisticated technologies that automate and enhance various processes across industries, becoming increasingly integral to business operations. In 2023, these agents are notable for their advanced capabilities in communication, data visualization, and language processing.\\n\\n**Popular AI Agents in 2023:**\\n1. **Auto GPT**: This agent is renowned for its seamless integration abilities, significantly impacting industries by improving communication and operational workflows.\\n2. **ChartGPT**: Specializing in data visualization, ChartGPT enables users to interact with data innovatively, providing deeper insights and comprehension.\\n3. **LLMops**: With advanced language capabilities, LLMops is a versatile tool seeing widespread use across multiple sectors.\\n\\n**Market Trends:**\\nThe AI agents market is experiencing rapid growth, with significant advancements anticipated by 2030. There's a growing demand for AI agents in personalized interactions, particularly within customer service, healthcare, and marketing sectors. This trend is fueled by the need for more efficient and tailored customer experiences.\\n\\n**Key Players:**\\nLeading companies such as Microsoft, IBM, Google, Oracle, and AWS are key players in the AI agents market, highlighting the widespread adoption and investment in these technologies.\\n\\n**Technological Innovations:**\\nAI agents are being developed alongside simulation technologies for robust testing and deployment environments. Innovations in generative AI are accelerating, supported by advancements in large language models and platforms like ChatGPT.\\n\\n**Applications in Healthcare:**\\nIn healthcare, AI agents are automating routine tasks, allowing medical professionals to focus more on patient care. They're poised to significantly enhance healthcare delivery and efficiency.\\n\\n**Future Prospects:**\\nThe future of AI agents is promising, with continued evolution and integration into various platforms and ecosystems, offering more seamless and intelligent interactions. As these technologies advance, they are expected to redefine business operations and customer interactions.\", additional_kwargs={}, response_metadata={}, name='research_team', id='5f6606e0-838c-406c-b50d-9f9f6a076322')]}}\n",
"---\n",
"{'supervisor': {'next': 'PaperWritingTeam'}}\n",
"{'supervisor': {'next': 'writing_team'}}\n",
"---\n",
"{'PaperWritingTeam': {'messages': [HumanMessage(content=\"It appears that the information you were seeking from the U.S. Fish & Wildlife Service web pages was not as detailed as you needed for the North American sturgeon species. If you're looking for more comprehensive data on their conservation status, size, lifespan, and conservation efforts, you might need to consider exploring scientific journals, research papers, or contacting experts in the field.\\n\\nIf you have any specific questions or require assistance with creating an outline or reading a document related to the North American sturgeon, please let me know how I can assist you further.\", name='NoteTaker')]}}\n",
"{'writing_team': {'messages': [HumanMessage(content=\"Here are the contents of the documents:\\n\\n### AI Agents Overview 2023\\n\\n**AI Agents Overview 2023**\\n\\nAI agents are sophisticated technologies that automate and enhance various processes across industries, becoming increasingly integral to business operations. In 2023, these agents are notable for their advanced capabilities in communication, data visualization, and language processing.\\n\\n**Popular AI Agents in 2023:**\\n1. **Auto GPT**: This agent is renowned for its seamless integration abilities, significantly impacting industries by improving communication and operational workflows.\\n2. **ChartGPT**: Specializing in data visualization, ChartGPT enables users to interact with data innovatively, providing deeper insights and comprehension.\\n3. **LLMops**: With advanced language capabilities, LLMops is a versatile tool seeing widespread use across multiple sectors.\\n\\n**Market Trends:**\\nThe AI agents market is experiencing rapid growth, with significant advancements anticipated by 2030. There's a growing demand for AI agents in personalized interactions, particularly within customer service, healthcare, and marketing sectors. This trend is fueled by the need for more efficient and tailored customer experiences.\\n\\n**Key Players:**\\nLeading companies such as Microsoft, IBM, Google, Oracle, and AWS are key players in the AI agents market, highlighting the widespread adoption and investment in these technologies.\\n\\n**Technological Innovations:**\\nAI agents are being developed alongside simulation technologies for robust testing and deployment environments. Innovations in generative AI are accelerating, supported by advancements in large language models and platforms like ChatGPT.\\n\\n**Applications in Healthcare:**\\nIn healthcare, AI agents are automating routine tasks, allowing medical professionals to focus more on patient care. They're poised to significantly enhance healthcare delivery and efficiency.\\n\\n**Future Prospects:**\\nThe future of AI agents is promising, with continued evolution and integration into various platforms and ecosystems, offering more seamless and intelligent interactions. As these technologies advance, they are expected to redefine business operations and customer interactions.\\n\\n### AI_Agents_Overview_2023_Outline\\n\\n1. Introduction to AI Agents in 2023\\n2. Popular AI Agents: Auto GPT, ChartGPT, LLMops\\n3. Market Trends and Growth\\n4. Key Players in the AI Agents Market\\n5. Technological Innovations: Simulation and Generative AI\\n6. Applications of AI Agents in Healthcare\\n7. Future Prospects of AI Agents\", additional_kwargs={}, response_metadata={}, name='writing_team', id='851bd8a6-740e-488c-8928-1f9e05e96ea0')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"{'supervisor': {'next': 'writing_team'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='I\\'ve found several resources that could provide the comprehensive data you\\'re looking for on the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. A paper titled \"Reconnecting Fragmented Sturgeon Populations in North American Rivers\" by Jager et al., which may contain information on distribution, range contraction, and conservation efforts ([Read the paper](https://web.ornl.gov/~zij/mypubs/sturgeon/Jager at al_2016_Reconnecting Fragmented Sturgeon Populations in North American Rivers_Fisheries.pdf)).\\n\\n2. The North American Sturgeon and Paddlefish Society (NASPS) website, which lists experts and provides details on the society\\'s mission to foster the conservation and restoration of sturgeon species in North America ([Visit NASPS](https://nasps-sturgeon.org/about/)).\\n\\n3. A press release from the U.S. Fish and Wildlife Service indicating that lake sturgeon do not require listing under the Endangered Species Act due to successful ongoing management efforts ([Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list)).\\n\\n4. Information on the Conservation Genetics of Atlantic Sturgeon by the USGS, discussing genetic studies and management strategies for Atlantic Sturgeon populations ([Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon)).\\n\\n5. A story on restoring lake sturgeon along the Ontonagon River in Michigan and St. Louis River in Minnesota, detailing efforts by the Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office ([Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon)).\\n\\nThese resources should provide a strong foundation for understanding the current state of North American sturgeon species. If you require more detailed summaries or have any other questions, feel free to ask.', name='Search')]}}\n",
"{'writing_team': {'messages': [HumanMessage(content='The documents have been successfully created and saved:\\n\\n1. **AI_Agents_Overview_2023.txt** - Contains the detailed overview of AI agents in 2023.\\n2. **AI_Agents_Overview_2023_Outline.txt** - Contains the outline of the document.', additional_kwargs={}, response_metadata={}, name='writing_team', id='c87c0778-a085-4a8e-8ee1-9b43b9b0b143')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.', name='Search')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n1. **Reconnecting Fragmented Sturgeon Populations in North American Rivers (Jager et al.)**:\\n - This paper discusses the fragmentation of large North American rivers by dams that interrupt the migrations of wide-ranging fishes like sturgeons. Efforts to reconnect habitats are viewed as crucial for protecting sturgeon species in U.S. rivers, as these species have lost between 5% and 60% of their historical ranges. [Learn more from the paper](https://www.semanticscholar.org/paper/Reconnecting-Fragmented-Sturgeon-Populations-in-Jager-Parsley/45414d7c86cd2d4f04b9490c7143f36b5158e729/figure/0).\\n\\n2. **North American Sturgeon and Paddlefish Society (NASPS)**:\\n - NASPS is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing and advancing research pertaining to their biology, management, and utilization. [Visit NASPS](https://nasps-sturgeon.org/about/).\\n\\n3. **U.S. Fish and Wildlife Service on Lake Sturgeon and the Endangered Species Act**:\\n - The U.S. Fish and Wildlife Service determined that lake sturgeon do not require listing under the Endangered Species Act, thanks to ongoing management efforts such as fish stocking that have contributed to their population stability. [Read the press release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list).\\n\\n4. **Conservation Genetics of Atlantic Sturgeon (USGS)**:\\n - The USGS is conducting research on the conservation genetics of Atlantic sturgeon, with a focus on genetic assignment testing and population genetic studies. This is in response to the rediscovery of populations that were previously thought to be extirpated, necessitating updated management strategies. [Learn more from USGS](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon).\\n\\n5. **Restoration Efforts Along the Ontonagon River and St. Louis River**:\\n - The Iron River National Fish Hatchery and Ashland Fish and Wildlife Conservation Office are working with partners to restore lake sturgeon in Michigan and Minnesota. Efforts include collecting larval sturgeon and milt for breeding and stocking programs. [Read the story](https://www.fws.gov/story/2024-04/restoring-reverence-along-lake-sturgeon).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n**Conservation Status of North American Sturgeon:**\\n- Lake sturgeon has origins dating back at least 150 million years and is one of the largest freshwater fish in North America. They are not currently listed under the Endangered Species Act, thanks to conservation efforts such as fish stocking ([U.S. Fish and Wildlife Service Press Release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list)).\\n- The North American Sturgeon and Paddlefish Society (NASPS) is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing research on their biology, management, and utilization ([NASPS About](https://nasps-sturgeon.org/about/)).\\n- All 26 remaining sturgeon species are now threatened with extinction according to the IUCN ([WWF News](https://wwf.panda.org/wwf_news/?6080466/sturgeon-slipping-towards-extinction)).\\n- The USGS is conducting research on the conservation genetics of Atlantic sturgeon to ensure appropriate management strategies can be developed ([USGS Conservation Genetics](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon)).\\n\\n**Size and Lifespan of North American Sturgeon Species:**\\n- The white sturgeon (Acipenser transmontanus), also known as the Pacific sturgeon, can grow up to 20 feet long and weigh up to 1,800 pounds. It is the largest freshwater fish in North America ([American Oceans](https://www.americanoceans.org/facts/types-of-sturgeon/)).\\n- The shortnose sturgeon (Acipenser brevirostrum) can grow up to 4 feet long and weigh up to 50 pounds. It inhabits the eastern coast of North America ([American Oceans](https://www.americanoceans.org/facts/types-of-sturgeon/)).\\n- The green sturgeon (Acipenser medirostris) can reach up to 7 feet long and weigh up to 350 pounds ([American Oceans](https://www.americanoceans.org/facts/types-of-sturgeon/)).\\n\\n**Conservation Efforts for North American Sturgeon Species:**\\n- Long-term conservation efforts in North America have helped to stabilize and increase some sturgeon populations, such as the white sturgeon in the Fraser River in the U.S. ([WWF News](https://wwf.panda.org/wwf_news/?6080466/sturgeon-slipping-towards-extinction)).\\n- The NASPS works to foster the conservation of sturgeon species and restoration of sturgeon stocks in North America ([NASPS About](https://nasps-sturgeon.org/about/)).\\n- The collaborative conservation efforts, including fish stocking, have contributed to the conservation and resiliency of lake sturgeon ([U.S. Fish and Wildlife Service Press Release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list)).\\n- Work in the Chesapeake Bay includes identifying and protecting habitat used by Atlantic sturgeon for spawning, seeking to minimize vessel strikes, and educating students about these fish ([NOAA Fisheries](https://www.fisheries.noaa.gov/feature-story/supporting-endangered-atlantic-sturgeon-chesapeake-bay)).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.', name='Search')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n**Conservation Status of North American Sturgeon:**\\n- Lake sturgeon has origins dating back at least 150 million years and is one of the largest freshwater fish in North America. They are not currently listed under the Endangered Species Act, thanks to conservation efforts such as fish stocking ([U.S. Fish and Wildlife Service Press Release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list)).\\n- The North American Sturgeon and Paddlefish Society (NASPS) is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing research on their biology, management, and utilization ([NASPS About](https://nasps-sturgeon.org/about/)).\\n- All 26 remaining sturgeon species are now threatened with extinction according to the IUCN ([WWF News](https://wwf.panda.org/wwf_news/?6080466/sturgeon-slipping-towards-extinction)).\\n- The USGS is conducting research on the conservation genetics of Atlantic sturgeon to ensure appropriate management strategies can be developed ([USGS Conservation Genetics](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon)).\\n\\n**Size and Lifespan of North American Sturgeon Species:**\\n- The white sturgeon (Acipenser transmontanus), also known as the Pacific sturgeon, can grow up to 20 feet long and weigh up to 1,800 pounds. It is the largest freshwater fish in North America ([American Oceans](https://www.americanoceans.org/facts/types-of-sturgeon/)).\\n- The shortnose sturgeon (Acipenser brevirostrum) can grow up to 4 feet long and weigh up to 50 pounds. It inhabits the eastern coast of North America ([American Oceans](https://www.americanoceans.org/facts/types-of-sturgeon/)).\\n- The green sturgeon (Acipenser medirostris) can reach up to 7 feet long and weigh up to 350 pounds ([American Oceans](https://www.americanoceans.org/facts/types-of-sturgeon/)).\\n\\n**Conservation Efforts for North American Sturgeon Species:**\\n- Long-term conservation efforts in North America have helped to stabilize and increase some sturgeon populations, such as the white sturgeon in the Fraser River in the U.S. ([WWF News](https://wwf.panda.org/wwf_news/?6080466/sturgeon-slipping-towards-extinction)).\\n- The NASPS works to foster the conservation of sturgeon species and restoration of sturgeon stocks in North America ([NASPS About](https://nasps-sturgeon.org/about/)).\\n- The collaborative conservation efforts, including fish stocking, have contributed to the conservation and resiliency of lake sturgeon ([U.S. Fish and Wildlife Service Press Release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list)).\\n- Work in the Chesapeake Bay includes identifying and protecting habitat used by Atlantic sturgeon for spawning, seeking to minimize vessel strikes, and educating students about these fish ([NOAA Fisheries](https://www.fisheries.noaa.gov/feature-story/supporting-endangered-atlantic-sturgeon-chesapeake-bay)).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='Based on the search results obtained, here is a summary of the information available regarding the conservation status, size, lifespan, and conservation efforts for North American sturgeon species:\\n\\n**Conservation Status of North American Sturgeon:**\\n- Lake sturgeon has origins dating back at least 150 million years and is one of the largest freshwater fish in North America. They are not currently listed under the Endangered Species Act, thanks to conservation efforts such as fish stocking ([U.S. Fish and Wildlife Service Press Release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list)).\\n- The North American Sturgeon and Paddlefish Society (NASPS) is dedicated to promoting the conservation and restoration of sturgeon species in North America by developing research on their biology, management, and utilization ([NASPS About](https://nasps-sturgeon.org/about/)).\\n- All 26 remaining sturgeon species are now threatened with extinction according to the IUCN ([WWF News](https://wwf.panda.org/wwf_news/?6080466/sturgeon-slipping-towards-extinction)).\\n- The USGS is conducting research on the conservation genetics of Atlantic sturgeon to ensure appropriate management strategies can be developed ([USGS Conservation Genetics](https://www.usgs.gov/centers/eesc/science/conservation-genetics-atlantic-sturgeon)).\\n\\n**Size and Lifespan of North American Sturgeon Species:**\\n- The white sturgeon (Acipenser transmontanus), also known as the Pacific sturgeon, can grow up to 20 feet long and weigh up to 1,800 pounds. It is the largest freshwater fish in North America ([American Oceans](https://www.americanoceans.org/facts/types-of-sturgeon/)).\\n- The shortnose sturgeon (Acipenser brevirostrum) can grow up to 4 feet long and weigh up to 50 pounds. It inhabits the eastern coast of North America ([American Oceans](https://www.americanoceans.org/facts/types-of-sturgeon/)).\\n- The green sturgeon (Acipenser medirostris) can reach up to 7 feet long and weigh up to 350 pounds ([American Oceans](https://www.americanoceans.org/facts/types-of-sturgeon/)).\\n\\n**Conservation Efforts for North American Sturgeon Species:**\\n- Long-term conservation efforts in North America have helped to stabilize and increase some sturgeon populations, such as the white sturgeon in the Fraser River in the U.S. ([WWF News](https://wwf.panda.org/wwf_news/?6080466/sturgeon-slipping-towards-extinction)).\\n- The NASPS works to foster the conservation of sturgeon species and restoration of sturgeon stocks in North America ([NASPS About](https://nasps-sturgeon.org/about/)).\\n- The collaborative conservation efforts, including fish stocking, have contributed to the conservation and resiliency of lake sturgeon ([U.S. Fish and Wildlife Service Press Release](https://www.fws.gov/press-release/2024-04/collaborative-conservation-keeps-lake-sturgeon-endangered-list)).\\n- Work in the Chesapeake Bay includes identifying and protecting habitat used by Atlantic sturgeon for spawning, seeking to minimize vessel strikes, and educating students about these fish ([NOAA Fisheries](https://www.fisheries.noaa.gov/feature-story/supporting-endangered-atlantic-sturgeon-chesapeake-bay)).\\n\\nThese resources provide comprehensive data on the state of North American sturgeon species and the various conservation efforts being undertaken to preserve and enhance their populations. If you require further information or assistance, feel free to ask.')]}}\n",
"---\n",
"{'supervisor': {'next': 'PaperWritingTeam'}}\n",
"---\n",
"{'PaperWritingTeam': {'messages': [HumanMessage(content='The outline for North American sturgeon species, including their conservation status, size, lifespan, and conservation efforts, has been successfully created and saved to a file named \"North_American_Sturgeon_Overview\". If you need to review the document or require additional information, please let me know.', name='NoteTaker')]}}\n",
"---\n",
"{'supervisor': {'next': 'PaperWritingTeam'}}\n",
"---\n",
"{'PaperWritingTeam': {'messages': [HumanMessage(content='The document \"North_American_Sturgeon_Overview\" contains the following outline:\\n\\n1. Conservation Status of North American Sturgeon\\n2. Size and Lifespan of North American Sturgeon Species\\n3. Conservation Efforts for North American Sturgeon Species\\n\\nIf you need more detailed information on any of these topics or have any other requests related to the document, feel free to let me know!', name='DocWriter')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='The document \"North_American_Sturgeon_Overview\" contains the following outline:\\n\\n1. Conservation Status of North American Sturgeon\\n2. Size and Lifespan of North American Sturgeon Species\\n3. Conservation Efforts for North American Sturgeon Species\\n\\nIf you need more detailed information on any of these topics or have any other requests related to the document, feel free to let me know!')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='The document \"North_American_Sturgeon_Overview\" contains the following outline:\\n\\n1. Conservation Status of North American Sturgeon\\n2. Size and Lifespan of North American Sturgeon Species\\n3. Conservation Efforts for North American Sturgeon Species\\n\\nIf you need more detailed information on any of these topics or have any other requests related to the document, feel free to let me know!')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='The document \"North_American_Sturgeon_Overview\" contains the following outline:\\n\\n1. Conservation Status of North American Sturgeon\\n2. Size and Lifespan of North American Sturgeon Species\\n3. Conservation Efforts for North American Sturgeon Species\\n\\nIf you need more detailed information on any of these topics or have any other requests related to the document, feel free to let me know!')]}}\n",
"---\n",
"{'supervisor': {'next': 'PaperWritingTeam'}}\n",
"---\n",
"{'PaperWritingTeam': {'messages': [HumanMessage(content='It seems that the document \"North_American_Sturgeon_Overview\" contains exactly the outline provided earlier, with three main topics:\\n\\n1. Conservation Status of North American Sturgeon\\n2. Size and Lifespan of North American Sturgeon Species\\n3. Conservation Efforts for North American Sturgeon Species\\n\\nIf you would like to delve into any of these topics or have another request regarding the document, please let me know how I can assist you further!', name='NoteTaker')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='It seems that the document \"North_American_Sturgeon_Overview\" contains exactly the outline provided earlier, with three main topics:\\n\\n1. Conservation Status of North American Sturgeon\\n2. Size and Lifespan of North American Sturgeon Species\\n3. Conservation Efforts for North American Sturgeon Species\\n\\nIf you would like to delve into any of these topics or have another request regarding the document, please let me know how I can assist you further!')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='It seems that the document \"North_American_Sturgeon_Overview\" contains exactly the outline provided earlier, with three main topics:\\n\\n1. Conservation Status of North American Sturgeon\\n2. Size and Lifespan of North American Sturgeon Species\\n3. Conservation Efforts for North American Sturgeon Species\\n\\nIf you would like to delve into any of these topics or have another request regarding the document, please let me know how I can assist you further!')]}}\n",
"---\n",
"{'supervisor': {'next': 'PaperWritingTeam'}}\n",
"---\n",
"{'PaperWritingTeam': {'messages': [HumanMessage(content='The document \"North_American_Sturgeon_Overview\" indeed contains the three main topics outlined earlier:\\n\\n1. Conservation Status of North American Sturgeon\\n2. Size and Lifespan of North American Sturgeon Species\\n3. Conservation Efforts for North American Sturgeon Species\\n\\nIf you need detailed information on any of these topics or have another specific request related to the document, please let me know, and I can provide the information or take further action as needed.', name='NoteTaker')]}}\n",
"---\n",
"{'supervisor': {'next': 'ResearchTeam'}}\n",
"---\n",
"{'ResearchTeam': {'messages': [HumanMessage(content='The document \"North_American_Sturgeon_Overview\" indeed contains the three main topics outlined earlier:\\n\\n1. Conservation Status of North American Sturgeon\\n2. Size and Lifespan of North American Sturgeon Species\\n3. Conservation Efforts for North American Sturgeon Species\\n\\nIf you need detailed information on any of these topics or have another specific request related to the document, please let me know, and I can provide the information or take further action as needed.')]}}\n",
"---\n",
"{'supervisor': {'next': 'FINISH'}}\n",
"{'supervisor': {'next': '__end__'}}\n",
"---\n"
]
}
@@ -1088,16 +826,13 @@
"for s in super_graph.stream(\n",
" {\n",
" \"messages\": [\n",
" HumanMessage(\n",
" content=\"Write a brief research report on the North American sturgeon. Include a chart.\"\n",
" )\n",
" (\"user\", \"Research AI agents and write a brief report about them.\")\n",
" ],\n",
" },\n",
" {\"recursion_limit\": 150},\n",
"):\n",
" if \"__end__\" not in s:\n",
" print(s)\n",
" print(\"---\")"
" print(s)\n",
" print(\"---\")"
]
}
],
@@ -2,8 +2,8 @@
"cells": [
{
"attachments": {
"02659c68-8b4b-42ed-a002-1c08f4a7c299.png": {
"image/png": "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 truncated
"7d0ca3af-e391-4d23-981a-dd640e08e4c1.png": {
"image/png": "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 truncated
}
},
"cell_type": "markdown",
@@ -20,7 +20,7 @@
"\n",
"The resulting graph will look something like the following diagram:\n",
"\n",
"![multi_agent diagram](attachment:02659c68-8b4b-42ed-a002-1c08f4a7c299.png)\n",
"![multi_agent diagram](attachment:7d0ca3af-e391-4d23-981a-dd640e08e4c1.png)\n",
"\n",
"Before we get started, a quick note: this and other multi-agent notebooks are designed to show _how_ you can implement certain design patterns in LangGraph. If the pattern suits your needs, we recommend combining it with some of the other fundamental patterns described elsewhere in the docs for best performance.\n",
"\n",
@@ -37,12 +37,12 @@
"outputs": [],
"source": [
"%%capture --no-stderr\n",
"%pip install -U langchain langchain_openai langsmith pandas langchain_experimental matplotlib langgraph langchain_core"
"%pip install -U langchain_community langchain_anthropic langchain_experimental matplotlib langgraph"
]
},
{
"cell_type": "code",
"execution_count": 2,
"execution_count": null,
"id": "743c19df-6da9-4d1e-b2d2-ea40080b9fdc",
"metadata": {},
"outputs": [],
@@ -56,7 +56,7 @@
" os.environ[var] = getpass.getpass(f\"Please provide your {var}\")\n",
"\n",
"\n",
"_set_if_undefined(\"OPENAI_API_KEY\")\n",
"_set_if_undefined(\"ANTHROPIC_API_KEY\")\n",
"_set_if_undefined(\"TAVILY_API_KEY\")"
]
},
@@ -73,57 +73,6 @@
"</div>"
]
},
{
"cell_type": "markdown",
"id": "5e4344a7-21df-4d54-90d2-9d19b3416ffb",
"metadata": {},
"source": [
"## Create Agents\n",
"\n",
"The following helper functions will help create agents. These agents will then be nodes in the graph.\n",
"\n",
"You can skip ahead if you just want to see what the graph looks like."
]
},
{
"cell_type": "code",
"execution_count": 31,
"id": "4325a10e-38dc-4a98-9004-e1525eaba377",
"metadata": {},
"outputs": [],
"source": [
"from langchain_core.messages import (\n",
" BaseMessage,\n",
" HumanMessage,\n",
" ToolMessage,\n",
")\n",
"from langchain_core.prompts import ChatPromptTemplate, MessagesPlaceholder\n",
"\n",
"from langgraph.graph import END, StateGraph, START\n",
"\n",
"\n",
"def create_agent(llm, tools, system_message: str):\n",
" \"\"\"Create an agent.\"\"\"\n",
" prompt = ChatPromptTemplate.from_messages(\n",
" [\n",
" (\n",
" \"system\",\n",
" \"You are a helpful AI assistant, collaborating with other assistants.\"\n",
" \" Use the provided tools to progress towards answering the question.\"\n",
" \" If you are unable to fully answer, that's OK, another assistant with different tools \"\n",
" \" will help where you left off. Execute what you can to make progress.\"\n",
" \" If you or any of the other assistants have the final answer or deliverable,\"\n",
" \" prefix your response with FINAL ANSWER so the team knows to stop.\"\n",
" \" You have access to the following tools: {tool_names}.\\n{system_message}\",\n",
" ),\n",
" MessagesPlaceholder(variable_name=\"messages\"),\n",
" ]\n",
" )\n",
" prompt = prompt.partial(system_message=system_message)\n",
" prompt = prompt.partial(tool_names=\", \".join([tool.name for tool in tools]))\n",
" return prompt | llm.bind_tools(tools)"
]
},
{
"cell_type": "markdown",
"id": "b4b40de2-5dd4-4d5b-882e-577210723ff4",
@@ -136,7 +85,7 @@
},
{
"cell_type": "code",
"execution_count": 63,
"execution_count": 3,
"id": "ca076f3b-a729-4ca9-8f91-05c2ba58d610",
"metadata": {},
"outputs": [],
@@ -155,7 +104,7 @@
"\n",
"\n",
"@tool\n",
"def python_repl(\n",
"def python_repl_tool(\n",
" code: Annotated[str, \"The python code to execute to generate your chart.\"],\n",
"):\n",
" \"\"\"Use this to execute python code. If you want to see the output of a value,\n",
@@ -180,37 +129,6 @@
"Now that we've defined our tools and made some helper functions, will create the individual agents below and tell them how to talk to each other using LangGraph."
]
},
{
"cell_type": "markdown",
"id": "0c6a8c3c-86a0-46aa-b970-ab070fb787d9",
"metadata": {},
"source": [
"### Define State\n",
"\n",
"We first define the state of the graph. This will just a list of messages, along with a key to track the most recent sender"
]
},
{
"cell_type": "code",
"execution_count": 64,
"id": "290c91d4-f6f4-443c-8181-233d39102974",
"metadata": {},
"outputs": [],
"source": [
"import operator\n",
"from typing import Annotated, Sequence\n",
"from typing_extensions import TypedDict\n",
"\n",
"from langchain_openai import ChatOpenAI\n",
"\n",
"\n",
"# This defines the object that is passed between each node\n",
"# in the graph. We will create different nodes for each agent and tool\n",
"class AgentState(TypedDict):\n",
" messages: Annotated[Sequence[BaseMessage], operator.add]\n",
" sender: str"
]
},
{
"cell_type": "markdown",
"id": "911a283e-ea04-40c1-b792-f9e5f7d81203",
@@ -218,77 +136,91 @@
"source": [
"### Define Agent Nodes\n",
"\n",
"We now need to define the nodes. First, let's define the nodes for the agents."
"We now need to define the nodes.\n",
"\n",
"First, we'll create a utility to create a system prompt for each agent."
]
},
{
"cell_type": "code",
"execution_count": 65,
"execution_count": 4,
"id": "4325a10e-38dc-4a98-9004-e1525eaba377",
"metadata": {},
"outputs": [],
"source": [
"def make_system_prompt(suffix: str) -> str:\n",
" return (\n",
" \"You are a helpful AI assistant, collaborating with other assistants.\"\n",
" \" Use the provided tools to progress towards answering the question.\"\n",
" \" If you are unable to fully answer, that's OK, another assistant with different tools \"\n",
" \" will help where you left off. Execute what you can to make progress.\"\n",
" \" If you or any of the other assistants have the final answer or deliverable,\"\n",
" \" prefix your response with FINAL ANSWER so the team knows to stop.\"\n",
" f\"\\n{suffix}\"\n",
" )"
]
},
{
"cell_type": "code",
"execution_count": 5,
"id": "71b790ca-9cef-4b22-b469-4b1d5d8424d6",
"metadata": {},
"outputs": [],
"source": [
"import functools\n",
"from langchain_core.messages import HumanMessage\n",
"from langchain_anthropic import ChatAnthropic\n",
"\n",
"from langchain_core.messages import AIMessage\n",
"from langgraph.prebuilt import create_react_agent\n",
"from langgraph.graph import MessagesState\n",
"\n",
"\n",
"# Helper function to create a node for a given agent\n",
"def agent_node(state, agent, name):\n",
" result = agent.invoke(state)\n",
" # We convert the agent output into a format that is suitable to append to the global state\n",
" if isinstance(result, ToolMessage):\n",
" pass\n",
" else:\n",
" result = AIMessage(**result.dict(exclude={\"type\", \"name\"}), name=name)\n",
"llm = ChatAnthropic(model=\"claude-3-5-sonnet-latest\")\n",
"\n",
"# Research agent and node\n",
"research_agent = create_react_agent(\n",
" llm,\n",
" tools=[tavily_tool],\n",
" state_modifier=make_system_prompt(\n",
" \"You can only do research. You are working with a chart generator colleague.\"\n",
" ),\n",
")\n",
"\n",
"\n",
"def research_node(state: MessagesState) -> MessagesState:\n",
" result = research_agent.invoke(state)\n",
" # wrap in a human message, as not all providers allow\n",
" # AI message at the last position of the input messages list\n",
" result[\"messages\"][-1] = HumanMessage(\n",
" content=result[\"messages\"][-1].content, name=\"researcher\"\n",
" )\n",
" return {\n",
" \"messages\": [result],\n",
" # Since we have a strict workflow, we can\n",
" # track the sender so we know who to pass to next.\n",
" \"sender\": name,\n",
" # share internal message history of research agent with other agents\n",
" \"messages\": result[\"messages\"],\n",
" }\n",
"\n",
"\n",
"llm = ChatOpenAI(model=\"gpt-4o\")\n",
"\n",
"# Research agent and node\n",
"research_agent = create_agent(\n",
"# Chart generator agent and node\n",
"# NOTE: THIS PERFORMS ARBITRARY CODE EXECUTION, WHICH CAN BE UNSAFE WHEN NOT SANDBOXED\n",
"chart_agent = create_react_agent(\n",
" llm,\n",
" [tavily_tool],\n",
" system_message=\"You should provide accurate data for the chart_generator to use.\",\n",
" [python_repl_tool],\n",
" state_modifier=make_system_prompt(\n",
" \"You can only generate charts. You are working with a researcher colleague.\"\n",
" ),\n",
")\n",
"research_node = functools.partial(agent_node, agent=research_agent, name=\"Researcher\")\n",
"\n",
"# chart_generator\n",
"chart_agent = create_agent(\n",
" llm,\n",
" [python_repl],\n",
" system_message=\"Any charts you display will be visible by the user.\",\n",
")\n",
"chart_node = functools.partial(agent_node, agent=chart_agent, name=\"chart_generator\")"
]
},
{
"cell_type": "markdown",
"id": "71c7f1b2-24a3-4340-bcb2-feb22e344fb6",
"metadata": {},
"source": [
"### Define Tool Node\n",
"\n",
"We now define a node to run the tools"
]
},
{
"cell_type": "code",
"execution_count": 66,
"id": "d9a79c76-5c7c-42f6-91cf-635bc8305804",
"metadata": {},
"outputs": [],
"source": [
"from langgraph.prebuilt import ToolNode\n",
"\n",
"tools = [tavily_tool, python_repl]\n",
"tool_node = ToolNode(tools)"
"def chart_node(state: MessagesState) -> MessagesState:\n",
" result = chart_agent.invoke(state)\n",
" # wrap in a human message, as not all providers allow\n",
" # AI message at the last position of the input messages list\n",
" result[\"messages\"][-1] = HumanMessage(\n",
" content=result[\"messages\"][-1].content, name=\"chart_generator\"\n",
" )\n",
" return {\n",
" # share internal message history of chart agent with other agents\n",
" \"messages\": result[\"messages\"],\n",
" }"
]
},
{
@@ -303,22 +235,15 @@
},
{
"cell_type": "code",
"execution_count": 67,
"id": "4f4b4d37-e8a3-4abb-8d42-eaea26016f35",
"execution_count": 6,
"id": "c30f800f-99dc-4207-ba09-0164e226dade",
"metadata": {},
"outputs": [],
"source": [
"# Either agent can decide to end\n",
"from typing import Literal\n",
"\n",
"\n",
"def router(state):\n",
"def router(state: MessagesState):\n",
" # This is the router\n",
" messages = state[\"messages\"]\n",
" last_message = messages[-1]\n",
" if last_message.tool_calls:\n",
" # The previous agent is invoking a tool\n",
" return \"call_tool\"\n",
" if \"FINAL ANSWER\" in last_message.content:\n",
" # Any agent decided the work is done\n",
" return END\n",
@@ -337,53 +262,41 @@
},
{
"cell_type": "code",
"execution_count": 68,
"id": "4dce3901-6ad5-4df5-8528-6e865cf96cb0",
"execution_count": 7,
"id": "2c4a5ade-5912-494b-bf62-8a99278f9f12",
"metadata": {},
"outputs": [],
"source": [
"workflow = StateGraph(AgentState)\n",
"from langgraph.graph import StateGraph, START, END\n",
"\n",
"workflow.add_node(\"Researcher\", research_node)\n",
"workflow = StateGraph(MessagesState)\n",
"workflow.add_node(\"researcher\", research_node)\n",
"workflow.add_node(\"chart_generator\", chart_node)\n",
"workflow.add_node(\"call_tool\", tool_node)\n",
"\n",
"workflow.add_conditional_edges(\n",
" \"Researcher\",\n",
" \"researcher\",\n",
" router,\n",
" {\"continue\": \"chart_generator\", \"call_tool\": \"call_tool\", END: END},\n",
" {\"continue\": \"chart_generator\", END: END},\n",
")\n",
"workflow.add_conditional_edges(\n",
" \"chart_generator\",\n",
" router,\n",
" {\"continue\": \"Researcher\", \"call_tool\": \"call_tool\", END: END},\n",
" {\"continue\": \"researcher\", END: END},\n",
")\n",
"\n",
"workflow.add_conditional_edges(\n",
" \"call_tool\",\n",
" # Each agent node updates the 'sender' field\n",
" # the tool calling node does not, meaning\n",
" # this edge will route back to the original agent\n",
" # who invoked the tool\n",
" lambda x: x[\"sender\"],\n",
" {\n",
" \"Researcher\": \"Researcher\",\n",
" \"chart_generator\": \"chart_generator\",\n",
" },\n",
")\n",
"workflow.add_edge(START, \"Researcher\")\n",
"workflow.add_edge(START, \"researcher\")\n",
"graph = workflow.compile()"
]
},
{
"cell_type": "code",
"execution_count": 12,
"execution_count": 8,
"id": "97f8e0eb",
"metadata": {},
"outputs": [
{
"data": {
"image/jpeg": "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 truncated
"image/png": "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 truncated
"text/plain": [
"<IPython.core.display.Image object>"
]
@@ -396,7 +309,7 @@
"from IPython.display import Image, display\n",
"\n",
"try:\n",
" display(Image(graph.get_graph(xray=True).draw_mermaid_png()))\n",
" display(Image(graph.get_graph().draw_mermaid_png()))\n",
"except Exception:\n",
" # This requires some extra dependencies and is optional\n",
" pass"
@@ -414,73 +327,30 @@
},
{
"cell_type": "code",
"execution_count": 70,
"id": "176a99b0-b457-45cf-8901-90facaa852da",
"execution_count": 10,
"id": "9f478b05-3f09-447f-a9f4-1b2eae73f5ef",
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"{'Researcher': {'messages': [AIMessage(content='', additional_kwargs={'tool_calls': [{'id': 'call_3zDlnDMUkWEJxnHASo59doCL', 'function': {'arguments': '{\"query\":\"UK GDP 2018 to 2023\"}', 'name': 'tavily_search_results_json'}, 'type': 'function'}]}, response_metadata={'token_usage': {'completion_tokens': 26, 'prompt_tokens': 221, 'total_tokens': 247}, 'model_name': 'gpt-4o', 'system_fingerprint': None, 'finish_reason': 'tool_calls', 'logprobs': None}, name='Researcher', id='run-ac6640c6-2bb4-478f-b3c4-eabf98cf4900-0', tool_calls=[{'name': 'tavily_search_results_json', 'args': {'query': 'UK GDP 2018 to 2023'}, 'id': 'call_3zDlnDMUkWEJxnHASo59doCL'}])], 'sender': 'Researcher'}}\n",
"----\n",
"{'call_tool': {'messages': [ToolMessage(content='[{\"url\": \"https://www.ons.gov.uk/economy/grossdomesticproductgdp/timeseries/ihyp/pn2\", \"content\": \"Preliminary estimate of GDP time series (PGDP), released on 27 April 2018\\\\nPublications that use this data\\\\nContact details for this data\\\\nFooter links\\\\nHelp\\\\nAbout ONS\\\\nConnect with us\\\\nAll content is available under the Open Government Licence v3.0, except where otherwise stated Year on Year growth: CVM SA %\\\\nDownload full time series as:\\\\nDownload filtered time series as:\\\\nTable\\\\nNotes\\\\nFollowing a quality review it has been identified that the methodology used to estimate elements of purchased software within gross fixed capital formation (GFCF) has led to some double counting from 1997 onwards. GDP quarterly national accounts time series (QNA), released on 22 December 2023\\\\nIHYP: UK Economic Accounts time series (UKEA), released on 22 December 2023\\\\nIHYP: GDP first quarterly estimate time series\\\\n(PN2), released on 10 November 2023\\\\nIHYP: Year on Year growth: CVM SA %\\\\nSource dataset: GDP first quarterly estimate time series (PN2)\\\\nContact: Niamh McAuley\\\\nRelease date: 10 November 2023\\\\nView previous versions\\\\n %\\\\nFilters\\\\nCustom time period\\\\nChart\\\\nDownload this time seriesGross Domestic Product:\"}, {\"url\": \"https://www.ons.gov.uk/economy/grossdomesticproductgdp\", \"content\": \"Quarter on Quarter growth: CVM SA %\\\\nChained Volume Measures (CVM)\\\\nGross Domestic Product: q-on-q4 growth rate CVM SA %\\\\nChained Volume Measures (CVM)\\\\nGross Domestic Product at market prices: Current price: Seasonally adjusted \\\\u00a3m\\\\nCurrent Prices (CP)\\\\nGross Domestic Product: quarter on quarter growth rate: CP SA %\\\\nCurrent Prices (CP)\\\\nGross Domestic Product: q-on-q4 growth quarter growth: CP SA %\\\\nCurrent Prices (CP)\\\\nDatasets related to Gross Domestic Product (GDP)\\\\n A roundup of the latest data and trends on the economy, business and jobs\\\\nTime series related to Gross Domestic Product (GDP)\\\\nGross Domestic Product: chained volume measures: Seasonally adjusted \\\\u00a3m\\\\nChained Volume Measures (CVM)\\\\nGross Domestic Product: Hide\\\\nData and analysis from Census 2021\\\\nGross Domestic Product (GDP)\\\\nGross domestic product (GDP) estimates as the main measure of UK economic growth based on the value of goods and services produced during a given period. Contains current and constant price data on the value of goods and services to indicate the economic performance of the UK.\\\\nEstimates of short-term indicators of investment in non-financial assets; business investment and asset and sector breakdowns of total gross fixed capital formation.\\\\n Monthly gross domestic product by gross value added\\\\nThe gross value added (GVA) tables showing the monthly and annual growths and indices as published within the monthly gross domestic product (GDP) statistical bulletin.\\\\n\"}, {\"url\": \"https://www.macrotrends.net/global-metrics/countries/GBR/united-kingdom/gdp-gross-domestic-product\", \"content\": \"U.K. gdp for 2021 was $3,141.51B, a 16.45% increase from 2020. U.K. gdp for 2020 was $2,697.81B, a 5.39% decline from 2019. U.K. gdp for 2019 was $2,851.41B, a 0.69% decline from 2018. GDP at purchaser\\'s prices is the sum of gross value added by all resident producers in the economy plus any product taxes and minus any subsidies not included in ...\"}, {\"url\": \"https://www.statista.com/statistics/281744/gdp-of-the-united-kingdom/\", \"content\": \"Industry Overview\\\\nDigital & Trend reports\\\\nOverview and forecasts on trending topics\\\\nIndustry & Market reports\\\\nIndustry and market insights and forecasts\\\\nCompanies & Products reports\\\\nKey figures and rankings about companies and products\\\\nConsumer & Brand reports\\\\nConsumer and brand insights and preferences in various industries\\\\nPolitics & Society reports\\\\nDetailed information about political and social topics\\\\nCountry & Region reports\\\\nAll key figures about countries and regions\\\\nMarket forecast and expert KPIs for 1000+ markets in 190+ countries & territories\\\\nInsights on consumer attitudes and behavior worldwide\\\\nBusiness information on 100m+ public and private companies\\\\nExplore Company Insights\\\\nDetailed information for 39,000+ online stores and marketplaces\\\\nDirectly accessible data for 170 industries from 150+ countries\\\\nand over 1\\\\u00a0Mio. facts.\\\\n Transforming data into design:\\\\nStatista Content & Design\\\\nStrategy and business building for the data-driven economy:\\\\nGDP of the UK 1948-2022\\\\nUK economy expected to shrink in 2023\\\\nHow big is the UK economy compared to others?\\\\nGross domestic product of the United Kingdom from 1948 to 2022\\\\n(in million GBP)\\\\nAdditional Information\\\\nShow sources information\\\\nShow publisher information\\\\nUse Ask Statista Research Service\\\\nDecembLine truncated
"----\n",
"{'Researcher': {'messages': [AIMessage(content=\"The search results provide some information about the UK's GDP over the past years, but most of the relevant data is either not in a structured format that can be easily extracted or it is behind a source that requires further access for detailed statistics. To proceed with generating a line graph, we need specific GDP values for each year from 2018 to 2023.\\n\\nHowever, one of the search results from macrotrends.net does provide specific GDP values for the years 2018 to 2021:\\n\\n- U.K. GDP for 2021 was $3,141.51 billion, a 16.45% increase from 2020.\\n- U.K. GDP for 2020 was $2,697.81 billion, a 5.39% decline from 2019.\\n- U.K. GDP for 2019 was $2,851.41 billion, a 0.69% decline from 2018.\\n\\nWe still need the GDP values for 2022 and 2023 to complete the dataset for the past five years. I will now conduct a further search to find the missing GDP data for 2022 and 2023.\", additional_kwargs={'tool_calls': [{'id': 'call_nvB1wQyQuNeTrOXQZnEtgNDZ', 'function': {'arguments': '{\"query\":\"UK GDP 2022 2023\"}', 'name': 'tavily_search_results_json'}, 'type': 'function'}]}, response_metadata={'token_usage': {'completion_tokens': 263, 'prompt_tokens': 3199, 'total_tokens': 3462}, 'model_name': 'gpt-4o', 'system_fingerprint': None, 'finish_reason': 'tool_calls', 'logprobs': None}, name='Researcher', id='run-25901401-0d62-485f-b7d5-37e3c159effe-0', tool_calls=[{'name': 'tavily_search_results_json', 'args': {'query': 'UK GDP 2022 2023'}, 'id': 'call_nvB1wQyQuNeTrOXQZnEtgNDZ'}])], 'sender': 'Researcher'}}\n",
"----\n",
"{'call_tool': {'messages': [ToolMessage(content='[{\"url\": \"https://www.statista.com/statistics/281744/gdp-of-the-united-kingdom/\", \"content\": \"Industry Overview\\\\nDigital & Trend reports\\\\nOverview and forecasts on trending topics\\\\nIndustry & Market reports\\\\nIndustry and market insights and forecasts\\\\nCompanies & Products reports\\\\nKey figures and rankings about companies and products\\\\nConsumer & Brand reports\\\\nConsumer and brand insights and preferences in various industries\\\\nPolitics & Society reports\\\\nDetailed information about political and social topics\\\\nCountry & Region reports\\\\nAll key figures about countries and regions\\\\nMarket forecast and expert KPIs for 1000+ markets in 190+ countries & territories\\\\nInsights on consumer attitudes and behavior worldwide\\\\nBusiness information on 100m+ public and private companies\\\\nExplore Company Insights\\\\nDetailed information for 39,000+ online stores and marketplaces\\\\nDirectly accessible data for 170 industries from 150+ countries\\\\nand over 1\\\\u00a0Mio. facts.\\\\n Transforming data into design:\\\\nStatista Content & Design\\\\nStrategy and business building for the data-driven economy:\\\\nGDP of the UK 1948-2022\\\\nUK economy expected to shrink in 2023\\\\nHow big is the UK economy compared to others?\\\\nGross domestic product of the United Kingdom from 1948 to 2022\\\\n(in million GBP)\\\\nAdditional Information\\\\nShow sources information\\\\nShow publisher information\\\\nUse Ask Statista Research Service\\\\nDecember 2023\\\\nUnited Kingdom\\\\n1948 to 2022\\\\n*GDP is displayed in real terms (seasonally adjusted chained volume measure with 2019 as the reference year)\\\\n Statistics on\\\\n\\\\\"\\\\nEconomy of the UK\\\\n\\\\\"\\\\nOther statistics that may interest you Economy of the UK\\\\nGross domestic product\\\\nLabor Market\\\\nInflation\\\\nGovernment finances\\\\nBusiness Enterprise\\\\nFurther related statistics\\\\nFurther Content: You might find this interesting as well\\\\nStatistics\\\\nTopics Other statistics on the topicThe UK economy\\\\nEconomy\\\\nRPI annual inflation rate UK 2000-2028\\\\nEconomy\\\\nCPI annual inflation rate UK 2000-2028\\\\nEconomy\\\\nAverage annual earnings for full-time employees in the UK 1999-2023\\\\nEconomy\\\\nInflation rate in the UK 1989-2023\\\\nYou only have access to basic statistics.\\\\n Customized Research & Analysis projects:\\\\nGet quick analyses with our professional research service\\\\nThe best of the best: the portal for top lists & rankings:\\\\n\"}, {\"url\": \"https://www.ons.gov.uk/economy/grossdomesticproductgdp\", \"content\": \"Quarter on Quarter growth: CVM SA %\\\\nChained Volume Measures (CVM)\\\\nGross Domestic Product: q-on-q4 growth rate CVM SA %\\\\nChained Volume Measures (CVM)\\\\nGross Domestic Product at market prices: Current price: Seasonally adjusted \\\\u00a3m\\\\nCurrent Prices (CP)\\\\nGross Domestic Product: quarter on quarter growth rate: CP SA %\\\\nCurrent Prices (CP)\\\\nGross Domestic Product: q-on-q4 growth quarter growth: CP SA %\\\\nCurrent Prices (CP)\\\\nDatasets related to Gross Domestic Product (GDP)\\\\n A roundup of the latest data and trends on the economy, business and jobs\\\\nTime series related to Gross Domestic Product (GDP)\\\\nGross Domestic Product: chained volume measures: Seasonally adjusted \\\\u00a3m\\\\nChained Volume Measures (CVM)\\\\nGross Domestic Product: Hide\\\\nData and analysis from Census 2021\\\\nGross Domestic Product (GDP)\\\\nGross domestic product (GDP) estimates as the main measure of UK economic growth based on the value of goods and services produced during a given period. Contains current and constant price data on the value of goods and services to indicate the economic performance of the UK.\\\\nEstimates of short-term indicators of investment in non-financial assets; business investment and asset and sector breakdowns of total gross fixed capital formation.\\\\n Monthly gross domestic product by gross value added\\\\nThe gross value added (GVA) tables showing the monthly and annual growths and indices as published within the monthly gross domestic product (GDP) statistical bulletin.\\\\n\"}, {\"url\": \"https://www.ons.gov.uk/economy/grossdomesticproductgdp/bulletins/gdpfirstquarterlyestimateuk/octobertodecember2023\", \"content\": \"This review covered:\\\\nprocesses and quality assurance in making revisions to GDP\\\\npotential improvements to early estimates of GDP enabled through enhanced access to data\\\\ncommunication of revisions to GDP, the story behind the most recent set of revisions in particular, and uncertainty in early estimates of GDP\\\\nWe have already started work looking into the recommendations of this review and have set out our plans on how we will improve the way we communicate uncertainty.\\\\n Source: GDP first quarterly estimate from the Office for National Statistics\\\\nNotes\\\\nOffice for Statistics Regulation RevisiLine truncated
"----\n",
"{'Researcher': {'messages': [AIMessage(content=\"The search results did not provide exact figures for the UK's GDP in 2022 and 2023. While there are several references to GDP data, growth rates, and quarterly figures, we do not have the specific annual GDP values in a consistent currency format (such as USD or GBP) that would allow us to compile a complete dataset for the past five years.\\n\\nTo proceed, we will need to find another source or use a different method to obtain the missing GDP data for 2022 and 2023. If this data is not available, we may not be able to draw an accurate line graph of the UK's GDP over the past five years.\", response_metadata={'token_usage': {'completion_tokens': 134, 'prompt_tokens': 6996, 'total_tokens': 7130}, 'model_name': 'gpt-4o', 'system_fingerprint': None, 'finish_reason': 'stop', 'logprobs': None}, name='Researcher', id='run-aa7d307d-cfdd-4c83-ad09-b6b0efbffe6e-0')], 'sender': 'Researcher'}}\n",
"----\n",
"{'chart_generator': {'messages': [AIMessage(content=\"It seems we have hit a roadblock in finding the exact GDP figures for the UK for the years 2022 and 2023. The information provided by the search results does not include the specific data we need. Therefore, we currently do not have the complete dataset to generate a line graph of the UK's GDP over the past five years.\\n\\nTo proceed, we might need to look for an official statistical release or a comprehensive economic report that includes the GDP figures for 2022 and 2023. If such data can be obtained, we can then use it to create the desired line graph. Without this data, we cannot fulfill the request as specified.\", response_metadata={'token_usage': {'completion_tokens': 134, 'prompt_tokens': 7150, 'total_tokens': 7284}, 'model_name': 'gpt-4o', 'system_fingerprint': None, 'finish_reason': 'stop', 'logprobs': None}, name='chart_generator', id='run-a667e647-45b2-414e-b301-81f846fa59ad-0')], 'sender': 'chart_generator'}}\n",
"----\n",
"{'Researcher': {'messages': [AIMessage(content=\"I am unable to proceed with generating the line graph as we lack the specific GDP data for the UK for the years 2022 and 2023. To complete this task, we would need to acquire the missing data points. If the data becomes available, or if there's an alternative source that can provide the figures, we can revisit this task and generate the line graph accordingly. For now, we must conclude this attempt.\", response_metadata={'token_usage': {'completion_tokens': 87, 'prompt_tokens': 7276, 'total_tokens': 7363}, 'model_name': 'gpt-4o', 'system_fingerprint': None, 'finish_reason': 'stop', 'logprobs': None}, name='Researcher', id='run-1731ab9f-7ee9-4ff9-a920-7b998a41fe4d-0')], 'sender': 'Researcher'}}\n",
"----\n",
"{'chart_generator': {'messages': [AIMessage(content=\"As of my last attempt, I have not been able to find the exact GDP figures for the UK for the years 2022 and 2023. Without these figures, it's not possible to generate a complete and accurate line graph of the UK's GDP over the past five years. Should the data become available or if an alternative source can provide the figures, we can proceed with creating the graph. For the time being, this task cannot be completed.\", response_metadata={'token_usage': {'completion_tokens': 93, 'prompt_tokens': 7383, 'total_tokens': 7476}, 'model_name': 'gpt-4o', 'system_fingerprint': None, 'finish_reason': 'stop', 'logprobs': None}, name='chart_generator', id='run-6e12dccd-b1b2-4c7d-befd-4a338d027756-0')], 'sender': 'chart_generator'}}\n",
"----\n",
"{'Researcher': {'messages': [AIMessage(content=\"I have attempted to gather the UK's GDP data for the past five years to draw a line graph, but I was only able to obtain confirmed figures for the years 2018 through 2021. The GDP data for 2022 and 2023 was not available in the search results. Without complete data, it is not possible to generate the line graph as requested. If the missing data for 2022 and 2023 becomes available or an alternative verified source can provide these figures, we can revisit this task to create the graph.\", response_metadata={'token_usage': {'completion_tokens': 111, 'prompt_tokens': 7468, 'total_tokens': 7579}, 'model_name': 'gpt-4o', 'system_fingerprint': None, 'finish_reason': 'stop', 'logprobs': None}, name='Researcher', id='run-9d93e637-cedd-4b17-945a-cc97e490432c-0')], 'sender': 'Researcher'}}\n",
"----\n",
"{'chart_generator': {'messages': [AIMessage(content=\"I've exhausted the available tools to find the UK's GDP for the past five years, but I was able to obtain data up to the year 2021. Unfortunately, without the GDP data for 2022 and 2023, I cannot create a complete line graph for the UK's GDP over the past five years.\\n\\nTo generate the line graph, we would need to have all the necessary data points for each year from 2018 to 2023. If you can provide the GDP data for 2022 and 2023 or direct me to a specific source where these figures can be found, I will be able to create the line graph for you.\", response_metadata={'token_usage': {'completion_tokens': 136, 'prompt_tokens': 7599, 'total_tokens': 7735}, 'model_name': 'gpt-4o', 'system_fingerprint': None, 'finish_reason': 'stop', 'logprobs': None}, name='chart_generator', id='run-82063d76-6655-473e-9f6a-a5c005d92bd3-0')], 'sender': 'chart_generator'}}\n",
"----\n",
"{'Researcher': {'messages': [AIMessage(content=\"I have exhausted the available tools to find the UK's GDP for the past five years, but I was able to obtain data up to the year 2021. Unfortunately, without the GDP data for 2022 and 2023, I cannot create a complete line graph for the UK's GDP over the past five years.\\n\\nTo generate the line graph, we would need to have all the necessary data points for each year from 2018 to 2023. If you can provide the GDP data for 2022 and 2023 or direct me to a specific source where these figures can be found, I will be able to create the line graph for you.\", response_metadata={'token_usage': {'completion_tokens': 136, 'prompt_tokens': 7727, 'total_tokens': 7863}, 'model_name': 'gpt-4o', 'system_fingerprint': 'fp_85bf4c41a2', 'finish_reason': 'stop', 'logprobs': None}, name='Researcher', id='run-954e7bb2-ae3e-4610-9927-4b16d733414e-0')], 'sender': 'Researcher'}}\n",
"----\n",
"{'chart_generator': {'messages': [AIMessage(content=\"Having attempted to find the UK's GDP figures for the years 2022 and 2023 through available data sources and coming up short, it appears we are currently unable to produce a complete line graph of the UK's GDP over the past five years as initially requested. To create a graph, we would need precise GDP data for each year from 2018 to 2023.\\n\\nIf the missing GDP data for 2022 and 2023 becomes available or if an alternative source can provide these figures, we can then proceed to generate the line graph. As of now, this task must be paused until the necessary data can be obtained.\", response_metadata={'token_usage': {'completion_tokens': 130, 'prompt_tokens': 7883, 'total_tokens': 8013}, 'model_name': 'gpt-4o', 'system_fingerprint': 'fp_85bf4c41a2', 'finish_reason': 'stop', 'logprobs': None}, name='chart_generator', id='run-8d1382e2-a77c-4d2f-b06a-2597be59542b-0')], 'sender': 'chart_generator'}}\n",
"----\n",
"{'Researcher': {'messages': [AIMessage(content=\"The search results do not provide the exact GDP figures for the UK for 2022 and 2023. Without this information, it is not possible to generate a line graph of the UK's GDP over the past five years. We would require the GDP values for those two years to complete the dataset and create the graph. As of now, I must conclude this task until the necessary data becomes available.\", response_metadata={'token_usage': {'completion_tokens': 82, 'prompt_tokens': 8005, 'total_tokens': 8087}, 'model_name': 'gpt-4o', 'system_fingerprint': None, 'finish_reason': 'stop', 'logprobs': None}, name='Researcher', id='run-246b9b29-ffc7-4da9-a09a-0dcfbbb3bd7a-0')], 'sender': 'Researcher'}}\n",
"----\n",
"{'chart_generator': {'messages': [AIMessage(content=\"I have attempted to find the UK's GDP for the past five years to create a line graph, but I could only obtain confirmed figures for the years 2018 through 2021. The GDP data for 2022 and 2023 was not available in the search results. Without complete data, it is not possible to generate the line graph as requested. If the missing data for 2022 and 2023 becomes available or an alternative verified source can provide these figures, we can revisit this task to create the graph.\", response_metadata={'token_usage': {'completion_tokens': 108, 'prompt_tokens': 8107, 'total_tokens': 8215}, 'model_name': 'gpt-4o', 'system_fingerprint': 'fp_85bf4c41a2', 'finish_reason': 'stop', 'logprobs': None}, name='chart_generator', id='run-f2847a80-610d-49c5-924a-ccffccb7cd5a-0')], 'sender': 'chart_generator'}}\n",
"----\n",
"{'Researcher': {'messages': [AIMessage(content=\"As of now, I was unable to obtain the complete data for the UK's GDP over the past five years due to lack of specific information for the years 2022 and 2023. Therefore, it's not possible to draw a line graph of the UK's GDP for this period without the complete dataset. Further action to acquire the missing data would be required to proceed.\", response_metadata={'token_usage': {'completion_tokens': 77, 'prompt_tokens': 8207, 'total_tokens': 8284}, 'model_name': 'gpt-4o', 'system_fingerprint': None, 'finish_reason': 'stop', 'logprobs': None}, name='Researcher', id='run-28e09000-8787-4ac0-a7d8-0aba888c2520-0')], 'sender': 'Researcher'}}\n",
"----\n",
"{'chart_generator': {'messages': [AIMessage(content=\"It appears we have encountered a limitation in obtaining the complete GDP data for the UK for 2022 and 2023. Without these figures, we cannot create the line graph of the UK's GDP over the past five years as requested. If the data becomes available, or if there's an alternative source that can provide the figures, we can revisit this task and generate the line graph accordingly. For now, this task will have to be concluded without completion.\", response_metadata={'token_usage': {'completion_tokens': 93, 'prompt_tokens': 8304, 'total_tokens': 8397}, 'model_name': 'gpt-4o', 'system_fingerprint': None, 'finish_reason': 'stop', 'logprobs': None}, name='chart_generator', id='run-8bf8f247-cb86-4ef0-a81b-14da2d27b6f1-0')], 'sender': 'chart_generator'}}\n",
"----\n",
"{'Researcher': {'messages': [AIMessage(content='', additional_kwargs={'tool_calls': [{'id': 'call_df3UdS3vJkJFB30O0WYq38k8', 'function': {'arguments': '{\"query\":\"UK GDP 2022 2023 statistics\"}', 'name': 'tavily_search_results_json'}, 'type': 'function'}]}, response_metadata={'token_usage': {'completion_tokens': 26, 'prompt_tokens': 8389, 'total_tokens': 8415}, 'model_name': 'gpt-4o', 'system_fingerprint': None, 'finish_reason': 'tool_calls', 'logprobs': None}, name='Researcher', id='run-e1577cc7-5673-4821-9683-34947c7a2bc5-0', tool_calls=[{'name': 'tavily_search_results_json', 'args': {'query': 'UK GDP 2022 2023 statistics'}, 'id': 'call_df3UdS3vJkJFB30O0WYq38k8'}])], 'sender': 'Researcher'}}\n",
"----\n",
"{'call_tool': {'messages': [ToolMessage(content='[{\"url\": \"https://www.statista.com/statistics/281744/gdp-of-the-united-kingdom/\", \"content\": \"Industry Overview\\\\nDigital & Trend reports\\\\nOverview and forecasts on trending topics\\\\nIndustry & Market reports\\\\nIndustry and market insights and forecasts\\\\nCompanies & Products reports\\\\nKey figures and rankings about companies and products\\\\nConsumer & Brand reports\\\\nConsumer and brand insights and preferences in various industries\\\\nPolitics & Society reports\\\\nDetailed information about political and social topics\\\\nCountry & Region reports\\\\nAll key figures about countries and regions\\\\nMarket forecast and expert KPIs for 1000+ markets in 190+ countries & territories\\\\nInsights on consumer attitudes and behavior worldwide\\\\nBusiness information on 100m+ public and private companies\\\\nExplore Company Insights\\\\nDetailed information for 39,000+ online stores and marketplaces\\\\nDirectly accessible data for 170 industries from 150+ countries\\\\nand over 1\\\\u00a0Mio. facts.\\\\n Transforming data into design:\\\\nStatista Content & Design\\\\nStrategy and business building for the data-driven economy:\\\\nGDP of the UK 1948-2022\\\\nUK economy expected to shrink in 2023\\\\nHow big is the UK economy compared to others?\\\\nGross domestic product of the United Kingdom from 1948 to 2022\\\\n(in million GBP)\\\\nAdditional Information\\\\nShow sources information\\\\nShow publisher information\\\\nUse Ask Statista Research Service\\\\nDecember 2023\\\\nUnited Kingdom\\\\n1948 to 2022\\\\n*GDP is displayed in real terms (seasonally adjusted chained volume measure with 2019 as the reference year)\\\\n Statistics on\\\\n\\\\\"\\\\nEconomy of the UK\\\\n\\\\\"\\\\nOther statistics that may interest you Economy of the UK\\\\nGross domestic product\\\\nLabor Market\\\\nInflation\\\\nGovernment finances\\\\nBusiness Enterprise\\\\nFurther related statistics\\\\nFurther Content: You might find this interesting as well\\\\nStatistics\\\\nTopics Other statistics on the topicThe UK economy\\\\nEconomy\\\\nRPI annual inflation rate UK 2000-2028\\\\nEconomy\\\\nCPI annual inflation rate UK 2000-2028\\\\nEconomy\\\\nAverage annual earnings for full-time employees in the UK 1999-2023\\\\nEconomy\\\\nInflation rate in the UK 1989-2023\\\\nYou only have access to basic statistics.\\\\n Customized Research & Analysis projects:\\\\nGet quick analyses with our professional research service\\\\nThe best of the best: the portal for top lists & rankings:\\\\n\"}, {\"url\": \"https://www.statista.com/topics/3795/gdp-of-the-uk/\", \"content\": \"Monthly growth of gross domestic product in the United Kingdom from January 2019 to November 2023\\\\nContribution to GDP growth in the UK 2023, by sector\\\\nContribution to gross domestic product growth in the United Kingdom in January 2023, by sector\\\\nGDP growth rate in the UK 1999-2021, by country\\\\nAnnual growth rates of gross domestic product in the United Kingdom from 1999 to 2021, by country\\\\nGDP growth rate in the UK 2021, by region\\\\nAnnual growth rates of gross domestic product in the United Kingdom in 2021, by region\\\\nGDP growth of Scotland 2021, by local area\\\\nAnnual growth rates of gross domestic product in Scotland in 2021, by local (ITL 3) area\\\\nGDP growth of Wales 2021, by local area\\\\nAnnual growth rates of gross domestic product in Wales in 2021, by local (ITL 3) area\\\\nGDP growth of Northern Ireland 2021, by local area\\\\nAnnual growth rates of gross domestic product in Northern Ireland in 2021, by local (ITL 3) area\\\\nGDP per capita\\\\nGDP per capita\\\\nGDP per capita in the UK 1955-2022\\\\nGross domestic product per capita in the United Kingdom from 1955 to 2022 (in GBP)\\\\nAnnual GDP per capita growth in the UK 1956-2022\\\\nAnnual GDP per capita growth in the United Kingdom from 1956 to 2022\\\\nQuarterly GDP per capita in the UK 2019-2023\\\\nQuarterly GDP per capita in the United Kingdom from 1st quarter 2019 to 3rd quarter 2023 (in GBP)\\\\nQuarterly GDP per capita growth in the UK 2019-2023\\\\nQuarterly GDP per capita growth in the United Kingdom from 1st quarter 2019 to 3rd quarter 2023 (in GBP)\\\\nGDP per capita of the UK 1999-2021, by country\\\\nGross domestic product per capita of the United Kingdom from 1999 to 2021, by country (in GBP)\\\\nGDP per capita of the UK 2021, by region\\\\nGross domestic product per capita of the United Kingdom in 2021, by region (in GBP)\\\\nGlobal Comparisons\\\\nGlobal Comparisons\\\\nCountries with the largest gross domestic product (GDP) 2022\\\\n Monthly GDP of the UK 2019-2023\\\\nMonthly index of gross domestic product in the United Kingdom from January 2019 to November 2023 (2019=100)\\\\nGVA of the UK 2022, by sector\\\\nGross value added of the United Kingdom in 2022, by industry sector (in million GBP)\\\\nGDP of the UK 2021, by country\\\\nGross domestic product of the United Kingdom in Line truncated
"----\n",
"{'Researcher': {'messages': [AIMessage(content=\"The search results unfortunately do not provide specific figures for the UK's GDP in 2022 and 2023. While there are references to GDP data and related economic indicators, the exact annual GDP values needed to create the line graph are not present.\\n\\nOne possible approach to obtain these figures would be to access detailed statistical databases or reports from official sources such as the Office for National Statistics (ONS) or economic research institutions that publish historical GDP data. These sources might have the most recent and accurate GDP figures available for the UK, which are necessary to complete the line graph.\\n\\nSince I cannot directly access or retrieve the data from these sources using the tools available to me, I recommend consulting such databases or reports to find the UK's GDP for 2022 and 2023. Once the data is obtained, it can be used to create the line graph.\", response_metadata={'token_usage': {'completion_tokens': 172, 'prompt_tokens': 12099, 'total_tokens': 12271}, 'model_name': 'gpt-4o', 'system_fingerprint': None, 'finish_reason': 'stop', 'logprobs': None}, name='Researcher', id='run-7b4bcbc3-3ed0-4fa0-8e5d-a366c5a80d5a-0')], 'sender': 'Researcher'}}\n",
"----\n",
"{'chart_generator': {'messages': [AIMessage(content='', additional_kwargs={'tool_calls': [{'id': 'call_JPVxDAzEFi21crVT7Rt6SRJl', 'function': {'arguments': '{\"code\":\"import matplotlib.pyplot as plt\\\\n\\\\n# UK GDP data obtained from search results for 2018-2021 (in billion USD)\\\\n# The data for 2022 and 2023 are placeholders and should be replaced with actual figures when available\\\\ngdp_data = {\\\\n \\'Year\\': [2018, 2019, 2020, 2021, 2022, 2023],\\\\n \\'GDP (Billion USD)\\': [2851.41, 2697.81, 3141.51, None, None]\\\\n}\\\\n\\\\n# Plot a line graph\\\\nplt.figure(figsize=(10, 5))\\\\nplt.plot(gdp_data[\\'Year\\'], gdp_data[\\'GDP (Billion USD)\\'], marker=\\'o\\')\\\\n\\\\n# Title and labels\\\\nplt.title(\\'UK GDP from 2018 to 2023\\')\\\\nplt.xlabel(\\'Year\\')\\\\nplt.ylabel(\\'GDP (Billion USD)\\')\\\\n\\\\n# Show grid\\\\nplt.grid(True)\\\\n\\\\n# Display the graph\\\\nplt.show()\"}', 'name': 'python_repl'}, 'type': 'function'}]}, response_metadata={'token_usage': {'completion_tokens': 240, 'prompt_tokens': 12291, 'total_tokens': 12531}, 'model_name': 'gpt-4o', 'system_fingerprint': None, 'finish_reason': 'tool_calls', 'logprobs': None}, name='chart_generator', id='run-6cff57bc-ba87-4690-9528-4d15bba7986c-0', tool_calls=[{'name': 'python_repl', 'args': {'code': \"import matplotlib.pyplot as plt\\n\\n# UK GDP data obtained from search results for 2018-2021 (in billion USD)\\n# The data for 2022 and 2023 are placeholders and should be replaced with actual figures when available\\ngdp_data = {\\n 'Year': [2018, 2019, 2020, 2021, 2022, 2023],\\n 'GDP (Billion USD)': [2851.41, 2697.81, 3141.51, None, None]\\n}\\n\\n# Plot a line graph\\nplt.figure(figsize=(10, 5))\\nplt.plot(gdp_data['Year'], gdp_data['GDP (Billion USD)'], marker='o')\\n\\n# Title and labels\\nplt.title('UK GDP from 2018 to 2023')\\nplt.xlabel('Year')\\nplt.ylabel('GDP (Billion USD)')\\n\\n# Show grid\\nplt.grid(True)\\n\\n# Display the graph\\nplt.show()\"}, 'id': 'call_JPVxDAzEFi21crVT7Rt6SRJl'}])], 'sender': 'chart_generator'}}\n",
"----\n",
"{'call_tool': {'messages': [ToolMessage(content=\"Successfully executed:\\n```python\\nimport matplotlib.pyplot as plt\\n\\n# UK GDP data obtained from search results for 2018-2021 (in billion USD)\\n# The data for 2022 and 2023 are placeholders and should be replaced with actual figures when available\\ngdp_data = {\\n 'Year': [2018, 2019, 2020, 2021, 2022, 2023],\\n 'GDP (Billion USD)': [2851.41, 2697.81, 3141.51, None, None]\\n}\\n\\n# Plot a line graph\\nplt.figure(figsize=(10, 5))\\nplt.plot(gdp_data['Year'], gdp_data['GDP (Billion USD)'], marker='o')\\n\\n# Title and labels\\nplt.title('UK GDP from 2018 to 2023')\\nplt.xlabel('Year')\\nplt.ylabel('GDP (Billion USD)')\\n\\n# Show grid\\nplt.grid(True)\\n\\n# Display the graph\\nplt.show()\\n```\\nStdout: ValueError('x and y must have same first dimension, but have shapes (6,) and (5,)')\\n\\nIf you have completed all tasks, respond with FINAL ANSWER.\", name='python_repl', tool_call_id='call_JPVxDAzEFi21crVT7Rt6SRJl')]}}\n",
"{'researcher': {'messages': [HumanMessage(content=\"First, get the UK's GDP over the past 5 years, then make a line chart of it. Once you make the chart, finish.\", additional_kwargs={}, response_metadata={}, id='fa1f5e95-9e1a-47d4-b4b6-e93f345e339d'), AIMessage(content=[{'text': \"I'll help search for the UK's GDP data over the past 5 years. Then my colleague can help create the line chart.\", 'type': 'text'}, {'id': 'toolu_01Jd9dxa4Ss2NhzBhCuwUX3E', 'input': {'query': 'UK GDP annual data past 5 years 2019-2023'}, 'name': 'tavily_search_results_json', 'type': 'tool_use'}], additional_kwargs={}, response_metadata={'id': 'msg_014nCkfVHnG6LAsiS6pY7zcd', 'model': 'claude-3-5-sonnet-20241022', 'stop_reason': 'tool_use', 'stop_sequence': None, 'usage': {'input_tokens': 555, 'output_tokens': 101}}, id='run-e2297529-9972-4de6-835d-23d920b0e29b-0', tool_calls=[{'name': 'tavily_search_results_json', 'args': {'query': 'UK GDP annual data past 5 years 2019-2023'}, 'id': 'toolu_01Jd9dxa4Ss2NhzBhCuwUX3E', 'type': 'tool_call'}], usage_metadata={'input_tokens': 555, 'output_tokens': 101, 'total_tokens': 656, 'input_token_details': {}}), ToolMessage(content='[{\"url\": \"https://www.macrotrends.net/global-metrics/countries/GBR/united-kingdom/gdp-gross-domestic-product\", \"content\": \"Dollar figures for GDP are converted from domestic currencies using single year official exchange rates. For a few countries where the official exchange rate does not reflect the rate effectively applied to actual foreign exchange transactions, an alternative conversion factor is used. U.K. gdp for 2023 was $3,340.03B, a 8.13% increase from 2022.\"}, {\"url\": \"https://www.statista.com/topics/3795/gdp-of-the-uk/\", \"content\": \"Monthly growth of gross domestic product in the United Kingdom from January 2019 to November 2023\\\\nContribution to GDP growth in the UK 2023, by sector\\\\nContribution to gross domestic product growth in the United Kingdom in January 2023, by sector\\\\nGDP growth rate in the UK 1999-2021, by country\\\\nAnnual growth rates of gross domestic product in the United Kingdom from 1999 to 2021, by country\\\\nGDP growth rate in the UK 2021, by region\\\\nAnnual growth rates of gross domestic product in the United Kingdom in 2021, by region\\\\nGDP growth of Scotland 2021, by local area\\\\nAnnual growth rates of gross domestic product in Scotland in 2021, by local (ITL 3) area\\\\nGDP growth of Wales 2021, by local area\\\\nAnnual growth rates of gross domestic product in Wales in 2021, by local (ITL 3) area\\\\nGDP growth of Northern Ireland 2021, by local area\\\\nAnnual growth rates of gross domestic product in Northern Ireland in 2021, by local (ITL 3) area\\\\nGDP per capita\\\\nGDP per capita\\\\nGDP per capita in the UK 1955-2022\\\\nGross domestic product per capita in the United Kingdom from 1955 to 2022 (in GBP)\\\\nAnnual GDP per capita growth in the UK 1956-2022\\\\nAnnual GDP per capita growth in the United Kingdom from 1956 to 2022\\\\nQuarterly GDP per capita in the UK 2019-2023\\\\nQuarterly GDP per capita in the United Kingdom from 1st quarter 2019 to 3rd quarter 2023 (in GBP)\\\\nQuarterly GDP per capita growth in the UK 2019-2023\\\\nQuarterly GDP per capita growth in the United Kingdom from 1st quarter 2019 to 3rd quarter 2023 (in GBP)\\\\nGDP per capita of the UK 1999-2021, by country\\\\nGross domestic product per capita of the United Kingdom from 1999 to 2021, by country (in GBP)\\\\nGDP per capita of the UK 2021, by region\\\\nGross domestic product per capita of the United Kingdom in 2021, by region (in GBP)\\\\nGlobal Comparisons\\\\nGlobal Comparisons\\\\nCountries with the largest gross domestic product (GDP) 2022\\\\n Monthly GDP of the UK 2019-2023\\\\nMonthly index of gross domestic product in the United Kingdom from January 2019 to November 2023 (2019=100)\\\\nGVA of the UK 2022, by sector\\\\nGross value added of the United Kingdom in 2022, by industry sector (in million GBP)\\\\nGDP of the UK 2021, by country\\\\nGross domestic product of the United Kingdom in 2021, by country (in million GBP)\\\\nGDP of the UK 2021, by region\\\\nGross domestic product of the United Kingdom in 2021, by region (in million GBP)\\\\nGDP of Scotland 2021, by local area\\\\nGross domestic product of Scotland in 2021, by local (ITL 3) area (in million GBP)\\\\nGDP of Wales 2021, by local area\\\\nGross domestic product of Wales in 2021, by local (ITL 3) area (in million GBP)\\\\nGDP of Northern Ireland 2021, by local area\\\\nGross domestic product of Northern Ireland in 2021, by local (ITL 3) area (in million GBP)\\\\nGDP growth\\\\nGDP growth\\\\nGDP growth forecast for the UK 2000-2028\\\\nForecasted annual growth of gross domestic product in the United Kingdom from 2000 to 2028\\\\nAnnual GDP growth in the UK 1949-2022\\\\nAnnual growth of gross domestic product in the United Kingdom from 1949 to 2022\\\\nQuarterly GDP growth of the UK 2019-2023\\\\nQuarterly growth of gross domestic product Line truncated
"----\n"
]
},
{
"data": {
"image/png": "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3bF48eKIiFi4cGFMmzYtGhsbIyJi7ty5cd9998X5558fVVVV8frrr8edd94Zc+fO7Y8jAACAsZJ3FNXV1cW+ffti+fLl0d7eHjNnzozm5ub+D1/YvXv3gDtDd9xxRxQUFMQdd9wRb731VnziE5+IuXPnxk9+8pPhexUAAABDVJCNg/ewdXV1RVlZWXR2dkZpaelYbwcAABgjI9EGI/7pcwAAAB9loggAAEiaKAIAAJImigAAgKSJIgAAIGmiCAAASJooAgAAkiaKAACApIkiAAAgaaIIAABImigCAACSJooAAICkiSIAACBpoggAAEiaKAIAAJImigAAgKSJIgAAIGmiCAAASJooAgAAkiaKAACApIkiAAAgaaIIAABImigCAACSJooAAICkiSIAACBpoggAAEiaKAIAAJImigAAgKSJIgAAIGmiCAAASJooAgAAkiaKAACApIkiAAAgaaIIAABImigCAACSJooAAICkiSIAACBpoggAAEiaKAIAAJImigAAgKSJIgAAIGmiCAAASJooAgAAkiaKAACApIkiAAAgaaIIAABImigCAACSJooAAICkiSIAACBpoggAAEiaKAIAAJImigAAgKSJIgAAIGmiCAAASJooAgAAkiaKAACApIkiAAAgaaIIAABImigCAACSJooAAICkiSIAACBpoggAAEiaKAIAAJImigAAgKSJIgAAIGmiCAAASNqQoqipqSmmT58eJSUlUVVVFZs2bfrA+e+8804sWbIkpkyZErlcLs4888zYsGHDkDYMAAAwnCbku2DdunVRX18fq1evjqqqqli1alXU1tbGjh07YvLkyYfN7+npia9+9asxefLkeOKJJ2LatGnx5ptvximnnDIc+wcAADgmBVmWZfksqKqqigsuuCDuv//+iIjo6+uLysrKuPHGG2Pp0qWHzV+9enX8/Oc/j+3bt8cJJ5wwpE12dXVFWVlZdHZ2Rmlp6ZCeAwAAGP9Gog3yevtcT09PbN68OWpqav77BIWFUVNTE62trYOueeaZZ6K6ujqWLFkS5eXlcc4558SKFSuit7f3iNc5ePBgdHV1DXgAAACMhLyiaP/+/dHb2xvl5eUDxsvLy6O9vX3QNTt37ownnngient7Y8OGDXHnnXfGvffeGz/+8Y+PeJ3GxsYoKyvrf1RWVuazTQAAgKM24p8+19fXF5MnT44HH3wwZs2aFXV1dXH77bfH6tWrj7hm2bJl0dnZ2f/Ys2fPSG8TAABIVF4ftDBp0qQoKiqKjo6OAeMdHR1RUVEx6JopU6bECSecEEVFRf1jn/vc56K9vT16enqiuLj4sDW5XC5yuVw+WwMAABiSvO4UFRcXx6xZs6KlpaV/rK+vL1paWqK6unrQNRdddFG8/vrr0dfX1z/22muvxZQpUwYNIgAAgNGU99vn6uvrY82aNfHrX/86tm3bFt/5zneiu7s7Fi9eHBERCxcujGXLlvXP/853vhN///vf46abborXXnst1q9fHytWrIglS5YM36sAAAAYory/p6iuri727dsXy5cvj/b29pg5c2Y0Nzf3f/jC7t27o7Dwv61VWVkZzz33XNxyyy1x3nnnxbRp0+Kmm26KW2+9dfheBQAAwBDl/T1FY8H3FAEAABEfge8pAgAAON6IIgAAIGmiCAAASJooAgAAkiaKAACApIkiAAAgaaIIAABImigCAACSJooAAICkiSIAACBpoggAAEiaKAIAAJImigAAgKSJIgAAIGmiCAAASJooAgAAkiaKAACApIkiAAAgaaIIAABImigCAACSJooAAICkiSIAACBpoggAAEiaKAIAAJImigAAgKSJIgAAIGmiCAAASJooAgAAkiaKAACApIkiAAAgaaIIAABImigCAACSJooAAICkiSIAACBpoggAAEiaKAIAAJImigAAgKSJIgAAIGmiCAAASJooAgAAkiaKAACApIkiAAAgaaIIAABImigCAACSJooAAICkiSIAACBpoggAAEiaKAIAAJImigAAgKSJIgAAIGmiCAAASJooAgAAkiaKAACApIkiAAAgaaIIAABImigCAACSJooAAICkiSIAACBpoggAAEiaKAIAAJImigAAgKSJIgAAIGmiCAAASJooAgAAkiaKAACApIkiAAAgaUOKoqamppg+fXqUlJREVVVVbNq06ajWrV27NgoKCmLevHlDuSwAAMCwyzuK1q1bF/X19dHQ0BBbtmyJGTNmRG1tbezdu/cD1+3atSu+973vxcUXXzzkzQIAAAy3vKPovvvui29961uxePHi+PznPx+rV6+Ok046KR555JEjrunt7Y2rr7467rrrrjj99NOPacMAAADDKa8o6unpic2bN0dNTc1/n6CwMGpqaqK1tfWI6370ox/F5MmT45prrjmq6xw8eDC6uroGPAAAAEZCXlG0f//+6O3tjfLy8gHj5eXl0d7ePuiaP/zhD/Hwww/HmjVrjvo6jY2NUVZW1v+orKzMZ5sAAABHbUQ/fe7AgQOxYMGCWLNmTUyaNOmo1y1btiw6Ozv7H3v27BnBXQIAACmbkM/kSZMmRVFRUXR0dAwY7+jLine truncated
"text/plain": [
"<Figure size 1000x500 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
"name": "stderr",
"output_type": "stream",
"text": [
"Python REPL can execute arbitrary code. Use with caution.\n"
]
},
{
"data": {
"image/png": "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 truncated
"image/png": "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 truncated
"text/plain": [
"<Figure size 1000x500 with 1 Axes>"
"<Figure size 1000x600 with 1 Axes>"
]
},
"metadata": {},
@@ -490,11 +360,7 @@
"name": "stdout",
"output_type": "stream",
"text": [
"{'chart_generator': {'messages': [AIMessage(content=\"Unfortunately, I made an error in the provided code. There was a mismatch in the dimensions of the 'Year' and 'GDP (Billion USD)' data arrays, which caused a ValueError. Additionally, I mistakenly included placeholders for the years 2022 and 2023 without having the actual GDP data for those years.\\n\\nLet's correct this and generate a line graph with the data we have up to 2021. I will revise the code to only include the years for which we have data, and then we can create the graph accordingly.\", additional_kwargs={'tool_calls': [{'id': 'call_1zGQMGouC0oFQJRUkNPvs9zX', 'function': {'arguments': '{\"code\":\"import matplotlib.pyplot as plt\\\\n\\\\n# UK GDP data obtained from search results for 2018-2021 (in billion USD)\\\\n# No data for 2022 and 2023 are available\\\\n# Note: 2021 data is used as a placeholder and should be updated when actual figures are available\\\\ngdp_data = {\\\\n \\'Year\\': [2018, 2019, 2020, 2021],\\\\n \\'GDP (Billion USD)\\': [2851.41, 2851.41, 2697.81, 3141.51]\\\\n}\\\\n\\\\n# Plot a line graph\\\\nplt.figure(figsize=(10, 5))\\\\nplt.plot(gdp_data[\\'Year\\'], gdp_data[\\'GDP (Billion USD)\\'], marker=\\'o\\')\\\\n\\\\n# Title and labels\\\\nplt.title(\\'UK GDP from 2018 to 2021\\')\\\\nplt.xlabel(\\'Year\\')\\\\nplt.ylabel(\\'GDP (Billion USD)\\')\\\\n\\\\n# Show grid\\\\nplt.grid(True)\\\\n\\\\n# Display the graph\\\\nplt.show()\"}', 'name': 'python_repl'}, 'type': 'function'}]}, response_metadata={'token_usage': {'completion_tokens': 359, 'prompt_tokens': 12796, 'total_tokens': 13155}, 'model_name': 'gpt-4o', 'system_fingerprint': None, 'finish_reason': 'tool_calls', 'logprobs': None}, name='chart_generator', id='run-0d4a67d2-696a-4955-990b-9a9d775b7635-0', tool_calls=[{'name': 'python_repl', 'args': {'code': \"import matplotlib.pyplot as plt\\n\\n# UK GDP data obtained from search results for 2018-2021 (in billion USD)\\n# No data for 2022 and 2023 are available\\n# Note: 2021 data is used as a placeholder and should be updated when actual figures are available\\ngdp_data = {\\n 'Year': [2018, 2019, 2020, 2021],\\n 'GDP (Billion USD)': [2851.41, 2851.41, 2697.81, 3141.51]\\n}\\n\\n# Plot a line graph\\nplt.figure(figsize=(10, 5))\\nplt.plot(gdp_data['Year'], gdp_data['GDP (Billion USD)'], marker='o')\\n\\n# Title and labels\\nplt.title('UK GDP from 2018 to 2021')\\nplt.xlabel('Year')\\nplt.ylabel('GDP (Billion USD)')\\n\\n# Show grid\\nplt.grid(True)\\n\\n# Display the graph\\nplt.show()\"}, 'id': 'call_1zGQMGouC0oFQJRUkNPvs9zX'}])], 'sender': 'chart_generator'}}\n",
"----\n",
"{'call_tool': {'messages': [ToolMessage(content=\"Successfully executed:\\n```python\\nimport matplotlib.pyplot as plt\\n\\n# UK GDP data obtained from search results for 2018-2021 (in billion USD)\\n# No data for 2022 and 2023 are available\\n# Note: 2021 data is used as a placeholder and should be updated when actual figures are available\\ngdp_data = {\\n 'Year': [2018, 2019, 2020, 2021],\\n 'GDP (Billion USD)': [2851.41, 2851.41, 2697.81, 3141.51]\\n}\\n\\n# Plot a line graph\\nplt.figure(figsize=(10, 5))\\nplt.plot(gdp_data['Year'], gdp_data['GDP (Billion USD)'], marker='o')\\n\\n# Title and labels\\nplt.title('UK GDP from 2018 to 2021')\\nplt.xlabel('Year')\\nplt.ylabel('GDP (Billion USD)')\\n\\n# Show grid\\nplt.grid(True)\\n\\n# Display the graph\\nplt.show()\\n```\\nStdout: \\n\\nIf you have completed all tasks, respond with FINAL ANSWER.\", name='python_repl', tool_call_id='call_1zGQMGouC0oFQJRUkNPvs9zX')]}}\n",
"----\n",
"{'chart_generator': {'messages': [AIMessage(content=\"FINAL ANSWER\\n\\nI have generated a line graph for the UK's GDP from 2018 to 2021 using the available data. Unfortunately, due to the lack of data for 2022 and 2023, the graph only includes figures up to 2021. Here is the graph:\\n\\n[Graph Image]\\n\\nPlease note that the data for 2022 and 2023 should be added to this graph once it becomes available to complete the analysis for the past five years.\", response_metadata={'token_usage': {'completion_tokens': 99, 'prompt_tokens': 13412, 'total_tokens': 13511}, 'model_name': 'gpt-4o', 'system_fingerprint': None, 'finish_reason': 'stop', 'logprobs': None}, name='chart_generator', id='run-3474a61c-0773-4e44-bd6e-2e88cf56bb90-0')], 'sender': 'chart_generator'}}\n",
"{'chart_generator': {'messages': [HumanMessage(content=\"First, get the UK's GDP over the past 5 years, then make a line chart of it. Once you make the chart, finish.\", additional_kwargs={}, response_metadata={}, id='fa1f5e95-9e1a-47d4-b4b6-e93f345e339d'), AIMessage(content=[{'text': \"I'll help search for the UK's GDP data over the past 5 years. Then my colleague can help create the line chart.\", 'type': 'text'}, {'id': 'toolu_01Jd9dxa4Ss2NhzBhCuwUX3E', 'input': {'query': 'UK GDP annual data past 5 years 2019-2023'}, 'name': 'tavily_search_results_json', 'type': 'tool_use'}], additional_kwargs={}, response_metadata={'id': 'msg_014nCkfVHnG6LAsiS6pY7zcd', 'model': 'claude-3-5-sonnet-20241022', 'stop_reason': 'tool_use', 'stop_sequence': None, 'usage': {'input_tokens': 555, 'output_tokens': 101}}, id='run-e2297529-9972-4de6-835d-23d920b0e29b-0', tool_calls=[{'name': 'tavily_search_results_json', 'args': {'query': 'UK GDP annual data past 5 years 2019-2023'}, 'id': 'toolu_01Jd9dxa4Ss2NhzBhCuwUX3E', 'type': 'tool_call'}], usage_metadata={'input_tokens': 555, 'output_tokens': 101, 'total_tokens': 656, 'input_token_details': {}}), ToolMessage(content='[{\"url\": \"https://www.macrotrends.net/global-metrics/countries/GBR/united-kingdom/gdp-gross-domestic-product\", \"content\": \"Dollar figures for GDP are converted from domestic currencies using single year official exchange rates. For a few countries where the official exchange rate does not reflect the rate effectively applied to actual foreign exchange transactions, an alternative conversion factor is used. U.K. gdp for 2023 was $3,340.03B, a 8.13% increase from 2022.\"}, {\"url\": \"https://www.statista.com/topics/3795/gdp-of-the-uk/\", \"content\": \"Monthly growth of gross domestic product in the United Kingdom from January 2019 to November 2023\\\\nContribution to GDP growth in the UK 2023, by sector\\\\nContribution to gross domestic product growth in the United Kingdom in January 2023, by sector\\\\nGDP growth rate in the UK 1999-2021, by country\\\\nAnnual growth rates of gross domestic product in the United Kingdom from 1999 to 2021, by country\\\\nGDP growth rate in the UK 2021, by region\\\\nAnnual growth rates of gross domestic product in the United Kingdom in 2021, by region\\\\nGDP growth of Scotland 2021, by local area\\\\nAnnual growth rates of gross domestic product in Scotland in 2021, by local (ITL 3) area\\\\nGDP growth of Wales 2021, by local area\\\\nAnnual growth rates of gross domestic product in Wales in 2021, by local (ITL 3) area\\\\nGDP growth of Northern Ireland 2021, by local area\\\\nAnnual growth rates of gross domestic product in Northern Ireland in 2021, by local (ITL 3) area\\\\nGDP per capita\\\\nGDP per capita\\\\nGDP per capita in the UK 1955-2022\\\\nGross domestic product per capita in the United Kingdom from 1955 to 2022 (in GBP)\\\\nAnnual GDP per capita growth in the UK 1956-2022\\\\nAnnual GDP per capita growth in the United Kingdom from 1956 to 2022\\\\nQuarterly GDP per capita in the UK 2019-2023\\\\nQuarterly GDP per capita in the United Kingdom from 1st quarter 2019 to 3rd quarter 2023 (in GBP)\\\\nQuarterly GDP per capita growth in the UK 2019-2023\\\\nQuarterly GDP per capita growth in the United Kingdom from 1st quarter 2019 to 3rd quarter 2023 (in GBP)\\\\nGDP per capita of the UK 1999-2021, by country\\\\nGross domestic product per capita of the United Kingdom from 1999 to 2021, by country (in GBP)\\\\nGDP per capita of the UK 2021, by region\\\\nGross domestic product per capita of the United Kingdom in 2021, by region (in GBP)\\\\nGlobal Comparisons\\\\nGlobal Comparisons\\\\nCountries with the largest gross domestic product (GDP) 2022\\\\n Monthly GDP of the UK 2019-2023\\\\nMonthly index of gross domestic product in the United Kingdom from January 2019 to November 2023 (2019=100)\\\\nGVA of the UK 2022, by sector\\\\nGross value added of the United Kingdom in 2022, by industry sector (in million GBP)\\\\nGDP of the UK 2021, by country\\\\nGross domestic product of the United Kingdom in 2021, by country (in million GBP)\\\\nGDP of the UK 2021, by region\\\\nGross domestic product of the United Kingdom in 2021, by region (in million GBP)\\\\nGDP of Scotland 2021, by local area\\\\nGross domestic product of Scotland in 2021, by local (ITL 3) area (in million GBP)\\\\nGDP of Wales 2021, by local area\\\\nGross domestic product of Wales in 2021, by local (ITL 3) area (in million GBP)\\\\nGDP of Northern Ireland 2021, by local area\\\\nGross domestic product of Northern Ireland in 2021, by local (ITL 3) area (in million GBP)\\\\nGDP growth\\\\nGDP growth\\\\nGDP growth forecast for the UK 2000-2028\\\\nForecasted annual growth of gross domestic product in the United Kingdom from 2000 to 2028\\\\nAnnual GDP growth in the UK 1949-2022\\\\nAnnual growth of gross domestic product in the United Kingdom from 1949 to 2022\\\\nQuarterly GDP growth of the UK 2019-2023\\\\nQuarterly growth of gross domestic proLine truncated
"----\n"
]
}
@@ -503,10 +369,10 @@
"events = graph.stream(\n",
" {\n",
" \"messages\": [\n",
" HumanMessage(\n",
" content=\"Fetch the UK's GDP over the past 5 years,\"\n",
" \" then draw a line graph of it.\"\n",
" \" Once you code it up, finish.\"\n",
" (\n",
" \"user\",\n",
" \"First, get the UK's GDP over the past 5 years, then make a line chart of it. \"\n",
" \"Once you make the chart, finish.\",\n",
" )\n",
" ],\n",
" },\n",
@@ -934,7 +934,7 @@
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.11.9"
"version": "3.11.4"
}
},
"nbformat": 4,
@@ -112,7 +112,7 @@
"metadata": {},
"outputs": [],
"source": [
"_set_env(\"LANGCHAIN_API_KEY\")\n",
"_set_env(\"LANGSMITH_API_KEY\")\n",
"os.environ[\"LANGCHAIN_TRACING_V2\"] = \"true\"\n",
"os.environ[\"LANGCHAIN_PROJECT\"] = \"local-llama32-rag\""
]
+242 -6
View File
@@ -25,6 +25,7 @@ theme:
- navigation.sections
- navigation.instant.prefetch
- navigation.instant.progress
- navigation.path
- navigation.prune
- navigation.tabs
- navigation.tabs.sticky
@@ -87,12 +88,245 @@ plugins:
filters:
- "!^_"
nav:
# Setting the names of the nav items explicitly due to mkdocs
# how-reload being a bit buggy with the names of the tabs.
- Home: "index.md"
- Tutorials: "tutorials/index.md"
- Concepts: "concepts/index.md"
- "How-to Guides": "how-tos/index.md"
- Home: index.md
- Tutorials:
- tutorials/index.md
- Quick Start:
- Quick Start: tutorials#quick-start
- tutorials/introduction.ipynb
- tutorials/langgraph-platform/local-server.md
- cloud/quick_start.md
- Chatbots:
- Chatbots: tutorials#chatbots
- tutorials/customer-support/customer-support.ipynb
- tutorials/chatbots/information-gather-prompting.ipynb
- tutorials/code_assistant/langgraph_code_assistant.ipynb
- RAG:
- RAG: tutorials#rag
- tutorials/rag/langgraph_adaptive_rag.ipynb
- tutorials/rag/langgraph_adaptive_rag_local.ipynb
- tutorials/rag/langgraph_agentic_rag.ipynb
- tutorials/rag/langgraph_crag.ipynb
- tutorials/rag/langgraph_crag_local.ipynb
- tutorials/rag/langgraph_self_rag.ipynb
- tutorials/rag/langgraph_self_rag_local.ipynb
- tutorials/sql-agent.ipynb
- Agent Architectures:
- Agent Architectures: tutorials#agent-architectures
- Multi-Agent Systems:
- Multi-Agent Systems: tutorials#multi-agent-systems
- tutorials/multi_agent/multi-agent-collaboration.ipynb
- tutorials/multi_agent/agent_supervisor.ipynb
- tutorials/multi_agent/hierarchical_agent_teams.ipynb
- Planning Agents:
- Planning Agents: tutorials#planning-agents
- tutorials/plan-and-execute/plan-and-execute.ipynb
- tutorials/rewoo/rewoo.ipynb
- tutorials/llm-compiler/LLMCompiler.ipynb
- Reflection & Critique:
- Reflection & Critique: tutorials#reflection-critique
- tutorials/reflection/reflection.ipynb
- tutorials/reflexion/reflexion.ipynb
- tutorials/tot/tot.ipynb
- tutorials/lats/lats.ipynb
- tutorials/self-discover/self-discover.ipynb
- Evaluation & Analysis:
- Evaluation & Analysis: tutorials#evaluation
- tutorials/chatbot-simulation-evaluation/agent-simulation-evaluation.ipynb
- tutorials/chatbot-simulation-evaluation/langsmith-agent-simulation-evaluation.ipynb
- Experimental:
- Experimental: tutorials#experimental
- tutorials/storm/storm.ipynb
- tutorials/tnt-llm/tnt-llm.ipynb
- tutorials/web-navigation/web_voyager.ipynb
- tutorials/usaco/usaco.ipynb
- tutorials/extraction/retries.ipynb
- How-to Guides:
- how-tos/index.md
- LangGraph:
- LangGraph: how-tos#langgraph
- Controllability:
- Controllability: how-tos#controllability
- how-tos/branching.ipynb
- how-tos/map-reduce.ipynb
- how-tos/recursion-limit.ipynb
- Persistence:
- Persistence: how-tos#persistence
- how-tos/persistence.ipynb
- how-tos/subgraph-persistence.ipynb
- how-tos/cross-thread-persistence.ipynb
- how-tos/persistence_postgres.ipynb
- how-tos/persistence_mongodb.ipynb
- how-tos/persistence_redis.ipynb
- Memory:
- Memory: how-tos#memory
- how-tos/memory/manage-conversation-history.ipynb
- how-tos/memory/delete-messages.ipynb
- how-tos/memory/add-summary-conversation-history.ipynb
- how-tos/memory/semantic-search.ipynb
- Human-in-the-loop:
- Human-in-the-loop: how-tos#human-in-the-loop
- how-tos/human_in_the_loop/breakpoints.ipynb
- how-tos/human_in_the_loop/dynamic_breakpoints.ipynb
- how-tos/human_in_the_loop/edit-graph-state.ipynb
- how-tos/human_in_the_loop/wait-user-input.ipynb
- how-tos/human_in_the_loop/time-travel.ipynb
- how-tos/human_in_the_loop/review-tool-calls.ipynb
- Streaming:
- Streaming: how-tos#streaming
- how-tos/stream-values.ipynb
- how-tos/stream-updates.ipynb
- how-tos/streaming-tokens.ipynb
- how-tos/streaming-tokens-without-langchain.ipynb
- how-tos/streaming-content.ipynb
- how-tos/stream-multiple.ipynb
- how-tos/streaming-events-from-within-tools.ipynb
- how-tos/streaming-events-from-within-tools-without-langchain.ipynb
- how-tos/streaming-from-final-node.ipynb
- how-tos/streaming-subgraphs.ipynb
- how-tos/disable-streaming.ipynb
- Tool calling:
- Tool calling: how-tos#tool-calling
- how-tos/tool-calling.ipynb
- how-tos/tool-calling-errors.ipynb
- how-tos/pass-run-time-values-to-tools.ipynb
- how-tos/pass-config-to-tools.ipynb
- how-tos/many-tools.ipynb
- Subgraphs:
- Subgraphs: how-tos#subgraphs
- how-tos/subgraph.ipynb
- how-tos/subgraphs-manage-state.ipynb
- how-tos/subgraph-transform-state.ipynb
- State Management:
- State Management: how-tos#state-management
- how-tos/state-model.ipynb
- how-tos/input_output_schema.ipynb
- how-tos/pass_private_state.ipynb
- Other:
- Other: how-tos#other
- how-tos/async.ipynb
- how-tos/visualization.ipynb
- how-tos/configuration.ipynb
- how-tos/node-retries.ipynb
- how-tos/react-agent-structured-output.ipynb
- how-tos/run-id-langsmith.ipynb
- how-tos/return-when-recursion-limit-hits.ipynb
- Prebuilt ReAct Agent:
- Prebuilt ReAct Agent: how-tos#prebuilt-react-agent
- how-tos/create-react-agent.ipynb
- how-tos/create-react-agent-memory.ipynb
- how-tos/create-react-agent-system-prompt.ipynb
- how-tos/create-react-agent-hitl.ipynb
- how-tos/react-agent-from-scratch.ipynb
- LangGraph Platform:
- LangGraph Platform: how-tos#langgraph-platform
- Application Structure:
- Application Structure: how-tos#application-structure
- cloud/deployment/setup.md
- cloud/deployment/setup_pyproject.md
- cloud/deployment/setup_javascript.md
- cloud/deployment/semantic_search.md
- cloud/deployment/custom_docker.md
- cloud/deployment/test_locally.md
- cloud/deployment/graph_rebuild.md
- Deployment:
- Deployment: how-tos#deployment
- cloud/deployment/cloud.md
- how-tos/deploy-self-hosted.md
- how-tos/use-remote-graph.md
- Assistants:
- Assistants: how-tos#assistants
- cloud/how-tos/configuration_cloud.md
- cloud/how-tos/assistant_versioning.md
- Threads:
- Threads: how-tos#threads
- cloud/how-tos/copy_threads.md
- cloud/how-tos/check_thread_status.md
- Runs:
- Runs: how-tos#runs
- cloud/how-tos/background_run.md
- cloud/how-tos/same-thread.md
- cloud/how-tos/cron_jobs.md
- cloud/how-tos/stateless_runs.md
- Streaming:
- Streaming: how-tos#streaming_1
- cloud/how-tos/stream_values.md
- cloud/how-tos/stream_updates.md
- cloud/how-tos/stream_messages.md
- cloud/how-tos/stream_events.md
- cloud/how-tos/stream_debug.md
- cloud/how-tos/stream_multiple.md
- Human-in-the-loop:
- Human-in-the-loop: how-tos#human-in-the-loop_1
- cloud/how-tos/human_in_the_loop_breakpoint.md
- cloud/how-tos/human_in_the_loop_user_input.md
- cloud/how-tos/human_in_the_loop_edit_state.md
- cloud/how-tos/human_in_the_loop_time_travel.md
- cloud/how-tos/human_in_the_loop_review_tool_calls.md
- Double-texting:
- Double-texting: how-tos#double-texting
- cloud/how-tos/interrupt_concurrent.md
- cloud/how-tos/rollback_concurrent.md
- cloud/how-tos/reject_concurrent.md
- cloud/how-tos/enqueue_concurrent.md
- Webhooks:
- cloud/how-tos/webhooks.md
- Cron Jobs:
- cloud/how-tos/cron_jobs.md
- LangGraph Studio:
- LangGraph Studio: how-tos#langgraph-studio
- cloud/how-tos/test_deployment.md
- cloud/how-tos/test_local_deployment.md
- cloud/how-tos/invoke_studio.md
- cloud/how-tos/threads_studio.md
- Troubleshooting:
- Troubleshooting: how-tos#troubleshooting
- troubleshooting/errors/index.md
- troubleshooting/errors/GRAPH_RECURSION_LIMIT.md
- troubleshooting/errors/INVALID_CONCURRENT_GRAPH_UPDATE.md
- troubleshooting/errors/INVALID_GRAPH_NODE_RETURN_VALUE.md
- troubleshooting/errors/MULTIPLE_SUBGRAPHS.md
- Conceptual Guides:
- concepts/index.md
- LangGraph:
- LangGraph: concepts#langgraph
- concepts/high_level.md
- concepts/low_level.md
- concepts/agentic_concepts.md
- concepts/multi_agent.md
- concepts/human_in_the_loop.md
- concepts/persistence.md
- concepts/memory.md
- concepts/streaming.md
- concepts/faq.md
- LangGraph Platform:
- LangGraph Platform: concepts#langgraph-platform
- High Level:
- High Level: concepts#high-level
- concepts/langgraph_platform.md
- concepts/deployment_options.md
- concepts/plans.md
- concepts/template_applications.md
- Components:
- Components: concepts#components
- concepts/langgraph_server.md
- concepts/langgraph_studio.md
- concepts/langgraph_cli.md
- concepts/sdk.md
- how-tos/use-remote-graph.md
- LangGraph Server:
- LangGraph Server: concepts#langgraph-server
- concepts/application_structure.md
- concepts/assistants.md
- concepts/double_texting.md
- Deployment Options:
- Deployment Options: concepts#deployment-options
- concepts/self_hosted.md
- concepts/langgraph_cloud.md
- concepts/bring_your_own_cloud.md
- Reference:
- "reference/index.md"
- Library:
@@ -206,3 +440,5 @@ validation:
# because it creates anchors in the generated report
# and those anchors are not available in the actual doc
anchors: info
# this is needed to handle headers with anchors for nav
not_found: info
+11
View File
@@ -34,6 +34,17 @@
color: #1E88E5;
}
.md-sidebar {
display: none;
}
/* Show sidebar on mobile */
@media screen and (max-width: 1220px) {
.md-sidebar--primary {
display: block;
}
}
.md-typeset a:hover {
color: #1565C0;
}
@@ -42,7 +42,7 @@ class DuckDBSaver(BaseDuckDBSaver):
DuckDBSaver: A new DuckDBSaver instance.
"""
with duckdb.connect(conn_string) as conn:
yield DuckDBSaver(conn)
yield cls(conn)
def setup(self) -> None:
"""Set up the checkpoint database asynchronously.
@@ -45,7 +45,7 @@ class AsyncDuckDBSaver(BaseDuckDBSaver):
AsyncDuckDBSaver: A new AsyncDuckDBSaver instance.
"""
with duckdb.connect(conn_string) as conn:
yield AsyncDuckDBSaver(conn)
yield cls(conn)
async def setup(self) -> None:
"""Set up the checkpoint database asynchronously.
@@ -156,7 +156,7 @@ class AsyncDuckDBStore(AsyncBatchedBaseStore, BaseDuckDBStore):
AsyncDuckDBStore: A new AsyncDuckDBStore instance.
"""
with duckdb.connect(conn_string) as conn:
yield AsyncDuckDBStore(conn)
yield cls(conn)
async def setup(self) -> None:
"""Set up the store database asynchronously.
@@ -23,6 +23,7 @@ from langgraph.store.base import (
Op,
PutOp,
Result,
SearchItem,
SearchOp,
)
@@ -283,7 +284,7 @@ class DuckDBStore(BaseStore, BaseDuckDBStore[duckdb.DuckDBPyConnection]):
for cur, idx in cursors:
rows = cur.fetchall()
items = [_row_to_item(_convert_ns(row[0]), row) for row in rows]
items = [_row_to_search_item(_convert_ns(row[0]), row) for row in rows]
results[idx] = items
def _batch_list_namespaces_ops(
@@ -376,6 +377,22 @@ def _row_to_item(
)
def _row_to_search_item(
namespace: tuple[str, ...],
row: tuple,
) -> SearchItem:
"""Convert a row from the database into an SearchItem."""
# TODO: Add support for search
_, key, val, created_at, updated_at = row
return SearchItem(
value=val if isinstance(val, dict) else json.loads(val),
key=key,
namespace=namespace,
created_at=created_at,
updated_at=updated_at,
)
def _group_ops(ops: Iterable[Op]) -> tuple[dict[type, list[tuple[int, Op]]], int]:
grouped_ops: dict[type, list[tuple[int, Op]]] = defaultdict(list)
tot = 0
+5 -1
View File
@@ -5,7 +5,11 @@
######################
start-postgres:
POSTGRES_VERSION=${POSTGRES_VERSION:-16} docker compose -f tests/compose-postgres.yml up -V --force-recreate --wait
POSTGRES_VERSION=${POSTGRES_VERSION:-16} docker compose -f tests/compose-postgres.yml up -V --force-recreate --wait || ( \
echo "Failed to start PostgreSQL, printing logs..."; \
docker compose -f tests/compose-postgres.yml logs; \
exit 1 \
)
stop-postgres:
docker compose -f tests/compose-postgres.yml down
@@ -1,10 +1,10 @@
import threading
from collections.abc import Iterator, Sequence
from contextlib import contextmanager
from typing import Any, Iterator, Optional, Sequence, Union
from typing import Any, Optional
from langchain_core.runnables import RunnableConfig
from psycopg import Connection, Cursor, Pipeline
from psycopg.errors import UndefinedTable
from psycopg import Capabilities, Connection, Cursor, Pipeline
from psycopg.rows import DictRow, dict_row
from psycopg.types.json import Jsonb
from psycopg_pool import ConnectionPool
@@ -17,21 +17,11 @@ from langgraph.checkpoint.base import (
CheckpointTuple,
get_checkpoint_id,
)
from langgraph.checkpoint.postgres import _internal
from langgraph.checkpoint.postgres.base import BasePostgresSaver
from langgraph.checkpoint.serde.base import SerializerProtocol
Conn = Union[Connection[DictRow], ConnectionPool[Connection[DictRow]]]
@contextmanager
def _get_connection(conn: Conn) -> Iterator[Connection[DictRow]]:
if isinstance(conn, Connection):
yield conn
elif isinstance(conn, ConnectionPool):
with conn.connection() as conn:
yield conn
else:
raise TypeError(f"Invalid connection type: {type(conn)}")
Conn = _internal.Conn # For backward compatibility
class PostgresSaver(BasePostgresSaver):
@@ -39,7 +29,7 @@ class PostgresSaver(BasePostgresSaver):
def __init__(
self,
conn: Conn,
conn: _internal.Conn,
pipe: Optional[Pipeline] = None,
serde: Optional[SerializerProtocol] = None,
) -> None:
@@ -52,6 +42,7 @@ class PostgresSaver(BasePostgresSaver):
self.conn = conn
self.pipe = pipe
self.lock = threading.Lock()
self.supports_pipeline = Capabilities().has_pipeline()
@classmethod
@contextmanager
@@ -72,9 +63,9 @@ class PostgresSaver(BasePostgresSaver):
) as conn:
if pipeline:
with conn.pipeline() as pipe:
yield PostgresSaver(conn, pipe)
yield cls(conn, pipe)
else:
yield PostgresSaver(conn)
yield cls(conn)
def setup(self) -> None:
"""Set up the checkpoint database asynchronously.
@@ -84,16 +75,15 @@ class PostgresSaver(BasePostgresSaver):
the first time checkpointer is used.
"""
with self._cursor() as cur:
try:
row = cur.execute(
"SELECT v FROM checkpoint_migrations ORDER BY v DESC LIMIT 1"
).fetchone()
if row is None:
version = -1
else:
version = row["v"]
except UndefinedTable:
cur.execute(self.MIGRATIONS[0])
results = cur.execute(
"SELECT v FROM checkpoint_migrations ORDER BY v DESC LIMIT 1"
)
row = results.fetchone()
if row is None:
version = -1
else:
version = row["v"]
for v, migration in zip(
range(version + 1, len(self.MIGRATIONS)),
self.MIGRATIONS[version + 1 :],
@@ -365,7 +355,14 @@ class PostgresSaver(BasePostgresSaver):
@contextmanager
def _cursor(self, *, pipeline: bool = False) -> Iterator[Cursor[DictRow]]:
with _get_connection(self.conn) as conn:
"""Create a database cursor as a context manager.
Args:
pipeline (bool): whether to use pipeline for the DB operations inside the context manager.
Will be applied regardless of whether the PostgresSaver instance was initialized with a pipeline.
If pipeline mode is not supported, will fall back to using transaction context manager.
"""
with _internal.get_connection(self.conn) as conn:
if self.pipe:
# a connection in pipeline mode can be used concurrently
# in multiple threads/coroutines, but only one cursor can be
@@ -379,13 +376,24 @@ class PostgresSaver(BasePostgresSaver):
elif pipeline:
# a connection not in pipeline mode can only be used by one
# thread/coroutine at a time, so we acquire a lock
with self.lock, conn.pipeline(), conn.cursor(
binary=True, row_factory=dict_row
) as cur:
yield cur
if self.supports_pipeline:
with (
self.lock,
conn.pipeline(),
conn.cursor(binary=True, row_factory=dict_row) as cur,
):
yield cur
else:
# Use connection's transaction context manager when pipeline mode not supported
with (
self.lock,
conn.transaction(),
conn.cursor(binary=True, row_factory=dict_row) as cur,
):
yield cur
else:
with self.lock, conn.cursor(binary=True, row_factory=dict_row) as cur:
yield cur
__all__ = ["PostgresSaver", "Conn"]
__all__ = ["PostgresSaver", "BasePostgresSaver", "Conn"]
@@ -0,0 +1,24 @@
"""Shared async utility functions for the Postgres checkpoint & storage classes."""
from collections.abc import AsyncIterator
from contextlib import asynccontextmanager
from typing import Union
from psycopg import AsyncConnection
from psycopg.rows import DictRow
from psycopg_pool import AsyncConnectionPool
Conn = Union[AsyncConnection[DictRow], AsyncConnectionPool[AsyncConnection[DictRow]]]
@asynccontextmanager
async def get_connection(
conn: Conn,
) -> AsyncIterator[AsyncConnection[DictRow]]:
if isinstance(conn, AsyncConnection):
yield conn
elif isinstance(conn, AsyncConnectionPool):
async with conn.connection() as conn:
yield conn
else:
raise TypeError(f"Invalid connection type: {type(conn)}")
@@ -0,0 +1,22 @@
"""Shared utility functions for the Postgres checkpoint & storage classes."""
from collections.abc import Iterator
from contextlib import contextmanager
from typing import Union
from psycopg import Connection
from psycopg.rows import DictRow
from psycopg_pool import ConnectionPool
Conn = Union[Connection[DictRow], ConnectionPool[Connection[DictRow]]]
@contextmanager
def get_connection(conn: Conn) -> Iterator[Connection[DictRow]]:
if isinstance(conn, Connection):
yield conn
elif isinstance(conn, ConnectionPool):
with conn.connection() as conn:
yield conn
else:
raise TypeError(f"Invalid connection type: {type(conn)}")
@@ -1,10 +1,10 @@
import asyncio
from collections.abc import AsyncIterator, Iterator, Sequence
from contextlib import asynccontextmanager
from typing import Any, AsyncIterator, Iterator, Optional, Sequence, Union
from typing import Any, Optional
from langchain_core.runnables import RunnableConfig
from psycopg import AsyncConnection, AsyncCursor, AsyncPipeline
from psycopg.errors import UndefinedTable
from psycopg import AsyncConnection, AsyncCursor, AsyncPipeline, Capabilities
from psycopg.rows import DictRow, dict_row
from psycopg.types.json import Jsonb
from psycopg_pool import AsyncConnectionPool
@@ -17,23 +17,11 @@ from langgraph.checkpoint.base import (
CheckpointTuple,
get_checkpoint_id,
)
from langgraph.checkpoint.postgres import _ainternal
from langgraph.checkpoint.postgres.base import BasePostgresSaver
from langgraph.checkpoint.serde.base import SerializerProtocol
Conn = Union[AsyncConnection[DictRow], AsyncConnectionPool[AsyncConnection[DictRow]]]
@asynccontextmanager
async def _get_connection(
conn: Conn,
) -> AsyncIterator[AsyncConnection[DictRow]]:
if isinstance(conn, AsyncConnection):
yield conn
elif isinstance(conn, AsyncConnectionPool):
async with conn.connection() as conn:
yield conn
else:
raise TypeError(f"Invalid connection type: {type(conn)}")
Conn = _ainternal.Conn # For backward compatibility
class AsyncPostgresSaver(BasePostgresSaver):
@@ -41,7 +29,7 @@ class AsyncPostgresSaver(BasePostgresSaver):
def __init__(
self,
conn: Conn,
conn: _ainternal.Conn,
pipe: Optional[AsyncPipeline] = None,
serde: Optional[SerializerProtocol] = None,
) -> None:
@@ -55,6 +43,7 @@ class AsyncPostgresSaver(BasePostgresSaver):
self.pipe = pipe
self.lock = asyncio.Lock()
self.loop = asyncio.get_running_loop()
self.supports_pipeline = Capabilities().has_pipeline()
@classmethod
@asynccontextmanager
@@ -65,7 +54,7 @@ class AsyncPostgresSaver(BasePostgresSaver):
pipeline: bool = False,
serde: Optional[SerializerProtocol] = None,
) -> AsyncIterator["AsyncPostgresSaver"]:
"""Create a new PostgresSaver instance from a connection string.
"""Create a new AsyncPostgresSaver instance from a connection string.
Args:
conn_string (str): The Postgres connection info string.
@@ -79,9 +68,9 @@ class AsyncPostgresSaver(BasePostgresSaver):
) as conn:
if pipeline:
async with conn.pipeline() as pipe:
yield AsyncPostgresSaver(conn=conn, pipe=pipe, serde=serde)
yield cls(conn=conn, pipe=pipe, serde=serde)
else:
yield AsyncPostgresSaver(conn=conn, serde=serde)
yield cls(conn=conn, serde=serde)
async def setup(self) -> None:
"""Set up the checkpoint database asynchronously.
@@ -91,17 +80,15 @@ class AsyncPostgresSaver(BasePostgresSaver):
the first time checkpointer is used.
"""
async with self._cursor() as cur:
try:
results = await cur.execute(
"SELECT v FROM checkpoint_migrations ORDER BY v DESC LIMIT 1"
)
row = await results.fetchone()
if row is None:
version = -1
else:
version = row["v"]
except UndefinedTable:
await cur.execute(self.MIGRATIONS[0])
results = await cur.execute(
"SELECT v FROM checkpoint_migrations ORDER BY v DESC LIMIT 1"
)
row = await results.fetchone()
if row is None:
version = -1
else:
version = row["v"]
for v, migration in zip(
range(version + 1, len(self.MIGRATIONS)),
self.MIGRATIONS[version + 1 :],
@@ -156,15 +143,17 @@ class AsyncPostgresSaver(BasePostgresSaver):
value["pending_sends"],
),
self._load_metadata(value["metadata"]),
{
"configurable": {
"thread_id": value["thread_id"],
"checkpoint_ns": value["checkpoint_ns"],
"checkpoint_id": value["parent_checkpoint_id"],
(
{
"configurable": {
"thread_id": value["thread_id"],
"checkpoint_ns": value["checkpoint_ns"],
"checkpoint_id": value["parent_checkpoint_id"],
}
}
}
if value["parent_checkpoint_id"]
else None,
if value["parent_checkpoint_id"]
else None
),
await asyncio.to_thread(self._load_writes, value["pending_writes"]),
)
@@ -215,15 +204,17 @@ class AsyncPostgresSaver(BasePostgresSaver):
value["pending_sends"],
),
self._load_metadata(value["metadata"]),
{
"configurable": {
"thread_id": thread_id,
"checkpoint_ns": checkpoint_ns,
"checkpoint_id": value["parent_checkpoint_id"],
(
{
"configurable": {
"thread_id": thread_id,
"checkpoint_ns": checkpoint_ns,
"checkpoint_id": value["parent_checkpoint_id"],
}
}
}
if value["parent_checkpoint_id"]
else None,
if value["parent_checkpoint_id"]
else None
),
await asyncio.to_thread(self._load_writes, value["pending_writes"]),
)
@@ -323,7 +314,14 @@ class AsyncPostgresSaver(BasePostgresSaver):
async def _cursor(
self, *, pipeline: bool = False
) -> AsyncIterator[AsyncCursor[DictRow]]:
async with _get_connection(self.conn) as conn:
"""Create a database cursor as a context manager.
Args:
pipeline (bool): whether to use pipeline for the DB operations inside the context manager.
Will be applied regardless of whether the AsyncPostgresSaver instance was initialized with a pipeline.
If pipeline mode is not supported, will fall back to using transaction context manager.
"""
async with _ainternal.get_connection(self.conn) as conn:
if self.pipe:
# a connection in pipeline mode can be used concurrently
# in multiple threads/coroutines, but only one cursor can be
@@ -337,14 +335,26 @@ class AsyncPostgresSaver(BasePostgresSaver):
elif pipeline:
# a connection not in pipeline mode can only be used by one
# thread/coroutine at a time, so we acquire a lock
async with self.lock, conn.pipeline(), conn.cursor(
binary=True, row_factory=dict_row
) as cur:
yield cur
if self.supports_pipeline:
async with (
self.lock,
conn.pipeline(),
conn.cursor(binary=True, row_factory=dict_row) as cur,
):
yield cur
else:
# Use connection's transaction context manager when pipeline mode not supported
async with (
self.lock,
conn.transaction(),
conn.cursor(binary=True, row_factory=dict_row) as cur,
):
yield cur
else:
async with self.lock, conn.cursor(
binary=True, row_factory=dict_row
) as cur:
async with (
self.lock,
conn.cursor(binary=True, row_factory=dict_row) as cur,
):
yield cur
def list(
@@ -373,7 +383,7 @@ class AsyncPostgresSaver(BasePostgresSaver):
while True:
try:
yield asyncio.run_coroutine_threadsafe(
anext(aiter_),
anext(aiter_), # noqa: F821
self.loop,
).result()
except StopAsyncIteration:
@@ -452,3 +462,6 @@ class AsyncPostgresSaver(BasePostgresSaver):
return asyncio.run_coroutine_threadsafe(
self.aput_writes(config, writes, task_id), self.loop
).result()
__all__ = ["AsyncPostgresSaver", "Conn"]
@@ -1,5 +1,6 @@
import random
from typing import Any, List, Optional, Sequence, Tuple, cast
from collections.abc import Sequence
from typing import Any, Optional, cast
from langchain_core.runnables import RunnableConfig
from psycopg.types.json import Jsonb
@@ -84,7 +85,7 @@ select
and cw.checkpoint_id = checkpoints.checkpoint_id
) as pending_writes,
(
select array_agg(array[cw.type::bytea, cw.blob] order by cw.idx)
select array_agg(array[cw.type::bytea, cw.blob] order by cw.task_id, cw.idx)
from checkpoint_writes cw
where cw.thread_id = checkpoints.thread_id
and cw.checkpoint_ns = checkpoints.checkpoint_ns
@@ -133,6 +134,7 @@ class BasePostgresSaver(BaseCheckpointSaver[str]):
INSERT_CHECKPOINT_WRITES_SQL = INSERT_CHECKPOINT_WRITES_SQL
jsonplus_serde = JsonPlusSerializer()
supports_pipeline: bool
def _load_checkpoint(
self,
@@ -248,7 +250,7 @@ class BasePostgresSaver(BaseCheckpointSaver[str]):
config: Optional[RunnableConfig],
filter: MetadataInput,
before: Optional[RunnableConfig] = None,
) -> Tuple[str, List[Any]]:
) -> tuple[str, list[Any]]:
"""Return WHERE clause predicates for alist() given config, filter, before.
This method returns a tuple of a string and a tuple of values. The string
@@ -1,110 +1,305 @@
import asyncio
import logging
from collections.abc import AsyncIterator, Iterable, Sequence
from contextlib import asynccontextmanager
from typing import (
Any,
AsyncIterator,
Callable,
Iterable,
Optional,
Sequence,
Union,
cast,
)
from typing import Any, Callable, Optional, Union, cast
import orjson
from psycopg import AsyncConnection, AsyncCursor
from psycopg import AsyncConnection, AsyncCursor, AsyncPipeline, Capabilities
from psycopg.errors import UndefinedTable
from psycopg.rows import dict_row
from psycopg.rows import DictRow, dict_row
from psycopg_pool import AsyncConnectionPool
from langgraph.store.base import GetOp, ListNamespacesOp, Op, PutOp, Result, SearchOp
from langgraph.checkpoint.postgres import _ainternal
from langgraph.store.base import (
GetOp,
ListNamespacesOp,
Op,
PutOp,
Result,
SearchOp,
)
from langgraph.store.base.batch import AsyncBatchedBaseStore
from langgraph.store.postgres.base import (
_PLACEHOLDER,
BasePostgresStore,
PoolConfig,
PostgresIndexConfig,
Row,
_decode_ns_bytes,
_ensure_index_config,
_group_ops,
_row_to_item,
_row_to_search_item,
)
logger = logging.getLogger(__name__)
class AsyncPostgresStore(AsyncBatchedBaseStore, BasePostgresStore[AsyncConnection]):
__slots__ = ("_deserializer",)
class AsyncPostgresStore(AsyncBatchedBaseStore, BasePostgresStore[_ainternal.Conn]):
"""Asynchronous Postgres-backed store with optional vector search using pgvector.
!!! example "Examples"
Basic setup and key-value storage:
```python
from langgraph.store.postgres import AsyncPostgresStore
async with AsyncPostgresStore.from_conn_string(
"postgresql://user:pass@localhost:5432/dbname"
) as store:
await store.setup()
# Store and retrieve data
await store.aput(("users", "123"), "prefs", {"theme": "dark"})
item = await store.aget(("users", "123"), "prefs")
```
Vector search using LangChain embeddings:
```python
from langchain.embeddings import init_embeddings
from langgraph.store.postgres import AsyncPostgresStore
async with AsyncPostgresStore.from_conn_string(
"postgresql://user:pass@localhost:5432/dbname",
index={
"dims": 1536,
"embed": init_embeddings("openai:text-embedding-3-small"),
"fields": ["text"] # specify which fields to embed. Default is the whole serialized value
}
) as store:
await store.setup() # Do this once to run migrations
# Store documents
await store.aput(("docs",), "doc1", {"text": "Python tutorial"})
await store.aput(("docs",), "doc2", {"text": "TypeScript guide"})
# Don't index the following
await store.aput(("docs",), "doc3", {"text": "Other guide"}, index=False)
# Search by similarity
results = await store.asearch(("docs",), query="python programming")
```
Using connection pooling for better performance:
```python
from langgraph.store.postgres import AsyncPostgresStore, PoolConfig
async with AsyncPostgresStore.from_conn_string(
"postgresql://user:pass@localhost:5432/dbname",
pool_config=PoolConfig(
min_size=5,
max_size=20
)
) as store:
await store.setup()
# Use store with connection pooling...
```
Warning:
Make sure to:
1. Call `setup()` before first use to create necessary tables and indexes
2. Have the pgvector extension available to use vector search
3. Use Python 3.10+ for async functionality
"""
__slots__ = (
"_deserializer",
"pipe",
"lock",
"supports_pipeline",
"index_config",
"embeddings",
)
def __init__(
self,
conn: AsyncConnection[Any],
conn: _ainternal.Conn,
*,
pipe: Optional[AsyncPipeline] = None,
deserializer: Optional[
Callable[[Union[bytes, orjson.Fragment]], dict[str, Any]]
] = None,
index: Optional[PostgresIndexConfig] = None,
) -> None:
if isinstance(conn, AsyncConnectionPool) and pipe is not None:
raise ValueError(
"Pipeline should be used only with a single AsyncConnection, not AsyncConnectionPool."
)
super().__init__()
self._deserializer = deserializer
self.conn = conn
self.pipe = pipe
self.lock = asyncio.Lock()
self.loop = asyncio.get_running_loop()
self.supports_pipeline = Capabilities().has_pipeline()
self.index_config = index
if self.index_config:
self.embeddings, self.index_config = _ensure_index_config(self.index_config)
else:
self.embeddings = None
async def abatch(self, ops: Iterable[Op]) -> list[Result]:
grouped_ops, num_ops = _group_ops(ops)
results: list[Result] = [None] * num_ops
async with self.conn.pipeline():
tasks = []
if GetOp in grouped_ops:
tasks.append(
self._batch_get_ops(
cast(Sequence[tuple[int, GetOp]], grouped_ops[GetOp]), results
)
)
if PutOp in grouped_ops:
tasks.append(
self._batch_put_ops(
cast(Sequence[tuple[int, PutOp]], grouped_ops[PutOp])
)
)
if SearchOp in grouped_ops:
tasks.append(
self._batch_search_ops(
cast(Sequence[tuple[int, SearchOp]], grouped_ops[SearchOp]),
results,
)
)
if ListNamespacesOp in grouped_ops:
tasks.append(
self._batch_list_namespaces_ops(
cast(
Sequence[tuple[int, ListNamespacesOp]],
grouped_ops[ListNamespacesOp],
),
results,
)
)
await asyncio.gather(*tasks)
async with _ainternal.get_connection(self.conn) as conn:
if self.pipe:
async with self.pipe:
await self._execute_batch(grouped_ops, results, conn)
else:
await self._execute_batch(grouped_ops, results, conn)
return results
def batch(self, ops: Iterable[Op]) -> list[Result]:
return asyncio.run_coroutine_threadsafe(self.abatch(ops), self.loop).result()
@classmethod
@asynccontextmanager
async def from_conn_string(
cls,
conn_string: str,
*,
pipeline: bool = False,
pool_config: Optional[PoolConfig] = None,
index: Optional[PostgresIndexConfig] = None,
) -> AsyncIterator["AsyncPostgresStore"]:
"""Create a new AsyncPostgresStore instance from a connection string.
Args:
conn_string (str): The Postgres connection info string.
pipeline (bool): Whether to use AsyncPipeline (only for single connections)
pool_config (Optional[PoolConfig]): Configuration for the connection pool.
If provided, will create a connection pool and use it instead of a single connection.
This overrides the `pipeline` argument.
index (Optional[PostgresIndexConfig]): The embedding config.
Returns:
AsyncPostgresStore: A new AsyncPostgresStore instance.
"""
if pool_config is not None:
pc = pool_config.copy()
async with cast(
AsyncConnectionPool[AsyncConnection[DictRow]],
AsyncConnectionPool(
conn_string,
min_size=pc.pop("min_size", 1),
max_size=pc.pop("max_size", None),
kwargs={
"autocommit": True,
"prepare_threshold": 0,
"row_factory": dict_row,
**(pc.pop("kwargs", None) or {}),
},
**cast(dict, pc),
),
) as pool:
yield cls(conn=pool, index=index)
else:
async with await AsyncConnection.connect(
conn_string, autocommit=True, prepare_threshold=0, row_factory=dict_row
) as conn:
if pipeline:
async with conn.pipeline() as pipe:
yield cls(conn=conn, pipe=pipe, index=index)
else:
yield cls(conn=conn, index=index)
async def setup(self) -> None:
"""Set up the store database asynchronously.
This method creates the necessary tables in the Postgres database if they don't
already exist and runs database migrations. It MUST be called directly by the user
the first time the store is used.
"""
async def _get_version(cur: AsyncCursor[DictRow], table: str) -> int:
try:
await cur.execute(f"SELECT v FROM {table} ORDER BY v DESC LIMIT 1")
row = await cur.fetchone()
if row is None:
version = -1
else:
version = row["v"]
except UndefinedTable:
version = -1
await cur.execute(
f"""
CREATE TABLE IF NOT EXISTS {table} (
v INTEGER PRIMARY KEY
)
"""
)
return version
async with self._cursor() as cur:
version = await _get_version(cur, table="store_migrations")
for v, sql in enumerate(self.MIGRATIONS[version + 1 :], start=version + 1):
await cur.execute(sql)
await cur.execute("INSERT INTO store_migrations (v) VALUES (%s)", (v,))
if self.index_config:
version = await _get_version(cur, table="vector_migrations")
for v, migration in enumerate(
self.VECTOR_MIGRATIONS[version + 1 :], start=version + 1
):
sql = migration.sql
if migration.params:
params = {
k: v(self) if v is not None and callable(v) else v
for k, v in migration.params.items()
}
sql = sql % params
await cur.execute(sql)
await cur.execute(
"INSERT INTO vector_migrations (v) VALUES (%s)", (v,)
)
async def _execute_batch(
self,
grouped_ops: dict,
results: list[Result],
conn: AsyncConnection[DictRow],
) -> None:
async with self._cursor(pipeline=True) as cur:
if GetOp in grouped_ops:
await self._batch_get_ops(
cast(Sequence[tuple[int, GetOp]], grouped_ops[GetOp]),
results,
cur,
)
if SearchOp in grouped_ops:
await self._batch_search_ops(
cast(Sequence[tuple[int, SearchOp]], grouped_ops[SearchOp]),
results,
cur,
)
if ListNamespacesOp in grouped_ops:
await self._batch_list_namespaces_ops(
cast(
Sequence[tuple[int, ListNamespacesOp]],
grouped_ops[ListNamespacesOp],
),
results,
cur,
)
if PutOp in grouped_ops:
await self._batch_put_ops(
cast(Sequence[tuple[int, PutOp]], grouped_ops[PutOp]),
cur,
)
async def _batch_get_ops(
self,
get_ops: Sequence[tuple[int, GetOp]],
results: list[Result],
cur: AsyncCursor[DictRow],
) -> None:
cursors = []
for query, params, namespace, items in self._get_batch_GET_ops_queries(get_ops):
cur = self.conn.cursor(binary=True)
await cur.execute(query, params)
cursors.append((cur, namespace, items))
for cur, namespace, items in cursors:
rows = cast(list[Row], await cur.fetchall())
key_to_row = {row["key"]: row for row in rows}
for idx, key in items:
@@ -119,29 +314,59 @@ class AsyncPostgresStore(AsyncBatchedBaseStore, BasePostgresStore[AsyncConnectio
async def _batch_put_ops(
self,
put_ops: Sequence[tuple[int, PutOp]],
cur: AsyncCursor[DictRow],
) -> None:
queries = self._get_batch_PUT_queries(put_ops)
queries, embedding_request = self._prepare_batch_PUT_queries(put_ops)
if embedding_request:
if self.embeddings is None:
# Should not get here since the embedding config is required
# to return an embedding_request above
raise ValueError(
"Embedding configuration is required for vector operations "
f"(for semantic search). "
f"Please provide an EmbeddingConfig when initializing the {self.__class__.__name__}."
)
query, txt_params = embedding_request
vectors = await self.embeddings.aembed_documents(
[param[-1] for param in txt_params]
)
queries.append(
(
query,
[
p
for (ns, k, pathname, _), vector in zip(txt_params, vectors)
for p in (ns, k, pathname, vector)
],
)
)
for query, params in queries:
cur = self.conn.cursor(binary=True)
await cur.execute(query, params)
async def _batch_search_ops(
self,
search_ops: Sequence[tuple[int, SearchOp]],
results: list[Result],
cur: AsyncCursor[DictRow],
) -> None:
queries = self._get_batch_search_queries(search_ops)
cursors: list[tuple[AsyncCursor[Any], int]] = []
queries, embedding_requests = self._prepare_batch_search_queries(search_ops)
for (query, params), (idx, _) in zip(queries, search_ops):
cur = self.conn.cursor(binary=True)
if embedding_requests and self.embeddings:
vectors = await self.embeddings.aembed_documents(
[query for _, query in embedding_requests]
)
for (idx, _), vector in zip(embedding_requests, vectors):
_paramslist = queries[idx][1]
for i in range(len(_paramslist)):
if _paramslist[i] is _PLACEHOLDER:
_paramslist[i] = vector
for (idx, _), (query, params) in zip(search_ops, queries):
await cur.execute(query, params)
cursors.append((cur, idx))
for cur, idx in cursors:
rows = cast(list[Row], await cur.fetchall())
items = [
_row_to_item(
_row_to_search_item(
_decode_ns_bytes(row["prefix"]), row, loader=self._deserializer
)
for row in rows
@@ -152,67 +377,57 @@ class AsyncPostgresStore(AsyncBatchedBaseStore, BasePostgresStore[AsyncConnectio
self,
list_ops: Sequence[tuple[int, ListNamespacesOp]],
results: list[Result],
cur: AsyncCursor[DictRow],
) -> None:
queries = self._get_batch_list_namespaces_queries(list_ops)
cursors: list[tuple[AsyncCursor[Any], int]] = []
for (query, params), (idx, _) in zip(queries, list_ops):
cur = self.conn.cursor(binary=True)
await cur.execute(query, params)
cursors.append((cur, idx))
for cur, idx in cursors:
rows = cast(list[dict], await cur.fetchall())
namespaces = [_decode_ns_bytes(row["truncated_prefix"]) for row in rows]
results[idx] = namespaces
@classmethod
@asynccontextmanager
async def from_conn_string(
cls,
conn_string: str,
) -> AsyncIterator["AsyncPostgresStore"]:
"""Create a new AsyncPostgresStore instance from a connection string.
async def _cursor(
self, *, pipeline: bool = False
) -> AsyncIterator[AsyncCursor[DictRow]]:
"""Create a database cursor as a context manager.
Args:
conn_string (str): The Postgres connection info string.
Returns:
AsyncPostgresStore: A new AsyncPostgresStore instance.
pipeline: whether to use pipeline for the DB operations inside the context manager.
Will be applied regardless of whether the PostgresStore instance was initialized with a pipeline.
If pipeline mode is not supported, will fall back to using transaction context manager.
"""
async with await AsyncConnection.connect(
conn_string, autocommit=True, prepare_threshold=0, row_factory=dict_row
) as conn:
yield cls(conn=conn)
async def setup(self) -> None:
"""Set up the store database asynchronously.
This method creates the necessary tables in the Postgres database if they don't
already exist and runs database migrations. It MUST be called directly by the user
the first time the store is used.
"""
async with self.conn.cursor() as cur:
try:
await cur.execute(
"SELECT v FROM store_migrations ORDER BY v DESC LIMIT 1"
)
row = cast(dict, await cur.fetchone())
if row is None:
version = -1
async with _ainternal.get_connection(self.conn) as conn:
if self.pipe:
# a connection in pipeline mode can be used concurrently
# in multiple threads/coroutines, but only one cursor can be
# used at a time
try:
async with conn.cursor(binary=True, row_factory=dict_row) as cur:
yield cur
finally:
if pipeline:
await self.pipe.sync()
elif pipeline:
# a connection not in pipeline mode can only be used by one
# thread/coroutine at a time, so we acquire a lock
if self.supports_pipeline:
async with (
self.lock,
conn.pipeline(),
conn.cursor(binary=True, row_factory=dict_row) as cur,
):
yield cur
else:
version = row["v"]
except UndefinedTable:
version = -1
# Create store_migrations table if it doesn't exist
await cur.execute(
"""
CREATE TABLE IF NOT EXISTS store_migrations (
v INTEGER PRIMARY KEY
)
"""
)
for v, migration in enumerate(
self.MIGRATIONS[version + 1 :], start=version + 1
):
await cur.execute(migration)
await cur.execute("INSERT INTO store_migrations (v) VALUES (%s)", (v,))
async with (
self.lock,
conn.transaction(),
conn.cursor(binary=True, row_factory=dict_row) as cur,
):
yield cur
else:
async with (
self.lock,
conn.cursor(binary=True) as cur,
):
yield cur
File diff suppressed because it is too large. Load diff
+529 -426
View File
File diff suppressed because it is too large. Load diff
+4 -4
View File
@@ -1,6 +1,6 @@
[tool.poetry]
name = "langgraph-checkpoint-postgres"
version = "2.0.2"
version = "2.0.7"
description = "Library with a Postgres implementation of LangGraph checkpoint saver."
authors = []
license = "MIT"
@@ -10,10 +10,10 @@ packages = [{ include = "langgraph" }]
[tool.poetry.dependencies]
python = "^3.9.0,<4.0"
langgraph-checkpoint = "^2.0.2"
langgraph-checkpoint = "^2.0.7"
orjson = ">=3.10.1"
psycopg = "^3.0.0"
psycopg-pool = "^3.0.0"
psycopg = "^3.2.0"
psycopg-pool = "^3.2.0"
[tool.poetry.group.dev.dependencies]
ruff = "^0.6.2"
Whitespace-only changes.
@@ -1,12 +1,13 @@
services:
postgres-test:
image: postgres:${POSTGRES_VERSION:-16}
image: pgvector/pgvector:pg${POSTGRES_VERSION:-16}
ports:
- "5441:5432"
environment:
POSTGRES_DB: postgres
POSTGRES_USER: postgres
POSTGRES_PASSWORD: postgres
command: ["postgres", "-c", "shared_preload_libraries=vector"]
healthcheck:
test: pg_isready -U postgres
start_period: 10s
+17 -2
View File
@@ -1,10 +1,13 @@
from typing import AsyncIterator
from collections.abc import AsyncIterator
import pytest
from psycopg import AsyncConnection
from psycopg.errors import UndefinedTable
from psycopg.rows import DictRow, dict_row
from tests.embed_test_utils import CharacterEmbeddings
DEFAULT_POSTGRES_URI = "postgres://postgres:postgres@localhost:5441/"
DEFAULT_URI = "postgres://postgres:postgres@localhost:5441/postgres?sslmode=disable"
@@ -24,6 +27,18 @@ async def clear_test_db(conn: AsyncConnection[DictRow]) -> None:
await conn.execute("DELETE FROM checkpoint_blobs")
await conn.execute("DELETE FROM checkpoint_writes")
await conn.execute("DELETE FROM checkpoint_migrations")
await conn.execute("DELETE FROM store_migrations")
except UndefinedTable:
pass
try:
await conn.execute("DELETE FROM store_migrations")
await conn.execute("DELETE FROM store")
except UndefinedTable:
pass
@pytest.fixture
def fake_embeddings() -> CharacterEmbeddings:
return CharacterEmbeddings(dims=500)
VECTOR_TYPES = ["vector", "halfvec"]
@@ -0,0 +1,55 @@
"""Embedding utilities for testing."""
import math
import random
from collections import Counter, defaultdict
from typing import Any
from langchain_core.embeddings import Embeddings
class CharacterEmbeddings(Embeddings):
"""Simple character-frequency based embeddings using random projections."""
def __init__(self, dims: int = 50, seed: int = 42):
"""Initialize with embedding dimensions and random seed."""
self._rng = random.Random(seed)
self.dims = dims
# Create projection vector for each character lazily
self._char_projections: defaultdict[str, list[float]] = defaultdict(
lambda: [
self._rng.gauss(0, 1 / math.sqrt(self.dims)) for _ in range(self.dims)
]
)
def _embed_one(self, text: str) -> list[float]:
"""Embed a single text."""
counts = Counter(text)
total = sum(counts.values())
if total == 0:
return [0.0] * self.dims
embedding = [0.0] * self.dims
for char, count in counts.items():
weight = count / total
char_proj = self._char_projections[char]
for i, proj in enumerate(char_proj):
embedding[i] += weight * proj
norm = math.sqrt(sum(x * x for x in embedding))
if norm > 0:
embedding = [x / norm for x in embedding]
return embedding
def embed_documents(self, texts: list[str]) -> list[list[float]]:
"""Embed a list of documents."""
return [self._embed_one(text) for text in texts]
def embed_query(self, text: str) -> list[float]:
"""Embed a query string."""
return self._embed_one(text)
def __eq__(self, other: Any) -> bool:
return isinstance(other, CharacterEmbeddings) and self.dims == other.dims
+202 -87
View File
@@ -1,8 +1,14 @@
# type: ignore
from contextlib import asynccontextmanager
from typing import Any
from uuid import uuid4
import pytest
from conftest import DEFAULT_URI # type: ignore
from langchain_core.runnables import RunnableConfig
from psycopg import AsyncConnection
from psycopg.rows import dict_row
from psycopg_pool import AsyncConnectionPool
from langgraph.checkpoint.base import (
Checkpoint,
@@ -11,103 +17,212 @@ from langgraph.checkpoint.base import (
empty_checkpoint,
)
from langgraph.checkpoint.postgres.aio import AsyncPostgresSaver
from tests.conftest import DEFAULT_POSTGRES_URI
class TestAsyncPostgresSaver:
@pytest.fixture(autouse=True)
async def setup(self) -> None:
# objects for test setup
self.config_1: RunnableConfig = {
"configurable": {
"thread_id": "thread-1",
# for backwards compatibility testing
"thread_ts": "1",
"checkpoint_ns": "",
}
}
self.config_2: RunnableConfig = {
"configurable": {
"thread_id": "thread-2",
"checkpoint_id": "2",
"checkpoint_ns": "",
}
}
self.config_3: RunnableConfig = {
"configurable": {
"thread_id": "thread-2",
"checkpoint_id": "2-inner",
"checkpoint_ns": "inner",
}
}
@asynccontextmanager
async def _pool_saver():
"""Fixture for pool mode testing."""
database = f"test_{uuid4().hex[:16]}"
# create unique db
async with await AsyncConnection.connect(
DEFAULT_POSTGRES_URI, autocommit=True
) as conn:
await conn.execute(f"CREATE DATABASE {database}")
try:
# yield checkpointer
async with AsyncConnectionPool(
DEFAULT_POSTGRES_URI + database,
max_size=10,
kwargs={"autocommit": True, "row_factory": dict_row},
) as pool:
checkpointer = AsyncPostgresSaver(pool)
await checkpointer.setup()
yield checkpointer
finally:
# drop unique db
async with await AsyncConnection.connect(
DEFAULT_POSTGRES_URI, autocommit=True
) as conn:
await conn.execute(f"DROP DATABASE {database}")
self.chkpnt_1: Checkpoint = empty_checkpoint()
self.chkpnt_2: Checkpoint = create_checkpoint(self.chkpnt_1, {}, 1)
self.chkpnt_3: Checkpoint = empty_checkpoint()
self.metadata_1: CheckpointMetadata = {
"source": "input",
"step": 2,
"writes": {},
"score": 1,
@asynccontextmanager
async def _pipe_saver():
"""Fixture for pipeline mode testing."""
database = f"test_{uuid4().hex[:16]}"
# create unique db
async with await AsyncConnection.connect(
DEFAULT_POSTGRES_URI, autocommit=True
) as conn:
await conn.execute(f"CREATE DATABASE {database}")
try:
async with await AsyncConnection.connect(
DEFAULT_POSTGRES_URI + database,
autocommit=True,
prepare_threshold=0,
row_factory=dict_row,
) as conn:
async with conn.pipeline() as pipe:
checkpointer = AsyncPostgresSaver(conn, pipe=pipe)
await checkpointer.setup()
async with conn.pipeline() as pipe:
checkpointer = AsyncPostgresSaver(conn, pipe=pipe)
yield checkpointer
finally:
# drop unique db
async with await AsyncConnection.connect(
DEFAULT_POSTGRES_URI, autocommit=True
) as conn:
await conn.execute(f"DROP DATABASE {database}")
@asynccontextmanager
async def _base_saver():
"""Fixture for regular connection mode testing."""
database = f"test_{uuid4().hex[:16]}"
# create unique db
async with await AsyncConnection.connect(
DEFAULT_POSTGRES_URI, autocommit=True
) as conn:
await conn.execute(f"CREATE DATABASE {database}")
try:
async with await AsyncConnection.connect(
DEFAULT_POSTGRES_URI + database,
autocommit=True,
prepare_threshold=0,
row_factory=dict_row,
) as conn:
checkpointer = AsyncPostgresSaver(conn)
await checkpointer.setup()
yield checkpointer
finally:
# drop unique db
async with await AsyncConnection.connect(
DEFAULT_POSTGRES_URI, autocommit=True
) as conn:
await conn.execute(f"DROP DATABASE {database}")
@asynccontextmanager
async def _saver(name: str):
if name == "base":
async with _base_saver() as saver:
yield saver
elif name == "pool":
async with _pool_saver() as saver:
yield saver
elif name == "pipe":
async with _pipe_saver() as saver:
yield saver
@pytest.fixture
def test_data():
"""Fixture providing test data for checkpoint tests."""
config_1: RunnableConfig = {
"configurable": {
"thread_id": "thread-1",
# for backwards compatibility testing
"thread_ts": "1",
"checkpoint_ns": "",
}
self.metadata_2: CheckpointMetadata = {
"source": "loop",
}
config_2: RunnableConfig = {
"configurable": {
"thread_id": "thread-2",
"checkpoint_id": "2",
"checkpoint_ns": "",
}
}
config_3: RunnableConfig = {
"configurable": {
"thread_id": "thread-2",
"checkpoint_id": "2-inner",
"checkpoint_ns": "inner",
}
}
chkpnt_1: Checkpoint = empty_checkpoint()
chkpnt_2: Checkpoint = create_checkpoint(chkpnt_1, {}, 1)
chkpnt_3: Checkpoint = empty_checkpoint()
metadata_1: CheckpointMetadata = {
"source": "input",
"step": 2,
"writes": {},
"score": 1,
}
metadata_2: CheckpointMetadata = {
"source": "loop",
"step": 1,
"writes": {"foo": "bar"},
"score": None,
}
metadata_3: CheckpointMetadata = {}
return {
"configs": [config_1, config_2, config_3],
"checkpoints": [chkpnt_1, chkpnt_2, chkpnt_3],
"metadata": [metadata_1, metadata_2, metadata_3],
}
@pytest.mark.parametrize("saver_name", ["base", "pool", "pipe"])
async def test_asearch(request, saver_name: str, test_data) -> None:
async with _saver(saver_name) as saver:
configs = test_data["configs"]
checkpoints = test_data["checkpoints"]
metadata = test_data["metadata"]
await saver.aput(configs[0], checkpoints[0], metadata[0], {})
await saver.aput(configs[1], checkpoints[1], metadata[1], {})
await saver.aput(configs[2], checkpoints[2], metadata[2], {})
# call method / assertions
query_1 = {"source": "input"} # search by 1 key
query_2 = {
"step": 1,
"writes": {"foo": "bar"},
"score": None,
}
self.metadata_3: CheckpointMetadata = {}
async with AsyncPostgresSaver.from_conn_string(DEFAULT_URI) as saver:
await saver.setup()
} # search by multiple keys
query_3: dict[str, Any] = {} # search by no keys, return all checkpoints
query_4 = {"source": "update", "step": 1} # no match
async def test_asearch(self) -> None:
async with AsyncPostgresSaver.from_conn_string(DEFAULT_URI) as saver:
await saver.aput(self.config_1, self.chkpnt_1, self.metadata_1, {})
await saver.aput(self.config_2, self.chkpnt_2, self.metadata_2, {})
await saver.aput(self.config_3, self.chkpnt_3, self.metadata_3, {})
search_results_1 = [c async for c in saver.alist(None, filter=query_1)]
assert len(search_results_1) == 1
assert search_results_1[0].metadata == metadata[0]
# call method / assertions
query_1 = {"source": "input"} # search by 1 key
query_2 = {
"step": 1,
"writes": {"foo": "bar"},
} # search by multiple keys
query_3: dict[str, Any] = {} # search by no keys, return all checkpoints
query_4 = {"source": "update", "step": 1} # no match
search_results_2 = [c async for c in saver.alist(None, filter=query_2)]
assert len(search_results_2) == 1
assert search_results_2[0].metadata == metadata[1]
search_results_1 = [c async for c in saver.alist(None, filter=query_1)]
assert len(search_results_1) == 1
assert search_results_1[0].metadata == self.metadata_1
search_results_3 = [c async for c in saver.alist(None, filter=query_3)]
assert len(search_results_3) == 3
search_results_2 = [c async for c in saver.alist(None, filter=query_2)]
assert len(search_results_2) == 1
assert search_results_2[0].metadata == self.metadata_2
search_results_4 = [c async for c in saver.alist(None, filter=query_4)]
assert len(search_results_4) == 0
search_results_3 = [c async for c in saver.alist(None, filter=query_3)]
assert len(search_results_3) == 3
# search by config (defaults to checkpoints across all namespaces)
search_results_5 = [
c async for c in saver.alist({"configurable": {"thread_id": "thread-2"}})
]
assert len(search_results_5) == 2
assert {
search_results_5[0].config["configurable"]["checkpoint_ns"],
search_results_5[1].config["configurable"]["checkpoint_ns"],
} == {"", "inner"}
search_results_4 = [c async for c in saver.alist(None, filter=query_4)]
assert len(search_results_4) == 0
# search by config (defaults to checkpoints across all namespaces)
search_results_5 = [
c
async for c in saver.alist({"configurable": {"thread_id": "thread-2"}})
]
assert len(search_results_5) == 2
assert {
search_results_5[0].config["configurable"]["checkpoint_ns"],
search_results_5[1].config["configurable"]["checkpoint_ns"],
} == {"", "inner"}
# TODO: test before and limit params
async def test_null_chars(self) -> None:
async with AsyncPostgresSaver.from_conn_string(DEFAULT_URI) as saver:
config = await saver.aput(
self.config_1, self.chkpnt_1, {"my_key": "\x00abc"}, {}
)
assert (await saver.aget_tuple(config)).metadata["my_key"] == "abc" # type: ignore
assert [c async for c in saver.alist(None, filter={"my_key": "abc"})][
0
].metadata["my_key"] == "abc"
@pytest.mark.parametrize("saver_name", ["base", "pool", "pipe"])
async def test_null_chars(request, saver_name: str, test_data) -> None:
async with _saver(saver_name) as saver:
config = await saver.aput(
test_data["configs"][0],
test_data["checkpoints"][0],
{"my_key": "\x00abc"},
{},
)
assert (await saver.aget_tuple(config)).metadata["my_key"] == "abc" # type: ignore
assert [c async for c in saver.alist(None, filter={"my_key": "abc"})][
0
].metadata["my_key"] == "abc"
+355 -377
View File
@@ -1,114 +1,84 @@
# type: ignore
import itertools
import sys
import uuid
from datetime import datetime
from typing import Any
from unittest.mock import AsyncMock, MagicMock
from collections.abc import AsyncIterator
from contextlib import asynccontextmanager
from typing import Any, Optional
import pytest
from conftest import DEFAULT_URI # type: ignore
from langchain_core.embeddings import Embeddings
from psycopg import AsyncConnection
from langgraph.store.base import GetOp, Item, ListNamespacesOp, PutOp, SearchOp
from langgraph.store.postgres import AsyncPostgresStore
from tests.conftest import (
DEFAULT_URI,
VECTOR_TYPES,
CharacterEmbeddings,
)
class MockAsyncCursor:
def __init__(self, fetch_result: Any) -> None:
self.fetch_result = fetch_result
self.execute = AsyncMock()
self.fetchall = AsyncMock(return_value=self.fetch_result)
@pytest.fixture(scope="function", params=["default", "pipe", "pool"])
async def store(request) -> AsyncIterator[AsyncPostgresStore]:
if sys.version_info < (3, 10):
pytest.skip("Async Postgres tests require Python 3.10+")
database = f"test_{uuid.uuid4().hex[:16]}"
uri_parts = DEFAULT_URI.split("/")
uri_base = "/".join(uri_parts[:-1])
query_params = ""
if "?" in uri_parts[-1]:
db_name, query_params = uri_parts[-1].split("?", 1)
query_params = "?" + query_params
class MockAsyncConnection:
def __init__(self) -> None:
self.cursor = MagicMock()
self.pipeline = MagicMock(
return_value=AsyncMock(__aenter__=AsyncMock(), __aexit__=AsyncMock())
)
conn_string = f"{uri_base}/{database}{query_params}"
admin_conn_string = DEFAULT_URI
async with await AsyncConnection.connect(
admin_conn_string, autocommit=True
) as conn:
await conn.execute(f"CREATE DATABASE {database}")
try:
async with AsyncPostgresStore.from_conn_string(conn_string) as store:
await store.setup()
@pytest.fixture
def mock_connection() -> MockAsyncConnection:
return MockAsyncConnection()
@pytest.fixture
async def store(mock_connection: MockAsyncConnection) -> AsyncPostgresStore:
return AsyncPostgresStore(mock_connection)
if request.param == "pipe":
async with AsyncPostgresStore.from_conn_string(
conn_string, pipeline=True
) as store:
yield store
elif request.param == "pool":
async with AsyncPostgresStore.from_conn_string(
conn_string, pool_config={"min_size": 1, "max_size": 10}
) as store:
yield store
else: # default
async with AsyncPostgresStore.from_conn_string(conn_string) as store:
yield store
finally:
async with await AsyncConnection.connect(
admin_conn_string, autocommit=True
) as conn:
await conn.execute(f"DROP DATABASE {database}")
async def test_abatch_order(store: AsyncPostgresStore) -> None:
mock_connection = store.conn
mock_get_cursor = MockAsyncCursor(
[
{
"key": "key1",
"value": '{"data": "value1"}',
"created_at": datetime.now(),
"updated_at": datetime.now(),
"prefix": "test.foo",
},
{
"key": "key2",
"value": '{"data": "value2"}',
"created_at": datetime.now(),
"updated_at": datetime.now(),
"prefix": "test.bar",
},
]
)
mock_search_cursor = MockAsyncCursor(
[
{
"key": "key1",
"value": '{"data": "value1"}',
"created_at": datetime.now(),
"updated_at": datetime.now(),
"prefix": "test.foo",
},
]
)
mock_list_namespaces_cursor = MockAsyncCursor(
[
{"truncated_prefix": b"\x01test"},
]
)
failures = []
def cursor_side_effect(binary: bool = False) -> Any:
cursor = MagicMock()
async def execute_side_effect(query: str, *params: Any) -> None:
# My super sophisticated database.
if "SELECT prefix, key," in query:
cursor.fetchall = mock_search_cursor.fetchall
elif "SELECT DISTINCT ON (truncated_prefix)" in query:
cursor.fetchall = mock_list_namespaces_cursor.fetchall
elif "WHERE prefix = %s AND key" in query:
cursor.fetchall = mock_get_cursor.fetchall
elif "INSERT INTO " in query:
pass
else:
e = ValueError(f"Unmatched query: {query}")
failures.append(e)
raise e
cursor.execute = AsyncMock(side_effect=execute_side_effect)
return cursor
mock_connection.cursor.side_effect = cursor_side_effect # type: ignore
# Setup test data
await store.aput(("test", "foo"), "key1", {"data": "value1"})
await store.aput(("test", "bar"), "key2", {"data": "value2"})
ops = [
GetOp(namespace=("test",), key="key1"),
PutOp(namespace=("test",), key="key2", value={"data": "value2"}),
GetOp(namespace=("test", "foo"), key="key1"),
PutOp(namespace=("test", "bar"), key="key2", value={"data": "value2"}),
SearchOp(
namespace_prefix=("test",), filter={"data": "value1"}, limit=10, offset=0
),
ListNamespacesOp(match_conditions=None, max_depth=None, limit=10, offset=0),
GetOp(namespace=("test",), key="key3"),
]
results = await store.abatch(ops)
assert not failures
assert len(results) == 5
assert isinstance(results[0], Item)
assert isinstance(results[0].value, dict)
@@ -118,27 +88,29 @@ async def test_abatch_order(store: AsyncPostgresStore) -> None:
assert isinstance(results[2], list)
assert len(results[2]) == 1
assert isinstance(results[3], list)
assert results[3] == [("test",)]
assert ("test", "foo") in results[3] and ("test", "bar") in results[3]
assert results[4] is None
ops_reordered = [
SearchOp(namespace_prefix=("test",), filter=None, limit=5, offset=0),
GetOp(namespace=("test",), key="key2"),
GetOp(namespace=("test", "bar"), key="key2"),
ListNamespacesOp(match_conditions=None, max_depth=None, limit=5, offset=0),
PutOp(namespace=("test",), key="key3", value={"data": "value3"}),
GetOp(namespace=("test",), key="key1"),
GetOp(namespace=("test", "foo"), key="key1"),
]
results_reordered = await store.abatch(ops_reordered)
assert not failures
assert len(results_reordered) == 5
assert isinstance(results_reordered[0], list)
assert len(results_reordered[0]) == 1
assert len(results_reordered[0]) == 2
assert isinstance(results_reordered[1], Item)
assert results_reordered[1].value == {"data": "value2"}
assert results_reordered[1].key == "key2"
assert isinstance(results_reordered[2], list)
assert results_reordered[2] == [("test",)]
assert ("test", "foo") in results_reordered[2] and (
"test",
"bar",
) in results_reordered[2]
assert results_reordered[3] is None
assert isinstance(results_reordered[4], Item)
assert results_reordered[4].value == {"data": "value1"}
@@ -146,26 +118,9 @@ async def test_abatch_order(store: AsyncPostgresStore) -> None:
async def test_batch_get_ops(store: AsyncPostgresStore) -> None:
mock_connection = store.conn
mock_cursor = MockAsyncCursor(
[
{
"key": "key1",
"value": '{"data": "value1"}',
"created_at": datetime.now(),
"updated_at": datetime.now(),
"prefix": "test.foo",
},
{
"key": "key2",
"value": '{"data": "value2"}',
"created_at": datetime.now(),
"updated_at": datetime.now(),
"prefix": "test.bar",
},
]
)
mock_connection.cursor.return_value = mock_cursor
# Setup test data
await store.aput(("test",), "key1", {"data": "value1"})
await store.aput(("test",), "key2", {"data": "value2"})
ops = [
GetOp(namespace=("test",), key="key1"),
@@ -184,10 +139,6 @@ async def test_batch_get_ops(store: AsyncPostgresStore) -> None:
async def test_batch_put_ops(store: AsyncPostgresStore) -> None:
mock_connection = store.conn
mock_cursor = MockAsyncCursor([])
mock_connection.cursor.return_value = mock_cursor
ops = [
PutOp(namespace=("test",), key="key1", value={"data": "value1"}),
PutOp(namespace=("test",), key="key2", value={"data": "value2"}),
@@ -198,30 +149,16 @@ async def test_batch_put_ops(store: AsyncPostgresStore) -> None:
assert len(results) == 3
assert all(result is None for result in results)
assert mock_cursor.execute.call_count == 2
# Verify the puts worked
items = await store.asearch(["test"], limit=10)
assert len(items) == 2 # key3 had None value so wasn't stored
async def test_batch_search_ops(store: AsyncPostgresStore) -> None:
mock_connection = store.conn
mock_cursor = MockAsyncCursor(
[
{
"key": "key1",
"value": '{"data": "value1"}',
"created_at": datetime.now(),
"updated_at": datetime.now(),
"prefix": "test.foo",
},
{
"key": "key2",
"value": '{"data": "value2"}',
"created_at": datetime.now(),
"updated_at": datetime.now(),
"prefix": "test.bar",
},
]
)
mock_connection.cursor.return_value = mock_cursor
# Setup test data
await store.aput(("test", "foo"), "key1", {"data": "value1"})
await store.aput(("test", "bar"), "key2", {"data": "value2"})
ops = [
SearchOp(
@@ -233,297 +170,338 @@ async def test_batch_search_ops(store: AsyncPostgresStore) -> None:
results = await store.abatch(ops)
assert len(results) == 2
assert len(results[0]) == 2
assert len(results[1]) == 2
assert len(results[0]) == 1 # Filtered results
assert len(results[1]) == 2 # All results
async def test_batch_list_namespaces_ops(store: AsyncPostgresStore) -> None:
mock_connection = store.conn
mock_cursor = MockAsyncCursor(
[
{"truncated_prefix": b"\x01test.namespace1"},
{"truncated_prefix": b"\x01test.namespace2"},
]
)
mock_connection.cursor.return_value = mock_cursor
# Setup test data
await store.aput(("test", "namespace1"), "key1", {"data": "value1"})
await store.aput(("test", "namespace2"), "key2", {"data": "value2"})
ops = [ListNamespacesOp(match_conditions=None, max_depth=None, limit=10, offset=0)]
results = await store.abatch(ops)
assert len(results) == 1
assert results[0] == [("test", "namespace1"), ("test", "namespace2")]
assert len(results[0]) == 2
assert ("test", "namespace1") in results[0]
assert ("test", "namespace2") in results[0]
# The following use the actual DB connection
@asynccontextmanager
async def _create_vector_store(
vector_type: str,
distance_type: str,
fake_embeddings: CharacterEmbeddings,
text_fields: Optional[list[str]] = None,
) -> AsyncIterator[AsyncPostgresStore]:
"""Create a store with vector search enabled."""
if sys.version_info < (3, 10):
pytest.skip("Async Postgres tests require Python 3.10+")
database = f"test_{uuid.uuid4().hex[:16]}"
uri_parts = DEFAULT_URI.split("/")
uri_base = "/".join(uri_parts[:-1])
query_params = ""
if "?" in uri_parts[-1]:
db_name, query_params = uri_parts[-1].split("?", 1)
query_params = "?" + query_params
class TestAsyncPostgresStore:
@pytest.fixture(autouse=True)
async def setup(self) -> None:
async with AsyncPostgresStore.from_conn_string(DEFAULT_URI) as store:
conn_string = f"{uri_base}/{database}{query_params}"
admin_conn_string = DEFAULT_URI
index_config = {
"dims": fake_embeddings.dims,
"embed": fake_embeddings,
"ann_index_config": {
"vector_type": vector_type,
},
"distance_type": distance_type,
"text_fields": text_fields,
}
async with await AsyncConnection.connect(
admin_conn_string, autocommit=True
) as conn:
await conn.execute(f"CREATE DATABASE {database}")
try:
async with AsyncPostgresStore.from_conn_string(
conn_string,
index=index_config,
) as store:
await store.setup()
yield store
finally:
async with await AsyncConnection.connect(
admin_conn_string, autocommit=True
) as conn:
await conn.execute(f"DROP DATABASE {database}")
async def test_basic_store_ops(self) -> None:
async with AsyncPostgresStore.from_conn_string(DEFAULT_URI) as store:
namespace = ("test", "documents")
item_id = "doc1"
item_value = {"title": "Test Document", "content": "Hello, World!"}
await store.aput(namespace, item_id, item_value)
item = await store.aget(namespace, item_id)
@pytest.fixture(
scope="function",
params=[
(vector_type, distance_type)
for vector_type in VECTOR_TYPES
for distance_type in (
["hamming"] if vector_type == "bit" else ["l2", "inner_product", "cosine"]
)
],
ids=lambda p: f"{p[0]}_{p[1]}",
)
async def vector_store(
request,
fake_embeddings: CharacterEmbeddings,
) -> AsyncIterator[AsyncPostgresStore]:
"""Create a store with vector search enabled."""
vector_type, distance_type = request.param
async with _create_vector_store(
vector_type, distance_type, fake_embeddings
) as store:
yield store
assert item
assert item.namespace == namespace
assert item.key == item_id
assert item.value == item_value
updated_value = {
"title": "Updated Test Document",
"content": "Hello, LangGraph!",
}
await store.aput(namespace, item_id, updated_value)
updated_item = await store.aget(namespace, item_id)
async def test_vector_store_initialization(
vector_store: AsyncPostgresStore, fake_embeddings: CharacterEmbeddings
) -> None:
"""Test store initialization with embedding config."""
assert vector_store.index_config is not None
assert vector_store.index_config["dims"] == fake_embeddings.dims
if isinstance(vector_store.index_config["embed"], Embeddings):
assert vector_store.index_config["embed"] == fake_embeddings
assert updated_item.value == updated_value
assert updated_item.updated_at > item.updated_at
different_namespace = ("test", "other_documents")
item_in_different_namespace = await store.aget(different_namespace, item_id)
assert item_in_different_namespace is None
new_item_id = "doc2"
new_item_value = {"title": "Another Document", "content": "Greetings!"}
await store.aput(namespace, new_item_id, new_item_value)
async def test_vector_insert_with_auto_embedding(
vector_store: AsyncPostgresStore,
) -> None:
"""Test inserting items that get auto-embedded."""
docs = [
("doc1", {"text": "short text"}),
("doc2", {"text": "longer text document"}),
("doc3", {"text": "longest text document here"}),
("doc4", {"description": "text in description field"}),
("doc5", {"content": "text in content field"}),
("doc6", {"body": "text in body field"}),
]
search_results = await store.asearch(["test"], limit=10)
items = search_results
assert len(items) == 2
assert any(item.key == item_id for item in items)
assert any(item.key == new_item_id for item in items)
for key, value in docs:
await vector_store.aput(("test",), key, value)
namespaces = await store.alist_namespaces(prefix=["test"])
assert ("test", "documents") in namespaces
results = await vector_store.asearch(("test",), query="long text")
assert len(results) > 0
await store.adelete(namespace, item_id)
await store.adelete(namespace, new_item_id)
deleted_item = await store.aget(namespace, item_id)
assert deleted_item is None
doc_order = [r.key for r in results]
assert "doc2" in doc_order
assert "doc3" in doc_order
deleted_item = await store.aget(namespace, new_item_id)
assert deleted_item is None
empty_search_results = await store.asearch(["test"], limit=10)
assert len(empty_search_results) == 0
async def test_vector_update_with_embedding(vector_store: AsyncPostgresStore) -> None:
"""Test that updating items properly updates their embeddings."""
await vector_store.aput(("test",), "doc1", {"text": "zany zebra Xerxes"})
await vector_store.aput(("test",), "doc2", {"text": "something about dogs"})
await vector_store.aput(("test",), "doc3", {"text": "text about birds"})
async def test_list_namespaces(self) -> None:
async with AsyncPostgresStore.from_conn_string(DEFAULT_URI) as store:
test_pref = str(uuid.uuid4())
test_namespaces = [
(test_pref, "test", "documents", "public", test_pref),
(test_pref, "test", "documents", "private", test_pref),
(test_pref, "test", "images", "public", test_pref),
(test_pref, "test", "images", "private", test_pref),
(test_pref, "prod", "documents", "public", test_pref),
(
test_pref,
"prod",
"documents",
"some",
"nesting",
"public",
test_pref,
),
(test_pref, "prod", "documents", "private", test_pref),
]
results_initial = await vector_store.asearch(("test",), query="Zany Xerxes")
assert len(results_initial) > 0
assert results_initial[0].key == "doc1"
initial_score = results_initial[0].score
for namespace in test_namespaces:
await store.aput(namespace, "dummy", {"content": "dummy"})
await vector_store.aput(("test",), "doc1", {"text": "new text about dogs"})
prefix_result = await store.alist_namespaces(prefix=[test_pref, "test"])
assert len(prefix_result) == 4
assert all([ns[1] == "test" for ns in prefix_result])
results_after = await vector_store.asearch(("test",), query="Zany Xerxes")
after_score = next((r.score for r in results_after if r.key == "doc1"), 0.0)
assert after_score < initial_score
specific_prefix_result = await store.alist_namespaces(
prefix=[test_pref, "test", "documents"]
)
assert len(specific_prefix_result) == 2
assert all(
[ns[1:3] == ("test", "documents") for ns in specific_prefix_result]
)
results_new = await vector_store.asearch(("test",), query="new text about dogs")
for r in results_new:
if r.key == "doc1":
assert r.score > after_score
suffix_result = await store.alist_namespaces(suffix=["public", test_pref])
assert len(suffix_result) == 4
assert all(ns[-2] == "public" for ns in suffix_result)
# Don't index this one
await vector_store.aput(
("test",), "doc4", {"text": "new text about dogs"}, index=False
)
results_new = await vector_store.asearch(
("test",), query="new text about dogs", limit=3
)
assert not any(r.key == "doc4" for r in results_new)
prefix_suffix_result = await store.alist_namespaces(
prefix=[test_pref, "test"], suffix=["public", test_pref]
)
assert len(prefix_suffix_result) == 2
assert all(
ns[1] == "test" and ns[-2] == "public" for ns in prefix_suffix_result
)
wildcard_prefix_result = await store.alist_namespaces(
prefix=[test_pref, "*", "documents"]
)
assert len(wildcard_prefix_result) == 5
assert all(ns[2] == "documents" for ns in wildcard_prefix_result)
async def test_vector_search_with_filters(vector_store: AsyncPostgresStore) -> None:
"""Test combining vector search with filters."""
docs = [
("doc1", {"text": "red apple", "color": "red", "score": 4.5}),
("doc2", {"text": "red car", "color": "red", "score": 3.0}),
("doc3", {"text": "green apple", "color": "green", "score": 4.0}),
("doc4", {"text": "blue car", "color": "blue", "score": 3.5}),
]
wildcard_suffix_result = await store.alist_namespaces(
suffix=["*", "public", test_pref]
)
assert len(wildcard_suffix_result) == 4
assert all(ns[-2] == "public" for ns in wildcard_suffix_result)
wildcard_single = await store.alist_namespaces(
suffix=["some", "*", "public", test_pref]
)
assert len(wildcard_single) == 1
assert wildcard_single[0] == (
test_pref,
"prod",
"documents",
"some",
"nesting",
"public",
test_pref,
)
for key, value in docs:
await vector_store.aput(("test",), key, value)
max_depth_result = await store.alist_namespaces(max_depth=3)
assert all([len(ns) <= 3 for ns in max_depth_result])
max_depth_result = await store.alist_namespaces(
max_depth=4, prefix=[test_pref, "*", "documents"]
)
assert (
len(set(tuple(res) for res in max_depth_result))
== len(max_depth_result)
== 5
)
results = await vector_store.asearch(
("test",), query="apple", filter={"color": "red"}
)
assert len(results) == 2
assert results[0].key == "doc1"
limit_result = await store.alist_namespaces(prefix=[test_pref], limit=3)
assert len(limit_result) == 3
results = await vector_store.asearch(
("test",), query="car", filter={"color": "red"}
)
assert len(results) == 2
assert results[0].key == "doc2"
offset_result = await store.alist_namespaces(prefix=[test_pref], offset=3)
assert len(offset_result) == len(test_namespaces) - 3
results = await vector_store.asearch(
("test",), query="bbbbluuu", filter={"score": {"$gt": 3.2}}
)
assert len(results) == 3
assert results[0].key == "doc4"
empty_prefix_result = await store.alist_namespaces(prefix=[test_pref])
assert len(empty_prefix_result) == len(test_namespaces)
assert set(tuple(ns) for ns in empty_prefix_result) == set(
tuple(ns) for ns in test_namespaces
)
results = await vector_store.asearch(
("test",), query="apple", filter={"score": {"$gte": 4.0}, "color": "green"}
)
assert len(results) == 1
assert results[0].key == "doc3"
for namespace in test_namespaces:
await store.adelete(namespace, "dummy")
async def test_search(self):
async with AsyncPostgresStore.from_conn_string(DEFAULT_URI) as store:
test_namespaces = [
("test_search", "documents", "user1"),
("test_search", "documents", "user2"),
("test_search", "reports", "department1"),
("test_search", "reports", "department2"),
]
test_items = [
{"title": "Doc 1", "author": "John Doe", "tags": ["important"]},
{"title": "Doc 2", "author": "Jane Smith", "tags": ["draft"]},
{"title": "Report A", "author": "John Doe", "tags": ["final"]},
{"title": "Report B", "author": "Alice Johnson", "tags": ["draft"]},
]
empty = await store.asearch(
(
"scoped",
"assistant_id",
"shared",
"6c5356f6-63ab-4158-868d-cd9fd14c736e",
),
limit=10,
offset=0,
)
assert len(empty) == 0
async def test_vector_search_pagination(vector_store: AsyncPostgresStore) -> None:
"""Test pagination with vector search."""
for i in range(5):
await vector_store.aput(
("test",), f"doc{i}", {"text": f"test document number {i}"}
)
for namespace, item in zip(test_namespaces, test_items):
await store.aput(namespace, f"item_{namespace[-1]}", item)
results_page1 = await vector_store.asearch(("test",), query="test", limit=2)
results_page2 = await vector_store.asearch(
("test",), query="test", limit=2, offset=2
)
docs_result = await store.asearch(["test_search", "documents"])
assert len(docs_result) == 2
assert all([item.namespace[1] == "documents" for item in docs_result]), [
item.namespace for item in docs_result
]
assert len(results_page1) == 2
assert len(results_page2) == 2
assert results_page1[0].key != results_page2[0].key
reports_result = await store.asearch(["test_search", "reports"])
assert len(reports_result) == 2
assert all(item.namespace[1] == "reports" for item in reports_result)
all_results = await vector_store.asearch(("test",), query="test", limit=10)
assert len(all_results) == 5
limited_result = await store.asearch(["test_search"], limit=2)
assert len(limited_result) == 2
offset_result = await store.asearch(["test_search"])
assert len(offset_result) == 4
offset_result = await store.asearch(["test_search"], offset=2)
assert len(offset_result) == 2
assert all(item not in limited_result for item in offset_result)
async def test_vector_search_edge_cases(vector_store: AsyncPostgresStore) -> None:
"""Test edge cases in vector search."""
await vector_store.aput(("test",), "doc1", {"text": "test document"})
john_doe_result = await store.asearch(
["test_search"], filter={"author": "John Doe"}
)
assert len(john_doe_result) == 2
assert all(item.value["author"] == "John Doe" for item in john_doe_result)
perfect_match = await vector_store.asearch(("test",), query="text test document")
perfect_score = perfect_match[0].score
draft_result = await store.asearch(
["test_search"], filter={"tags": ["draft"]}
)
assert len(draft_result) == 2
assert all("draft" in item.value["tags"] for item in draft_result)
results = await vector_store.asearch(("test",), query="")
assert len(results) == 1
assert results[0].score is None
page1 = await store.asearch(["test_search"], limit=2, offset=0)
page2 = await store.asearch(["test_search"], limit=2, offset=2)
all_items = page1 + page2
assert len(all_items) == 4
assert len(set(item.key for item in all_items)) == 4
empty = await store.asearch(
(
"scoped",
"assistant_id",
"shared",
"again",
"maybe",
"some-long",
"6be5cb0e-2eb4-42e6-bb6b-fba3c269db25",
),
limit=10,
offset=0,
)
assert len(empty) == 0
results = await vector_store.asearch(("test",), query=None)
assert len(results) == 1
assert results[0].score is None
# Test with a namespace beginning with a number (like a UUID)
uuid_namespace = (str(uuid.uuid4()), "documents")
uuid_item_id = "uuid_doc"
uuid_item_value = {
"title": "UUID Document",
"content": "This document has a UUID namespace.",
}
long_query = "foo " * 100
results = await vector_store.asearch(("test",), query=long_query)
assert len(results) == 1
assert results[0].score < perfect_score
# Insert the item with the UUID namespace
await store.aput(uuid_namespace, uuid_item_id, uuid_item_value)
special_query = "test!@#$%^&*()"
results = await vector_store.asearch(("test",), query=special_query)
assert len(results) == 1
assert results[0].score < perfect_score
# Retrieve the item to verify it was stored correctly
retrieved_item = await store.aget(uuid_namespace, uuid_item_id)
assert retrieved_item is not None
assert retrieved_item.namespace == uuid_namespace
assert retrieved_item.key == uuid_item_id
assert retrieved_item.value == uuid_item_value
# Search for the item using the UUID namespace
search_result = await store.asearch([uuid_namespace[0]])
assert len(search_result) == 1
assert search_result[0].key == uuid_item_id
assert search_result[0].value == uuid_item_value
@pytest.mark.parametrize(
"vector_type,distance_type",
[
*itertools.product(["vector", "halfvec"], ["cosine", "inner_product", "l2"]),
],
)
async def test_embed_with_path(
request: Any,
fake_embeddings: CharacterEmbeddings,
vector_type: str,
distance_type: str,
) -> None:
"""Test vector search with specific text fields in Postgres store."""
async with _create_vector_store(
vector_type,
distance_type,
fake_embeddings,
text_fields=["key0", "key1", "key3"],
) as store:
# This will have 2 vectors representing it
doc1 = {
# Omit key0 - check it doesn't raise an error
"key1": "xxx",
"key2": "yyy",
"key3": "zzz",
}
# This will have 3 vectors representing it
doc2 = {
"key0": "uuu",
"key1": "vvv",
"key2": "www",
"key3": "xxx",
}
await store.aput(("test",), "doc1", doc1)
await store.aput(("test",), "doc2", doc2)
# Clean up: delete the item with the UUID namespace
await store.adelete(uuid_namespace, uuid_item_id)
# doc2.key3 and doc1.key1 both would have the highest score
results = await store.asearch(("test",), query="xxx")
assert len(results) == 2
assert results[0].key != results[1].key
ascore = results[0].score
bscore = results[1].score
assert ascore == pytest.approx(bscore, abs=1e-3)
# Verify the item was deleted
deleted_item = await store.aget(uuid_namespace, uuid_item_id)
assert deleted_item is None
results = await store.asearch(("test",), query="uuu")
assert len(results) == 2
assert results[0].key != results[1].key
assert results[0].key == "doc2"
assert results[0].score > results[1].score
assert ascore == pytest.approx(results[0].score, abs=1e-3)
for namespace in test_namespaces:
await store.adelete(namespace, f"item_{namespace[-1]}")
# Un-indexed - will have low results for both. Not zero (because we're projecting)
# but less than the above.
results = await store.asearch(("test",), query="www")
assert len(results) == 2
assert results[0].score < ascore
assert results[1].score < ascore
@pytest.mark.parametrize(
"vector_type,distance_type",
[
*itertools.product(["vector", "halfvec"], ["cosine", "inner_product", "l2"]),
],
)
async def test_search_sorting(
request: Any,
fake_embeddings: CharacterEmbeddings,
vector_type: str,
distance_type: str,
) -> None:
"""Test operation-level field configuration for vector search."""
async with _create_vector_store(
vector_type,
distance_type,
fake_embeddings,
text_fields=["key1"], # Default fields that won't match our test data
) as store:
amatch = {
"key1": "mmm",
}
await store.aput(("test", "M"), "M", amatch)
N = 100
for i in range(N):
await store.aput(("test", "A"), f"A{i}", {"key1": "no"})
for i in range(N):
await store.aput(("test", "Z"), f"Z{i}", {"key1": "no"})
results = await store.asearch(("test",), query="mmm", limit=10)
assert len(results) == 10
assert len(set(r.key for r in results)) == 10
assert results[0].key == "M"
assert results[0].score > results[1].score
File diff suppressed because it is too large. Load diff
+189 -86
View File
@@ -1,8 +1,14 @@
# type: ignore
from contextlib import contextmanager
from typing import Any
from uuid import uuid4
import pytest
from conftest import DEFAULT_URI # type: ignore
from langchain_core.runnables import RunnableConfig
from psycopg import Connection
from psycopg.rows import dict_row
from psycopg_pool import ConnectionPool
from langgraph.checkpoint.base import (
Checkpoint,
@@ -11,102 +17,199 @@ from langgraph.checkpoint.base import (
empty_checkpoint,
)
from langgraph.checkpoint.postgres import PostgresSaver
from tests.conftest import DEFAULT_POSTGRES_URI
class TestPostgresSaver:
@pytest.fixture(autouse=True)
def setup(self) -> None:
# objects for test setup
self.config_1: RunnableConfig = {
"configurable": {
"thread_id": "thread-1",
# for backwards compatibility testing
"thread_ts": "1",
"checkpoint_ns": "",
}
}
self.config_2: RunnableConfig = {
"configurable": {
"thread_id": "thread-2",
"checkpoint_id": "2",
"checkpoint_ns": "",
}
}
self.config_3: RunnableConfig = {
"configurable": {
"thread_id": "thread-2",
"checkpoint_id": "2-inner",
"checkpoint_ns": "inner",
}
}
@contextmanager
def _pool_saver():
"""Fixture for pool mode testing."""
database = f"test_{uuid4().hex[:16]}"
# create unique db
with Connection.connect(DEFAULT_POSTGRES_URI, autocommit=True) as conn:
conn.execute(f"CREATE DATABASE {database}")
try:
# yield checkpointer
with ConnectionPool(
DEFAULT_POSTGRES_URI + database,
max_size=10,
kwargs={"autocommit": True, "row_factory": dict_row},
) as pool:
checkpointer = PostgresSaver(pool)
checkpointer.setup()
yield checkpointer
finally:
# drop unique db
with Connection.connect(DEFAULT_POSTGRES_URI, autocommit=True) as conn:
conn.execute(f"DROP DATABASE {database}")
self.chkpnt_1: Checkpoint = empty_checkpoint()
self.chkpnt_2: Checkpoint = create_checkpoint(self.chkpnt_1, {}, 1)
self.chkpnt_3: Checkpoint = empty_checkpoint()
self.metadata_1: CheckpointMetadata = {
"source": "input",
"step": 2,
"writes": {},
"score": 1,
@contextmanager
def _pipe_saver():
"""Fixture for pipeline mode testing."""
database = f"test_{uuid4().hex[:16]}"
# create unique db
with Connection.connect(DEFAULT_POSTGRES_URI, autocommit=True) as conn:
conn.execute(f"CREATE DATABASE {database}")
try:
with Connection.connect(
DEFAULT_POSTGRES_URI + database,
autocommit=True,
prepare_threshold=0,
row_factory=dict_row,
) as conn:
with conn.pipeline() as pipe:
checkpointer = PostgresSaver(conn, pipe=pipe)
checkpointer.setup()
with conn.pipeline() as pipe:
checkpointer = PostgresSaver(conn, pipe=pipe)
yield checkpointer
finally:
# drop unique db
with Connection.connect(DEFAULT_POSTGRES_URI, autocommit=True) as conn:
conn.execute(f"DROP DATABASE {database}")
@contextmanager
def _base_saver():
"""Fixture for regular connection mode testing."""
database = f"test_{uuid4().hex[:16]}"
# create unique db
with Connection.connect(DEFAULT_POSTGRES_URI, autocommit=True) as conn:
conn.execute(f"CREATE DATABASE {database}")
try:
with Connection.connect(
DEFAULT_POSTGRES_URI + database,
autocommit=True,
prepare_threshold=0,
row_factory=dict_row,
) as conn:
checkpointer = PostgresSaver(conn)
checkpointer.setup()
yield checkpointer
finally:
# drop unique db
with Connection.connect(DEFAULT_POSTGRES_URI, autocommit=True) as conn:
conn.execute(f"DROP DATABASE {database}")
@contextmanager
def _saver(name: str):
if name == "base":
with _base_saver() as saver:
yield saver
elif name == "pool":
with _pool_saver() as saver:
yield saver
elif name == "pipe":
with _pipe_saver() as saver:
yield saver
@pytest.fixture
def test_data():
"""Fixture providing test data for checkpoint tests."""
config_1: RunnableConfig = {
"configurable": {
"thread_id": "thread-1",
# for backwards compatibility testing
"thread_ts": "1",
"checkpoint_ns": "",
}
self.metadata_2: CheckpointMetadata = {
"source": "loop",
}
config_2: RunnableConfig = {
"configurable": {
"thread_id": "thread-2",
"checkpoint_id": "2",
"checkpoint_ns": "",
}
}
config_3: RunnableConfig = {
"configurable": {
"thread_id": "thread-2",
"checkpoint_id": "2-inner",
"checkpoint_ns": "inner",
}
}
chkpnt_1: Checkpoint = empty_checkpoint()
chkpnt_2: Checkpoint = create_checkpoint(chkpnt_1, {}, 1)
chkpnt_3: Checkpoint = empty_checkpoint()
metadata_1: CheckpointMetadata = {
"source": "input",
"step": 2,
"writes": {},
"score": 1,
}
metadata_2: CheckpointMetadata = {
"source": "loop",
"step": 1,
"writes": {"foo": "bar"},
"score": None,
}
metadata_3: CheckpointMetadata = {}
return {
"configs": [config_1, config_2, config_3],
"checkpoints": [chkpnt_1, chkpnt_2, chkpnt_3],
"metadata": [metadata_1, metadata_2, metadata_3],
}
@pytest.mark.parametrize("saver_name", ["base", "pool", "pipe"])
def test_search(saver_name: str, test_data) -> None:
with _saver(saver_name) as saver:
configs = test_data["configs"]
checkpoints = test_data["checkpoints"]
metadata = test_data["metadata"]
saver.put(configs[0], checkpoints[0], metadata[0], {})
saver.put(configs[1], checkpoints[1], metadata[1], {})
saver.put(configs[2], checkpoints[2], metadata[2], {})
# call method / assertions
query_1 = {"source": "input"} # search by 1 key
query_2 = {
"step": 1,
"writes": {"foo": "bar"},
"score": None,
}
self.metadata_3: CheckpointMetadata = {}
with PostgresSaver.from_conn_string(DEFAULT_URI) as saver:
saver.setup()
} # search by multiple keys
query_3: dict[str, Any] = {} # search by no keys, return all checkpoints
query_4 = {"source": "update", "step": 1} # no match
def test_search(self) -> None:
with PostgresSaver.from_conn_string(DEFAULT_URI) as saver:
# save checkpoints
saver.put(self.config_1, self.chkpnt_1, self.metadata_1, {})
saver.put(self.config_2, self.chkpnt_2, self.metadata_2, {})
saver.put(self.config_3, self.chkpnt_3, self.metadata_3, {})
search_results_1 = list(saver.list(None, filter=query_1))
assert len(search_results_1) == 1
assert search_results_1[0].metadata == metadata[0]
# call method / assertions
query_1 = {"source": "input"} # search by 1 key
query_2 = {
"step": 1,
"writes": {"foo": "bar"},
} # search by multiple keys
query_3: dict[str, Any] = {} # search by no keys, return all checkpoints
query_4 = {"source": "update", "step": 1} # no match
search_results_2 = list(saver.list(None, filter=query_2))
assert len(search_results_2) == 1
assert search_results_2[0].metadata == metadata[1]
search_results_1 = list(saver.list(None, filter=query_1))
assert len(search_results_1) == 1
assert search_results_1[0].metadata == self.metadata_1
search_results_3 = list(saver.list(None, filter=query_3))
assert len(search_results_3) == 3
search_results_2 = list(saver.list(None, filter=query_2))
assert len(search_results_2) == 1
assert search_results_2[0].metadata == self.metadata_2
search_results_4 = list(saver.list(None, filter=query_4))
assert len(search_results_4) == 0
search_results_3 = list(saver.list(None, filter=query_3))
assert len(search_results_3) == 3
# search by config (defaults to checkpoints across all namespaces)
search_results_5 = list(saver.list({"configurable": {"thread_id": "thread-2"}}))
assert len(search_results_5) == 2
assert {
search_results_5[0].config["configurable"]["checkpoint_ns"],
search_results_5[1].config["configurable"]["checkpoint_ns"],
} == {"", "inner"}
search_results_4 = list(saver.list(None, filter=query_4))
assert len(search_results_4) == 0
# search by config (defaults to checkpoints across all namespaces)
search_results_5 = list(
saver.list({"configurable": {"thread_id": "thread-2"}})
)
assert len(search_results_5) == 2
assert {
search_results_5[0].config["configurable"]["checkpoint_ns"],
search_results_5[1].config["configurable"]["checkpoint_ns"],
} == {"", "inner"}
# TODO: test before and limit params
def test_null_chars(self) -> None:
with PostgresSaver.from_conn_string(DEFAULT_URI) as saver:
config = saver.put(self.config_1, self.chkpnt_1, {"my_key": "\x00abc"}, {})
assert saver.get_tuple(config).metadata["my_key"] == "abc" # type: ignore
assert (
list(saver.list(None, filter={"my_key": "abc"}))[0].metadata["my_key"] # type: ignore
== "abc"
)
@pytest.mark.parametrize("saver_name", ["base", "pool", "pipe"])
def test_null_chars(saver_name: str, test_data) -> None:
with _saver(saver_name) as saver:
config = saver.put(
test_data["configs"][0],
test_data["checkpoints"][0],
{"my_key": "\x00abc"},
{},
)
assert saver.get_tuple(config).metadata["my_key"] == "abc" # type: ignore
assert (
list(saver.list(None, filter={"my_key": "abc"}))[0].metadata["my_key"]
== "abc"
)
@@ -110,7 +110,7 @@ class SqliteSaver(BaseCheckpointSaver[str]):
check_same_thread=False,
)
) as conn:
yield SqliteSaver(conn)
yield cls(conn)
def setup(self) -> None:
"""Set up the checkpoint database.
@@ -137,7 +137,7 @@ class AsyncSqliteSaver(BaseCheckpointSaver[str]):
AsyncSqliteSaver: A new AsyncSqliteSaver instance.
"""
async with aiosqlite.connect(conn_string) as conn:
yield AsyncSqliteSaver(conn)
yield cls(conn)
def get_tuple(self, config: RunnableConfig) -> Optional[CheckpointTuple]:
"""Get a checkpoint tuple from the database.
+4 -2
View File
@@ -4,11 +4,13 @@
# TESTING AND COVERAGE
######################
TEST ?= .
test:
poetry run pytest tests
poetry run pytest $(TEST)
test_watch:
poetry run ptw .
poetry run ptw $(TEST)
######################
# LINTING AND FORMATTING
@@ -24,6 +24,8 @@ from langgraph.checkpoint.serde.base import SerializerProtocol, maybe_add_typed_
from langgraph.checkpoint.serde.jsonplus import JsonPlusSerializer
from langgraph.checkpoint.serde.types import (
ERROR,
INTERRUPT,
RESUME,
SCHEDULED,
ChannelProtocol,
SendProtocol,
@@ -37,12 +39,13 @@ PendingWrite = Tuple[str, str, Any]
class CheckpointMetadata(TypedDict, total=False):
"""Metadata associated with a checkpoint."""
source: Literal["input", "loop", "update"]
source: Literal["input", "loop", "update", "fork"]
"""The source of the checkpoint.
- "input": The checkpoint was created from an input to invoke/stream/batch.
- "loop": The checkpoint was created from inside the pregel loop.
- "update": The checkpoint was created from a manual state update.
- "fork": The checkpoint was created as a copy of another checkpoint.
"""
step: int
"""The step number of the checkpoint.
@@ -449,4 +452,4 @@ Special writes (e.g. errors) map to negative indices, to avoid those writes from
conflicting with regular writes.
Each Checkpointer implementation should use this mapping in put_writes.
"""
WRITES_IDX_MAP = {ERROR: -1, SCHEDULED: -2}
WRITES_IDX_MAP = {ERROR: -1, SCHEDULED: -2, INTERRUPT: -3, RESUME: -4}
@@ -1,10 +1,14 @@
import asyncio
import logging
import os
import pickle
import random
import shutil
from collections import defaultdict
from contextlib import AbstractAsyncContextManager, AbstractContextManager
from contextlib import AbstractAsyncContextManager, AbstractContextManager, ExitStack
from functools import partial
from types import TracebackType
from typing import Any, AsyncIterator, Dict, Iterator, Optional, Sequence, Tuple
from typing import Any, AsyncIterator, Dict, Iterator, Optional, Sequence, Tuple, Type
from langchain_core.runnables import RunnableConfig
@@ -20,6 +24,8 @@ from langgraph.checkpoint.base import (
)
from langgraph.checkpoint.serde.types import TASKS, ChannelProtocol
logger = logging.getLogger(__name__)
class MemorySaver(
BaseCheckpointSaver[str], AbstractContextManager, AbstractAsyncContextManager
@@ -68,13 +74,18 @@ class MemorySaver(
self,
*,
serde: Optional[SerializerProtocol] = None,
factory: Type[defaultdict] = defaultdict,
) -> None:
super().__init__(serde=serde)
self.storage = defaultdict(lambda: defaultdict(dict))
self.writes = defaultdict(dict)
self.storage = factory(lambda: defaultdict(dict))
self.writes = factory(dict)
self.stack = ExitStack()
if factory is not defaultdict:
self.stack.enter_context(self.storage) # type: ignore[arg-type]
self.stack.enter_context(self.writes) # type: ignore[arg-type]
def __enter__(self) -> "MemorySaver":
return self
return self.stack.__enter__()
def __exit__(
self,
@@ -82,10 +93,10 @@ class MemorySaver(
exc_value: Optional[BaseException],
traceback: Optional[TracebackType],
) -> Optional[bool]:
return
return self.stack.__exit__(exc_type, exc_value, traceback)
async def __aenter__(self) -> "MemorySaver":
return self
return self.stack.__enter__()
async def __aexit__(
self,
@@ -93,7 +104,7 @@ class MemorySaver(
__exc_value: Optional[BaseException],
__traceback: Optional[TracebackType],
) -> Optional[bool]:
return
return self.stack.__exit__(__exc_type, __exc_value, __traceback)
def get_tuple(self, config: RunnableConfig) -> Optional[CheckpointTuple]:
"""Get a checkpoint tuple from the in-memory storage.
@@ -361,11 +372,15 @@ class MemorySaver(
RunnableConfig: The updated config containing the saved writes' timestamp.
"""
thread_id = config["configurable"]["thread_id"]
checkpoint_ns = config["configurable"]["checkpoint_ns"]
checkpoint_ns = config["configurable"].get("checkpoint_ns", "")
checkpoint_id = config["configurable"]["checkpoint_id"]
outer_key = (thread_id, checkpoint_ns, checkpoint_id)
outer_writes_ = self.writes.get(outer_key)
for idx, (c, v) in enumerate(writes):
inner_key = (task_id, WRITES_IDX_MAP.get(c, idx))
if inner_key[1] >= 0 and outer_writes_ and inner_key in outer_writes_:
continue
self.writes[outer_key][inner_key] = (task_id, c, self.serde.dumps_typed(v))
async def aget_tuple(self, config: RunnableConfig) -> Optional[CheckpointTuple]:
@@ -474,3 +489,76 @@ class MemorySaver(
next_v = current_v + 1
next_h = random.random()
return f"{next_v:032}.{next_h:016}"
class PersistentDict(defaultdict):
"""Persistent dictionary with an API compatible with shelve and anydbm.
The dict is kept in memory, so the dictionary operations run as fast as
a regular dictionary.
Write to disk is delayed until close or sync (similar to gdbm's fast mode).
Input file format is automatically discovered.
Output file format is selectable between pickle, json, and csv.
All three serialization formats are backed by fast C implementations.
Adapted from https://code.activestate.com/recipes/576642-persistent-dict-with-multiple-standard-file-format/
"""
def __init__(self, *args: Any, filename: str, **kwds: Any) -> None:
self.flag = "c" # r=readonly, c=create, or n=new
self.mode = None # None or an octal triple like 0644
self.format = "pickle" # 'csv', 'json', or 'pickle'
self.filename = filename
super().__init__(*args, **kwds)
def sync(self) -> None:
"Write dict to disk"
if self.flag == "r":
return
tempname = self.filename + ".tmp"
fileobj = open(tempname, "wb" if self.format == "pickle" else "w")
try:
self.dump(fileobj)
except Exception:
os.remove(tempname)
raise
finally:
fileobj.close()
shutil.move(tempname, self.filename) # atomic commit
if self.mode is not None:
os.chmod(self.filename, self.mode)
def close(self) -> None:
self.sync()
self.clear()
def __enter__(self) -> "PersistentDict":
return self
def __exit__(self, *exc_info: Any) -> None:
self.close()
def dump(self, fileobj: Any) -> None:
if self.format == "pickle":
pickle.dump(dict(self), fileobj, 2)
else:
raise NotImplementedError("Unknown format: " + repr(self.format))
def load(self) -> None:
# try formats from most restrictive to least restrictive
if self.flag == "n":
return
with open(self.filename, "rb" if self.format == "pickle" else "r") as fileobj:
for loader in (pickle.load,):
fileobj.seek(0)
try:
return self.update(loader(fileobj))
except EOFError:
return
except Exception:
logging.error(f"Failed to load file: {fileobj.name}")
raise
raise ValueError("File not in a supported f ormat")
@@ -11,6 +11,8 @@ from typing_extensions import Self
ERROR = "__error__"
SCHEDULED = "__scheduled__"
INTERRUPT = "__interrupt__"
RESUME = "__resume__"
TASKS = "__pregel_tasks"
Value = TypeVar("Value", covariant=True)
+720 -105
View File
@@ -1,12 +1,27 @@
"""Base classes and types for persistent key-value stores.
Stores enable persistence and memory that can be shared across threads,
scoped to user IDs, assistant IDs, or other arbitrary namespaces.
Stores provide long-term memory that persists across threads and conversations.
Supports hierarchical namespaces, key-value storage, and optional vector search.
Core types:
- BaseStore: Store interface with sync/async operations
- Item: Stored key-value pairs with metadata
- Op: Get/Put/Search/List operations
"""
from abc import ABC, abstractmethod
from datetime import datetime
from typing import Any, Iterable, Literal, NamedTuple, Optional, Union, cast
from typing import Any, Iterable, Literal, NamedTuple, Optional, TypedDict, Union, cast
from langchain_core.embeddings import Embeddings
from langgraph.store.base.embed import (
AEmbeddingsFunc,
EmbeddingsFunc,
ensure_embeddings,
get_text_at_path,
tokenize_path,
)
class Item:
@@ -73,112 +88,506 @@ class Item:
}
class SearchItem(Item):
"""Represents an item returned from a search operation with additional metadata."""
__slots__ = ("score",)
def __init__(
self,
namespace: tuple[str, ...],
key: str,
value: dict[str, Any],
created_at: datetime,
updated_at: datetime,
score: Optional[float] = None,
) -> None:
"""Initialize a result item.
Args:
namespace: Hierarchical path to the item.
key: Unique identifier within the namespace.
value: The stored value.
created_at: When the item was first created.
updated_at: When the item was last updated.
score: Relevance/similarity score if from a ranked operation.
"""
super().__init__(
value=value,
key=key,
namespace=namespace,
created_at=created_at,
updated_at=updated_at,
)
self.score = score
def dict(self) -> dict:
result = super().dict()
result["score"] = self.score
return result
class GetOp(NamedTuple):
"""Operation to retrieve an item by namespace and key."""
"""Operation to retrieve a specific item by its namespace and key.
This operation allows precise retrieval of stored items using their full path
(namespace) and unique identifier (key) combination.
???+ example "Examples"
Basic item retrieval:
```python
GetOp(namespace=("users", "profiles"), key="user123")
GetOp(namespace=("cache", "embeddings"), key="doc456")
```
"""
namespace: tuple[str, ...]
"""Hierarchical path for the item."""
"""Hierarchical path that uniquely identifies the item's location.
???+ example "Examples"
```python
("users",) # Root level users namespace
("users", "profiles") # Profiles within users namespace
```
"""
key: str
"""Unique identifier within the namespace."""
"""Unique identifier for the item within its specific namespace.
???+ example "Examples"
```python
"user123" # For a user profile
"doc456" # For a document
```
"""
class SearchOp(NamedTuple):
"""Operation to search for items within a namespace prefix."""
"""Operation to search for items within a specified namespace hierarchy.
This operation supports both structured filtering and natural language search
within a given namespace prefix. It provides pagination through limit and offset
parameters.
Note:
Natural language search support depends on your store implementation.
???+ example "Examples"
Search with filters and pagination:
```python
SearchOp(
namespace_prefix=("documents",),
filter={"type": "report", "status": "active"},
limit=5,
offset=10
)
```
Natural language search:
```python
SearchOp(
namespace_prefix=("users", "content"),
query="technical documentation about APIs",
limit=20
)
```
"""
namespace_prefix: tuple[str, ...]
"""Hierarchical path prefix to search within."""
"""Hierarchical path prefix defining the search scope.
???+ example "Examples"
```python
() # Search entire store
("documents",) # Search all documents
("users", "content") # Search within user content
```
"""
filter: Optional[dict[str, Any]] = None
"""Key-value pairs to filter results."""
"""Key-value pairs for filtering results based on exact matches or comparison operators.
The filter supports both exact matches and operator-based comparisons.
Supported Operators:
- $eq: Equal to (same as direct value comparison)
- $ne: Not equal to
- $gt: Greater than
- $gte: Greater than or equal to
- $lt: Less than
- $lte: Less than or equal to
???+ example "Examples"
Simple exact match:
```python
{"status": "active"}
```
Comparison operators:
```python
{"score": {"$gt": 4.99}} # Score greater than 4.99
```
Multiple conditions:
```python
{
"score": {"$gte": 3.0},
"color": "red"
}
```
"""
limit: int = 10
"""Maximum number of items to return."""
"""Maximum number of items to return in the search results."""
offset: int = 0
"""Number of items to skip before returning results."""
"""Number of matching items to skip for pagination."""
query: Optional[str] = None
"""Natural language search query for semantic search capabilities.
class PutOp(NamedTuple):
"""Operation to store, update, or delete an item."""
namespace: tuple[str, ...]
"""Hierarchical path for the item.
Represented as a tuple of strings, allowing for nested categorization.
For example: ("documents", "user123")
"""
key: str
"""Unique identifier for the document.
Should be distinct within its namespace.
"""
value: Optional[dict[str, Any]]
"""Data to be stored, or None to delete the item.
Schema:
- Should be a dictionary where:
- Keys are strings representing field names
- Values can be of any serializable type
- If None, it indicates that the item should be deleted
???+ example "Examples"
- "technical documentation about REST APIs"
- "machine learning papers from 2023"
"""
NameSpacePath = tuple[Union[str, Literal["*"]], ...]
# Type representing a namespace path that can include wildcards
NamespacePath = tuple[Union[str, Literal["*"]], ...]
"""A tuple representing a namespace path that can include wildcards.
???+ example "Examples"
```python
("users",) # Exact users namespace
("documents", "*") # Any sub-namespace under documents
("cache", "*", "v1") # Any cache category with v1 version
```
"""
# Type for specifying how to match namespaces
NamespaceMatchType = Literal["prefix", "suffix"]
"""Specifies how to match namespace paths.
Values:
"prefix": Match from the start of the namespace
"suffix": Match from the end of the namespace
"""
class MatchCondition(NamedTuple):
"""Represents a single match condition."""
"""Represents a pattern for matching namespaces in the store.
This class combines a match type (prefix or suffix) with a namespace path
pattern that can include wildcards to flexibly match different namespace
hierarchies.
???+ example "Examples"
Prefix matching:
```python
MatchCondition(match_type="prefix", path=("users", "profiles"))
```
Suffix matching with wildcard:
```python
MatchCondition(match_type="suffix", path=("cache", "*"))
```
Simple suffix matching:
```python
MatchCondition(match_type="suffix", path=("v1",))
```
"""
match_type: NamespaceMatchType
path: NameSpacePath
"""Type of namespace matching to perform."""
path: NamespacePath
"""Namespace path pattern that can include wildcards."""
class ListNamespacesOp(NamedTuple):
"""Operation to list namespaces with optional match conditions."""
"""Operation to list and filter namespaces in the store.
This operation allows exploring the organization of data, finding specific
collections, and navigating the namespace hierarchy.
???+ example "Examples"
List all namespaces under the "documents" path:
```python
ListNamespacesOp(
match_conditions=(MatchCondition(match_type="prefix", path=("documents",)),),
max_depth=2
)
```
List all namespaces that end with "v1":
```python
ListNamespacesOp(
match_conditions=(MatchCondition(match_type="suffix", path=("v1",)),),
limit=50
)
```
"""
match_conditions: Optional[tuple[MatchCondition, ...]] = None
"""A tuple of match conditions to apply to namespaces."""
"""Optional conditions for filtering namespaces.
???+ example "Examples"
All user namespaces:
```python
(MatchCondition(match_type="prefix", path=("users",)),)
```
All namespaces that start with "docs" and end with "draft":
```python
(
MatchCondition(match_type="prefix", path=("docs",)),
MatchCondition(match_type="suffix", path=("draft",))
)
```
"""
max_depth: Optional[int] = None
"""Return namespaces up to this depth in the hierarchy."""
"""Maximum depth of namespace hierarchy to return.
Note:
Namespaces deeper than this level will be truncated.
"""
limit: int = 100
"""Maximum number of namespaces to return."""
offset: int = 0
"""Number of namespaces to skip before returning results."""
"""Number of namespaces to skip for pagination."""
class PutOp(NamedTuple):
"""Operation to store, update, or delete an item in the store.
This class represents a single operation to modify the store's contents,
whether adding new items, updating existing ones, or removing them.
"""
namespace: tuple[str, ...]
"""Hierarchical path that identifies the location of the item.
The namespace acts as a folder-like structure to organize items.
Each element in the tuple represents one level in the hierarchy.
???+ example "Examples"
Root level documents
```python
("documents",)
```
User-specific documents
```python
("documents", "user123")
```
Nested cache structure
```python
("cache", "embeddings", "v1")
```
"""
key: str
"""Unique identifier for the item within its namespace.
The key must be unique within the specific namespace to avoid conflicts.
Together with the namespace, it forms a complete path to the item.
Example:
If namespace is ("documents", "user123") and key is "report1",
the full path would effectively be "documents/user123/report1"
"""
value: Optional[dict[str, Any]]
"""The data to store, or None to mark the item for deletion.
The value must be a dictionary with string keys and JSON-serializable values.
Setting this to None signals that the item should be deleted.
Example:
{
"field1": "string value",
"field2": 123,
"nested": {"can": "contain", "any": "serializable data"}
}
"""
index: Optional[Union[Literal[False], list[str]]] = None # type: ignore[assignment]
"""Controls how the item's fields are indexed for search operations.
Indexing configuration determines how the item can be found through search:
- None (default): Uses the store's default indexing configuration (if provided)
- False: Disables indexing for this item
- list[str]: Specifies which json path fields to index for search
The item remains accessible through direct get() operations regardless of indexing.
When indexed, fields can be searched using natural language queries through
vector similarity search (if supported by the store implementation).
Path Syntax:
- Simple field access: "field"
- Nested fields: "parent.child.grandchild"
- Array indexing:
- Specific index: "array[0]"
- Last element: "array[-1]"
- All elements (each individually): "array[*]"
???+ example "Examples"
- None - Use store defaults (whole item)
- list[str] - List of fields to index
```python
[
"metadata.title", # Nested field access
"context[*].content", # Index content from all context as separate vectors
"authors[0].name", # First author's name
"revisions[-1].changes", # Most recent revision's changes
"sections[*].paragraphs[*].text", # All text from all paragraphs in all sections
"metadata.tags[*]", # All tags in metadata
]
```
"""
Op = Union[GetOp, SearchOp, PutOp, ListNamespacesOp]
Result = Union[Item, list[Item], list[tuple[str, ...]], None]
Result = Union[Item, list[Item], list[SearchItem], list[tuple[str, ...]], None]
class InvalidNamespaceError(ValueError):
"""Provided namespace is invalid."""
def _validate_namespace(namespace: tuple[str, ...]) -> None:
if not namespace:
raise InvalidNamespaceError("Namespace cannot be empty.")
for label in namespace:
if not isinstance(label, str):
raise InvalidNamespaceError(
f"Invalid namespace label '{label}' found in {namespace}. Namespace labels"
f" must be strings, but got {type(label).__name__}."
)
if "." in label:
raise InvalidNamespaceError(
f"Invalid namespace label '{label}' found in {namespace}. Namespace labels cannot contain periods ('.')."
)
elif not label:
raise InvalidNamespaceError(
f"Namespace labels cannot be empty strings. Got {label} in {namespace}"
)
if namespace[0] == "langgraph":
raise InvalidNamespaceError(
f'Root label for namespace cannot be "langgraph". Got: {namespace}'
class IndexConfig(TypedDict, total=False):
"""Configuration for indexing documents for semantic search in the store."""
dims: int
"""Number of dimensions in the embedding vectors.
Common embedding models have the following dimensions:
- openai:text-embedding-3-large: 3072
- openai:text-embedding-3-small: 1536
- openai:text-embedding-ada-002: 1536
- cohere:embed-english-v3.0: 1024
- cohere:embed-english-light-v3.0: 384
- cohere:embed-multilingual-v3.0: 1024
- cohere:embed-multilingual-light-v3.0: 384
"""
embed: Union[Embeddings, EmbeddingsFunc, AEmbeddingsFunc]
"""Optional function to generate embeddings from text.
Can be specified in three ways:
1. A LangChain Embeddings instance
2. A synchronous embedding function (EmbeddingsFunc)
3. An asynchronous embedding function (AEmbeddingsFunc)
???+ example "Examples"
Using LangChain's initialization with InMemoryStore:
```python
from langchain.embeddings import init_embeddings
from langgraph.store.memory import InMemoryStore
store = InMemoryStore(
index={
"dims": 1536,
"embed": init_embeddings("openai:text-embedding-3-small")
}
)
```
Using a custom embedding function with InMemoryStore:
```python
from openai import OpenAI
from langgraph.store.memory import InMemoryStore
client = OpenAI()
def embed_texts(texts: list[str]) -> list[list[float]]:
response = client.embeddings.create(
model="text-embedding-3-small",
input=texts
)
return [e.embedding for e in response.data]
store = InMemoryStore(
index={
"dims": 1536,
"embed": embed_texts
}
)
```
Using an asynchronous embedding function with InMemoryStore:
```python
from openai import AsyncOpenAI
from langgraph.store.memory import InMemoryStore
client = AsyncOpenAI()
async def aembed_texts(texts: list[str]) -> list[list[float]]:
response = await client.embeddings.create(
model="text-embedding-3-small",
input=texts
)
return [e.embedding for e in response.data]
store = InMemoryStore(
index={
"dims": 1536,
"embed": aembed_texts
}
)
```
"""
fields: Optional[list[str]]
"""Fields to extract text from for embedding generation.
Controls which parts of stored items are embedded for semantic search. Follows JSON path syntax:
- ["$"]: Embeds the entire JSON object as one vector (default)
- ["field1", "field2"]: Embeds specific top-level fields
- ["parent.child"]: Embeds nested fields using dot notation
- ["array[*].field"]: Embeds field from each array element separately
Note:
You can always override this behavior when storing an item using the
`index` parameter in the `put` or `aput` operations.
???+ example "Examples"
```python
# Embed entire document (default)
fields=["$"]
# Embed specific fields
fields=["text", "summary"]
# Embed nested fields
fields=["metadata.title", "content.body"]
# Embed from arrays
fields=["messages[*].content"] # Each message content separately
fields=["context[0].text"] # First context item's text
```
Note:
- Fields missing from a document are skipped
- Array notation creates separate embeddings for each element
- Complex nested paths are supported (e.g., "a.b[*].c.d")
"""
class BaseStore(ABC):
@@ -231,33 +640,109 @@ class BaseStore(ABC):
namespace_prefix: tuple[str, ...],
/,
*,
query: Optional[str] = None,
filter: Optional[dict[str, Any]] = None,
limit: int = 10,
offset: int = 0,
) -> list[Item]:
) -> list[SearchItem]:
"""Search for items within a namespace prefix.
Args:
namespace_prefix: Hierarchical path prefix to search within.
query: Optional query for natural language search.
filter: Key-value pairs to filter results.
limit: Maximum number of items to return.
offset: Number of items to skip before returning results.
Returns:
List of items matching the search criteria.
"""
return self.batch([SearchOp(namespace_prefix, filter, limit, offset)])[0]
def put(self, namespace: tuple[str, ...], key: str, value: dict[str, Any]) -> None:
"""Store or update an item.
???+ example "Examples"
Basic filtering:
```python
# Search for documents with specific metadata
results = store.search(
("docs",),
filter={"type": "article", "status": "published"}
)
```
Natural language search (requires vector store implementation):
```python
# Initialize store with embedding configuration
store = YourStore( # e.g., InMemoryStore, AsyncPostgresStore
index={
"dims": 1536, # embedding dimensions
"embed": your_embedding_function, # function to create embeddings
"fields": ["text"] # fields to embed. Defaults to ["$"]
}
)
# Search for semantically similar documents
results = store.search(
("docs",),
query="machine learning applications in healthcare",
filter={"type": "research_paper"},
limit=5
)
```
Note: Natural language search support depends on your store implementation
and requires proper embedding configuration.
"""
return self.batch([SearchOp(namespace_prefix, filter, limit, offset, query)])[0]
def put(
self,
namespace: tuple[str, ...],
key: str,
value: dict[str, Any],
index: Optional[Union[Literal[False], list[str]]] = None,
) -> None:
"""Store or update an item in the store.
Args:
namespace: Hierarchical path for the item.
key: Unique identifier within the namespace.
value: Dictionary containing the item's data.
namespace: Hierarchical path for the item, represented as a tuple of strings.
Example: ("documents", "user123")
key: Unique identifier within the namespace. Together with namespace forms
the complete path to the item.
value: Dictionary containing the item's data. Must contain string keys
and JSON-serializable values.
index: Controls how the item's fields are indexed for search:
- None (default): Use `fields` you configured when creating the store (if any)
If you do not initialize the store with indexing capabilities,
the `index` parameter will be ignored
- False: Disable indexing for this item
- list[str]: List of field paths to index, supporting:
- Nested fields: "metadata.title"
- Array access: "chapters[*].content" (each indexed separately)
- Specific indices: "authors[0].name"
Note:
Indexing support depends on your store implementation.
If you do not initialize the store with indexing capabilities,
the `index` parameter will be ignored.
???+ example "Examples"
Store item. Indexing depends on how you configure the store.
```python
store.put(("docs",), "report", {"memory": "Will likes ai"})
```
Do not index item for semantic search. Still accessible through get()
and search() operations but won't have a vector representation.
```python
store.put(("docs",), "report", {"memory": "Will likes ai"}, index=False)
```
Index specific fields for search.
```python
store.put(("docs",), "report", {"memory": "Will likes ai"}, index=["memory"])
```
"""
_validate_namespace(namespace)
self.batch([PutOp(namespace, key, value)])
self.batch([PutOp(namespace, key, value, index=index)])
def delete(self, namespace: tuple[str, ...], key: str) -> None:
"""Delete an item.
@@ -271,8 +756,8 @@ class BaseStore(ABC):
def list_namespaces(
self,
*,
prefix: Optional[NameSpacePath] = None,
suffix: Optional[NameSpacePath] = None,
prefix: Optional[NamespacePath] = None,
suffix: Optional[NamespacePath] = None,
max_depth: Optional[int] = None,
limit: int = 100,
offset: int = 0,
@@ -286,7 +771,7 @@ class BaseStore(ABC):
prefix (Optional[Tuple[str, ...]]): Filter namespaces that start with this path.
suffix (Optional[Tuple[str, ...]]): Filter namespaces that end with this path.
max_depth (Optional[int]): Return namespaces up to this depth in the hierarchy.
Namespaces deeper than this level will be truncated to this depth.
Namespaces deeper than this level will be truncated.
limit (int): Maximum number of namespaces to return (default 100).
offset (int): Number of namespaces to skip for pagination (default 0).
@@ -294,16 +779,18 @@ class BaseStore(ABC):
List[Tuple[str, ...]]: A list of namespace tuples that match the criteria.
Each tuple represents a full namespace path up to `max_depth`.
Examples:
???+ example "Examples":
Setting max_depth=3. Given the namespaces:
# ("a", "b", "c")
# ("a", "b", "d", "e")
# ("a", "b", "d", "i")
# ("a", "b", "f")
# ("a", "c", "f")
store.list_namespaces(prefix=("a", "b"), max_depth=3)
# [("a", "b", "c"), ("a", "b", "d"), ("a", "b", "f")]
```python
# Example if you have the following namespaces:
# ("a", "b", "c")
# ("a", "b", "d", "e")
# ("a", "b", "d", "i")
# ("a", "b", "f")
# ("a", "c", "f")
store.list_namespaces(prefix=("a", "b"), max_depth=3)
# [("a", "b", "c"), ("a", "b", "d"), ("a", "b", "f")]
```
"""
match_conditions = []
if prefix:
@@ -336,37 +823,121 @@ class BaseStore(ABC):
namespace_prefix: tuple[str, ...],
/,
*,
query: Optional[str] = None,
filter: Optional[dict[str, Any]] = None,
limit: int = 10,
offset: int = 0,
) -> list[Item]:
) -> list[SearchItem]:
"""Asynchronously search for items within a namespace prefix.
Args:
namespace_prefix: Hierarchical path prefix to search within.
query: Optional query for natural language search.
filter: Key-value pairs to filter results.
limit: Maximum number of items to return.
offset: Number of items to skip before returning results.
Returns:
List of items matching the search criteria.
???+ example "Examples"
Basic filtering:
```python
# Search for documents with specific metadata
results = await store.asearch(
("docs",),
filter={"type": "article", "status": "published"}
)
```
Natural language search (requires vector store implementation):
```python
# Initialize store with embedding configuration
store = YourStore( # e.g., InMemoryStore, AsyncPostgresStore
index={
"dims": 1536, # embedding dimensions
"embed": your_embedding_function, # function to create embeddings
"fields": ["text"] # fields to embed
}
)
# Search for semantically similar documents
results = await store.asearch(
("docs",),
query="machine learning applications in healthcare",
filter={"type": "research_paper"},
limit=5
)
```
Note: Natural language search support depends on your store implementation
and requires proper embedding configuration.
"""
return (await self.abatch([SearchOp(namespace_prefix, filter, limit, offset)]))[
0
]
return (
await self.abatch(
[SearchOp(namespace_prefix, filter, limit, offset, query)]
)
)[0]
async def aput(
self, namespace: tuple[str, ...], key: str, value: dict[str, Any]
self,
namespace: tuple[str, ...],
key: str,
value: dict[str, Any],
index: Optional[Union[Literal[False], list[str]]] = None,
) -> None:
"""Asynchronously store or update an item.
"""Asynchronously store or update an item in the store.
Args:
namespace: Hierarchical path for the item.
key: Unique identifier within the namespace.
value: Dictionary containing the item's data.
namespace: Hierarchical path for the item, represented as a tuple of strings.
Example: ("documents", "user123")
key: Unique identifier within the namespace. Together with namespace forms
the complete path to the item.
value: Dictionary containing the item's data. Must contain string keys
and JSON-serializable values.
index: Controls how the item's fields are indexed for search:
- None (default): Use `fields` you configured when creating the store (if any)
If you do not initialize the store with indexing capabilities,
the `index` parameter will be ignored
- False: Disable indexing for this item
- list[str]: List of field paths to index, supporting:
- Nested fields: "metadata.title"
- Array access: "chapters[*].content" (each indexed separately)
- Specific indices: "authors[0].name"
Note:
Indexing support depends on your store implementation.
If you do not initialize the store with indexing capabilities,
the `index` parameter will be ignored.
???+ example "Examples"
Store item. Indexing depends on how you configure the store.
```python
await store.aput(("docs",), "report", {"memory": "Will likes ai"})
```
Do not index item for semantic search. Still accessible through get()
and search() operations but won't have a vector representation.
```python
await store.aput(("docs",), "report", {"memory": "Will likes ai"}, index=False)
```
Index specific fields for search (if store configured to index items):
```python
await store.aput(
("docs",),
"report",
{
"memory": "Will likes ai",
"context": [{"content": "..."}, {"content": "..."}]
},
index=["memory", "context[*].content"]
)
```
"""
_validate_namespace(namespace)
await self.abatch([PutOp(namespace, key, value)])
await self.abatch([PutOp(namespace, key, value, index=index)])
async def adelete(self, namespace: tuple[str, ...], key: str) -> None:
"""Asynchronously delete an item.
@@ -380,8 +951,8 @@ class BaseStore(ABC):
async def alist_namespaces(
self,
*,
prefix: Optional[NameSpacePath] = None,
suffix: Optional[NameSpacePath] = None,
prefix: Optional[NamespacePath] = None,
suffix: Optional[NamespacePath] = None,
max_depth: Optional[int] = None,
limit: int = 100,
offset: int = 0,
@@ -403,16 +974,19 @@ class BaseStore(ABC):
List[Tuple[str, ...]]: A list of namespace tuples that match the criteria.
Each tuple represents a full namespace path up to `max_depth`.
Examples:
???+ example "Examples"
Setting max_depth=3 with existing namespaces:
```python
# Given the following namespaces:
# ("a", "b", "c")
# ("a", "b", "d", "e")
# ("a", "b", "d", "i")
# ("a", "b", "f")
# ("a", "c", "f")
Setting max_depth=3. Given the namespaces:
# ("a", "b", "c")
# ("a", "b", "d", "e")
# ("a", "b", "d", "i")
# ("a", "b", "f")
# ("a", "c", "f")
await store.alist_namespaces(prefix=("a", "b"), max_depth=3)
# [("a", "b", "c"), ("a", "b", "d"), ("a", "b", "f")]
await store.alist_namespaces(prefix=("a", "b"), max_depth=3)
# Returns: [("a", "b", "c"), ("a", "b", "d"), ("a", "b", "f")]
```
"""
match_conditions = []
if prefix:
@@ -427,3 +1001,44 @@ class BaseStore(ABC):
offset=offset,
)
return (await self.abatch([op]))[0]
def _validate_namespace(namespace: tuple[str, ...]) -> None:
if not namespace:
raise InvalidNamespaceError("Namespace cannot be empty.")
for label in namespace:
if not isinstance(label, str):
raise InvalidNamespaceError(
f"Invalid namespace label '{label}' found in {namespace}. Namespace labels"
f" must be strings, but got {type(label).__name__}."
)
if "." in label:
raise InvalidNamespaceError(
f"Invalid namespace label '{label}' found in {namespace}. Namespace labels cannot contain periods ('.')."
)
elif not label:
raise InvalidNamespaceError(
f"Namespace labels cannot be empty strings. Got {label} in {namespace}"
)
if namespace[0] == "langgraph":
raise InvalidNamespaceError(
f'Root label for namespace cannot be "langgraph". Got: {namespace}'
)
__all__ = [
"BaseStore",
"Item",
"Op",
"PutOp",
"GetOp",
"SearchOp",
"ListNamespacesOp",
"MatchCondition",
"NamespacePath",
"NamespaceMatchType",
"Embeddings",
"ensure_embeddings",
"tokenize_path",
"get_text_at_path",
]
+84 -5
View File
@@ -1,13 +1,17 @@
import asyncio
import weakref
from typing import Any, Optional
from typing import Any, Literal, Optional, Union
from langgraph.store.base import (
BaseStore,
GetOp,
Item,
ListNamespacesOp,
MatchCondition,
NamespacePath,
Op,
PutOp,
SearchItem,
SearchOp,
_validate_namespace,
)
@@ -40,12 +44,13 @@ class AsyncBatchedBaseStore(BaseStore):
namespace_prefix: tuple[str, ...],
/,
*,
query: Optional[str] = None,
filter: Optional[dict[str, Any]] = None,
limit: int = 10,
offset: int = 0,
) -> list[Item]:
) -> list[SearchItem]:
fut = self._loop.create_future()
self._aqueue[fut] = SearchOp(namespace_prefix, filter, limit, offset)
self._aqueue[fut] = SearchOp(namespace_prefix, filter, limit, offset, query)
return await fut
async def aput(
@@ -53,10 +58,11 @@ class AsyncBatchedBaseStore(BaseStore):
namespace: tuple[str, ...],
key: str,
value: dict[str, Any],
index: Optional[Union[Literal[False], list[str]]] = None,
) -> None:
_validate_namespace(namespace)
fut = self._loop.create_future()
self._aqueue[fut] = PutOp(namespace, key, value)
self._aqueue[fut] = PutOp(namespace, key, value, index)
return await fut
async def adelete(
@@ -68,6 +74,74 @@ class AsyncBatchedBaseStore(BaseStore):
self._aqueue[fut] = PutOp(namespace, key, None)
return await fut
async def alist_namespaces(
self,
*,
prefix: Optional[NamespacePath] = None,
suffix: Optional[NamespacePath] = None,
max_depth: Optional[int] = None,
limit: int = 100,
offset: int = 0,
) -> list[tuple[str, ...]]:
fut = self._loop.create_future()
match_conditions = []
if prefix:
match_conditions.append(MatchCondition(match_type="prefix", path=prefix))
if suffix:
match_conditions.append(MatchCondition(match_type="suffix", path=suffix))
op = ListNamespacesOp(
match_conditions=tuple(match_conditions),
max_depth=max_depth,
limit=limit,
offset=offset,
)
self._aqueue[fut] = op
return await fut
def _dedupe_ops(values: list[Op]) -> tuple[Optional[list[int]], list[Op]]:
"""Dedupe operations while preserving order for results.
Args:
values: List of operations to dedupe
Returns:
Tuple of (listen indices, deduped operations)
where listen indices map deduped operation results back to original positions
"""
if len(values) <= 1:
return None, list(values)
dedupped: list[Op] = []
listen: list[int] = []
puts: dict[tuple[tuple[str, ...], str], int] = {}
for op in values:
if isinstance(op, (GetOp, SearchOp, ListNamespacesOp)):
try:
listen.append(dedupped.index(op))
except ValueError:
listen.append(len(dedupped))
dedupped.append(op)
elif isinstance(op, PutOp):
putkey = (op.namespace, op.key)
if putkey in puts:
# Overwrite previous put
ix = puts[putkey]
dedupped[ix] = op
listen.append(ix)
else:
puts[putkey] = len(dedupped)
listen.append(len(dedupped))
dedupped.append(op)
else: # Any new ops will be treated regularly
listen.append(len(dedupped))
dedupped.append(op)
return listen, dedupped
async def _run(
aqueue: dict[asyncio.Future, Op], store: weakref.ReferenceType[BaseStore]
@@ -81,7 +155,12 @@ async def _run(
taken = aqueue.copy()
# action each operation
try:
results = await s.abatch(taken.values())
values = list(taken.values())
listen, dedupped = _dedupe_ops(values)
results = await s.abatch(dedupped)
if listen is not None:
results = [results[ix] for ix in listen]
# set the results of each operation
for fut, result in zip(taken, results):
fut.set_result(result)
Loaded 100 of 186 files, more files were not shown because too many files have changed in this diff. Show more