Updated samples for summary and feedback

Author: aosingh

.gitignore

@@ -17,3 +17,5 @@ pytest.env
 .venv3.11/
 .venv3.9/
 sample_connect.py
+async_pipeline_test.py
+parquet.py

doc/requirements.txt

@@ -1,3 +1,4 @@
 sphinx
 sphinx-rtd-theme
 sphinx_toolbox
+pydata_sphinx_theme

doc/source/conf.py

@@ -52,7 +52,7 @@
 # -- Options for HTML output -------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
-html_theme = "sphinx_rtd_theme"
+html_theme = "python_docs_theme"
 html_static_path = ["_static"]
 
 pygments_style = "sphinx"

doc/source/user_guide/actions.rst

@@ -34,3 +34,12 @@ Following list of actions can be performed using ``select_ai``
     * - showsql
       - ``select_ai.Action.SHOWSQL``
       - Displays the generated SQL statement without executing it.
+    * - summarize
+      - ``select_ai.Action.SUMMARIZE``
+      - Generate summary of your large texts
+    * - feedback
+      - ``select_ai.Action.FEEDBACK``
+      - Provide feedback to improve accuracy of the generated SQL
+    * - translate
+      - ``select_ai.Action.TRANSLATE``
+      - Translate text from one language to another

doc/source/user_guide/agent.rst

@@ -125,7 +125,7 @@ output::
 List Tools
 ++++++++++
 
-.. literalinclude:: ../../../samples/agent/tool_list.py
+.. literalinclude:: ../../../samples/agent/tools_list.py
    :language: python
    :lines: 14-
 
@@ -168,6 +168,7 @@ previous step
 
 .. literalinclude:: ../../../samples/agent/task_create.py
    :language: python
+   :lines: 14-
 
 output::
 
@@ -188,6 +189,7 @@ List Tasks
 
 .. literalinclude:: ../../../samples/agent/tasks_list.py
    :language: python
+   :lines: 14-
 
 output::
 
@@ -219,6 +221,7 @@ Create Agent
 
 .. literalinclude:: ../../../samples/agent/agent_create.py
    :language: python
+   :lines: 14-
 
 output::
 
@@ -254,10 +257,23 @@ Run Team
 
 .. literalinclude:: ../../../samples/agent/team_create.py
    :language: python
+   :lines: 14-
 
 output::
 
-    To list the movies, you can use the SQL query: SELECT m.* FROM "SPARK_DB_USER"."MOVIE" m.
+    The database contains 100 movies with various titles, genres, and release dates. The list includes a wide range of genres such as Action, Comedy, Drama, Thriller, Romance, Adventure, Mystery, Sci-Fi, Historical, Biography, War, Sports, Music, Documentary, Animated, Fantasy, Horror, Western, Family, and more. The release dates are primarily in January and February of 2019. Here is a summary of the movies:
+
+    1. Action Movie (Action, 2019-01-01)
+    2. Comedy Film (Comedy, 2019-01-02)
+    3. Drama Series (Drama, 2019-01-03)
+    4. Thriller Night (Thriller, 2019-01-04)
+    5. Romance Story (Romance, 2019-01-05)
+    6. Adventure Time (Adventure, 2019-01-06)
+    7. Mystery Solver (Mystery, 2019-01-07)
+    8. Sci-Fi World (Sci-Fi, 2019-01-08)
+    9. Historical Epic (Historical, 2019-01-09)
+    10. Biographical (Biography, 2019-01-10)
+    ... (list continues up to 100 movies)
 
 .. latex:clearpage::
 

doc/source/user_guide/async_profile.rst

@@ -177,6 +177,50 @@ output::
 
 .. latex:clearpage::
 
+**************************
+Summarize
+**************************
+
+.. literalinclude:: ../../../samples/async/profile_summarize_content.py
+   :language: python
+   :lines: 14-
+
+output::
+
+    A gas cloud in the Sagittarius B2 galaxy contains a large amount of alcohol,
+    while some stars are cool enough to touch without being burned. The exoplanet
+    55 Cancri e has a unique form of "hot ice" where water remains solid despite
+    high temperatures due to high pressure. Ancient stars in the Milky Way's halo
+    are older than the Sun, providing insights into the early universe and its composition,
+    offering clues about the universe's formation and evolution.
+
+.. latex:clearpage::
+
+
+.. literalinclude:: ../../../samples/async/profile_summarize_uri.py
+   :language: python
+   :lines: 14-
+
+output::
+
+    Astronomy is a natural science that studies celestial objects and phenomena,
+    using mathematics, physics, and chemistry to explain their origin and evolution.
+    The field has a long history, with early civilizations making methodical
+    observations of the night sky, and has since split into observational and
+    theoretical branches. Observational astronomy focuses on acquiring data
+    from observations, while theoretical astronomy develops computer or
+    analytical models to describe astronomical objects and phenomena. The study
+    of astronomy has led to numerous discoveries, including the existence of
+    galaxies, the expansion of the universe, and the detection of gravitational
+    waves. Astronomers use various methods, such as radio, infrared, optical,
+    ultraviolet, X-ray, and gamma-ray astronomy, to study objects and events in
+    the universe. The field has also led to the development of new technologies and
+    has inspired new areas of research, such as astrobiology and the search for
+    extraterrestrial life. Overall, astronomy is a dynamic and constantly evolving
+    field that seeks to understand the universe and its many mysteries.
+
+.. latex:clearpage::
+
 *********************
 Async pipeline
 *********************

