Skip to content

docs: Course section — Conversation Branching and Forking #22

@rdwj

Description

@rdwj

Summary

Teach users how to fork conversations for exploration, testing, and comparison. Branching enables A/B testing of agent configurations, user-driven exploration of alternate paths, and red-teaming workflows — all without losing the original conversation history.

Course Section Outline

  • Use cases — A/B testing agent configs, user exploration of alternatives, red-teaming and adversarial testing
  • Using the fork API — creating a branch from any message in a session
  • Branch navigation in the UI — tree visualization, switching between forks
  • Session lineage and fork metadata — parent_session_id, fork_point, branch labels
  • Comparing outcomes across branches — side-by-side view of divergent paths
  • Schema requirements for message-level session storage — what changes from turn-level storage

Lab Exercise

Start a conversation with an agent. At a meaningful midpoint, fork the session using the API. Take different conversational paths in each fork (e.g., ask the same question with different constraints). Compare the outcomes and verify that each fork maintains independent message history while sharing the common prefix.

Companion Issues

Companion issues filed on fips-agents/agent-template, fips-agents/gateway-template, fips-agents/ui-template, and fips-agents/fips-agents-cli.

Size

S

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions