{"record":{"id":"3c420953b5b58a67","repo":"crewAIInc/crewAI","slug":"error-connecting-to-couchbase-please-check-the-co","errorCode":null,"errorMessage":"Error connecting to couchbase. Please check the connection and credentials","messagePattern":"Error connecting to couchbase\\. Please check the connection and credentials","errorType":"exception","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"lib/crewai-tools/src/crewai_tools/tools/couchbase_tool/couchbase_tool.py","lineNumber":156,"sourceCode":"        Args:\n            **kwargs: Keyword arguments to pass to the BaseTool constructor and\n                      to configure the Couchbase connection and search parameters.\n                      Requires 'cluster', 'bucket_name', 'scope_name',\n                      'collection_name', 'index_name', and 'embedding_function'.\n\n        Raises:\n            ValueError: If required parameters are missing, the Couchbase cluster\n                        cannot be reached, or the specified bucket, scope,\n                        collection, or index does not exist.\n        \"\"\"\n        super().__init__(**kwargs)\n        if COUCHBASE_AVAILABLE:\n            try:\n                self._bucket = self.cluster.bucket(self.bucket_name)\n                self._scope = self._bucket.scope(self.scope_name)\n                self._collection = self._scope.collection(self.collection_name)\n            except Exception as e:\n                raise ValueError(\n                    \"Error connecting to couchbase. \"\n                    \"Please check the connection and credentials\"\n                ) from e\n\n            if not self._check_bucket_exists():\n                raise ValueError(\n                    f\"Bucket {self.bucket_name} does not exist. \"\n                    \" Please create the bucket before searching.\"\n                )\n\n            self._check_scope_and_collection_exists()\n            self._check_index_exists()\n        else:\n            import click\n\n            if click.confirm(\n                \"The 'couchbase' package is required to use the CouchbaseFTSVectorSearchTool. \"\n                \"Would you like to install it?\"","sourceCodeStart":138,"sourceCodeEnd":174,"githubUrl":"https://github.com/crewAIInc/crewAI/blob/754d7323beb2fd042e33444a115ea2d5a47193f0/lib/crewai-tools/src/crewai_tools/tools/couchbase_tool/couchbase_tool.py#L138-L174","documentation":"Error \"Error connecting to couchbase. Please check the connection and credentials\" thrown in crewAIInc/crewAI.","triggerScenarios":"Thrown at lib/crewai-tools/src/crewai_tools/tools/couchbase_tool/couchbase_tool.py:156 when the library encounters an invalid state.","commonSituations":"Occurs when connecting to Couchbase fails. Verify the connection string, credentials, and network access to the cluster.","solutions":["Verify the Couchbase connection string, username, and password.","Check network access and that the Couchbase cluster is running."],"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-15T17:31:12.345Z"}