vectara-agentic 0.1.25__py3-none-any.whl → 0.1.26__py3-none-any.whl

vectara_agentic/_version.py

@@ -1,4 +1,4 @@
 """
 Define the version of the package.
 """
-__version__ = "0.1.25"
+__version__ = "0.1.26"

vectara_agentic/agent.py

@@ -397,8 +397,8 @@ class Agent:
                 print(f"- {tool.metadata.name}")
             else:
                 print("- tool without metadata")
-        print(f"Agent LLM = {get_llm(LLMRole.MAIN).metadata.model_name}")
-        print(f"Tool LLM = {get_llm(LLMRole.TOOL).metadata.model_name}")
+        print(f"Agent LLM = {get_llm(LLMRole.MAIN, config=self.agent_config).metadata.model_name}")
+        print(f"Tool LLM = {get_llm(LLMRole.TOOL, config=self.agent_config).metadata.model_name}")
 
     def token_counts(self) -> dict:
         """

vectara_agentic/tools.py

@@ -19,9 +19,10 @@ from llama_index.core.tools.types import ToolMetadata, ToolOutput
 
 
 from .types import ToolType
-from .tools_catalog import summarize_text, rephrase_text, critique_text, get_bad_topics
+from .tools_catalog import ToolsCatalog, get_bad_topics
 from .db_tools import DBLoadSampleData, DBLoadUniqueValues, DBLoadData
 from .utils import is_float
+from .agent_config import AgentConfig
 
 LI_packages = {
     "yahoo_finance": ToolType.QUERY,
@@ -624,6 +625,9 @@ class ToolsFactory:
     A factory class for creating agent tools.
     """
 
+    def __init__(self, agent_config: AgentConfig = None) -> None:
+        self.agent_config = agent_config
+
     def create_tool(self, function: Callable, tool_type: ToolType = ToolType.QUERY) -> VectaraTool:
         """
         Create a tool from a function.
@@ -686,7 +690,8 @@ class ToolsFactory:
         """
         Create a list of standard tools.
         """
-        return [self.create_tool(tool) for tool in [summarize_text, rephrase_text]]
+        tc = ToolsCatalog(self.agent_config)
+        return [self.create_tool(tool) for tool in [tc.summarize_text, tc.rephrase_text, tc.critique_text]]
 
     def guardrail_tools(self) -> List[FunctionTool]:
         """
@@ -711,7 +716,8 @@ class ToolsFactory:
             """
             Use this tool to summarize legal text with no more than summary_max_length characters.
             """
