fix: correct messages API method from send to create (#4299)

Updated documentation examples to use the correct API method:
- Changed groups.messages.send() to groups.messages.create()
- Changed agents.messages.send() to agents.messages.create()
- Updated parameter format to use messages array with role/content

Fixes inconsistent API usage across documentation and examples.

Author: cpfiffer

examples/notebooks/Agentic RAG with Letta.ipynb

@@ -857,106 +857,11 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 37,
+   "execution_count": null,
    "id": "b339b7b1-3198-4fd9-9a53-7940dcc20437",
    "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/html": [
-       "\n",
-       "        <style>\n",
-       "            .message-container, .usage-container {\n",
-       "                font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;\n",
-       "                max-width: 800px;\n",
-       "                margin: 20px auto;\n",
-       "                background-color: #1e1e1e;\n",
-       "                border-radius: 8px;\n",
-       "                overflow: hidden;\n",
-       "                color: #d4d4d4;\n",
-       "            }\n",
-       "            .message, .usage-stats {\n",
-       "                padding: 10px 15px;\n",
-       "                border-bottom: 1px solid #3a3a3a;\n",
-       "            }\n",
-       "            .message:last-child, .usage-stats:last-child {\n",
-       "                border-bottom: none;\n",
-       "            }\n",
-       "            .title {\n",
-       "                font-weight: bold;\n",
-       "                margin-bottom: 5px;\n",
-       "                color: #ffffff;\n",
-       "                text-transform: uppercase;\n",
-       "                font-size: 0.9em;\n",
-       "            }\n",
-       "            .content {\n",
-       "                background-color: #2d2d2d;\n",
-       "                border-radius: 4px;\n",
-       "                padding: 5px 10px;\n",
-       "                font-family: 'Consolas', 'Courier New', monospace;\n",
-       "                white-space: pre-wrap;\n",
-       "            }\n",
-       "            .json-key, .function-name, .json-boolean { color: #9cdcfe; }\n",
-       "            .json-string { color: #ce9178; }\n",
-       "            .json-number { color: #b5cea8; }\n",
-       "            .internal-monologue { font-style: italic; }\n",
-       "        </style>\n",
-       "        <div class=\"message-container\">\n",
-       "        \n",
-       "            <div class=\"message\">\n",
-       "                <div class=\"title\">FUNCTION CALL</div>\n",
-       "                <div class=\"content\"><span class=\"function-name\">tavily_search_results</span>({<br>&nbsp;&nbsp;<span class=\"json-key\">\"query\"</span>: <span class=\"json-key\">\"Who founded OpenAI\",<br>&nbsp;&nbsp;\"request_heartbeat\"</span>: <span class=\"json-boolean\">true</span><br>})</div>\n",
-       "            </div>\n",
-       "            \n",
-       "            <div class=\"message\">\n",
-       "                <div class=\"title\">FUNCTION RETURN</div>\n",
-       "                <div class=\"content\">{<br>&nbsp;&nbsp;<span class=\"json-key\">\"status\"</span>: <span class=\"json-key\">\"Failed\",<br>&nbsp;&nbsp;\"message\"</span>: <span class=\"json-key\">\"Error calling function tavily_search_results: module langchain_community.tools has no attribute TavilySearchAPIWrapper\",<br>&nbsp;&nbsp;\"time\"</span>: <span class=\"json-string\">\"2024-11-13 05:40:04 PM PST-0800\"</span><br>}</div>\n",
-       "            </div>\n",
-       "            \n",
-       "            <div class=\"message\">\n",
-       "                <div class=\"title\">INTERNAL MONOLOGUE</div>\n",
-       "                <div class=\"content\"><span class=\"internal-monologue\">The search function seems to have encountered an error. Let&#x27;s attempt to answer the user&#x27;s question another way.</span></div>\n",
-       "            </div>\n",
-       "            \n",
-       "            <div class=\"message\">\n",
-       "                <div class=\"title\">FUNCTION CALL</div>\n",
-       "                <div class=\"content\"><span class=\"function-name\">send_message</span>({<br>&nbsp;&nbsp;<span class=\"json-key\">\"message\"</span>: <span class=\"json-string\">\"OpenAI was founded by Elon Musk, Sam Altman, Greg Brockman, Ilya Sutskever, John Schulman and Wojciech Zaremba in December 2015. However, please note that Elon Musk is no longer associated with the organization.\"</span><br>})</div>\n",
-       "            </div>\n",
-       "            \n",
-       "            <div class=\"message\">\n",
-       "                <div class=\"title\">FUNCTION RETURN</div>\n",
-       "                <div class=\"content\">{<br>&nbsp;&nbsp;<span class=\"json-key\">\"status\"</span>: <span class=\"json-key\">\"OK\",<br>&nbsp;&nbsp;\"message\"</span>: <span class=\"json-key\">\"None\",<br>&nbsp;&nbsp;\"time\"</span>: <span class=\"json-string\">\"2024-11-13 05:40:09 PM PST-0800\"</span><br>}</div>\n",
-       "            </div>\n",
-       "            </div>\n",
-       "        <div class=\"usage-container\">\n",
-       "            <div class=\"usage-stats\">\n",
-       "                <div class=\"title\">USAGE STATISTICS</div>\n",
-       "                <div class=\"content\">{<br>&nbsp;&nbsp;<span class=\"json-key\">\"completion_tokens\"</span>: <span class=\"json-number\">120</span>,<br>&nbsp;&nbsp;<span class=\"json-key\">\"prompt_tokens\"</span>: <span class=\"json-number\">4737</span>,<br>&nbsp;&nbsp;<span class=\"json-key\">\"total_tokens\"</span>: <span class=\"json-number\">4857</span>,<br>&nbsp;&nbsp;<span class=\"json-key\">\"step_count\"</span>: <span class=\"json-number\">2</span><br>}</div>\n",
-       "            </div>\n",
-       "        </div>\n",
-       "        "
-      ],
-      "text/plain": [
-       "LettaResponse(messages=[FunctionCallMessage(id='message-31269f23-f32a-4267-ac85-b4548c56a1dd', date=datetime.datetime(2024, 11, 14, 1, 40, 4, 928751, tzinfo=datetime.timezone.utc), message_type='function_call', function_call=FunctionCall(name='tavily_search_results', arguments='{\\n  \"query\": \"Who founded OpenAI\",\\n  \"request_heartbeat\": true\\n}', function_call_id='call_EMmwx5mNy2vEttk97GDMjYwy')), FunctionReturn(id='message-a1e13057-6244-44c8-8ee5-2e057e5bed2d', date=datetime.datetime(2024, 11, 14, 1, 40, 4, 931214, tzinfo=datetime.timezone.utc), message_type='function_return', function_return='{\\n  \"status\": \"Failed\",\\n  \"message\": \"Error calling function tavily_search_results: module langchain_community.tools has no attribute TavilySearchAPIWrapper\",\\n  \"time\": \"2024-11-13 05:40:04 PM PST-0800\"\\n}', status='error', function_call_id='call_EMmwx5mNy2vEttk97GDMjYwy'), InternalMonologue(id='message-0cb514d9-0874-43e8-b537-6bfcceeb9875', date=datetime.datetime(2024, 11, 14, 1, 40, 9, 498385, tzinfo=datetime.timezone.utc), message_type='internal_monologue', internal_monologue=\"The search function seems to have encountered an error. Let's attempt to answer the user's question another way.\"), FunctionCallMessage(id='message-0cb514d9-0874-43e8-b537-6bfcceeb9875', date=datetime.datetime(2024, 11, 14, 1, 40, 9, 498385, tzinfo=datetime.timezone.utc), message_type='function_call', function_call=FunctionCall(name='send_message', arguments='{\\n  \"message\": \"OpenAI was founded by Elon Musk, Sam Altman, Greg Brockman, Ilya Sutskever, John Schulman and Wojciech Zaremba in December 2015. However, please note that Elon Musk is no longer associated with the organization.\"\\n}', function_call_id='call_MiF3dvSF7ImLBoOOwugKpZLy')), FunctionReturn(id='message-2e27c5ce-574e-4135-8486-f586a42b020c', date=datetime.datetime(2024, 11, 14, 1, 40, 9, 499244, tzinfo=datetime.timezone.utc), message_type='function_return', function_return='{\\n  \"status\": \"OK\",\\n  \"message\": \"None\",\\n  \"time\": \"2024-11-13 05:40:09 PM PST-0800\"\\n}', status='success', function_call_id='call_MiF3dvSF7ImLBoOOwugKpZLy')], usage=LettaUsageStatistics(completion_tokens=120, prompt_tokens=4737, total_tokens=4857, step_count=2))"
-      ]
-     },
-     "execution_count": 37,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "response = client.agents.messages.send(\n",
-    "    agent_id=agent_state.id, \n",
-    "    messages=[\n",
-    "        MessageCreate(\n",
-    "            role=\"user\",\n",
-    "            content=\"Who founded OpenAI?\",\n",
-    "        )\n",
-    "    ],\n",
-    ")\n",
-    "response"
-   ]
+   "outputs": [],
+   "source": "response = client.agents.messages.create(\n    agent_id=agent_state.id, \n    messages=[\n        MessageCreate(\n            role=\"user\",\n            content=\"Who founded OpenAI?\",\n        )\n    ],\n)\nresponse"
   }
  ],
  "metadata": {
@@ -980,4 +885,4 @@
  },
  "nbformat": 4,
  "nbformat_minor": 5
-}
+}