Groups

1
import { LettaClient } from '@letta-ai/letta-client';
2
3
const client = new LettaClient();
4
5
// Create main conversation agent
6
const mainAgent = await client.agents.create({
7
    model: "openai/gpt-4.1",
8
    memoryBlocks: [
9
        {label: "persona", value: "I am the main conversation agent"}
10
    ]
11
});
12
13
// Create sleeptime agents for background tasks
14
const monitorAgent = await client.agents.create({
15
    model: "openai/gpt-4.1",
16
    memoryBlocks: [
17
        {label: "persona", value: "I monitor conversation sentiment and key topics"}
18
    ]
19
});
20
21
const summaryAgent = await client.agents.create({
22
    model: "openai/gpt-4.1",
23
    memoryBlocks: [
24
        {label: "persona", value: "I create periodic summaries of the conversation"}
25
    ]
26
});
27
28
// Create a Sleeptime group
29
const group = await client.groups.create({
30
    agentIds: [monitorAgent.id, summaryAgent.id],
31
    description: "Background agents that process conversation periodically",
32
    managerConfig: {
33
        managerType: "sleeptime",
34
        managerAgentId: mainAgent.id,
35
        sleeptimeAgentFrequency: 3  // Execute every 3 turns
36
    }
37
});
38
39
// Send messages to the group
40
const response = await client.groups.messages.create(
41
    group.id,
42
    {
43
        messages: [{role: "user", content: "Let's discuss our project roadmap"}]
44
    }
45
);

1
import { LettaClient } from '@letta-ai/letta-client';
2
3
const client = new LettaClient();
4
5
// Create agents for the group
6
const agent1 = await client.agents.create({
7
    model: "openai/gpt-4.1",
8
    memoryBlocks: [
9
        {label: "persona", value: "I am the first agent in the group"}
10
    ]
11
});
12
13
const agent2 = await client.agents.create({
14
    model: "openai/gpt-4.1",
15
    memoryBlocks: [
16
        {label: "persona", value: "I am the second agent in the group"}
17
    ]
18
});
19
20
const agent3 = await client.agents.create({
21
    model: "openai/gpt-4.1",
22
    memoryBlocks: [
23
        {label: "persona", value: "I am the third agent in the group"}
24
    ]
25
});
26
27
// Create a RoundRobin group
28
const group = await client.groups.create({
29
    agentIds: [agent1.id, agent2.id, agent3.id],
30
    description: "A group that cycles through agents in order",
31
    managerConfig: {
32
        managerType: "round_robin",
33
        maxTurns: 3  // Optional: defaults to number of agents
34
    }
35
});
36
37
// Send a message to the group
38
const response = await client.groups.messages.create(
39
    group.id,
40
    {
41
        messages: [{role: "user", content: "Hello group, what are your thoughts on this topic?"}]
42
    }
43
);

1
import { LettaClient } from '@letta-ai/letta-client';
2
3
const client = new LettaClient();
4
5
// Create supervisor agent
6
const supervisor = await client.agents.create({
7
    model: "openai/gpt-4.1",
8
    memoryBlocks: [
9
        {label: "persona", value: "I am a supervisor managing multiple workers"}
10
    ]
11
});
12
13
// Create worker agents
14
const worker1 = await client.agents.create({
15
    model: "openai/gpt-4.1",
16
    memoryBlocks: [
17
        {label: "persona", value: "I am a data analysis specialist"}
18
    ]
19
});
20
21
const worker2 = await client.agents.create({
22
    model: "openai/gpt-4.1",
23
    memoryBlocks: [
24
        {label: "persona", value: "I am a research specialist"}
25
    ]
26
});
27
28
const worker3 = await client.agents.create({
29
    model: "openai/gpt-4.1",
30
    memoryBlocks: [
31
        {label: "persona", value: "I am a writing specialist"}
32
    ]
33
});
34
35
// Create a Supervisor group
36
const group = await client.groups.create({
37
    agentIds: [worker1.id, worker2.id, worker3.id],
38
    description: "A supervisor-worker group for parallel task execution",
39
    managerConfig: {
40
        managerType: "supervisor",
41
        managerAgentId: supervisor.id
42
    }
43
});
44
45
// Send a message to the group
46
const response = await client.groups.messages.create(
47
    group.id,
48
    {
49
        messages: [{role: "user", content: "Analyze this data and prepare a report"}]
50
    }
51
);

1
import { LettaClient } from '@letta-ai/letta-client';
2
3
const client = new LettaClient();
4
5
// Create orchestrator agent
6
const orchestrator = await client.agents.create({
7
    model: "openai/gpt-4.1",
8
    memoryBlocks: [
9
        {label: "persona", value: "I am an orchestrator that decides who speaks next based on context"}
10
    ]
11
});
12
13
// Create participant agents
14
const expert1 = await client.agents.create({
15
    model: "openai/gpt-4.1",
16
    memoryBlocks: [
17
        {label: "persona", value: "I am a technical expert"}
18
    ]
19
});
20
21
const expert2 = await client.agents.create({
22
    model: "openai/gpt-4.1",
23
    memoryBlocks: [
24
        {label: "persona", value: "I am a business strategist"}
25
    ]
26
});
27
28
const expert3 = await client.agents.create({
29
    model: "openai/gpt-4.1",
30
    memoryBlocks: [
31
        {label: "persona", value: "I am a creative designer"}
32
    ]
33
});
34
35
// Create a Dynamic group
36
const group = await client.groups.create({
37
    agentIds: [expert1.id, expert2.id, expert3.id],
38
    description: "A dynamic group where the orchestrator chooses speakers",
39
    managerConfig: {
40
        managerType: "dynamic",
41
        managerAgentId: orchestrator.id,
42
        terminationToken: "DONE!",  // Optional: default is "DONE!"
43
        maxTurns: 10  // Optional: prevent infinite loops
44
    }
45
});
46
47
// Send a message to the group
48
const response = await client.groups.messages.create(
49
    group.id,
50
    {
51
        messages: [{role: "user", content: "Let's design a new product. Who should start?"}]
52
    }
53
);