Update docstrings

Author: tmichaeldb

mindsdb_sdk/agents.py

@@ -17,7 +17,35 @@ def __repr__(self):
 
 
 class Agent:
-    """Represents a MindsDB agent"""
+    """Represents a MindsDB agent.
+    
+    Working with agents:
+
+    Get an agent by name:
+    >>> agent = agents.get('my_agent')
+
+    Query an agent:
+    >>> completion = agent.completion([{'question': 'What is your name?', 'answer': None}])
+    >>> print(completion.content)
+
+    List all agents:
+    >>> agents = agents.list()
+
+    Create a new agent:
+    >>> model = models.get('my_model') # Or use models.create(...)
+    >>> # Connect your agent to a MindsDB table.
+    >>> text_to_sql_skill = skills.create('text_to_sql', 'sql', { 'tables': ['my_table'], 'database': 'my_database' })
+    >>> agent = agents.create('my_agent', model, [text_to_sql_skill])
+
+    Update an agent:
+    >>> new_model = models.get('new_model')
+    >>> agent.model_name = new_model.name
+    >>> new_skill = skills.create('new_skill', 'sql', { 'tables': ['new_table'], 'database': 'new_database' })
+    >>> updated_agent = agents.update('my_agent', agent)
+
+    Delete an agent by name:
+    >>> agents.delete('my_agent')
+    """
     def __init__(
             self,
             name: str,

mindsdb_sdk/skills.py

@@ -4,7 +4,26 @@
 
 
 class Skill():
-    """Represents a MindsDB skill"""
+    """Represents a MindsDB skill
+
+    Working with skills:
+
+    Get a skill by name:
+    >>> skill = skills.get('my_skill')
+
+    List all skills:
+    >>> skills = skills.list()
+
+    Create a new SQL skill:
+    >>> text_to_sql_skill = skills.create('text_to_sql', 'sql', { 'tables': ['my_table'], 'database': 'my_database' })
+
+    Update a skill:
+    >>> skill.params = { 'tables': ['new_table'], 'database': 'new_database' }
+    >>> updated_skill = skills.update('my_skill', skill)
+
+    Delete a skill by name
+    >>> skills.delete('my_skill')
+    """
     def __init__(
             self,
             name: str,