crewAI/src/crewai/knowledge/source/string_knowledge_source.py

from pydantic import Field

from crewai.knowledge.source.base_knowledge_source import BaseKnowledgeSource


class StringKnowledgeSource(BaseKnowledgeSource):
    """A knowledge source that stores and queries plain text content using embeddings."""

    content: str = Field(...)
    collection_name: str | None = Field(default=None)

    def model_post_init(self, _) -> None:
        """Post-initialization method to validate content."""
        self.validate_content()

    def validate_content(self) -> None:
        """Validate string content."""
        if not isinstance(self.content, str):
            msg = "StringKnowledgeSource only accepts string content"
            raise ValueError(msg)

    def add(self) -> None:
        """Add string content to the knowledge source, chunk it, compute embeddings, and save them."""
        new_chunks = self._chunk_text(self.content)
        self.chunks.extend(new_chunks)
        self._save_documents()

    def _chunk_text(self, text: str) -> list[str]:
        """Utility method to split text into chunks."""
        return [
            text[i : i + self.chunk_size]
            for i in range(0, len(text), self.chunk_size - self.chunk_overlap)
        ]