September 2026 Summaries
18 posts from Braintrust
Filter
Month:
Year:
Post Summaries
Back to Blog
Web search APIs enable AI agents to retrieve ranked web results, excerpts, full-page content, and source metadata for evidence-based answers, with providers differing in retrieval quality, freshness, latency, cost, extraction capabilities, and MCP support. The guide compares Parallel, You.com, Exa, TinyFish, Firecrawl, Brave Search API, and Tavily, highlighting use cases such as rapid iterative searches, current-events research, semantic discovery, browser-based interaction, crawling, independent-index ranking controls, and framework-oriented RAG workflows. Direct API integrations offer detailed control over search parameters and response handling, while MCP servers allow compatible agent clients to discover and invoke search tools but consume context tokens through tool descriptions and returned content. Provider selection should be tested on representative tasks under consistent models, prompts, and search budgets, with evaluations measuring answer accuracy, source support, end-to-end latency, and cost per correct answer. Ongoing tracing and production monitoring are recommended because changing web content, retrieval behavior, and task types can affect performance over time.
Sep 26, 2026
4,154 words in the original blog post.
Prompt changes can alter application behavior without conventional code deployment safeguards, so the text describes a CI/CD approach for managing them through versioning, evaluation, approval, staged rollout, and monitoring. Using Braintrust, each prompt revision is assigned an immutable version identifier and paired with its model settings, parameters, dataset version, and code commit to make results reproducible across changes authored in Git, a prompt registry, or a Playground. Candidate prompts are evaluated against production baselines using production-derived datasets, deterministic checks for structured requirements, model-based quality scoring, and measurements of latency and cost; critical failures can block promotion, while mixed or secondary results may require human review. Validated versions progress through development and staging to production via environment assignments, with pull-request checks and permissions supporting controlled approvals. Production releases can use canary routing, predefined rollback triggers, and restoration of prior versions if quality degrades. Online scoring, trace-level version attribution, alerts, and feedback of verified production failures into evaluation datasets extend release criteria into live traffic and support continual improvement of future prompt versions.
Sep 26, 2026
3,560 words in the original blog post.
Multi-agent AI systems can fail even when each individual agent passes isolated tests because coordination problems such as incomplete handoffs, shared-state conflicts, duplicated work, ownership loops, and unsupported final responses emerge only across the full workflow. Effective evaluation therefore requires representative, controlled tasks with resettable tools and shared state, verifiable final outcomes, and separate scoring for task completion, handoff completeness, state integrity, tool use, efficiency, safety, and termination. Testing should operate at agent, handoff, and system levels, using real upstream payloads and contracts that validate required fields, provenance, and formats before downstream agents act. Connected end-to-end traces that capture routing, model outputs, tool calls, state writes, and errors enable teams to identify the first decision responsible for a failed outcome, including across services through propagated trace context. Since valid systems may follow different action sequences, evaluations should enforce required dependencies and final-state constraints rather than a single fixed trajectory while detecting redundant actions, unsafe behavior, loops, and excess steps. Repeated trials reveal consistency issues hidden by single runs, and experiments should isolate changes to prompts, models, tools, or orchestration while retaining shared datasets and configuration metadata. The approach recommends enforcing high-signal evaluations in CI, monitoring sampled production traces, and converting confirmed production failures into regression cases so coordination defects become permanent release checks.
Sep 26, 2026
2,938 words in the original blog post.
Model routing can reduce LLM costs only when lower-priced models meet application-specific quality, safety, relevance, formatting, and latency requirements for distinct query classes. OpenRouter and LiteLLM provide routing mechanisms based on task classification, configured tiers, usage patterns, or adaptive feedback, but reliable production decisions require separate benchmarks using representative traffic, task-specific scorers, and defined quality thresholds. Braintrust supports this process by storing evaluation datasets, comparing baseline and candidate models under consistent conditions, setting release rules that account for both minimum pass rates and allowable declines from baseline performance, and connecting deployed traffic to evaluations through its gateway and tracing tools. The approach emphasizes grouping requests by expected output and failure consequences rather than superficial complexity, monitoring score, cost, and latency after deployment, and automatically reverting to an approved baseline if quality falls below a defined floor. An illustrative support-ticket example shows a mid-tier model maintaining 95% accuracy versus a 96% baseline while reducing classification costs by 80%, whereas a cheaper but less accurate candidate remains excluded.
Sep 26, 2026
2,603 words in the original blog post.
Prompt performance can deteriorate after deployment because production traffic, retrieved context, model behavior, tool schemas, and user patterns change even when prompt text does not. Effective monitoring requires attaching consistent prompt slug, version, model, environment, customer, task, and input metadata to production traces so teams can distinguish prompt regressions from changes elsewhere in the application. Teams should establish segment-specific baselines across complete traffic cycles, monitor quality, formatting, refusals, latency, token use, cost, and user feedback, and use sufficient sampling, percentile-based thresholds, and sustained alert conditions to avoid misleading results. When a regression appears, investigators should compare matched traffic segments, inspect failing traces and execution spans, identify shared input patterns, and test the same cases against prior and current prompt versions to isolate the cause. Confirmed production failures should become versioned evaluation cases and CI/CD regression tests, while staged rollouts and rapid rollback to validated prompt versions limit user impact. Braintrust supports this workflow by connecting versioned prompts, production traces, asynchronous scoring, dashboards, trace investigation, datasets, and deployment environments.
Sep 26, 2026
3,627 words in the original blog post.
Jev is TypeSafe’s AI model for rapid, structured semantic decisions, designed to classify or evaluate text within predefined answer sets rather than generate free-form language. It accepts textual state, including JSON, and supports Choice questions with up to 255 labels, Score questions using ordered rating levels, and Noul yes-or-no probability estimates, returning labels or scores alongside probabilities and, for Choice and Score, confidence measures. Its intended uses include support-ticket routing, evaluating AI-generated replies, RAG relevance checks, and agent-trace reviews, particularly where low latency and low input-token pricing make repeated judgments practical. Jev evaluates independent questions in parallel but cannot handle dependencies between questions, generate text or code, process non-text media, or reliably perform arithmetic, counting, and date comparisons. Although typed outputs prevent malformed responses, they do not ensure correct judgments or prevent prompt injection, so TypeSafe recommends testing against human-labeled examples and setting automation thresholds based on observed false approvals and rejections. As of September 2026, Jev 1.13 was available through Braintrust, TypeSafe direct access, and OpenRouter, with listed pricing of $0.042 per million input tokens and reported response times of roughly 70 to 500 milliseconds.
Sep 26, 2026
1,536 words in the original blog post.
Braintrust introduced Nitro, an asynchronous query engine for Brainstore designed to accelerate investigation of production agent traces stored in object storage, where large volumes of concurrent full-text searches can otherwise be constrained by network latency, CPU, and memory. Built around Tantivy’s index format, Nitro separates storage-read and compute scheduling, allowing many object-store requests to overlap without overloading compute workers, while also reducing requests through aggressive prefetching, coalescing nearby reads, and early filtering for phrase searches. In a three-day A/B test covering more than one million queries, Nitro made full-text searches over twice as fast on average and improved other queries by 15%, with selected cold-cache production workloads improving by roughly two to more than four times. A separate synthetic benchmark on 40 GB of text showed strong phrase-search performance relative to two unnamed observability vendors, although one competitor was faster on a span-count aggregate query and aggregate performance remains an identified area for improvement. Nitro is enabled automatically for Braintrust SaaS and BYOC customers and is available to self-hosted users from dataplane version 2.15.
Sep 24, 2026
2,081 words in the original blog post.
Braintrust’s new Patterns, Topics, enhanced Loop, and Debugger features are designed to connect production tracing, evaluation, investigation, and iteration for AI agents in a continuous feedback process. Patterns can automatically identify recurring agent failures from sampled traces even without preconfigured evaluators, investigate their prevalence more broadly, suggest ways to create evals, and be customized using an open-source Agent Behavior Spec; it is currently free in public preview aside from bring-your-own-model-key inference costs. Topics provides real-time trace clustering and nightly cluster regeneration to identify broad themes, while Loop can automate alerts or investigations and Debugger supports analysis of individual traces. The platform supports single-turn, trace-level, span-level, and session-level evaluation, allowing teams to assess outcomes and agent trajectories across multi-turn conversations regardless of whether they organize data as threads or traces. Teams can use discovered failures to create targeted evals, deploy fixes, and monitor whether problems decline over time, including for emerging agent and MCP-server use cases, though telemetry limitations remain for coding-agent interactions.
Sep 23, 2026
1,420 words in the original blog post.
LLM testing combines conventional software verification with evaluation of variable model outputs, since deterministic application components such as prompts, parsers, schemas, retrieval pipelines, tool wrappers, and orchestration can use fixed assertions, while response quality requires scored criteria for correctness, relevance, tone, safety, and other behaviors. A layered testing strategy includes unit, integration, end-to-end, behavioral, regression, performance, and security testing, with inexpensive deterministic checks run frequently and more costly model evaluations used during reviews and before release. Effective evaluation relies on versioned datasets, clear rubrics, code-based and model-based scorers, human review, and repeated trials to account for non-determinism, provider drift, and multiple acceptable answers. Regression testing compares prompts, models, and retrieval configurations against stable baselines using aggregate quality floors and per-case limits, while performance testing tracks latency, concurrency, reliability, and token costs. Security testing uses adversarial cases for prompt injection, jailbreaks, data leakage, and unauthorized tool use, retaining discovered vulnerabilities as permanent regression tests. In CI/CD, teams can run fast tests and sampled evaluations on pull requests, apply full quality, security, and performance gates before release, then use staged rollouts and production scoring to detect new failures and convert production traces into future test cases; Braintrust is presented as a platform for managing these datasets, scorers, experiments, traces, and release criteria.
Sep 20, 2026
3,908 words in the original blog post.
Prompt testing is a repeatable process for running a versioned prompt configuration, including its model, parameters, tools, output format, and retrieval context, against representative inputs with explicit expectations and consistent scoring to identify regressions before release. It evaluates task correctness, format compliance, safety boundaries, tool use, latency, and cost, using datasets that combine typical production requests, edge cases, known failures, and adversarial inputs; these datasets should be versioned and tagged to support reliable comparisons. Testing differs from broader prompt evaluation, production A/B testing, and deterministic unit testing, although all can complement one another. Scoring may use deterministic checks for schemas, labels, tool calls, and limits; model-based judges for qualities such as helpfulness or faithfulness; and targeted human review for calibration and disputed cases. Effective workflows compare saved experiment baselines at both aggregate and per-case levels, account for model variability through repeated trials, progress from exploratory playground testing to immutable experiment records and CI release gates, and turn traced production failures into future regression cases. The text presents Braintrust as a platform that unifies dataset management, scoring, experiment comparisons, CI integration, tracing, online evaluation, and cost monitoring, while noting that testing costs depend on dataset size, run frequency, scoring methods, model tokens, and retained trace data.
Sep 20, 2026
4,159 words in the original blog post.
A unified LLM API acts as an intermediary between applications and model providers, allowing developers to use one client structure, endpoint, credential path, and normalized request and response format across models such as OpenAI, Anthropic, Gemini, and hosted or self-managed providers. It translates provider-specific schemas, parameters, streaming events, errors, and usage data while often adding gateway functions such as credential management, logging, caching, rate limits, regional routing, retries, failover, cost attribution, and tracing. This approach can simplify experimentation, reduce provider-specific integration work, centralize observability and spending, and make model changes largely configuration-based. However, it does not make models fully interchangeable: native parameters, multimodal inputs, tool behavior, context limits, metadata, quotas, pricing, and output quality can differ substantially, while translation may silently omit or alter unsupported features. Applications requiring provider-native capabilities may need passthrough parameters, specialized headers, native SDK calls, or other controlled escape hatches, and teams should evaluate candidate models against representative production cases before switching.
Sep 20, 2026
3,481 words in the original blog post.
Context engineering is the request-time practice of assembling everything an LLM receives beyond its core model weights, including system instructions, examples, conversation history, retrieved documents, memory, tool outputs, user data, and application metadata. Unlike prompt engineering, which focuses on instructions, it manages the selection, ranking, freshness, ordering, formatting, compression, deduplication, conflict resolution, and token allocation of changing inputs within a limited context window. Effective workflows gather candidate information, filter and rerank it, resolve duplicates and contradictions, compress it to fit a defined budget, log the final payload, and evaluate both the context and resulting answer. Key measures include context precision and recall, groundedness, utilization, task success, token share, and freshness, while common failures include missing or ignored evidence, silent truncation, stale memory, contradictory sources, context bloat, permission leakage, and history crowding out relevant information. The text presents Braintrust as a platform for tracing assembled contexts, creating regression datasets from production failures, defining deterministic and model-based scorers, running ablation experiments, enforcing evaluation gates in CI, and monitoring context quality after deployment.
Sep 20, 2026
3,570 words in the original blog post.
Jev, TypeSafe’s System One API, enables applications and Braintrust evaluations to make narrow, typed decisions from unstructured inputs by returning constrained classifications or scores alongside probabilities and confidence values rather than prose. In Braintrust, it can be used as a judge scorer through a TypeSafe API key or, with enabled access, as a built-in model, allowing teams to evaluate outputs such as customer support responses against defined categories for accuracy, safety, completeness, and readiness. Its confidence and per-choice probability data can support review routing and threshold-based automation, although teams are advised to validate thresholds against their own observed accuracy before relying on them operationally. Developers can also instrument Jev calls through TypeSafe’s JavaScript or Python SDKs, with Braintrust tracing inputs, decision criteria, answers, token usage, latency, and model metadata. By exposing specific failure modes and structured evaluation outcomes, the integration is intended to help teams diagnose agent performance, refine scoring criteria, and improve production workflows, with TypeSafe reporting substantial speed and cost advantages in its own evaluations.
Sep 18, 2026
1,159 words in the original blog post.
Effective AI documentation provides shared expectations for product behavior, agent tools, APIs, SDKs, evaluations, and releases, helping teams reproduce tests, diagnose behavior changes, and prevent integration failures caused by outdated guidance. The comparison evaluates 10 documentation platforms using criteria including Git-based docs-as-code workflows, API-reference generation, machine-readable and agent-friendly formats, AI-assisted maintenance, search, versioning, governance, analytics, customization, and developer experience, with extra emphasis on maintenance and retrieval readiness. Mintlify is ranked first for combining MDX and Git workflows, OpenAPI and AsyncAPI support, AI-generated update proposals, semantic search, and outputs such as llms.txt, skill.md, and MCP servers. GitBook, ReadMe, and Fern offer alternatives for collaborative knowledge bases, interactive API documentation, and generated SDKs, while Docusaurus, MkDocs, and Read the Docs appeal to teams seeking self-hosted or open-source, versioned documentation workflows. Redocly and Stoplight focus on API governance, specification design, and validation, whereas Document360 emphasizes enterprise permissions, approval processes, and knowledge-base administration. The recommended choice depends on whether a team prioritizes AI-agent accessibility, API-first developer experience, strict OpenAPI governance, open-source hosting, collaborative editing, or enterprise content controls.
Sep 08, 2026
3,915 words in the original blog post.
Prompt injection is an attack in which untrusted user input or external content attempts to override an LLM application's instructions, either directly through messages or indirectly through retrieved documents, webpages, emails, or tool results. Runtime guardrails can block, modify, or allow requests, but their effectiveness must be measured with labeled datasets that reveal false positives and false negatives. The Braintrust workflow described uses an LLM-based binary classifier, offline evaluations against labeled prompt-injection examples, and iterative prompt refinements to improve detection, while emphasizing that small samples cannot establish production accuracy. In production, the detector can asynchronously score sampled traces without adding application latency, while separate runtime controls remain responsible for preventing harmful actions. Suspected incidents should be reviewed by humans, converted into regression tests, categorized by attack type, and used to expand the evaluation dataset over time. Monitoring injection-rate trends and configuring alerts can help identify potential campaigns or changing risks, although alerts on individual records do not replace baseline-based rate analysis. Because prompt injection cannot be fully eliminated when applications process untrusted content, sensitive actions should rely on external authorization, limited tool permissions, deterministic validation, or human approval rather than model output alone.
Sep 08, 2026
2,404 words in the original blog post.
AI agents require monitoring beyond conventional infrastructure signals because they can remain available while output quality declines, costs rise, or latency worsens due to model changes, prompt revisions, retries, tool failures, or growing context. The guidance recommends instrumenting complete agent traces with consistent metadata for environments, models, prompts, agents, tools, users, workloads, token usage, costs, timing, errors, and retries, while using child spans to capture model calls and orchestration steps. Quality should be measured through asynchronous online scoring, combining deterministic checks and LLM-based evaluators at span, trace, or group scope, with sampling rates chosen to provide reliable production signal. Braintrust alerts can use per-log SQL conditions for individual failures such as low scores, expensive runs, slow requests, or errors, and Time window alerts for aggregate measures such as percentiles, rates, and average scores. Alerts should be segmented by meaningful operational dimensions, calibrated from historical baselines, routed to responsible teams through Slack or webhooks, tested and tuned using real production behavior, and assigned clear ownership to limit alert fatigue. Confirmed, reproducible incidents should be converted into evaluation cases and included in CI to prevent future regressions in quality, cost, latency, or agent behavior.
Sep 08, 2026
3,538 words in the original blog post.
LLM evaluation pipelines complement conventional CI by detecting quality regressions caused by changes to models, prompts, retrieval, or tool behavior that linting, type checks, and deterministic unit tests cannot catch. Using Braintrust, teams can define versioned datasets, production-linked tasks, and deterministic or model-based scorers to measure qualities such as correctness, groundedness, safety, and tool-use behavior, then run them through GitHub Actions or the bt eval CLI. A typical workflow securely supplies Braintrust and provider credentials, executes evals non-interactively, compares results against a stable baseline, and posts pull-request comments showing aggregate and case-level improvements or regressions. To make evaluations enforceable, repositories must configure required status checks and custom reporters that fail builds when critical score floors, regression limits, or individual safety conditions are violated, while leaving variable signals such as latency and cost advisory unless they are release requirements. The approach recommends fast smoke suites for pull requests, full and scheduled evaluations after merges, repeated trials and aggregate thresholds for non-deterministic outputs, and investigation through immutable experiment records, traces, and output diffs. Production failures can be added to datasets as regression cases alongside their fixes, allowing teams to steadily expand coverage and connect real-world incidents to future release decisions.
Sep 08, 2026
4,708 words in the original blog post.
Braintrust has introduced Patterns and Debugger, alongside an enhanced Loop experience, to create a connected active-observability system for understanding and improving AI agents in production. Building on Topics, which classifies large trace volumes into broad themes, Patterns continuously identifies recurring failures or opportunities, provides supporting evidence and recommended actions, and can send findings to Slack for team review. Loop enables users to investigate production questions across traces, logs, datasets, and experiments, automate recurring analyses, and, with approval, create evaluators, datasets, dashboards, monitors, and other project assets; its capabilities are also available through a public MCP for compatible coding agents. Debugger focuses on individual complex traces, examining spans, tool calls, results, and model outputs to identify evidence-based likely failure modes and suggest next investigations. Patterns, Debugger, and Loop are available in public preview, with pricing planned before general availability.
Sep 03, 2026
1,275 words in the original blog post.