fix: update api docs

Author: gusye1234

src/server/api/memobase_server/api_layer/buffer.py

@@ -12,7 +12,7 @@ async def flush_buffer(
     user_id: str = Path(..., description="The ID of the user"),
     buffer_type: BlobType = Path(..., description="The type of buffer to flush"),
 ) -> res.ChatModalAPIResponse:
-    """Get the real-time user profiles for long term memory"""
+    """Flush unprocessed blobs into Memory"""
     project_id = request.state.memobase_project_id
     p = await controllers.buffer.wait_insert_done_then_flush(
         user_id, project_id, buffer_type

src/server/api/memobase_server/api_layer/profile.py

@@ -84,7 +84,7 @@ async def delete_user_profile(
     user_id: str = Path(..., description="The ID of the user"),
     profile_id: str = Path(..., description="The ID of the profile to delete"),
 ) -> res.BaseResponse:
-    """Get the real-time user profiles for long term memory"""
+    """Delete a profile"""
     project_id = request.state.memobase_project_id
     p = await controllers.profile.delete_user_profile(user_id, project_id, profile_id)
     return p.to_response(res.IdResponse)

src/server/api/memobase_server/api_layer/roleplay.py

@@ -36,7 +36,7 @@ async def infer_proactive_topics(
     ),
     body: res.ProactiveTopicRequest = Body(..., description="The body of the request"),
 ) -> res.ProactiveTopicResponse:
-    """Get the real-time user profiles for long term memory"""
+    """Provide interest detection and personalized topics"""
     project_id = request.state.memobase_project_id
     topic_limits_json = topic_limits_json or "{}"
     try:

src/server/api/memobase_server/models/response.py

@@ -194,8 +194,12 @@ class ProactiveTopicData(BaseModel):
 
 
 class ProactiveTopicRequest(BaseModel):
-    messages: list[OpenAICompatibleMessage] = Field(..., description="The messages")
-    agent_context: Optional[str] = Field(None, description="The agent context")
+    messages: list[OpenAICompatibleMessage] = Field(
+        ..., description="The latest messages between user/assistant"
+    )
+    agent_context: Optional[str] = Field(
+        None, description="The agent's roleplay prompt"
+    )
 
 
 class UserContextImport(BaseModel):