Retrieve Agent Context Window

1 from letta_client import Letta 2 3 client = Letta( 4 token="YOUR_TOKEN", 5 ) 6 client.agents.context.retrieve( 7 agent_id="agent_id", 8 )

1 { 2 "context_window_size_max": 42, 3 "context_window_size_current": 42, 4 "num_messages": 42, 5 "num_archival_memory": 42, 6 "num_recall_memory": 42, 7 "num_tokens_external_memory_summary": 42, 8 "external_memory_summary": "foo", 9 "num_tokens_system": 42, 10 "system_prompt": "foo", 11 "num_tokens_core_memory": 42, 12 "core_memory": "foo", 13 "num_tokens_summary_memory": 42, 14 "num_tokens_functions_definitions": 42, 15 "num_tokens_messages": 42, 16 "messages": [ 17 { 18 "role": "assistant", 19 "created_by_id": "foo", 20 "last_updated_by_id": "foo", 21 "created_at": "foo", 22 "updated_at": "foo", 23 "id": "message-123e4567-e89b-12d3-a456-426614174000", 24 "agent_id": "foo", 25 "model": "foo", 26 "content": [ 27 { 28 "type": "omitted_reasoning" 29 } 30 ], 31 "name": "foo", 32 "tool_calls": [ 33 { 34 "id": "foo", 35 "function": { 36 "arguments": "foo", 37 "name": "foo" 38 }, 39 "type": "foo" 40 } 41 ], 42 "tool_call_id": "foo", 43 "step_id": "foo", 44 "otid": "foo", 45 "tool_returns": [ 46 { 47 "status": "success", 48 "stdout": [ 49 "foo" 50 ], 51 "stderr": [ 52 "foo" 53 ] 54 } 55 ], 56 "group_id": "foo", 57 "sender_id": "foo", 58 "batch_item_id": "foo" 59 } 60 ], 61 "summary_memory": "foo", 62 "functions_definitions": [ 63 { 64 "function": { 65 "name": "foo", 66 "description": "foo", 67 "parameters": {}, 68 "strict": true 69 }, 70 "type": "foo" 71 } 72 ] 73 }

Retrieve the context window of a specific agent.

Path parameters

agent_idstringRequired

Headers

AuthorizationstringRequired

Header authentication of the form Bearer <token>

Response

Successful Response

context_window_size_maxinteger

The maximum amount of tokens the context window can hold.

context_window_size_currentinteger

The current number of tokens in the context window.

num_messagesinteger

The number of messages in the context window.

num_archival_memoryinteger

The number of messages in the archival memory.

num_recall_memoryinteger

The number of messages in the recall memory.

num_tokens_external_memory_summaryinteger

The number of tokens in the external memory summary (archival + recall metadata).

external_memory_summarystring

The metadata summary of the external memory sources (archival + recall metadata).

num_tokens_systeminteger

The number of tokens in the system prompt.

system_promptstring

The content of the system prompt.

num_tokens_core_memoryinteger

The number of tokens in the core memory.

core_memorystring

The content of the core memory.

num_tokens_summary_memoryinteger

The number of tokens in the summary memory.

num_tokens_functions_definitionsinteger

The number of tokens in the functions definitions.

num_tokens_messagesinteger

The number of tokens in the messages list.

messageslist of objects

The messages in the context window.

summary_memorystring or null

The content of the summary memory.

functions_definitionslist of objects or null

The content of the functions definitions.