crewAIInc/crewAI · error · ValueError

Cluster instance must be provided

Error message

Cluster instance must be provided

What it means

Error "Cluster instance must be provided" thrown in crewAIInc/crewAI.

Source

Thrown at lib/crewai-tools/src/crewai_tools/tools/couchbase_tool/couchbase_tool.py:122

        return True

    def _check_index_exists(self) -> bool:
        """Check if the Search index exists in the linked Couchbase cluster
        Raises a ValueError if the index does not exist.
        """
        if self.scoped_index:
            all_indexes = [
                index.name for index in self._scope.search_indexes().get_all_indexes()
            ]
            if self.index_name not in all_indexes:
                raise ValueError(
                    f"Index {self.index_name} does not exist. "
                    " Please create the index before searching."
                )
        else:
            if not self.cluster:
                raise ValueError("Cluster instance must be provided")

            all_indexes = [
                index.name for index in self.cluster.search_indexes().get_all_indexes()
            ]
            if self.index_name not in all_indexes:
                raise ValueError(
                    f"Index {self.index_name} does not exist. "
                    " Please create the index before searching."
                )

        return True

    def __init__(self, **kwargs: Any) -> None:
        """Initialize the CouchbaseFTSVectorSearchTool.

        Args:
            **kwargs: Keyword arguments to pass to the BaseTool constructor and
                      to configure the Couchbase connection and search parameters.

View on GitHub (pinned to 754d7323be)

Solutions

1. Pass a connected Couchbase Cluster instance to the tool.
2. Create the cluster connection before instantiating the tool.

When it happens

Trigger: Thrown at lib/crewai-tools/src/crewai_tools/tools/couchbase_tool/couchbase_tool.py:122 when the library encounters an invalid state.

Common situations: Occurs when no Couchbase cluster instance was provided to the tool. Pass a connected cluster instance when constructing the tool.

AI-assisted analysis of crewAIInc/crewAI@754d7323be (2026-08-15). Data as JSON: /api/errors/e3f7ddef30a0b2dc. Report an issue: GitHub.