Repository navigation
docs: build_graph_now() blocks searches while it runs; agents that write as they go need no setting - #191
Merged
Conversation
…ite as they go need no setting (#190) The vectors page now says that searches on an index wait for build_graph_now() while inserts carry on, how Ctrl-C and a kill behave during it, that the background rebuild starts on the first search after the threshold, and gives the write-per-turn agent a short section: the default needs nothing; building right before the model call lowers the search p99 at the cost of waiting for the build. Numbers from the agent-memory study (ab.py, 12 pairs per package); the robustness lines from probes on both packages. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #190
The "Rebuild the graph" section of
how-to/vectors.adocgains three things:build_graph_now()paragraph now says that searches on that index wait until it returns while inserts carry on, that Ctrl-C takes effect only when it returns, and that a process killed during the build leaves a consistent database;build_graph_now()right before a step without searches (such as the call to the language model), with a table of what that bought and cost on each package.Sources: the timing numbers come from the agent-memory study (timed with
ab.py --noise, 12 clean pairs per package, both packages of 26.11.1.dev0); the table is generated from its score files and every figure was checked against them. The robustness sentences come from probes on both packages of the matched build (bindingsdd45b53947, enginee353330c5c): searches waited for the whole build with the GIL released, inserts kept going, SIGKILL and SIGINT mid-build were followed by a cleanCHECK DATABASE. The page carries no probe timings (onlyab.pyfigures go into the docs).Checks: pre-commit passes on the file; the Antora build runs in the docs workflow.
🤖 Generated with Claude Code