feat: add e2e example scripts for documentation (#1995)

examples/docs/agent_basic.py

@@ -0,0 +1,40 @@
+from letta import EmbeddingConfig, LLMConfig, create_client
+
+client = create_client()
+
+# set automatic defaults for LLM/embedding config
+client.set_default_llm_config(
+    LLMConfig(model="gpt-4o-mini", model_endpoint_type="openai", model_endpoint="https://api.openai.com/v1", context_window=128000)
+)
+client.set_default_embedding_config(
+    EmbeddingConfig(
+        embedding_endpoint_type="openai",
+        embedding_endpoint="https://api.openai.com/v1",
+        embedding_model="text-embedding-ada-002",
+        embedding_dim=1536,
+        embedding_chunk_size=300,
+    )
+)
+
+
+# create a new agent
+agent_state = client.create_agent()
+print(f"Created agent with name {agent_state.name} and unique ID {agent_state.id}")
+
+# Message an agent
+response = client.send_message(agent_id=agent_state.id, role="user", message="hello")
+print("Usage", response.usage)
+print("Agent messages", response.messages)
+
+# list all agents
+agents = client.list_agents()
+
+# get the agent by ID
+agent_state = client.get_agent(agent_id=agent_state.id)
+
+# get the agent by name
+agent_id = client.get_agent_id(agent_name=agent_state.name)
+agent_state = client.get_agent(agent_id=agent_id)
+
+# delete an agent
+client.delete_agent(agent_id=agent_state.id)