> ## Documentation Index
> Fetch the complete documentation index at: https://docs.braintrust.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Config guides

> Set up features, configure integrations, and enable capabilities

Learn how to configure Braintrust features, set up integrations, and enable advanced capabilities. Each guide provides step-by-step configuration instructions.

## All config guides

> [card] [Access UI parameters in remote eval tasks](https://docs.braintrust.dev/kb/access-ui-parameters-in-remote-eval-tasks)

> [card] [Accessing log attachments in Python scorers](https://docs.braintrust.dev/kb/accessing-log-attachments-in-python-scorers)

> [card] [Add custom measures to monitoring charts](https://docs.braintrust.dev/kb/add-custom-measures-to-monitoring-charts)

> [card] [Aggregate scores across multiple experiments with BTQL](https://docs.braintrust.dev/kb/aggregate-scores-across-multiple-experiments-with-btql)

> [card] [Alerting on scorer errors and aggregated scores](https://docs.braintrust.dev/kb/alerting-on-scorer-errors-and-aggregated-scores)

> [card] [Allowlist Braintrust egress IPs for private provider endpoints](https://docs.braintrust.dev/kb/configure-litellm-as-a-custom-provider)

> [card] [Apply log retention policies across all projects via API](https://docs.braintrust.dev/kb/apply-log-retention-policies-across-all-projects-via-api)

> [card] [Attaching debuggers to Braintrust eval CLI](https://docs.braintrust.dev/kb/attaching-debuggers-to-braintrust-eval-cli)

> [card] [AWS Bedrock IAM permissions for Braintrust integration](https://docs.braintrust.dev/kb/aws-bedrock-iam-permissions-for-braintrust-integration)

> [card] [Browser and API domains for Braintrust orgs](https://docs.braintrust.dev/kb/browser-and-api-domains-for-braintrust-orgs)

> [card] [BTQL POST endpoint payload and response schema](https://docs.braintrust.dev/kb/btql-post-endpoint-payload-and-response-schema)

> [card] [Calculate per-trace averages in dashboards with custom measures](https://docs.braintrust.dev/kb/compute-average-cost-and-llm-calls-per-trace)

> [card] [Configure Bedrock with IAM role assumption in Braintrust](https://docs.braintrust.dev/kb/configure-bedrock-with-iam-role-assumption-in-braintrust)

> [card] [Configure custom model costs for estimation](https://docs.braintrust.dev/kb/configure-custom-model-costs-for-estimation)

> [card] [Configure dataset schemas via API](https://docs.braintrust.dev/kb/configure-dataset-schemas-via-api)

> [card] [Configure default groups for Google SSO users](https://docs.braintrust.dev/kb/configure-default-groups-for-google-sso-users)

> [card] [Configure human review visibility in dataset views](https://docs.braintrust.dev/kb/configure-human-review-visibility-in-dataset-views)

> [card] [Configure MCP server with self-hosted data plane](https://docs.braintrust.dev/kb/configure-mcp-server-with-self-hosted-data-plane)

> [card] [Configure Microsoft Entra ID SAML SSO](https://docs.braintrust.dev/kb/configure-microsoft-entra-id-saml-sso)

> [card] [Configure root span filter for online scoring](https://docs.braintrust.dev/kb/configure-root-span-filter-for-online-scoring)

> [card] [Configure scorer pass threshold via API](https://docs.braintrust.dev/kb/configure-scorer-pass-threshold-via-api)

> [card] [Copy prompts, scorers, and datasets across projects](https://docs.braintrust.dev/kb/copy-prompts-scorers-and-datasets-across-projects)

> [card] [Create a blank monitoring view via API](https://docs.braintrust.dev/kb/create-a-blank-monitoring-view-via-api)

> [card] [Create a root span with client-generated conversation IDs](https://docs.braintrust.dev/kb/create-a-root-span-with-client-generated-conversation-ids)

> [card] [Create project-level AI providers via API](https://docs.braintrust.dev/kb/create-project-level-ai-providers-via-api)

> [card] [Creating prompts with encoded custom provider model names](https://docs.braintrust.dev/kb/creating-prompts-with-custom-provider-model-names)

> [card] [Cross-trace cost dashboard SQL patterns](https://docs.braintrust.dev/kb/cross-trace-cost-dashboard-sql-patterns)

> [card] [Custom code scorers with internet access](https://docs.braintrust.dev/kb/custom-code-scorers-with-internet-access)

> [card] [Customizing experiment names in the SDK](https://docs.braintrust.dev/kb/customizing-experiment-names-in-the-sdk)

> [card] [Dataset format for system and user prompts](https://docs.braintrust.dev/kb/dataset-format-for-system-and-user-prompts)

> [card] [Defining response schema in prompts.create()](https://docs.braintrust.dev/kb/defining-response-schema-in-promptscreate)

> [card] [Detecting Remote Eval and CLI Execution Context: SDK Hooks and Environment Variables](https://docs.braintrust.dev/kb/detecting-remote-eval-and-cli-execution-context-sdk-hooks-and-environment-variables)

> [card] [Edit Topics automation sampling rate after setup](https://docs.braintrust.dev/kb/edit-topics-automation-sampling-rate-after-setup)

> [card] [Emit traces to multiple projects simultaneously](https://docs.braintrust.dev/kb/emit-traces-to-multiple-projects-simultaneously)

> [card] [Enable provider models in Loop](https://docs.braintrust.dev/kb/manage-loop-model-defaults-and-cost)

> [card] [Experiment Fetch Limited to 1000 Events - Export All](https://docs.braintrust.dev/kb/experiment-fetch-limited-to-1000-events)

> [card] [Export all experiment events using BTQL pagination](https://docs.braintrust.dev/kb/export-all-experiment-events-using-btql-pagination)

> [card] [Export billing usage data for reporting](https://docs.braintrust.dev/kb/export-billing-usage-data-for-reporting)

> [card] [Export cursor and service account handoff guidance](https://docs.braintrust.dev/kb/export-cursor-and-service-account-handoff-guidance)

> [card] [Export missing child spans](https://docs.braintrust.dev/kb/export-missing-child-spans)

> [card] [Fetching human review comments via API and BTQL](https://docs.braintrust.dev/kb/fetching-human-review-comments-via-api-and-btql)

> [card] [File attachment support across models](https://docs.braintrust.dev/kb/file-attachment-support-across-models)

> [card] [Filter logs by tags and scores with ANY\_SPAN](https://docs.braintrust.dev/kb/filter-logs-by-tags-and-scores-with-any_span)

> [card] [Filter logs for automatically converted file attachments](https://docs.braintrust.dev/kb/filter-logs-by-file-attachments)

> [card] [Filter logs for failed LLM calls](https://docs.braintrust.dev/kb/filter-logs-for-failed-llm-calls)

> [card] [Fix AI provider auth format and endpoint path after data plane v2](https://docs.braintrust.dev/kb/fix-ai-provider-auth-format-and-endpoint-path-after-data-plane-v2)

> [card] [Flagging logs and users for review via API](https://docs.braintrust.dev/kb/flagging-logs-and-users-for-review-via-api)

> [card] [Flagging users for review via API](https://docs.braintrust.dev/kb/flagging-users-for-review-via-api)

> [card] [How to configure OpenAI for EU organizations](https://docs.braintrust.dev/kb/how-to-configure-openai-for-eu-organizations-1776438526526)

> [card] [How to find and use self-hosted data plane API endpoints](https://docs.braintrust.dev/kb/how-to-find-and-use-self-hosted-data-plane-api-endpoints)

> [card] [How to Save Custom Instructions for Loop Using Project](https://docs.braintrust.dev/kb/how-to-save-custom-instructions-for)

> [card] [Human review visibility in experiment row view](https://docs.braintrust.dev/kb/human-review-visibility-in-experiment-row-view)

> [card] [Human review with multiple scores in expected field](https://docs.braintrust.dev/kb/human-review-with-multiple-scores-in)

> [card] [Include scorer explanations in S3 exports](https://docs.braintrust.dev/kb/include-scorer-explanations-in-s3-exports)

> [card] [Java SDK proxy configuration with authentication](https://docs.braintrust.dev/kb/java-sdk-proxy-configuration-with-authentication)

> [card] [JIT domain mapping setup for new users](https://docs.braintrust.dev/kb/jit-domain-mapping-setup-for-new-users)

> [card] [Link prompt versions to traces from code](https://docs.braintrust.dev/kb/link-prompt-versions-to-traces-from-code)

> [card] [Log token metrics to @traced spans manually](https://docs.braintrust.dev/kb/log-token-metrics-to-traced-spans-manually)

> [card] [Log user feedback selectively with init\_logger](https://docs.braintrust.dev/kb/log-user-feedback-selectively-with-init-logger)

> [card] [Managing Prompt Updates in Production: Environment Tags](https://docs.braintrust.dev/kb/managing-prompt-updates-in-production-environment)

> [card] [Map UUID ACL grants to user identities](https://docs.braintrust.dev/kb/map-uuid-acl-grants-to-user-identities)

> [card] [Minimum OpenAI API key permissions for Braintrust](https://docs.braintrust.dev/kb/minimum-openai-api-key-permissions-for-braintrust)

> [card] [Navigate and filter metadata arrays by index](https://docs.braintrust.dev/kb/navigate-and-filter-metadata-arrays-by-index)

> [card] [Nest LLM spans beneath code scorers to preserve span context](https://docs.braintrust.dev/kb/nest-llm-spans-beneath-code-scorers-to-preserve-span-context)

> [card] [Okta SCIM setup for multiple Braintrust organizations](https://docs.braintrust.dev/kb/okta-scim-setup-for-multiple-braintrust-organizations)

> [card] [Open trace URLs in a specific view mode](https://docs.braintrust.dev/kb/open-trace-urls-in-a-specific-view-mode)

> [card] [Optimize large trace logging with attachments](https://docs.braintrust.dev/kb/optimize-large-trace-logging-with-attachments)

> [card] [Pass Gemini Google Search via Braintrust Gateway](https://docs.braintrust.dev/kb/pass-gemini-google-search-via-braintrust-gateway)

> [card] [Permissions required to view custom trace views](https://docs.braintrust.dev/kb/permissions-required-to-view-custom-trace-views)

> [card] [Promoting prompts across environments via API](https://docs.braintrust.dev/kb/promoting-prompts-across-environments-via-api-complete-workflow-for-dev-staging-and-production)

> [card] [Provision service account access with permission groups](https://docs.braintrust.dev/kb/provision-service-account-access-with-permission-groups)

> [card] [Python SDK Docker containerization setup](https://docs.braintrust.dev/kb/python-sdk-docker-containerization-setup)

> [card] [Restrict user access to specific projects only](https://docs.braintrust.dev/kb/restrict-user-access-to-specific-projects-only)

> [card] [Retry-safe eval workers with stable row IDs](https://docs.braintrust.dev/kb/retry-safe-eval-workers-with-stable-row-ids)

> [card] [Review specific rows in Logs and Experiments](https://docs.braintrust.dev/kb/review-button-ignores-selected-rows-in-logs)

> [card] [Route requests to specific AI providers](https://docs.braintrust.dev/kb/route-requests-to-specific-ai-providers)

> [card] [Routing Python SDK logs to multiple Braintrust backends](https://docs.braintrust.dev/kb/python-sdk-byoc-routing-and-state-setup.md)

> [card] [Run multi-turn agent evaluations with MCP tools](https://docs.braintrust.dev/kb/multi-turn-evaluations-for-mcp-skills)

> [card] [Running Evaluations Per Git Commit: SHA-Based Experiment](https://docs.braintrust.dev/kb/running-evaluations-per-git-commit-sha)

> [card] [Scorer template variable reference](https://docs.braintrust.dev/kb/scorer-template-variable-reference-1777485051181)

> [card] [Service token permissions for log ingestion](https://docs.braintrust.dev/kb/service-token-permissions-for-log-ingestion)

> [card] [Set sub-5-minute export automation intervals via API](https://docs.braintrust.dev/kb/set-sub-5-minute-export-automation-intervals-via-api)

> [card] [Setting up SSO integration in Braintrust](https://docs.braintrust.dev/kb/setting-up-sso-integration-in-braintrust-1777472841602)

> [card] [Slack alert permissions in project settings](https://docs.braintrust.dev/kb/slack-alert-permissions-in-project-settings)

> [card] [Stitch multi-turn chat into one trace with wrapAISDK](https://docs.braintrust.dev/kb/stitch-multi-turn-chat-into-one-trace-with-wrapaisdk)

> [card] [Strip OTel attributes from metadata](https://docs.braintrust.dev/kb/strip-otel-attributes-from-metadata)

> [card] [Thread view span extraction and filtering](https://docs.braintrust.dev/kb/thread-view-span-extraction-and-filtering)

> [card] [Topics automation idle timeout and trace update behavior](https://docs.braintrust.dev/kb/topics-automation-idle-timeout-and-trace-update-behavior)

> [card] [Topics grouping and span scope](https://docs.braintrust.dev/kb/topics-grouping-and-span-scope)

> [card] [Tracing OpenAI Realtime API with WebSockets](https://docs.braintrust.dev/kb/tracing-openai-realtime-api-with-websockets)

> [card] [Troubleshooting 500 errors in self-hosted data planes](https://docs.braintrust.dev/kb/troubleshooting-500-errors-in-self-hosted)

> [card] [UI experiment timeout configuration for self-hosted k8s](https://docs.braintrust.dev/kb/ui-experiment-timeout-configuration-for-self-hosted-k8s)

> [card] [Understanding Experiment Score Aggregation: Simple vs](https://docs.braintrust.dev/kb/understanding-experiment-score-aggregation-simple-vs)

> [card] [Update AWS Bedrock credentials using API](https://docs.braintrust.dev/kb/update-aws-bedrock-credentials-using-api)

> [card] [Use project IDs to prevent duplicate projects after rename](https://docs.braintrust.dev/kb/use-project-ids-to-prevent-duplicate-projects-after-rename)

> [card] [User Engagement Tracking](https://docs.braintrust.dev/kb/user-engagement-tracking)

> [card] [Using OpenAI Responses API with Braintrust SDKs](https://docs.braintrust.dev/kb/using-openai-responses-api-with-braintrust-sdks)

> [card] [View model token usage and estimated costs](https://docs.braintrust.dev/kb/view-model-token-usage-and-estimated-costs)

## Need more help?

Can't find what you're looking for? Search across all documentation using the search bar above, or contact support at [support@braintrust.dev](mailto:support@braintrust.dev).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.