BerriAI/litellm · error · TimeoutError

Knowledge Base did not become active in time

Error message

Knowledge Base did not become active in time

What it means

Timeout after polling get_knowledge_base for ~30 iterations: the newly created Bedrock Knowledge Base never reached ACTIVE within the wait window (slow provisioning or a failed creation, e.g. role/data-source issues). The kb_id is recorded in _created_resources but ingestion cannot proceed until it is active; check the KB status in AWS and retry.

Source

Thrown at litellm/rag/ingestion/bedrock_ingestion.py:548

                        "vectorField": "bedrock-knowledge-base-default-vector",
                    },
                    "vectorIndexName": "bedrock-kb-index",
                },
            },
        )
        kb_id: Final = response["knowledgeBase"]["knowledgeBaseId"]
        self._created_resources["knowledge_base"] = kb_id

        # Wait for KB to be active (use asyncio.sleep to avoid blocking)
        verbose_logger.debug("Waiting for Knowledge Base to be active...")
        for _ in range(30):
            kb_status = bedrock_agent.get_knowledge_base(knowledgeBaseId=kb_id)
            status = kb_status["knowledgeBase"]["status"]
            if status == "ACTIVE":
                break
            await asyncio.sleep(2)
        else:
            raise TimeoutError("Knowledge Base did not become active in time")

        verbose_logger.info("Created Knowledge Base: %s", kb_id)
        return kb_id

    def _create_data_source(self, kb_name: str) -> str:
        """Create Data Source for the Knowledge Base."""
        bedrock_agent: Final = self._get_boto3_client("bedrock-agent")

        verbose_logger.debug("Creating Data Source for KB: %s", self.knowledge_base_id)

        response: Final = bedrock_agent.create_data_source(
            knowledgeBaseId=self.knowledge_base_id,
            name=f"{kb_name}-s3-source",
            dataSourceConfiguration={
                "type": "S3",
                "s3Configuration": {
                    "bucketArn": f"arn:aws:s3:::{self.s3_bucket}",
                    "inclusionPrefixes": [self.s3_prefix],

View on GitHub (pinned to 77b7c6c40c)

Solutions

1. Check the Knowledge Base status in AWS and retry; ensure ingestion jobs and data sources are healthy.

When it happens

Trigger: Thrown at litellm/rag/ingestion/bedrock_ingestion.py:548 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of BerriAI/litellm@77b7c6c40c (2026-08-18). Data as JSON: /api/errors/004385c8a68b6372. Report an issue: GitHub.