vectara-agentic 0.3.3__py3-none-any.whl → 0.4.1__py3-none-any.whl

vectara_agentic/tools_catalog.py

@@ -1,11 +1,10 @@
 """
 This module contains the tools catalog for the Vectara Agentic.
 """
+
 from typing import List
 from datetime import date
 
-import requests
-
 from pydantic import Field
 
 from .types import LLMRole
@@ -13,16 +12,6 @@ from .agent_config import AgentConfig
 from .llm_utils import get_llm
 from .utils import remove_self_from_signature
 
-req_session = requests.Session()
-
-get_headers = {
-    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:98.0) Gecko/20100101 Firefox/98.0",
-    "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8",
-    "Accept-Language": "en-US,en;q=0.5",
-    "Accept-Encoding": "gzip, deflate",
-    "Connection": "keep-alive",
-}
-
 def get_current_date() -> str:
     """
     Returns the current date as a string.
@@ -35,6 +24,7 @@ class ToolsCatalog:
     """
     A curated set of tools for vectara-agentic
     """
+
     def __init__(self, agent_config: AgentConfig):
         self.agent_config = agent_config
 
@@ -76,7 +66,9 @@ class ToolsCatalog:
     def rephrase_text(
         self,
         text: str = Field(description="the original text."),
-        instructions: str = Field(description="the specific instructions for how to rephrase the text."),
+        instructions: str = Field(
+            description="the specific instructions for how to rephrase the text."
+        ),
     ) -> str:
         """
         This is a helper tool.
@@ -103,8 +95,13 @@ class ToolsCatalog:
     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."),
