{"record":{"id":"e3f7ddef30a0b2dc","repo":"crewAIInc/crewAI","slug":"cluster-instance-must-be-provided","errorCode":null,"errorMessage":"Cluster instance must be provided","messagePattern":"Cluster instance must be provided","errorType":"exception","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"lib/crewai-tools/src/crewai_tools/tools/couchbase_tool/couchbase_tool.py","lineNumber":122,"sourceCode":"\n        return True\n\n    def _check_index_exists(self) -> bool:\n        \"\"\"Check if the Search index exists in the linked Couchbase cluster\n        Raises a ValueError if the index does not exist.\n        \"\"\"\n        if self.scoped_index:\n            all_indexes = [\n                index.name for index in self._scope.search_indexes().get_all_indexes()\n            ]\n            if self.index_name not in all_indexes:\n                raise ValueError(\n                    f\"Index {self.index_name} does not exist. \"\n                    \" Please create the index before searching.\"\n                )\n        else:\n            if not self.cluster:\n                raise ValueError(\"Cluster instance must be provided\")\n\n            all_indexes = [\n                index.name for index in self.cluster.search_indexes().get_all_indexes()\n            ]\n            if self.index_name not in all_indexes:\n                raise ValueError(\n                    f\"Index {self.index_name} does not exist. \"\n                    \" Please create the index before searching.\"\n                )\n\n        return True\n\n    def __init__(self, **kwargs: Any) -> None:\n        \"\"\"Initialize the CouchbaseFTSVectorSearchTool.\n\n        Args:\n            **kwargs: Keyword arguments to pass to the BaseTool constructor and\n                      to configure the Couchbase connection and search parameters.","sourceCodeStart":104,"sourceCodeEnd":140,"githubUrl":"https://github.com/crewAIInc/crewAI/blob/754d7323beb2fd042e33444a115ea2d5a47193f0/lib/crewai-tools/src/crewai_tools/tools/couchbase_tool/couchbase_tool.py#L104-L140","documentation":"Error \"Cluster instance must be provided\" thrown in crewAIInc/crewAI.","triggerScenarios":"Thrown at lib/crewai-tools/src/crewai_tools/tools/couchbase_tool/couchbase_tool.py:122 when the library encounters an invalid state.","commonSituations":"Occurs when no Couchbase cluster instance was provided to the tool. Pass a connected cluster instance when constructing the tool.","solutions":["Pass a connected Couchbase Cluster instance to the tool.","Create the cluster connection before instantiating the tool."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"754d7323beb2fd042e33444a115ea2d5a47193f0","analyzedAt":"2026-08-15T04:06:56.746Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}