docs: retrieve user by ID

argilla/src/argilla/client/users.py

@@ -104,7 +104,7 @@ def __init__(
             " advance in Argilla, unless you are creating a new one."
         )
         if id is not None:
-            error_msg += f" As the `id` argument is not None, you should use `User.from_id('{id}')` instead."
+            error_msg += f" As the `id` argument is not None, you should use `User.from_id(UUID('{id}'))` instead."
         if name is not None:
             error_msg += f" As the `name` argument is not None, you should use `User.from_name('{name}')` instead."
         raise Exception(error_msg)
@@ -285,9 +285,16 @@ def from_id(cls, id: UUID) -> "User":
 
         Examples:
             >>> from argilla import rg
-            >>> user = rg.User.from_id("my-user")
+            >>> from uuid import UUID
+            >>> user = rg.User.from_id(UUID("my-user"))
         """
         client = cls.__active_client()
+
+        try:
+            if not isinstance(id, UUID):
+                id = UUID(id)
+        except BaseClientError as e:
+            raise RuntimeError(f"Error while converting id=`{id}` to UUID. Is it a valid UUID?") from e
         try:
             users = users_api.list_users(client).parsed
             try:

docs/_source/getting_started/installation/configurations/user_management.md

@@ -179,10 +179,10 @@ You can get a user by id using the `from_id` classmethod in the `User` class.
 
 ```python
 import argilla as rg
-
+from uuid import UUID
 rg.init(api_url="<ARGILLA_API_URL>", api_key="<ARGILLA_API_KEY>")
 
-user = rg.User.from_id("00000000-0000-0000-0000-000000000000")
+user = rg.User.from_id(UUID("00000000-0000-0000-0000-000000000000"))
 ```
 
 ### Assign a `User` to a `Workspace`