+        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.
@@ -121,13 +118,16 @@ class ToolsCatalog:
         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 = (
+                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,13 +3,13 @@ This module contains the types used in the Vectara Agentic.
 """
 
 from enum import Enum
-from typing import Protocol, Any
+from typing import Any, Dict, Callable, AsyncIterator, Protocol, cast
+from dataclasses import dataclass, field
 
 from llama_index.core.schema import Document as LI_Document
 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,
+    AgentChatResponse as LI_AgentChatResponse,
 )
 
 
@@ -17,10 +17,7 @@ class AgentType(Enum):
     """Enumeration for different types of agents."""
 
     REACT = "REACT"
-    OPENAI = "OPENAI"
     FUNCTION_CALLING = "FUNCTION_CALLING"
-    LLMCOMPILER = "LLMCOMPILER"
-    LATS = "LATS"
 
 
 class ObserverType(Enum):
@@ -37,7 +34,6 @@ class ModelProvider(Enum):
     ANTHROPIC = "ANTHROPIC"
     TOGETHER = "TOGETHER"
     GROQ = "GROQ"
-    FIREWORKS = "FIREWORKS"
     COHERE = "COHERE"
     GEMINI = "GEMINI"
     BEDROCK = "BEDROCK"
@@ -84,8 +80,110 @@ class HumanReadableOutput(Protocol):
         """Get the raw output data."""
 
 
+class _StreamProto(Protocol):
+    """What we actually use from the LI streaming response."""
+
+    response: str | None
+    response_id: str | None
+
+    def get_response(self) -> LI_AgentChatResponse:
+        """Get the agent chat response."""
+
+    def to_response(self) -> LI_AgentChatResponse:
+        """Convert to agent chat response."""
+
+    def get_final_response(self) -> LI_AgentChatResponse:
+        """Get the final agent chat response."""
+
+    def __iter__(self):
+        """Return an iterator over the stream."""
+
+    async def async_response_gen(self) -> AsyncIterator[str]:
+        """Async generator that yields response strings."""
+
+
 # classes for Agent responses
 ToolOutput = LI_ToolOutput
 AgentResponse = LI_AgentChatResponse
-AgentStreamingResponse = LI_StreamingAgentChatResponse
 Document = LI_Document
+
+
+@dataclass
+class AgentStreamingResponse:
+    """Our stream wrapper with writable metadata and a typed get_response()."""
+
+    base: _StreamProto
+    metadata: Dict[str, Any] = field(default_factory=dict)
+
+    def __getattr__(self, name: str):
+        return getattr(self.base, name)
+
+    def get_response(self) -> AgentResponse:
+        """Get the response from the base stream, merging metadata."""
+        # choose whichever method the base actually has
+        if hasattr(self.base, "get_response"):
+            resp = cast(AgentResponse, self.base.get_response())
+        elif hasattr(self.base, "to_response"):
+            resp = cast(AgentResponse, self.base.to_response())
+        else:
+            resp = cast(AgentResponse, self.base.get_final_response())
+
+        resp.metadata = (resp.metadata or {}) | self.metadata
+        return resp
+
+    async def aget_response(self) -> AgentResponse:
+        """Get the response from the base stream, merging metadata (async version)."""
+        # prefer async version if available
+        if hasattr(self.base, "aget_response"):
+            resp = cast(AgentResponse, await self.base.aget_response())
+        elif hasattr(self.base, "get_response"):
+            resp = cast(AgentResponse, self.base.get_response())
+        elif hasattr(self.base, "to_response"):
+            resp = cast(AgentResponse, self.base.to_response())
+        elif hasattr(self.base, "get_final_response"):
+            resp = cast(AgentResponse, self.base.get_final_response())
+        else:
+            # Fallback for StreamingAgentChatResponse objects that don't have standard methods
+            # Try to get the response directly from the object's response attribute
+            if hasattr(self.base, "response"):
+                response_text = self.base.response if isinstance(self.base.response, str) else str(self.base.response)
+                resp = AgentResponse(response=response_text, metadata=getattr(self.base, "metadata", {}))
+            else:
+                resp = AgentResponse(response="", metadata={})
+
+        resp.metadata = (resp.metadata or {}) | self.metadata
+        return resp
+
+    @property
+    def async_response_gen(self) -> Callable[[], AsyncIterator[str]]:
+        """Get the async response generator from the base stream."""
+        return self.base.async_response_gen
+
+    @async_response_gen.setter
+    def async_response_gen(self, fn: Callable[[], AsyncIterator[str]]):
+        """Set the async response generator for the base stream."""
+        self.base.async_response_gen = fn
+
+    @classmethod
+    def from_error(cls, msg: str) -> "AgentStreamingResponse":
+        """Create an AgentStreamingResponse from an error message."""
+
+        async def _empty_gen():
+            if False:  # pylint: disable=using-constant-test
+                yield ""
+
+        class _ErrStream:
+            def __init__(self, msg: str):
+                self.response = msg
+                self.response_id = None
+
+            async def async_response_gen(self):
+                """Async generator that yields an error message."""
+                if False:  # pylint: disable=using-constant-test
+                    yield ""
+
+            def get_response(self) -> AgentResponse:
+                """Return an AgentResponse with the error message."""
+                return AgentResponse(response=self.response, metadata={})
+
+        return cls(base=_ErrStream(msg), metadata={})

{vectara_agentic-0.3.3.dist-info → vectara_agentic-0.4.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vectara_agentic
-Version: 0.3.3
+Version: 0.4.1
 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,26 +16,24 @@ 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.37
-Requires-Dist: llama-index-core==0.12.37
-Requires-Dist: llama-index-cli==0.4.1
+Requires-Dist: llama-index==0.12.52
+Requires-Dist: llama-index-core==0.12.52.post1
+Requires-Dist: llama-index-workflow==1.0.1
+Requires-Dist: llama-index-cli==0.4.4
 Requires-Dist: llama-index-indices-managed-vectara==0.4.5
-Requires-Dist: llama-index-agent-llm-compiler==0.3.1
-Requires-Dist: llama-index-agent-lats==0.3.0
-Requires-Dist: llama-index-agent-openai==0.4.8
-Requires-Dist: llama-index-llms-openai==0.3.44
-Requires-Dist: llama-index-llms-openai-like==0.3.5
-Requires-Dist: llama-index-llms-anthropic==0.6.19
-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.2
+Requires-Dist: llama-index-agent-openai==0.4.12
+Requires-Dist: llama-index-llms-openai==0.4.7
+Requires-Dist: llama-index-llms-openai-like==0.4.0
+Requires-Dist: llama-index-llms-anthropic==0.7.6
+Requires-Dist: llama-index-llms-together==0.3.2
+Requires-Dist: llama-index-llms-groq==0.3.2
 Requires-Dist: llama-index-llms-cohere==0.5.0
-Requires-Dist: llama-index-llms-google-genai==0.2.1
-Requires-Dist: llama-index-llms-bedrock-converse==0.7.1
+Requires-Dist: llama-index-llms-google-genai==0.2.5
+Requires-Dist: llama-index-llms-bedrock-converse==0.7.6
 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.1
+Requires-Dist: llama-index-tools-google==0.5.0
 Requires-Dist: llama-index-tools-tavily_research==0.3.0
 Requires-Dist: llama_index.tools.brave_search==0.3.0
 Requires-Dist: llama-index-tools-neo4j==0.3.0
@@ -44,21 +42,21 @@ Requires-Dist: llama-index-graph-stores-kuzu==0.7.0
 Requires-Dist: llama-index-tools-salesforce==0.3.0
 Requires-Dist: llama-index-tools-slack==0.3.0
 Requires-Dist: llama-index-tools-exa==0.3.0
-Requires-Dist: llama-index-tools-wikipedia==0.3.0
+Requires-Dist: llama-index-tools-wikipedia==0.3.1
 Requires-Dist: llama-index-tools-bing-search==0.3.0
-Requires-Dist: openai>=1.82.1
-Requires-Dist: tavily-python==0.7.3
-Requires-Dist: exa-py==1.13.1
+Requires-Dist: openai>=1.96.1
+Requires-Dist: tavily-python>=0.7.9
+Requires-Dist: exa-py>=1.14.8
 Requires-Dist: openinference-instrumentation-llama-index==4.3.1
 Requires-Dist: opentelemetry-proto>=1.31.0
 Requires-Dist: arize-phoenix==10.9.1
 Requires-Dist: arize-phoenix-otel==0.10.3
-Requires-Dist: protobuf==5.29.3
+Requires-Dist: protobuf==5.29.5
 Requires-Dist: tokenizers>=0.20
 Requires-Dist: pydantic==2.11.5
+Requires-Dist: pandas==2.2.3
 Requires-Dist: retrying==1.3.4
 Requires-Dist: python-dotenv==1.0.1
-Requires-Dist: tiktoken==0.9.0
 Requires-Dist: cloudpickle>=3.1.1
 Requires-Dist: httpx==0.28.1
 Requires-Dist: commonmark==0.9.1
@@ -108,6 +106,7 @@ Dynamic: summary
 - [Using Tools](#using-tools)
 - [Advanced Usage: Workflows](#advanced-usage-workflows)
 - [Configuration](#️-configuration)
+- [Migrating from v0.3.x](#-migrating-from-v03x)
 - [Contributing](#-contributing)
 - [License](#-license)
 
@@ -124,11 +123,11 @@ Dynamic: summary
 - **Rapid Tool Creation:**  
   Build Vectara RAG tools or search tools with a single line of code.
 - **Agent Flexibility:**  
-  Supports multiple agent types including `ReAct`, `OpenAIAgent`, `LATS`, and `LLMCompiler`.
+  Supports multiple agent types including `ReAct` and `Function Calling`.
 - **Pre-Built Domain Tools:**  
   Tools tailored for finance, legal, and other verticals.
 - **Multi-LLM Integration:**  
-  Seamless integration with OpenAI, Anthropic, Gemini, GROQ, Together.AI, Cohere, Bedrock, and Fireworks.
+  Seamless integration with OpenAI, Anthropic, Gemini, GROQ, Together.AI, Cohere, and Bedrock.
 - **Observability:**  
   Built-in support with Arize Phoenix for monitoring and feedback.
 - **Workflow Support:**  
@@ -148,7 +147,7 @@ Check out our example AI assistants:
 - [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, Cohere, GEMINI or GROQ, if you choose to use them).
   To use AWS Bedrock, make sure that
   * The Bedrock models you need are enabled on your account
   * Your environment includes `AWS_PROFILE` with your AWS profile name.
@@ -200,7 +199,8 @@ ask_finance = vec_factory.create_rag_tool(
     tool_description="Query financial reports for a company and year",
     tool_args_schema=QueryFinancialReportsArgs,
     lambda_val=0.005,
-    summary_num_results=7, 
+    summary_num_results=7,
+    vhc_eligible=True,  # RAG tools participate in VHC by default
     # Additional Vectara query arguments...
 )
 ```
@@ -480,6 +480,30 @@ def mult_func(x, y):
 mult_tool = ToolsFactory().create_tool(mult_func)
 ```
 
+#### VHC Eligibility
+
+When creating tools, you can control whether they participate in Vectara Hallucination Correction, by using the `vhc_eligible` parameter:
+
+```python
+# Tool that provides factual data - should participate in VHC
+data_tool = ToolsFactory().create_tool(get_company_data, vhc_eligible=True)
+
+# Utility tool that doesn't provide context - should not participate in VHC  
+summary_tool = ToolsFactory().create_tool(summarize_text, vhc_eligible=False)
+```
+
+**VHC-eligible tools** (default: `True`) are those that provide factual context for responses, such as:
+- Data retrieval tools
+- Search tools  
+- API calls that return factual information
+
+**Non-VHC-eligible tools** (`vhc_eligible=False`) are utility tools that don't contribute factual context:
+- Text summarization tools
+- Text rephrasing tools
+- Formatting or processing tools
+
+Built-in utility tools like `summarize_text`, `rephrase_text`, and `get_bad_topics` are automatically marked as non-VHC-eligible.
+
 #### Human-Readable Tool Output
 
 Tools can provide both raw data and human-readable formatted output using the `create_human_readable_output` utility:
@@ -504,7 +528,50 @@ Built-in formatters include `format_as_table`, `format_as_json`, and `format_as_
 > and not as nested functions. Nested functions are not supported if you use serialization 
 > (dumps/loads or from_dict/to_dict).
 
-The human-readable format, if available, is used when computing the factual consistency score.
+The human-readable format, if available, is used when using Vectara Hallucination Correction.
+
+## 🔍 Vectara Hallucination Correction (VHC)
+
+`vectara-agentic` provides built-in support for Vectara Hallucination Correction (VHC), which analyzes agent responses and corrects any detected hallucinations based on the factual content retrieved by VHC-eligible tools.
+
+### Computing VHC
+
+After a chat interaction, you can compute VHC to analyze and correct the agent's response:
+
+```python
+# Chat with the agent
+response = agent.chat("What was Apple's revenue in 2022?")
+print(response.response)
+
+# Compute VHC analysis
+vhc_result = agent.compute_vhc()
+
+# Access corrected text and corrections
+if vhc_result["corrected_text"]:
+    print("Original:", response.response)
+    print("Corrected:", vhc_result["corrected_text"])
+    print("Corrections:", vhc_result["corrections"])
+else:
+    print("No corrections needed or VHC not available")
+```
+
+### Async VHC Computation
+
+For async applications, use `acompute_vhc()`:
+
+```python
+# Async chat
+response = await agent.achat("What was Apple's revenue in 2022?")
+
+# Async VHC computation
+vhc_result = await agent.acompute_vhc()
+```
+
+### VHC Requirements
+
+- VHC requires a valid `VECTARA_API_KEY` environment variable
+- Only VHC-eligible tools (those marked with `vhc_eligible=True`) contribute to the analysis
+- VHC results are cached for each query/response pair to avoid redundant computation
 
 ### Tool Validation
 
@@ -719,12 +786,13 @@ agent = Agent(
 ```
 
 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).
+- `agent_type`: the agent type. Valid values are `REACT` or `FUNCTION_CALLING` (default: `FUNCTION_CALLING`).
+- `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` (default: `OPENAI`).
+
+> **Note:** Fireworks AI support has been removed. If you were using Fireworks, please migrate to one of the supported providers listed above.
+- `main_llm_model_name` and `tool_llm_model_name`: agent model name for agent and tools (default depends on provider: OpenAI uses gpt-4.1, Gemini uses gemini-2.5-flash).
 - `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`)
-- `max_reasoning_steps`: the maximum number of reasoning steps (iterations for React and function calls for OpenAI agent, respectively). Defaults to 50.
 
 If any of these are not provided, `AgentConfig` first tries to read the values from the OS environment.
 
@@ -759,3 +827,15 @@ agent = Agent(
 )
 ```
 
+## 🚀 Migrating from v0.3.x
+
+If you're upgrading from v0.3.x, please note the following breaking changes in v0.4.0:
+
+- **Fireworks LLM removed**: Migrate to OpenAI, Anthropic, Together.AI, GROQ, Cohere, Bedrock, or Gemini
+- **OPENAI AgentType removed**: Use the FUNCTION_CALLING AgentType instead, when using OpenAI for main_llm_provider
+- **StructuredPlanning deprecated**: Use standard Agent workflows or create custom workflows
+- **Token counting and compact_docstring removed**: Remove these from your configuration
+- **update_func removed**: This functionality is no longer available
+
+For detailed migration instructions, see [CHANGELOG.md](CHANGELOG.md).
+

vectara_agentic-0.4.1.dist-info/RECORD

@@ -0,0 +1,53 @@
+tests/__init__.py,sha256=vXhQJCyD1Uhx2NP8b8vIUG3RUhkXyvn7oOir2bmctQU,175
+tests/conftest.py,sha256=PlHevWpkOP1F9pG9GJSf8ewYW_1FsFYcx3CQyjxAziY,9286
+tests/endpoint.py,sha256=0URgtz8uydhP_rtpGn_59P1LiWkd3idNlI85LzXnlUE,2744
+tests/run_tests.py,sha256=2dKDJ2uhz6SKlr72Zkh7PTVb2F52_FpirM_wKiIFuiw,3232
+tests/test_agent.py,sha256=dwCHul-GnpURAmSMJlNo9_k_Aizr4KhkJKccKwDvZ38,5778
+tests/test_agent_fallback_memory.py,sha256=1LoRHxUM767bGmCeusPlGubX_pIeP5KxIABRwdWLJGo,10862
+tests/test_agent_memory_consistency.py,sha256=D8ivCGp5reJyOK7Q6wDiZlv3bKX4-SEchnqocyib1Po,8966
+tests/test_agent_type.py,sha256=d5Zs0iM12DxregfwkJ6UxERWcR5eLgy2ona1znwvK3I,5153
+tests/test_api_endpoint.py,sha256=I2UDamPMSLLkgw0pZ5QMM0o_8vVga9-F6ql-S3zlMBs,5136
+tests/test_bedrock.py,sha256=74M4k4MWFfZV-mD75R_27HQGTfWcPQ40ijLanT54y-E,1979
+tests/test_fallback.py,sha256=6wkyiyAvsibIdr33aXdsuU9nzDeJt0XSz5yiyuisUEQ,2963
+tests/test_gemini.py,sha256=pvCcfTf79-R49H_WVZou1xx-vVmZEY-19zRtxZeUdD4,2581
+tests/test_groq.py,sha256=OmO-VBrKfZYUc11QfZH25jT3FySQrSpv_FS488IqSik,1970
+tests/test_private_llm.py,sha256=P6sldeAWcHg29u_Nu4FdHVUyNaRe5ULE-hjNJz6WKHc,2620
+tests/test_return_direct.py,sha256=QsCw-ZGp06cutLkyrLh1U1rggoH7iBiFz4SQ9MIx-Xk,1521
+tests/test_serialization.py,sha256=wdVRoy6hoPqCF7SGpYbC2TM7iR2o_IKIRKOBZFAChp0,4824
+tests/test_session_memory.py,sha256=hnADl59agjpXySY-CBjw6sDPn3s6JketIK6XbLZsLzU,9691
+tests/test_streaming.py,sha256=EBihBb_ZQiGCCvv7Us7YqHN4CxDIQy-XsUSDVO1n5wU,3302
+tests/test_together.py,sha256=s0ywOxL-XT_iq970ucamVAPR_CIS9OT72vJB7degNdc,1983
+tests/test_tools.py,sha256=869Fl54kmLc44ijykO2QpfcXyAWLDqJ9Niq3XNzhzv8,13621
+tests/test_vectara_llms.py,sha256=H1M9OaDvD8_GCFRBm6IdvWejYKn-zm3-Rzt_noCBbiQ,2496
+tests/test_vhc.py,sha256=MXyFxckQzfdXcULqwoao4taoQ93qLDvkcf-h2LwUQnE,1974
+tests/test_workflow.py,sha256=dwQnHSxvRMVqUtFV8O2KvuyaSKJXFDkVhcffn8mSuJs,3555
+vectara_agentic/__init__.py,sha256=CfS3QR4drKygcTcyH5zUUDuXXQ3WZtTCytz8W4-loeE,1077
+vectara_agentic/_callback.py,sha256=ueckIfLNa9ykmmEyLqrrZwfDNWrEfyZzJeWktpnkwJQ,12970
+vectara_agentic/_observability.py,sha256=c_1WuP8rS9sPuMH6twzcz6CGLqfTT5y4fyOHvDVdxsg,4423
+vectara_agentic/_version.py,sha256=dWTo8m6tq_yNZLAER4W8gWnDQib4KBI28u8pwf8jiRM,65
+vectara_agentic/agent.py,sha256=2laHGTp1D2ve96zdxdN3wtq0MMIe5B8RxTxDXrJDTOE,46779
+vectara_agentic/agent_config.py,sha256=njqEX2qHJjAp2KpNuJglgZhyWXPK74wjIjBPACD6w7w,4074
+vectara_agentic/agent_endpoint.py,sha256=E_AF-YwxaKqd1-p43X62e1e4ugwOWKIyNq4RWOfsO7A,7402
+vectara_agentic/db_tools.py,sha256=nVZkpGdG63ooGngjX9g7YWyBZRtYMDpvzNasbO696nM,11498
+vectara_agentic/llm_utils.py,sha256=dgomwK7FOVmH_prgOR60CjhG6kwt-AxxMLlFa8vWspY,7449
+vectara_agentic/sub_query_workflow.py,sha256=wm2Lb2wbKrYx5bSq-npb3XbaxWzTcvK5BkW3NZ9vuIc,12968
+vectara_agentic/tool_utils.py,sha256=whnQlk9coeIt01sqUnKnzUorefgn96yWqhtRfHxNL84,25921
+vectara_agentic/tools.py,sha256=8gmC6UnHFTUr_hWWbuMyRNMMLkeY5Sb1FTgCsb7Hx1w,35689
+vectara_agentic/tools_catalog.py,sha256=p6eRram-diJyMz5dZI703auSAm97FfW5wLAMyz_2sB0,4634
+vectara_agentic/types.py,sha256=qKkK8vRNiLvEcMInMyOClK2bD7iFlrWGTkl3fGC6Xic,6117
+vectara_agentic/utils.py,sha256=R9HitEG5K3Q_p2M_teosT181OUxkhs1-hnj98qDYGbE,2545
+vectara_agentic/agent_core/__init__.py,sha256=R3KGbSOiY21FOjbeQ_GyIi6uR9Rz7PTfudO9RjSuEZQ,722
+vectara_agentic/agent_core/factory.py,sha256=AMlUuAwUVocqwfOYkW-HJuUr81Kj0kUjcG4pPXmCZMM,14201
+vectara_agentic/agent_core/prompts.py,sha256=HJ8b-5OEn6-suqWqQgeAVOZNEiPr7wKHeaczNdL-XN8,10127
+vectara_agentic/agent_core/serialization.py,sha256=Ag9Ux497_IyxrexYP90wbG-UJy-lTH1ec_ANmpPmQjo,11731
+vectara_agentic/agent_core/streaming.py,sha256=Xzz0kgt1LFeKlnhlDTsZmBze-asvYauwIlYJi2hgHjk,17772
+vectara_agentic/agent_core/utils/__init__.py,sha256=y5Xf0IH-5TRxMBRA9IyhmWnGZOVIyqV45P6lX4c2Qsc,762
+vectara_agentic/agent_core/utils/hallucination.py,sha256=XmV7tW-MBN9BrzM79zu0T7zaWil7fIkNQjLfDZE43v4,5312
+vectara_agentic/agent_core/utils/logging.py,sha256=-Ll8iUelml92WuhNWScuY6H-RheyZOTBHNxXQ1UGy0M,1701
+vectara_agentic/agent_core/utils/schemas.py,sha256=e7xhJBevgK7IM8cRT5hoO67T-Ep_FhNGp72Zo0OC_Jo,2853
+vectara_agentic/agent_core/utils/tools.py,sha256=k9Gm-UUQ3ZeGxrkjyrjmjcGxOkvnpylcm_Krnr-0fsY,4748
+vectara_agentic-0.4.1.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+vectara_agentic-0.4.1.dist-info/METADATA,sha256=PuM3HoXyagcOndjlq7XM5gPAGkjntAgIxI72OkHCLhw,35059
+vectara_agentic-0.4.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+vectara_agentic-0.4.1.dist-info/top_level.txt,sha256=Y7TQTFdOYGYodQRltUGRieZKIYuzeZj2kHqAUpfCUfg,22
+vectara_agentic-0.4.1.dist-info/RECORD,,

tests/test_agent_planning.py

@@ -1,64 +0,0 @@
-import unittest
-
-from vectara_agentic.agent_config import AgentConfig
-from vectara_agentic.agent import Agent
-from vectara_agentic.tools import VectaraToolFactory
-
-# SETUP special test account credentials for vectara
-# It's okay to expose these credentials in the test code
-vectara_corpus_key = "vectara-docs_1"
-vectara_api_key = 'zqt_UXrBcnI2UXINZkrv4g1tQPhzj02vfdtqYJIDiA'
-
-vec_factory = VectaraToolFactory(vectara_api_key=vectara_api_key,
-                                 vectara_corpus_key=vectara_corpus_key)
-summarizer = 'vectara-summary-table-md-query-ext-jan-2025-gpt-4o'
-ask_vectara = vec_factory.create_rag_tool(
-    tool_name = "ask_vectara",
-    tool_description = "This tool can respond to questions about Vectara.",
-    reranker = "multilingual_reranker_v1", rerank_k = 100, rerank_cutoff = 0.1,
-    n_sentences_before = 2, n_sentences_after = 2, lambda_val = 0.005,
-    summary_num_results = 10,
-    vectara_summarizer = summarizer,
-    include_citations = True,
-    verbose=False,
-)
-
-class TestAgentPlanningPackage(unittest.TestCase):
-
-    def test_no_planning(self):
-        tools = [ask_vectara]
-        topic = "vectara"
-        instructions = "Answer user queries about Vectara."
-
-        query = "What is Vectara and what demos are available of the Vectara platform?"
-        agent = Agent(
-            tools=tools,
-            topic=topic,
-            custom_instructions=instructions,
-            agent_config=AgentConfig(),
-        )
-        res = agent.chat(query)
-        self.assertIn("demos", res.response)
-        self.assertIn("Vectara", res.response)
-
-    def test_structured_planning(self):
-        tools = [ask_vectara]
-        topic = "vectara"
-        instructions = "Answer user queries about Vectara."
-
-        query = "What is Vectara and what demos are available of the Vectara platform?"
-        agent = Agent(
-            tools=tools,
-            topic=topic,
-            custom_instructions=instructions,
-            agent_config=AgentConfig(),
-            use_structured_planning=True,
-        )
-
-        res = agent.chat(query)
-        self.assertIn("demos", res.response)
-        self.assertIn("Vectara", res.response)
-
-
-if __name__ == "__main__":
-    unittest.main()

tests/test_hhem.py

@@ -1,100 +0,0 @@
-import unittest
-
-from vectara_agentic.agent import Agent, AgentType
-from vectara_agentic.agent_config import AgentConfig
-from vectara_agentic.tools import ToolsFactory, VectaraToolFactory
-from vectara_agentic.types import ModelProvider
-
-import nest_asyncio
-
-nest_asyncio.apply()
-
-vectara_corpus_key = "vectara-docs_1"
-vectara_api_key = 'zqt_UXrBcnI2UXINZkrv4g1tQPhzj02vfdtqYJIDiA'
-
-vec_factory = VectaraToolFactory(vectara_api_key=vectara_api_key,
-                                 vectara_corpus_key=vectara_corpus_key)
-summarizer = 'vectara-summary-table-md-query-ext-jan-2025-gpt-4o'
-ask_vectara = vec_factory.create_rag_tool(
-    tool_name = "ask_vectara",
-    tool_description = "This tool can respond to questions about Vectara.",
-    reranker = "multilingual_reranker_v1", rerank_k = 100, rerank_cutoff = 0.1,
-    n_sentences_before = 2, n_sentences_after = 2, lambda_val = 0.005,
-    summary_num_results = 10,
-    vectara_summarizer = summarizer,
-    include_citations = True,
-    verbose=False,
-)
-
-
-statements = [
-    "The sky is blue.",
-    "Cats are better than dogs.",
-    "Python is a great programming language.",
-    "The Earth revolves around the Sun.",
-    "Chocolate is the best ice cream flavor.",
-]
-st_inx = 0
-def get_statement() -> str:
-    "Generate next statement"
-    global st_inx
-    st = statements[st_inx]
-    st_inx += 1
-    return st
-
-
-fc_config = AgentConfig(
-    agent_type=AgentType.FUNCTION_CALLING,
-    main_llm_provider=ModelProvider.ANTHROPIC,
-    tool_llm_provider=ModelProvider.ANTHROPIC,
-)
-
-
-class TestFCS(unittest.TestCase):
-
-    def test_fcs(self):
-        tools = [ToolsFactory().create_tool(get_statement)]
-        topic = "statements"
-        instructions = (
-            f"Call the get_statement tool multiple times to get all {len(statements)} statements."
-            f"Respond to the user question based exclusively on the statements you receive - do not use any other knowledge or information."
-        )
-
-        agent = Agent(
-            tools=tools,
-            topic=topic,
-            agent_config=fc_config,
-            custom_instructions=instructions,
-            vectara_api_key=vectara_api_key,
-        )
-
-        res = agent.chat("Are cats better than dogs?")
-        fcs = res.metadata.get("fcs", None)
-        self.assertIsNotNone(fcs, "FCS score should not be None")
-        self.assertIsInstance(fcs, float, "FCS score should be a float")
-        self.assertGreater(
-            fcs, 0.5, "FCS score should be higher than 0.5 for this question"
-        )
-
-    def test_vectara_corpus(self):
-        tools = [ask_vectara]
-        topic = "vectara"
-        instructions = "Answer user queries about Vectara."
-
-        query = "What is Vectara and what API endpoints are available of the Vectara platform?"
-        agent = Agent(
-            tools=tools,
-            topic=topic,
-            custom_instructions=instructions,
-            agent_config=AgentConfig(),
-            vectara_api_key=vectara_api_key,
-        )
-
-        res = agent.chat(query)
-        fcs = res.metadata.get("fcs", None)
-        self.assertIn("Vectara", res.response)
-        self.assertGreater(fcs, 0.5, "FCS score should be higher than 0.5 for this question")
-
-
-if __name__ == "__main__":
-    unittest.main()