LangChain Reference home pageLangChain ReferenceLangChain Reference
  • GitHub
  • Main Docs
Deep Agents
LangChain
LangGraph
Integrations
LangSmith
  • Overview
    • Overview
    • Caches
    • Callbacks
    • Documents
    • Document loaders
    • Embeddings
    • Exceptions
    • Language models
    • Serialization
    • Output parsers
    • Prompts
    • Rate limiters
    • Retrievers
    • Runnables
    • Utilities
    • Vector stores
    MCP Adapters
    Standard Tests
    Text Splitters
    ⌘I

    Chat LangChain

    What can I help with?

    Enter to send·Shift+Enter new line

    Menu

    OverviewCachesCallbacksDocumentsDocument loadersEmbeddingsExceptionsLanguage modelsSerializationOutput parsersPromptsRate limitersRetrieversRunnablesUtilitiesVector stores
    MCP Adapters
    Standard Tests
    Text Splitters
    Language
    Theme
    Pythonlangchain-corecallbacksmanagertrace_as_chain_group
    Function●Since v1.8

    trace_as_chain_group

    Copy
    trace_as_chain_group(
      group_name: str,
      callback_manager: CallbackManager | None = None,
      *,
      
    View source on GitHub
    inputs
    :
    dict
    [
    str
    ,
    Any
    ]
    |
    None
    =
    None
    ,
    project_name
    :
    str
    |
    None
    =
    None
    ,
    address
    :
    AgentAddress
    |
    None
    =
    None
    ,
    example_id
    :
    str
    |
    UUID
    |
    None
    =
    None
    ,
    run_id
    :
    UUID
    |
    None
    =
    None
    ,
    tags
    :
    list
    [
    str
    ]
    |
    None
    =
    None
    ,
    metadata
    :
    dict
    [
    str
    ,
    Any
    ]
    |
    None
    =
    None
    )
    ->
    Generator
    [
    CallbackManagerForChainGroup
    ,
    None
    ,
    None
    ]

    Parameters

    NameTypeDescription
    group_name*str

    The name of the chain group.

    callback_managerCallbackManager | None
    Default:None

    The callback manager to use.

    inputsdict[str, Any] | None
    Default:None
    project_namestr | None
    Default:None
    addressAgentAddress | None
    Default:None
    example_idstr | UUID | None
    Default:None
    run_idUUID | None
    Default:None
    tagslist[str] | None
    Default:None
    metadatadict[str, Any] | None
    Default:None

    Get a callback manager for a chain group in a context manager.

    Useful for grouping different calls together as a single run even if they aren't composed in a single chain.

    Must have LANGCHAIN_TRACING_V2 env var set to true to see the trace in LangSmith.

    Example:

    llm_input = "Foo"
    with trace_as_chain_group("group_name", inputs={"input": llm_input}) as manager:
        # Use the callback manager for the chain group
        res = llm.invoke(llm_input, {"callbacks": manager})
        manager.on_chain_end({"output": res})

    The inputs to the chain group.

    The name of the project.

    The agent address to send traces to instead of a project.

    Beta

    Agent addressing must be enabled for the LangSmith workspace.

    The ID of the example.

    The ID of the run.

    The inheritable tags to apply to all runs.

    The metadata to apply to all runs.