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

vectara_agentic/tools_catalog.py

@@ -2,11 +2,15 @@
 This module contains the tools catalog for the Vectara Agentic.
 """
 from typing import List
-from functools import lru_cache
-from pydantic import Field
+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()
@@ -19,98 +23,120 @@ get_headers = {
     "Connection": "keep-alive",
 }
 
-
-#
-# 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.
+def get_current_date() -> str:
     """
-    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:
+    Returns: the current date.
     """
-    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."
+    return date.today().strftime("%A, %B %d, %Y")
 
-    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}.
-    If the input is Markdown, keep the output in Markdown as well.
-    original text: {text}
-    rephrased text:
-    """
-    llm = get_llm(LLMRole.TOOL)
-    response = llm.complete(prompt)
-    return response.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
 
-@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:
+class ToolsCatalog:
     """
-    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.
+    A curated set of tools for vectara-agentic
     """
-    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/types.py

@@ -3,6 +3,9 @@ This module contains the types used in the Vectara Agentic.
 """
 from enum import Enum
 
+from llama_index.core.tools.types import ToolOutput as LI_ToolOutput
+from llama_index.core.chat_engine.types import AgentChatResponse as LI_AgentChatResponse
+from llama_index.core.chat_engine.types import StreamingAgentChatResponse as LI_StreamingAgentChatResponse
 
 class AgentType(Enum):
     """Enumeration for different types of agents."""
@@ -29,6 +32,7 @@ class ModelProvider(Enum):
     FIREWORKS = "FIREWORKS"
     COHERE = "COHERE"
     GEMINI = "GEMINI"
+    BEDROCK = "BEDROCK"
 
 
 class AgentStatusType(Enum):
@@ -51,3 +55,9 @@ class ToolType(Enum):
     """Enumeration for different types of tools."""
     QUERY = "query"
     ACTION = "action"
+
+
+# classes for Agent responses
+ToolOutput = LI_ToolOutput
+AgentResponse = LI_AgentChatResponse
+AgentStreamingResponse = LI_StreamingAgentChatResponse

vectara_agentic/utils.py

@@ -20,6 +20,7 @@ provider_to_default_model_name = {
     ModelProvider.TOGETHER: "meta-llama/Llama-3.3-70B-Instruct-Turbo",
     ModelProvider.GROQ: "llama-3.3-70b-versatile",
     ModelProvider.FIREWORKS: "accounts/fireworks/models/firefunction-v2",
+    ModelProvider.BEDROCK: "anthropic.claude-3-5-sonnet-20241022-v2:0",
     ModelProvider.COHERE: "command-r-plus",
     ModelProvider.GEMINI: "models/gemini-1.5-flash",
 }
@@ -105,6 +106,9 @@ def get_llm(
     elif model_provider == ModelProvider.FIREWORKS:
         from llama_index.llms.fireworks import Fireworks
         llm = Fireworks(model=model_name, temperature=0)
+    elif model_provider == ModelProvider.BEDROCK:
+        from llama_index.llms.bedrock import Bedrock
+        llm = Bedrock(model=model_name, temperature=0)
     elif model_provider == ModelProvider.COHERE:
         from llama_index.llms.cohere import Cohere
         llm = Cohere(model=model_name, temperature=0)

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: vectara_agentic
-Version: 0.1.24
+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
@@ -16,39 +16,39 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: llama-index==0.12.7
+Requires-Dist: llama-index==0.12.11
 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.1
-Requires-Dist: llama-index-llms-openai==0.3.12
-Requires-Dist: llama-index-llms-anthropic==0.6.3
+Requires-Dist: llama-index-agent-openai==0.4.3
+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
-Requires-Dist: llama-index-llms-fireworks==0.3.0
+Requires-Dist: llama-index-llms-fireworks==0.3.1
 Requires-Dist: llama-index-llms-cohere==0.4.0
-Requires-Dist: llama-index-llms-gemini==0.4.2
+Requires-Dist: llama-index-llms-gemini==0.4.4
+Requires-Dist: llama-index-llms-bedrock==0.3.3
 Requires-Dist: llama-index-tools-yahoo-finance==0.3.0
 Requires-Dist: llama-index-tools-arxiv==0.3.0
 Requires-Dist: llama-index-tools-database==0.3.0
 Requires-Dist: llama-index-tools-google==0.3.0
 Requires-Dist: llama-index-tools-tavily_research==0.3.0
 Requires-Dist: llama-index-tools-neo4j==0.3.0
-Requires-Dist: llama-index-graph-stores-kuzu==0.5.0
+Requires-Dist: llama-index-graph-stores-kuzu==0.6.0
 Requires-Dist: llama-index-tools-slack==0.3.0
 Requires-Dist: llama-index-tools-exa==0.3.0
 Requires-Dist: tavily-python==0.5.0
-Requires-Dist: exa-py==1.7.0
+Requires-Dist: exa-py==1.8.5
 Requires-Dist: yahoo-finance==1.4.0
-Requires-Dist: openinference-instrumentation-llama-index==3.0.3
+Requires-Dist: openinference-instrumentation-llama-index==3.1.4
 Requires-Dist: opentelemetry-proto==1.26.0
-Requires-Dist: arize-phoenix==5.7.0
+Requires-Dist: arize-phoenix==7.11.0
 Requires-Dist: arize-phoenix-otel==0.6.1
 Requires-Dist: protobuf==4.25.5
 Requires-Dist: tokenizers>=0.20
-Requires-Dist: pydantic==2.9.2
+Requires-Dist: pydantic==2.10.3
 Requires-Dist: retrying==1.3.4
-Requires-Dist: pymongo==4.10.1
 Requires-Dist: python-dotenv==1.0.1
 Requires-Dist: tiktoken==0.8.0
 Requires-Dist: dill>=0.3.7
@@ -87,7 +87,7 @@ Dynamic: summary
 
 ## ✨ Overview
 
-`vectara-agentic` is a Python library for developing powerful AI assistants and agents using Vectara and Agentic-RAG. It leverages the LlamaIndex Agent framework, customized for use with Vectara.
+`vectara-agentic` is a Python library for developing powerful AI assistants and agents using Vectara and Agentic-RAG. It leverages the LlamaIndex Agent framework and provides helper functions to quickly create tools that connect to Vectara corpora.
 
 <p align="center">
 <img src="https://raw.githubusercontent.com/vectara/py-vectara-agentic/main/.github/assets/diagram1.png" alt="Agentic RAG diagram" width="100%" style="vertical-align: middle;">
@@ -96,10 +96,10 @@ Dynamic: summary
 ###  Features
 
 - Enables easy creation of custom AI assistants and agents.
-- Create a Vectara RAG tool with a single line of code.
-- Supports `ReAct`, `OpenAIAgent`, `LATS' and `LLMCompiler` agent types.
+- Create a Vectara RAG tool or search tool with a single line of code.
+- Supports `ReAct`, `OpenAIAgent`, `LATS` and `LLMCompiler` agent types.
 - Includes pre-built tools for various domains (e.g., finance, legal).
-- Integrates with various LLM inference services like OpenAI, Anthropic, Gemini, GROQ, Together.AI, Cohere and Fireworks
+- Integrates with various LLM inference services like OpenAI, Anthropic, Gemini, GROQ, Together.AI, Cohere, Bedrock and Fireworks
 - Built-in support for observability with Arize Phoenix
 
 ### 📚 Example AI Assistants
@@ -109,14 +109,14 @@ Check out our example AI assistants:
 - [Financial Assistant](https://huggingface.co/spaces/vectara/finance-chat)
 - [Justice Harvard Teaching Assistant](https://huggingface.co/spaces/vectara/Justice-Harvard)
 - [Legal Assistant](https://huggingface.co/spaces/vectara/legal-agent)
-
+- [EV Assistant](https://huggingface.co/spaces/vectara/ev-assistant)
 
 ###  Prerequisites
 
 - [Vectara account](https://console.vectara.com/signup/?utm_source=github&utm_medium=code&utm_term=DevRel&utm_content=vectara-agentic&utm_campaign=github-code-DevRel-vectara-agentic)
 - A Vectara corpus with an [API key](https://docs.vectara.com/docs/api-keys)
 - [Python 3.10 or higher](https://www.python.org/downloads/)
-- OpenAI API key (or API keys for Anthropic, TOGETHER.AI, Fireworks AI, Cohere, GEMINI or GROQ, if you choose to use them)
+- OpenAI API key (or API keys for Anthropic, TOGETHER.AI, Fireworks AI, Bedrock, Cohere, GEMINI or GROQ, if you choose to use them)
 
 ###  Installation
 
@@ -126,18 +126,25 @@ pip install vectara-agentic
 
 ## 🚀 Quick Start
 
-### 1. Create a Vectara RAG tool
+### 1. Initialize the Vectara tool factory
 
 ```python
 import os
 from vectara_agentic.tools import VectaraToolFactory
-from pydantic import BaseModel, Field
 
 vec_factory = VectaraToolFactory(
     vectara_api_key=os.environ['VECTARA_API_KEY'],
     vectara_customer_id=os.environ['VECTARA_CUSTOMER_ID'],
     vectara_corpus_id=os.environ['VECTARA_CORPUS_ID']
 )
+```
+
+### 2. Create a Vectara RAG Tool
+
+A RAG tool calls the full Vectara RAG pipeline to provide summarized responses to queries grounded in data.
+
+```python
+from pydantic import BaseModel, Field
 
 years = list(range(2020, 2024))
 tickers = {
@@ -156,17 +163,22 @@ query_financial_reports_tool = vec_factory.create_rag_tool(
     tool_name="query_financial_reports",
     tool_description="Query financial reports for a company and year",
     tool_args_schema=QueryFinancialReportsArgs,
+    lambda_val=0.005,
+    summary_num_results=7, 
+    # Additional arguments
 )
 ```
 
-### 2. Create other tools (optional)
+See the [docs](https://vectara.github.io/vectara-agentic-docs/) for additional arguments to customize your Vectara RAG tool.
+
+### 3. Create other tools (optional)
 
 In addition to RAG tools, you can generate a lot of other types of tools the agent can use. These could be mathematical tools, tools 
 that call other APIs to get more information, or any other type of tool.
 
 See [Agent Tools](#agent-tools) for more information.
 
-### 3. Create your agent
+### 4. Create your agent
 
 ```python
 from vectara_agentic import Agent
@@ -186,20 +198,89 @@ agent = Agent(
 )
 ```
 
-### 4. Run your agent
+See the [docs](https://vectara.github.io/vectara-agentic-docs/) for additional arguments, including `agent_progress_callback` and `query_logging_callback`.
+
+### 5. Run your agent
 
 ```python
-response = agent.chat("What was the revenue for Apple in 2021?")
-print(response)
+res = agent.chat("What was the revenue for Apple in 2021?")
+print(res.response)
+```
+
+Note that:
+1. `vectara-agentic` also supports `achat()` and two streaming variants `stream_chat()` and `astream_chat()`.
+2. The response types from `chat()` and `achat()` are of type `AgentResponse`. If you just need the actual string
+   response it's available as the `response` variable, or just use `str()`. For advanced use-cases you can look 
+   at other `AgentResponse` variables [such as `sources`](https://github.com/run-llama/llama_index/blob/659f9faaafbecebb6e6c65f42143c0bf19274a37/llama-index-core/llama_index/core/chat_engine/types.py#L53).
+
+## 🧰 Vectara tools
+
+`vectara-agentic` provides two helper functions to connect with Vectara RAG
+* `create_rag_tool()` to create an agent tool that connects with a Vectara corpus for querying. 
+* `create_search_tool()` to create a tool to search a Vectara corpus and return a list of matching documents.
+
+See the documentation for the full list of arguments for `create_rag_tool()` and `create_search_tool()`, 
+to understand how to configure Vectara query performed by those tools.
+
+### Creating a Vectara RAG tool
+
+A Vectara RAG tool is often the main workhorse for any Agentic RAG application, and enables the agent to query 
+one or more Vectara RAG corpora. 
+
+The tool generated always includes the `query` argument, followed by 1 or more optional arguments used for 
+metadata filtering, defined by `tool_args_schema`.
+
+For example, in the quickstart example the schema is:
+
 ```
+class QueryFinancialReportsArgs(BaseModel):
+    query: str = Field(..., description="The user query.")
+    year: int | str = Field(..., description=f"The year this query relates to. An integer between {min(years)} and {max(years)} or a string specifying a condition on the year (example: '>2020').")
+    ticker: str = Field(..., description=f"The company ticker. Must be a valid ticket symbol from the list {tickers.keys()}.")
+```
+
+The `query` is required and is always the query string.
+The other arguments are optional and will be interpreted as Vectara metadata filters.
 
-## 🛠️ Agent Tools
+For example, in the example above, the agent may call the `query_financial_reports_tool` tool with 
+query='what is the revenue?', year=2022 and ticker='AAPL'. Subsequently the RAG tool will issue
+a Vectara RAG query with the same query, but with metadata filtering (doc.year=2022 and doc.ticker='AAPL').
+
+There are also additional cool features supported here:
+* An argument can be a condition, for example year='>2022' translates to the correct metadata 
+  filtering condition doc.year>2022
+* if `fixed_filter` is defined in the RAG tool, it provides a constant metadata filtering that is always applied.
+  For example, if fixed_filter=`doc.filing_type='10K'` then a query with query='what is the reveue', year=2022
+  and ticker='AAPL' would translate into query='what is the revenue' with metadata filtering condition of
+  "doc.year=2022 AND doc.ticker='AAPL' and doc.filing_type='10K'"
+
+Note that `tool_args_type` is an optional dictionary that indicates the level at which metadata filtering
+is applied for each argument (`doc` or `part`)
+
+### Creating a Vectara search tool
+
+The Vectara search tool allows the agent to list documents that match a query.
+This can be helpful to the agent to answer queries like "how many documents discuss the iPhone?" or other
+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 (see ToolsCatalog for details):
 
-`vectara-agentic` provides a few tools out of the box:
 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
@@ -217,10 +298,9 @@ print(response)
 - `load_unique_values`: returns the top unique values for a given column
 
 In addition, we include various other tools from LlamaIndex ToolSpecs:
-* Tavily search
-* EXA.AI
+* Tavily search and EXA.AI
 * arxiv
-* neo4j & Kuzu for Graph integration
+* neo4j & Kuzu for Graph DB integration
 * Google tools (including gmail, calendar, and search)
 * Slack
 
@@ -237,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`, `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.26.dist-info/RECORD

@@ -0,0 +1,21 @@
+tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/test_agent.py,sha256=8LQlny0rIuVa13LGtebG0vatES6Ln7gmenbSwX-ctrY,4260
+tests/test_tools.py,sha256=2ofZYz3Q-YMSxjpiEg1VNUlA9gMjvNAcJAO2Ucd0eVE,2969
+vectara_agentic/__init__.py,sha256=ADH4fPKLbpGNYYYszv3c3QDOjPToPE_qh3LpkH_seCU,430
+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=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=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.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,,

vectara_agentic-0.1.24.dist-info/RECORD

@@ -1,21 +0,0 @@
-tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tests/test_agent.py,sha256=8LQlny0rIuVa13LGtebG0vatES6Ln7gmenbSwX-ctrY,4260
-tests/test_tools.py,sha256=2ofZYz3Q-YMSxjpiEg1VNUlA9gMjvNAcJAO2Ucd0eVE,2969
-vectara_agentic/__init__.py,sha256=FUWwh37ia9AduK4YDo_TCD52A09ocbYo49oYyBJtyqY,219
-vectara_agentic/_callback.py,sha256=OBiHk_OJZTS3iKz_LigfEjnl_p5V90XYsQC0vEYVSPo,8782
-vectara_agentic/_observability.py,sha256=HeQYJIkqPLW3EWHiXHatkaJzo08IQGESKujdeWTuRgk,3805
-vectara_agentic/_prompts.py,sha256=ITHWQQ4oSmRhqBwRcheYC_nMdZZielUOjfVIbDYi9rw,6257
-vectara_agentic/_version.py,sha256=3P-p27Ccx3RQ_PJQDAu-lIwPrPQ8S780FnRmeItjqNg,66
-vectara_agentic/agent.py,sha256=35dc7RBYevvX9XGz1WoPRQL6N8NnWxL_Eac56e1JpFo,22427
-vectara_agentic/agent_config.py,sha256=8q_eRPURAZYHUXu_rxD2eO1XHC9jNGe_d9ytPgXbS7g,2949
-vectara_agentic/agent_endpoint.py,sha256=QIMejCLlpW2qzXxeDAxv3anF46XMDdVMdKGWhJh3azY,1996
-vectara_agentic/db_tools.py,sha256=kCEENzmnorm8i-k4Kpd4KLJt1QWh_ZlAyX1aG-tzET0,3619
-vectara_agentic/tools.py,sha256=Qhql8IA_CGvsZ3ErOFQH2y-sxxHXvL3GUDH6shgxmzQ,28262
-vectara_agentic/tools_catalog.py,sha256=5NlJypdu0IKa7mODxVOwo05lw3PqQJtSl_ZOsUDH_TA,3986
-vectara_agentic/types.py,sha256=siRh9VmFt3jhTu4uJzYpvNlLi60lyIH5_xqYHKpB24Q,1149
-vectara_agentic/utils.py,sha256=-hnILxUAAtcFRlupeNEVBwHpm-EMF98iLV1Z_hjVrNA,4460
-vectara_agentic-0.1.24.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-vectara_agentic-0.1.24.dist-info/METADATA,sha256=VtSVDzA0zHVWq5C8fNqjATQCOpF_zXIAsWiPYd2_Y5E,15379
-vectara_agentic-0.1.24.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-vectara_agentic-0.1.24.dist-info/top_level.txt,sha256=Y7TQTFdOYGYodQRltUGRieZKIYuzeZj2kHqAUpfCUfg,22
-vectara_agentic-0.1.24.dist-info/RECORD,,