Skip to main content

​
Summary

Loop, Braintrust’s AI assistant for data analysis and report generation, can access custom instructions and context through your project description field. This allows you to save recurring instructions—such as URL structures for traceIDs, formatting preferences, or domain-specific context—so you don’t need to provide the same information with every Loop request. The project description is automatically included in Loop’s context, making this feature useful but somewhat hidden from users who may not know it exists.

​
Symptoms

  • You find yourself providing the same instructions to Loop repeatedly (e.g., URL structure for traceIDs in reports)
  • Loop doesn’t remember context from previous sessions
  • You need to explain your organization’s specific conventions or formatting requirements each time you use Loop
  • Reports generated by Loop lack customizations you frequently request

​
Workarounds

Add your recurring instructions, URL structures, and formatting preferences directly to your project’s description field. Loop will automatically include this context when generating reports and analyzing data.

​
Steps to configure

  1. Navigate to your project in the Braintrust dashboard
  2. Locate the project settings or project information section
  3. Find the project description field
  4. Add your custom instructions, including:
  5. Save your changes

​
Example project description

Project: Customer Support AI Assistant

Custom Instructions for Loop:
- When creating reports with traceIDs, format them as clickable URLs using this structure: https://app.braintrust.dev/project/[project_id]/traces/[trace_id]
- Always include p50, p95, and p99 latency metrics in performance reports
- Group feedback data by sentiment (positive, neutral, negative) by default
- Use ISO 8601 format for all timestamps
- Highlight any anomalies or significant changes in metrics compared to the previous period

​
Example custom instructions for traceID URLs

When generating reports with traceIDs, format them as URLs:
https://app.braintrust.dev/project/abc123/traces/{trace_id}

Replace {trace_id} with the actual trace identifier.

​
Option 2: Include instructions in individual Loop requests

If you need one-off customizations or are working across multiple projects, you can still provide specific instructions directly in your Loop query. This approach works for temporary or unique requests that don’t need to be saved as defaults.

​
Notes

  • The project description field is included in Loop’s context automatically—you don’t need to enable any additional settings
  • Instructions in the project description apply to all Loop interactions within that project
  • You can update the project description at any time, and changes will take effect immediately for subsequent Loop requests
  • Be specific and concise in your instructions to help Loop understand your requirements accurately
  • Consider organizing instructions with clear headings or bullet points for better readability
  • This feature is particularly useful for teams that have standardized reporting formats or organization-specific conventions

​
References

  • Braintrust Documentation
  • For additional support with Loop or project configuration, contact the Braintrust support team