-            return summarize_text(text, expertise="law")
+            tc = ToolsCatalog(self.agent_config)
+            return tc.summarize_text(text, expertise="law")
 
         def critique_as_judge(
             text: str = Field(description="the original text."),
@@ -719,7 +725,8 @@ class ToolsFactory:
             """
             Critique the legal document.
             """
-            return critique_text(
+            tc = ToolsCatalog(self.agent_config)
+            return tc.critique_text(
                 text,
                 role="judge",
                 point_of_view="""

vectara_agentic/tools_catalog.py

@@ -2,13 +2,15 @@
 This module contains the tools catalog for the Vectara Agentic.
 """
 from typing import List
-from functools import lru_cache
 from datetime import date
+
+from inspect import signature
 import requests
 
 from pydantic import Field
 
 from .types import LLMRole
+from .agent_config import AgentConfig
 from .utils import get_llm
 
 req_session = requests.Session()
@@ -27,97 +29,114 @@ def get_current_date() -> str:
     """
     return date.today().strftime("%A, %B %d, %Y")
 
-#
-# Standard Tools
-#
-@lru_cache(maxsize=None)
-def summarize_text(
-    text: str = Field(description="the original text."),
-    expertise: str = Field(
-        description="the expertise to apply to the summarization.",
-    ),
-) -> str:
-    """
-    This is a helper tool.
-    Use this tool to summarize text using a given expertise
-    with no more than summary_max_length characters.
-
-    Args:
-        text (str): The original text.
-        expertise (str): The expertise to apply to the summarization.
-
-    Returns:
-        str: The summarized text.
-    """
-    if not isinstance(expertise, str):
-        return "Please provide a valid string for expertise."
-    if not isinstance(text, str):
-        return "Please provide a valid string for text."
-    expertise = "general" if len(expertise) < 3 else expertise.lower()
-    prompt = f"As an expert in {expertise}, summarize the provided text"
-    prompt += " into a concise summary."
-    prompt += f"\noriginal text: {text}\nsummary:"
-    llm = get_llm(LLMRole.TOOL)
-    response = llm.complete(prompt)
-    return response.text
-
-
-@lru_cache(maxsize=None)
-def rephrase_text(
-    text: str = Field(description="the original text."),
-    instructions: str = Field(description="the specific instructions for how to rephrase the text."),
-) -> str:
-    """
-    This is a helper tool.
-    Use this tool to rephrase the text according to the provided instructions.
-    For example, instructions could be "as a 5 year old would say it."
 
-    Args:
-        text (str): The original text.
-        instructions (str): The specific instructions for how to rephrase the text.
+def remove_self_from_signature(func):
+    """Decorator to remove 'self' from a method's signature for introspection."""
+    sig = signature(func)
+    params = list(sig.parameters.values())
+    # Remove the first parameter if it is named 'self'
+    if params and params[0].name == "self":
+        params = params[1:]
+    new_sig = sig.replace(parameters=params)
+    func.__signature__ = new_sig
+    return func
 
-    Returns:
-        str: The rephrased text.
+class ToolsCatalog:
     """
-    prompt = f"""
-    Rephrase the provided text according to the following instructions: {instructions}.
-    If the input is Markdown, keep the output in Markdown as well.
-    original text: {text}
-    rephrased text:
+    A curated set of tools for vectara-agentic
     """
-    llm = get_llm(LLMRole.TOOL)
-    response = llm.complete(prompt)
-    return response.text
-
-
-@lru_cache(maxsize=None)
-def critique_text(
-    text: str = Field(description="the original text."),
-    role: str = Field(default=None, description="the role of the person providing critique."),
-    point_of_view: str = Field(default=None, description="the point of view with which to provide critique."),
-) -> str:
-    """
-    This is a helper tool.
-    Critique the text from the specified point of view.
-
-    Args:
-        text (str): The original text.
-        role (str): The role of the person providing critique.
-        point_of_view (str): The point of view with which to provide critique.
-
-    Returns:
-        str: The critique of the text.
-    """
-    if role:
-        prompt = f"As a {role}, critique the provided text from the point of view of {point_of_view}."
-    else:
-        prompt = f"Critique the provided text from the point of view of {point_of_view}."
-    prompt += "Structure the critique as bullet points.\n"
-    prompt += f"Original text: {text}\nCritique:"
-    llm = get_llm(LLMRole.TOOL)
-    response = llm.complete(prompt)
-    return response.text
-
+    def __init__(self, agent_config: AgentConfig):
+        self.agent_config = agent_config
+
+    @remove_self_from_signature
+    def summarize_text(
+        self,
+        text: str = Field(description="the original text."),
+        expertise: str = Field(
+            description="the expertise to apply to the summarization.",
+        ),
+    ) -> str:
+        """
+        This is a helper tool.
+        Use this tool to summarize text using a given expertise
+        with no more than summary_max_length characters.
+
+        Args:
+            text (str): The original text.
+            expertise (str): The expertise to apply to the summarization.
+
+        Returns:
+            str: The summarized text.
+        """
+        if not isinstance(expertise, str):
+            return "Please provide a valid string for expertise."
+        if not isinstance(text, str):
+            return "Please provide a valid string for text."
+        expertise = "general" if len(expertise) < 3 else expertise.lower()
+        prompt = (
+            f"As an expert in {expertise}, summarize the provided text "
+            "into a concise summary.\n"
+            f"Original text: {text}\nSummary:"
+        )
+        llm = get_llm(LLMRole.TOOL, config=self.agent_config)
+        response = llm.complete(prompt)
+        return response.text
+
+    @remove_self_from_signature
+    def rephrase_text(
+        self,
+        text: str = Field(description="the original text."),
+        instructions: str = Field(description="the specific instructions for how to rephrase the text."),
+    ) -> str:
+        """
+        This is a helper tool.
+        Use this tool to rephrase the text according to the provided instructions.
+        For example, instructions could be "as a 5 year old would say it."
+
+        Args:
+            text (str): The original text.
+            instructions (str): The specific instructions for how to rephrase the text.
+
+        Returns:
+            str: The rephrased text.
+        """
+        prompt = (
+            f"Rephrase the provided text according to the following instructions: {instructions}.\n"
+            "If the input is Markdown, keep the output in Markdown as well.\n"
+            f"Original text: {text}\nRephrased text:"
+        )
+        llm = get_llm(LLMRole.TOOL, config=self.agent_config)
+        response = llm.complete(prompt)
+        return response.text
+
+    @remove_self_from_signature
+    def critique_text(
+        self,
+        text: str = Field(description="the original text."),
+        role: str = Field(default=None, description="the role of the person providing critique."),
+        point_of_view: str = Field(default=None, description="the point of view with which to provide critique."),
+    ) -> str:
+        """
+        This is a helper tool.
+        Critique the text from the specified point of view.
+
+        Args:
+            text (str): The original text.
+            role (str): The role of the person providing critique.
+            point_of_view (str): The point of view with which to provide critique.
+
+        Returns:
+            str: The critique of the text.
+        """
+        if role:
+            prompt = f"As a {role}, critique the provided text from the point of view of {point_of_view}."
+        else:
+            prompt = f"Critique the provided text from the point of view of {point_of_view}."
+        prompt += "\nStructure the critique as bullet points.\n"
+        prompt += f"Original text: {text}\nCritique:"
+        llm = get_llm(LLMRole.TOOL, config=self.agent_config)
+        response = llm.complete(prompt)
+        return response.text
 
 #
 # Guardrails tool: returns list of topics to avoid

{vectara_agentic-0.1.25.dist-info → vectara_agentic-0.1.26.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: vectara_agentic
-Version: 0.1.25
+Version: 0.1.26
 Summary: A Python package for creating AI Assistants and AI Agents with Vectara
 Home-page: https://github.com/vectara/py-vectara-agentic
 Author: Ofer Mendelevitch
@@ -21,7 +21,7 @@ Requires-Dist: llama-index-indices-managed-vectara==0.3.1
 Requires-Dist: llama-index-agent-llm-compiler==0.3.0
 Requires-Dist: llama-index-agent-lats==0.3.0
 Requires-Dist: llama-index-agent-openai==0.4.3
-Requires-Dist: llama-index-llms-openai==0.3.16
+Requires-Dist: llama-index-llms-openai==0.3.18
 Requires-Dist: llama-index-llms-anthropic==0.6.4
 Requires-Dist: llama-index-llms-together==0.3.1
 Requires-Dist: llama-index-llms-groq==0.3.1
@@ -265,11 +265,22 @@ similar queries that require a response in terms of a list of matching documents
 
 ## 🛠️ Agent Tools at a Glance
 
-`vectara-agentic` provides a few tools out of the box:
+`vectara-agentic` provides a few tools out of the box (see ToolsCatalog for details):
+
 1. **Standard tools**: 
 - `summarize_text`: a tool to summarize a long text into a shorter summary (uses LLM)
 - `rephrase_text`: a tool to rephrase a given text, given a set of rephrase instructions (uses LLM)
-  
+These tools use an LLM and so would use the `Tools` LLM specified in your `AgentConfig`.
+To instantiate them:
+
+```python
+from vectara_agentic.tools_catalog import ToolsCatalog
+summarize_text = ToolsCatalog(agent_config).summarize_text
+```
+
+This ensures the summarize_text tool is configured with the proper LLM provider and model as 
+specified in the Agent configuration.
+
 2. **Legal tools**: a set of tools for the legal vertical, such as:
 - `summarize_legal_text`: summarize legal text with a certain point of view
 - `critique_as_judge`: critique a legal text as a judge, providing their perspective
@@ -306,19 +317,44 @@ mult_tool = ToolsFactory().create_tool(mult_func)
 
 ## 🛠️ Configuration
 
+## Configuring Vectara-agentic
+
 The main way to control the behavior of `vectara-agentic` is by passing an `AgentConfig` object to your `Agent` when creating it.
-This object will include the following items:
-- `VECTARA_AGENTIC_AGENT_TYPE`: valid values are `REACT`, `LLMCOMPILER`, `LATS` or `OPENAI` (default: `OPENAI`)
-- `VECTARA_AGENTIC_MAIN_LLM_PROVIDER`: valid values are `OPENAI`, `ANTHROPIC`, `TOGETHER`, `GROQ`, `COHERE`, `BEDROCK`, `GEMINI` or `FIREWORKS` (default: `OPENAI`)
-- `VECTARA_AGENTIC_MAIN_MODEL_NAME`: agent model name (default depends on provider)
-- `VECTARA_AGENTIC_TOOL_LLM_PROVIDER`: tool LLM provider (default: `OPENAI`)
-- `VECTARA_AGENTIC_TOOL_MODEL_NAME`: tool model name (default depends on provider)
-- `VECTARA_AGENTIC_OBSERVER_TYPE`: valid values are `ARIZE_PHOENIX` or `NONE` (default: `NONE`)
-- `VECTARA_AGENTIC_API_KEY`: a secret key if using the API endpoint option (defaults to `dev-api-key`)
+For example:
+
+```python
+agent_config = AgentConfig(
+    agent_type = AgentType.REACT,
+    main_llm_provider = ModelProvider.ANTHROPIC,
+    main_llm_model_name = 'claude-3-5-sonnet-20241022',
+    tool_llm_provider = ModelProvider.TOGETHER,
+    tool_llm_model_name = 'meta-llama/Llama-3.3-70B-Instruct-Turbo'
+)
+
+agent = Agent(
+    tools=[query_financial_reports_tool],
+    topic="10-K financial reports",
+    custom_instructions="You are a helpful financial assistant in conversation with a user.",
+    agent_config=agent_config
+)
+```
+
+The `AgentConfig` object may include the following items:
+- `agent_type`: the agent type. Valid values are `REACT`, `LLMCOMPILER`, `LATS` or `OPENAI` (default: `OPENAI`).
+- `main_llm_provider` and `tool_llm_provider`: the LLM provider for main agent and for the tools. Valid values are `OPENAI`, `ANTHROPIC`, `TOGETHER`, `GROQ`, `COHERE`, `BEDROCK`, `GEMINI` or `FIREWORKS` (default: `OPENAI`).
+- `main_llm_model_name` and `tool_llm_model_name`: agent model name for agent and tools (default depends on provider).
+- `observer`: the observer type; should be `ARIZE_PHOENIX` or if undefined no observation framework will be used.
+- `endpoint_api_key`: a secret key if using the API endpoint option (defaults to `dev-api-key`)
 
 If any of these are not provided, `AgentConfig` first tries to read the values from the OS environment.
 
-When creating a `VectaraToolFactory`, you can pass in a `vectara_api_key`, `vectara_customer_id`, and `vectara_corpus_id` to the factory. If not passed in, it will be taken from the environment variables (`VECTARA_API_KEY`, `VECTARA_CUSTOMER_ID` and `VECTARA_CORPUS_ID`). Note that `VECTARA_CORPUS_ID` can be a single ID or a comma-separated list of IDs (if you want to query multiple corpora).
+## Configuring Vectara RAG or search tools
+
+When creating a `VectaraToolFactory`, you can pass in a `vectara_api_key`, `vectara_customer_id`, and `vectara_corpus_id` to the factory. 
+
+If not passed in, it will be taken from the environment variables (`VECTARA_API_KEY`, `VECTARA_CUSTOMER_ID` and `VECTARA_CORPUS_ID`). Note that `VECTARA_CORPUS_ID` can be a single ID or a comma-separated list of IDs (if you want to query multiple corpora).
+
+These values will be used as credentials when creating Vectara tools - in `create_rag_tool()` and `create_search_tool()`.
 
 ## ℹ️ Additional Information
 

{vectara_agentic-0.1.25.dist-info → vectara_agentic-0.1.26.dist-info}/RECORD

@@ -5,17 +5,17 @@ vectara_agentic/__init__.py,sha256=ADH4fPKLbpGNYYYszv3c3QDOjPToPE_qh3LpkH_seCU,4
 vectara_agentic/_callback.py,sha256=OBiHk_OJZTS3iKz_LigfEjnl_p5V90XYsQC0vEYVSPo,8782
 vectara_agentic/_observability.py,sha256=HeQYJIkqPLW3EWHiXHatkaJzo08IQGESKujdeWTuRgk,3805
 vectara_agentic/_prompts.py,sha256=mgGx3zUJPtpS1epBLtl0BnoLeE7wb6AX1SX6dFNaTTQ,6368
-vectara_agentic/_version.py,sha256=90Cr_yLyeFeoJ2YK_LHwWc15gk11Emy9cx1xS0hlwtc,66
-vectara_agentic/agent.py,sha256=1-dno6FrC5sMuJ2nei9o2r3E53sg0dM6p-zn25hxRN0,25979
+vectara_agentic/_version.py,sha256=Fg_mimtI4WLCh87AZhsbvuJjEepRJHslbknNvA70s_Q,66
+vectara_agentic/agent.py,sha256=jUXiwhN6pJl3zWb01oF1PwbZCWWOE96aD8A6GsR2TC0,26031
 vectara_agentic/agent_config.py,sha256=9P9lyFAAXLX1ft2dBQ6tYN7dKzp7SC7B-h-DnhUHsSg,2941
 vectara_agentic/agent_endpoint.py,sha256=QIMejCLlpW2qzXxeDAxv3anF46XMDdVMdKGWhJh3azY,1996
 vectara_agentic/db_tools.py,sha256=kCEENzmnorm8i-k4Kpd4KLJt1QWh_ZlAyX1aG-tzET0,3619
-vectara_agentic/tools.py,sha256=8FNnlTj57VTCYCaUfNWCongg38_lwnEoWdc2idCX6Jw,34087
-vectara_agentic/tools_catalog.py,sha256=DDHoPuA88jiixZjNSuGIuZCB7NSsQXdbbhrbVrtR2Ec,4141
+vectara_agentic/tools.py,sha256=pWRiuHLoS8jxmiuHTepWT-mbn9NUJqrjWOf5Q3u_MSs,34374
+vectara_agentic/tools_catalog.py,sha256=O3vYFpZ5EQeh37X70TiHepXFGN5yGk4_d7CkrkLeUhk,5205
 vectara_agentic/types.py,sha256=00wm3YsJRyddvIBzeVjF3qklA38NuTkCvy_B-e68v6c,1589
 vectara_agentic/utils.py,sha256=eDEOUpCkb0r216LxSLkamll2NmJhu76Z1TgQFbAVq7A,4690
-vectara_agentic-0.1.25.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-vectara_agentic-0.1.25.dist-info/METADATA,sha256=TtClmE0CpgC9qcJlSWxFnTywur0fFK3UkIKnmyZIkGs,19469
-vectara_agentic-0.1.25.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-vectara_agentic-0.1.25.dist-info/top_level.txt,sha256=Y7TQTFdOYGYodQRltUGRieZKIYuzeZj2kHqAUpfCUfg,22
-vectara_agentic-0.1.25.dist-info/RECORD,,
+vectara_agentic-0.1.26.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+vectara_agentic-0.1.26.dist-info/METADATA,sha256=PeWZ9nc92otAPQJC27UCgHqBOXnuwWA4MrGvBAPuamE,20565
+vectara_agentic-0.1.26.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+vectara_agentic-0.1.26.dist-info/top_level.txt,sha256=Y7TQTFdOYGYodQRltUGRieZKIYuzeZj2kHqAUpfCUfg,22
+vectara_agentic-0.1.26.dist-info/RECORD,,