Message history for orchestrator agents or agents as tools

[rebecca-barton]

This seems related to this open question already...

I was wondering how the message history and agent's context works when you are either

• calling agents as tools
• using an orchestrator setup like the example here?

What I'm trying to design is a system where you do some data processing and then you make a report. You have two agents that are specialised in each of these tasks with their own system prompts. I want any useful insights gained from the data processing step to be passed to the agent that makes the report so that it doesn't have to re-extract insights that the data processing agent has already "learned".

If you have two separate agents doing this task sequentially then you'd presumably need to pass the message history from the first agent to the second agent? I know you can pass the response from the first agent to the second agent but this contains only the final response rather than the full message history.

However if you have one "main" agent doing this task that can call the data processing agent and the report agent as tools, for example, then I'm unclear if the context gets shared properly? Per the example below as far as I understand it the agent.messages object that belongs to the "main" agent does not contain the history of tool calls that were called within the other agents e.g. the data processing agent or the report agent.

[
    {
        'role': 'user',
        'content': 
        [
            {
                'text': 'I want to process the data in the file test.csv to analyse ....'
            }
        ]
    },
    {
        'role': 'assistant',
        'content':
        [
            {
                'text': 'Let me first examine the data to understand what ...'
            },
            {
                'toolUse':
                    {
                        'toolUseId': '123',
                        'name': 'process_raw_data',
                        'input':
                            {
                                'query': 'I need to analyse the data in the test.csv file ...'
                            }
                    }
            }
        ]
    },
    {
        'role': 'user',
        'content':
        [
            {
                'toolResult':
                    {
                        'toolUseId': '123',
                        'status': 'success',
                        'content':
                            [
                                {
                                    'text': 'I've successfully analyzed and cleaned the data...'
                                }
                            ]
                    }
            }
        ]
    },
    {
        'role': 'user',
        'content': 
        [
            {
                'text': 'Now I need to make a report ....'
            }
        ]
    },
    {
        'role': 'assistant',
        'content':
        [
            {
                'text': 'Let me look at the cleaned data...'
            },
            {
                'toolUse':
                    {
                        'toolUseId': '456',
                        'name': 'make_report',
                        'input':
                            {
                                'query': 'I need to make a report based on the cleaned data...'
                            }
                    }
            }
        ]
    },
    {
        'role': 'user',
        'content':
        [
            {
                'toolResult':
                    {
                        'toolUseId': '456',
                        'status': 'success',
                        'content':
                            [
                                {
                                    'text': 'I've successfully made a report on....'
                                }
                            ]
                    }
            }
        ]
    },
]

The page about Swarms seems to suggest context/message history is shared though?

Appreciate any advice on the best way to design this kind of system.