doc/source/user_guide/profile.rst

@@ -139,6 +139,50 @@ output::
 
 .. latex:clearpage::
 
+**************************
+Summarize
+**************************
+
+.. literalinclude:: ../../../samples/profile_summarize_content.py
+   :language: python
+   :lines: 14-
+
+output::
+
+    A gas cloud in the Sagittarius B2 galaxy contains a large amount of alcohol,
+    while some stars are cool enough to touch without being burned. The exoplanet
+    55 Cancri e has a unique form of "hot ice" where water remains solid despite
+    high temperatures due to high pressure. Ancient stars in the Milky Way's halo
+    are older than the Sun, providing insights into the early universe and its composition,
+    offering clues about the universe's formation and evolution.
+
+.. latex:clearpage::
+
+
+.. literalinclude:: ../../../samples/profile_summarize_uri.py
+   :language: python
+   :lines: 14-
+
+output::
+
+    Astronomy is a natural science that studies celestial objects and phenomena,
+    using mathematics, physics, and chemistry to explain their origin and evolution.
+    The field has a long history, with early civilizations making methodical
+    observations of the night sky, and has since split into observational and
+    theoretical branches. Observational astronomy focuses on acquiring data
+    from observations, while theoretical astronomy develops computer or
+    analytical models to describe astronomical objects and phenomena. The study
+    of astronomy has led to numerous discoveries, including the existence of
+    galaxies, the expansion of the universe, and the detection of gravitational
+    waves. Astronomers use various methods, such as radio, infrared, optical,
+    ultraviolet, X-ray, and gamma-ray astronomy, to study objects and events in
+    the universe. The field has also led to the development of new technologies and
+    has inspired new areas of research, such as astrobiology and the search for
+    extraterrestrial life. Overall, astronomy is a dynamic and constantly evolving
+    field that seeks to understand the universe and its many mysteries.
+
+.. latex:clearpage::
+
 **************************
 List profiles
 **************************

samples/agent/task_create.py

@@ -21,24 +21,19 @@
 user = os.getenv("SELECT_AI_USER")
 password = os.getenv("SELECT_AI_PASSWORD")
 dsn = os.getenv("SELECT_AI_DB_CONNECT_STRING")
-
 select_ai.connect(user=user, password=password, dsn=dsn)
 
-attributes = TaskAttributes(
-    instruction="Help the user with their request about movies. "
-    "User question: {query}. "
-    "You can use SQL tool to search the data from database",
-    tools=["MOVIE_SQL_TOOL"],
-    enable_human_tool=False,
-)
-
 task = Task(
     task_name="ANALYZE_MOVIE_TASK",
     description="Movie task involving a human",
-    attributes=attributes,
+    attributes=TaskAttributes(
+        instruction="Help the user with their request about movies. "
+        "User question: {query}. "
+        "You can use SQL tool to search the data from database",
+        tools=["MOVIE_SQL_TOOL"],
+        enable_human_tool=False,
+    ),
 )
-
 task.create(replace=True)
-
 print(task.task_name)
 print(pformat(task.attributes))

samples/agent/tool_list.py renamed to samples/agent/tools_list.py

@@ -0,0 +1,32 @@
+# -----------------------------------------------------------------------------
+# Copyright (c) 2025, Oracle and/or its affiliates.
+#
+# Licensed under the Universal Permissive License v 1.0 as shown at
+# http://oss.oracle.com/licenses/upl.
+# -----------------------------------------------------------------------------
+
+# -----------------------------------------------------------------------------
+# async/profile_feedback.py
+# -----------------------------------------------------------------------------
+
+import asyncio
+import os
+
+import select_ai
+
+user = os.getenv("SELECT_AI_USER")
+password = os.getenv("SELECT_AI_PASSWORD")
+dsn = os.getenv("SELECT_AI_DB_CONNECT_STRING")
+
+
+async def main():
+    await select_ai.async_connect(user=user, password=password, dsn=dsn)
+    async_profile = await select_ai.AsyncProfile(
+        profile_name="async_oci_ai_profile",
+    )
+    await async_profile.add_positive_feedback(
+        prompt_spec=("How many promotions ?", select_ai.Action.RUNSQL)
+    )
+
+
+asyncio.run(main())