ErrLookup › deepset-ai/haystack
deepset-ai/haystack
Open-source AI orchestration framework for building context-engineered, production-ready LLM applications. Design modular pipelines and agent workflows with explicit control over retrieval, routing, memory, and generation. Built for scalable agents, RAG, multimodal applications, semantic search, and conversational systems. · Python · 316 source files
Analyzed at e318778c9b on 2026-08-30. 398 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Invalid hook point '{hook_point}'. Valid hook points are: {' | validation | error | yaml, skill-store, frontmatter, parsing |
| Hook registered for hook point '{hook_point}' is callable bu | validation | error | yaml, skill-store, frontmatter, type-error |
| Hook registered for hook point '{hook_point}' must have a ca | validation | error | filesystem, skill-store, configuration, path |
| Hook of type '{type(h).__name__}' is registered under hook p | validation | error | skill-store, frontmatter, validation, configuration |
| {type(chat_generator).__name__} does not accept tools parame | validation | error | skill-store, duplicate, configuration, naming |
| state_schema keys {reserved_used} are reserved for Agent int | validation | error | skill-store, keyerror, lookup, unknown-name |
| tool_concurrency_limit must be greater than or equal to 1. | validation | error | security, path-traversal, skill-store, permission |
| Variable '{var_name}' from {prompt_source} is already define | validation | error | filenotfound, skill-store, filesystem, path |
| Variable '{var_name}' from {prompt_source} conflicts with in | validation | error | encoding, skill-store, file-type, utf-8 |
| {type(self.chat_generator).__name__} does not accept tools p | validation | error | telemetry, pipeline, type-error, component |
| tools must be a list of Tool and/or Toolset objects, a Tools | validation | error | python, type-validation, agent, tools |
| StateSchema: Key '{param}' is missing a 'type' entry. | validation | error | python, schema-validation, agent, state |
| StateSchema: 'type' for key '{param}' must be a Python type, | validation | error | python, schema-validation, agent, state, types |
| StateSchema: 'handler' for key '{param}' must be callable or | validation | error | python, schema-validation, agent, state |
| StateSchema: 'messages' must be of type list[ChatMessage], g | validation | error | python, schema-validation, agent, state, messages |
| State: Key '{key}' not found in schema. Schema: {self.schema | exception | error | python, agent, state, key-not-found |
| Tool execution requires at least one tool. | validation | error | python, agent, tools, validation |
| Tool '{tool.name}': failed to merge outputs into state. {e} | exception | error | python, agent, state, tools, merge |
| No tools were configured for the Agent at initialization. | validation | error | python, agent, tools, configuration |
| The following tool names are not valid: {invalid_tool_names} | exception | error | haystack, agents, tool-names, validation |
| user_prompt must define exactly one message block, found {le | exception | error | haystack, agents, prompt, validation |
| user_prompt message block must have role 'user', found role | exception | error | haystack, agents, prompt, role-mismatch |
| system_prompt must define exactly one message block, found { | exception | error | haystack, agents, prompt, validation |
| system_prompt message block must have role 'system', found r | exception | error | haystack, agents, prompt, role-mismatch |
| {prompt_label} must render to exactly one {expected_role.val | exception | error | haystack, agents, prompt, rendering |
| {prompt_label} must render to a {expected_role.value} messag | exception | error | haystack, agents, prompt, role-mismatch |
| Number of replies ({len(replies)}), and metadata ({len(meta) | exception | error | haystack, answer-builder, length-mismatch, validation |
| Pattern '{pattern}' contains multiple capture groups. Please | exception | error | haystack, answer-builder, regex, validation |
| ChatMessages from {role} role must contain text. Received Ch | exception | error | validation, chat-prompt-builder, jinja-template |
| The templatize_part filter cannot be used with a template co | exception | error | validation, chat-prompt-builder, jinja-template |
| The {self.__class__.__name__} requires a non-empty list of C | exception | error | validation, chat-prompt-builder, empty-input |
| The {self.__class__.__name__} expects a list containing only | exception | error | type-error, chat-prompt-builder, validation |
| Missing required input variables in ChatPromptBuilder: {miss | exception | error | validation, chat-prompt-builder, missing-variable |
| Missing required input variables in PromptBuilder: {missing_ | exception | error | validation, prompt-builder, missing-variable |
| Document store {type(self.document_store).__name__} does not | exception | error | async, document-store, cache-checker |
| CSVToDocument: delimiter must be a single character. | validation | error | validation, csv-converter, constructor-argument |
| CSVToDocument: quotechar must be a single character. | validation | error | python, csv, configuration, valueerror |
| CSVToDocument(row): 'content_column' is required in run() wh | validation | error | python, csv, missing-argument, configuration |
| CSVToDocument(row): could not parse CSV rows for {source}: { | exception | error | python, csv, parsing, runtimeerror |
| CSVToDocument(row): content_column='{content_column}' not fo | validation | error | python, csv, column-not-found, configuration |
| CSVToDocument(row): failed to process row {i} for {source}: | exception | error | python, csv, row-processing, data-quality |
| Unknown table format '{string}'. Supported formats are: {lis | validation | error | python, docx, enum, valueerror |
| Document with ID '{doc.id}' is missing the '{file_path_meta_ | validation | error | python, metadata, missing-key, image |
| Document with ID '{doc.id}' has a file path '{file_path}' th | validation | error | python, security, path-traversal, image |
| Document with ID '{doc.id}' has an invalid file path '{resol | validation | error | python, filesystem, file-not-found, image |
| Document with file path '{resolved_file_path}' has an unsupp | validation | error | python, mimetype, unsupported-format, image |
| Document with ID '{doc.id}' comes from the PDF file '{resolv | validation | error | python, haystack, image-converter, pdf, missing-metadata |
| No `jq_schema` nor `content_key` specified. Set either or bo | validation | error | python, haystack, json-converter, configuration |
| The MSG file is encrypted and cannot be read. | exception | error | python, haystack, msg-converter, encryption, email |
| Invalid Jinja template '{template}': {e} | validation | error | python, haystack, jinja, template-syntax, output-adapter |
| No input data provided for output adaptation | validation | error | python, haystack, jinja, output-adapter, missing-input |
| Undefined variable in the template {self.template}; kwargs: | exception | error | python, haystack, jinja, undefined-variable, output-adapter |
| Error adapting {self.template} with {kwargs}: {e} | exception | error | python, haystack, jinja, render-failure, output-adapter |
| Refusing to deserialize an OutputAdapter with unsafe=True wh | exception | critical | python, haystack, deserialization, security, sandbox-escape |
| Refusing to deserialize an OutputAdapter with custom filters | exception | critical | python, haystack, deserialization, security, arbitrary-code-execution |
| Unknown link format '{link_format}'. Supported formats are: | validation | error | python, haystack, pptx-converter, invalid-argument, configuration |
| Unknown extraction mode '{string}'. Supported modes are: {li | validation | error | python, valueerror, enum, invalid-argument |
| Unknown link format '{string}'. Supported formats are: {list | validation | error | python, valueerror, enum, invalid-argument |
| Unsupported source type {type(source)} | validation | error | python, valueerror, type-error, invalid-argument |
| The length of the metadata list must match the number of sou | validation | error | python, valueerror, metadata, length-mismatch |
| meta must be either None, a dictionary or a list of dictiona | validation | error | python, valueerror, metadata, type-error |
| Unsupported export format: {table_format}. Choose either 'cs | validation | error | python, valueerror, xlsx, invalid-argument |
| Unknown link format '{link_format}'. Supported formats are: | validation | error | python, valueerror, xlsx, invalid-argument |
| Please provide an Azure endpoint or set the environment vari | validation | critical | python, azure, configuration, env-var, missing-credential |
| Please provide an API key or an Azure Active Directory token | validation | critical | python, azure, authentication, api-key, missing-credential |
| Please provide an Azure endpoint or set the environment vari | validation | critical | python, azure, configuration, env-var, missing-credential |
| Please provide an API key or an Azure Active Directory token | validation | error | authentication, azure, configuration, python |
| Pass either 'embedding' or 'embedding_fn', not both. | validation | error | configuration, mock, python, parameters |
| 'dimension' must be a positive integer. | validation | error | configuration, validation, mock, python |
| MockDocumentEmbedder expects a list of Documents as input.In | exception | error | type-error, mock, documents, python |
| Pass either 'embedding' or 'embedding_fn', not both. | validation | error | configuration, mock, python, parameters |
| 'dimension' must be a positive integer. | validation | error | configuration, validation, mock, python |
| MockTextEmbedder expects a string as an input. In case you w | exception | error | type-error, mock, python, input-validation |
| {name} must be a sequence of numbers, got {type(value)}. | exception | error | type-error, validation, mock, embedding |
| {name} must not be empty. | validation | error | validation, mock, embedding, empty-value |
| OpenAIDocumentEmbedder expects a list of Documents as input. | exception | error | type-error, openai, documents, python |
| OpenAIDocumentEmbedder expects a list of Documents as input. | validation | error | python, type-error, embedders, openai |
| OpenAITextEmbedder expects a string as an input.In case you | validation | error | python, type-error, embedders, openai |
| The length of ground_truth_answers and predicted_answers mus | validation | error | python, value-error, evaluators, dataset-alignment |
| Unsupported document_comparison_field: '{self.document_compa | validation | error | python, value-error, evaluators, configuration |
| The length of ground_truth_documents and retrieved_documents | validation | error | python, value-error, evaluators, dataset-alignment |
| Unsupported document_comparison_field: '{self.document_compa | validation | error | python, value-error, evaluators, configuration |
| The length of ground_truth_documents and retrieved_documents | validation | error | python, value-error, evaluators, dataset-alignment |
| Unsupported document_comparison_field: '{self.document_compa | validation | error | python, value-error, evaluators, configuration |
| ground_truth_documents and retrieved_documents must be provi | validation | error | python, value-error, evaluators, empty-input |
| The length of ground_truth_documents and retrieved_documents | validation | error | python, value-error, evaluators, dataset-alignment |
| LLM evaluator expected input parameter '{param}' but receive | validation | error | python, validation, input-mismatch |
| LLM evaluator expects all input values to be lists but recei | validation | error | python, validation, type-error |
| LLM evaluator expects all input lists to have the same lengt | validation | error | python, validation, length-mismatch |
| The number of predictions and labels must be the same. | validation | error | python, validation, length-mismatch |
| Predicted answers must not contain None values. | validation | error | python, validation, null-value |
| The prompt must not have any variables, only instructions on | validation | error | python, validation, jinja-template |
| Prompt must have exactly one variable called 'document'. Fou | validation | error | python, validation, jinja-template |
| Expected ChatMessage object, got {type(last_message)} | validation | error | python, type-error, validation |
| Please provide an Azure endpoint or set the environment vari | validation | critical | azure, configuration, missing-env-var |
| Please provide an API key or an Azure Active Directory token | validation | critical | azure, authentication, missing-credentials |
| You must provide `azure_endpoint` or set the `AZURE_OPENAI_E | validation | error | azure, openai, configuration, missing-endpoint, env-var |
| 'chat_generators' must be a non-empty list | validation | error | validation, fallback, configuration, empty-list |
| All {len(self.chat_generators)} chat generators failed. Last | exception | error | fallback, runtime-error, api-failure, all-generators-failed |
| required_variables must not be empty. Set it to '*' to requi | validation | error | validation, template-variables, configuration |
| Pass either 'responses' or 'response_fn', not both. | validation | error | mock, validation, conflicting-arguments, testing |
| 'responses' must be a string, ChatMessage, or a sequence of | validation | error | mock, type-error, validation, testing |
| 'responses' must not be an empty list. | validation | error | mock, validation, empty-list, testing |
| Each ChatMessage response must have the 'assistant' role, go | validation | error | mock, validation, chat-message, role, testing |
| Each response must be a string or ChatMessage, got {type(ite | validation | error | mock, type-error, chat-message, testing |
| 'response_fn' must return an assistant ChatMessage, got '{re | exception | error | python, haystack, mock, chat-message, validation |
| 'response_fn' must return a string or ChatMessage, got {type | exception | error | python, haystack, mock, type-error |
| Cannot stream multiple responses, please set n=1. | exception | error | python, haystack, openai, streaming, validation |
| Unsupported content type: {type(part)} | exception | error | python, haystack, openai, content-parts, responses-api |
| A `ChatMessage` must contain at least one `TextContent`, `To | exception | error | python, haystack, openai, empty-content, validation |
| For OpenAI compatibility, a `ChatMessage` with a `ToolCallRe | exception | error | python, haystack, openai, tool-result, responses-api |
| Unsupported tool result: {result.result} | exception | error | python, haystack, openai, tool-result, type-error |
| Invalid messages type. Expected list[ChatMessage] or str. | exception | error | python, haystack, type-error, messages |
| Unknown join mode '{string}'. Supported modes in AnswerJoine | exception | error | python, haystack, joiner, config, enum |
| top_k must be greater than 0. | exception | error | python, haystack, joiner, validation, config |
| top_k must not be negative. | exception | error | validation, python, haystack |
| BranchJoiner expects only one input, but {inputs_count} were | exception | error | pipeline-wiring, python, haystack |
| Unknown join mode '{string}'. Supported modes in DocumentJoi | exception | error | validation, enum, haystack |
| top_k must be greater than 0. | exception | error | validation, python, haystack |
| The provided `weights` must not sum to zero. | exception | error | validation, weights, haystack |
| top_k must not be negative. | exception | error | validation, python, haystack |
| Split mode '{split_mode}' not recognized. Choose one among: | exception | error | validation, enum, haystack |
| row_split_threshold must be greater than 0 | exception | error | validation, python, haystack |
| column_split_threshold must be greater than 0 | exception | error | validation, python, haystack |
| At least one of row_split_threshold or column_split_threshol | exception | error | validation, configuration, haystack |
| header_split_levels must be a non-empty list. | validation | error | python, validation, constructor-argument, haystack |
| header_split_levels contains invalid values: {invalid}. All | validation | error | python, validation, range-check, haystack |
| header_split_levels must not contain duplicate values. | validation | error | python, validation, duplicates, haystack |
| MarkdownHeaderSplitter only works with text documents but co | validation | error | python, haystack, document-content, pipeline |
| MarkdownHeaderSplitter only works with text documents (str c | validation | error | python, haystack, type-error, document-content |
| min_effective_lines must be at least 1. | validation | error | python, validation, constructor-argument, haystack |
| max_effective_lines must be at least 1. | validation | error | python, validation, constructor-argument, haystack |
| min_effective_lines must not be greater than max_effective_l | validation | error | python, validation, range-invariant, haystack |
| expected_chars_per_line must be at least 1. | validation | error | python, validation, constructor-argument, haystack |
| oversized_factor must be at least 1. | validation | error | python, validation, constructor-argument, haystack |
| secondary_split_overlap must be non-negative. | validation | error | python, validation, constructor-argument, haystack |
| secondary_split_length must be at least 1. | validation | error | python, validation, constructor-argument, haystack |
| PythonCodeSplitter only works with text documents but conten | validation | error | python, haystack, document-content, type-mismatch |
| PythonCodeSplitter only works with text documents (str conte | validation | error | python, haystack, typeerror, document-content |
| Split length must be at least 1 character. | validation | error | python, validation, constructor-argument, haystack |
| split_overlap must be greater than or equal to 0. | validation | error | python, validation, constructor-argument, haystack |
| Overlap cannot be greater than or equal to the chunk size. | validation | error | python, validation, constructor-argument, haystack |
| All separators must be strings. | validation | error | python, validation, typeerror, constructor-argument, haystack |
| n_expansions must be positive | validation | error | python, validation, constructor-argument, haystack, query |
| Invalid value for word_count_threshold: {word_count_threshol | validation | error | python, validation, ranker, constructor-argument |
| top_k must be > 0, but got {top_k} | validation | error | python, validation, ranker, constructor-argument |
| Some provided documents are not textual; LostInTheMiddleRank | validation | error | python, ranker, documents, content-validation |
| top_k must be > 0, but got {top_k} | validation | error | python, validation, ranker, meta-field |
| Parameter <weight> must be in range [0,1] but is currently s | validation | error | python, validation, ranker, meta-field |
| The value of parameter <ranking_mode> must be 'reciprocal_ra | validation | error | python, validation, ranker, enum-value |
| The value of parameter <sort_order> must be 'ascending' or ' | validation | error | python, validation, ranker, enum-value |
| The value of parameter <missing_meta> must be 'drop', 'top', | validation | error | python, validation, ranker, enum-value |
| The value of parameter <meta_value_type> must be 'float', 'i | validation | error | validation, ranker, metafield, bad-parameter |
| The threshold parameter must be between 0 and 1. | validation | error | validation, retriever, threshold, config |
| The matched leaf documents do not have the required meta fie | validation | error | retriever, meta-field, documents, validation |
| The matched leaf documents do not have the required meta fie | validation | error | retriever, meta-field, documents, validation |
| The matched leaf documents do not have the required meta fie | validation | error | retriever, meta-field, documents, validation |
| Expected 1 parent document with id {parent_id}, found {len(p | exception | error | retriever, document-store, parent-lookup, data-integrity |
| Parent document with id {parent_id} does not have any childr | exception | error | retriever, document-store, meta-field, data-integrity |
| document_store must be an instance of InMemoryDocumentStore | exception | error | type-error, retriever, document-store, incompatibility |
| Refusing to deserialize a ConditionalRouter with unsafe=True | exception | error | deserialization, security, jinja, safe-mode |
| Refusing to deserialize a ConditionalRouter with custom filt | exception | error | deserialization, security, jinja, safe-mode |
| Variable '{output}' not found in inputs for passthrough rout | exception | error | router, missing-variable, pipeline-wiring |
| Route '{output_name}' type doesn't match expected type | exception | error | router, type-validation, jinja |
| Error evaluating condition for route '{route}': {e} | exception | error | router, jinja, condition-evaluation |
| No route fired. Routes: {self.routes} | exception | error | router, no-route, jinja |
| Route must be a dictionary, got: {route} | validation | error | router, validation, configuration |
| Route must contain 'condition', 'output', 'output_type' and | validation | error | router, validation, missing-field |
| Route output, output_type and output_name must have same len | validation | error | router, validation, multi-output |
| Invalid template for condition: {condition_value!r} (type: { | validation | error | router, jinja, validation, type-mismatch |
| Invalid template for condition: {condition_value} | validation | error | python, validation, jinja2, router |
| Invalid template for output: {output!r} (type: {type(output) | validation | error | python, validation, jinja2, router |
| Invalid template for output: {output} | validation | error | python, validation, jinja2, router |
| The list of mime types cannot be empty. | validation | error | python, validation, router, mime-type |
| At least one of 'mime_type_meta_field' or 'file_path_meta_fi | validation | error | python, validation, router, mime-type |
| Invalid regex pattern '{mime_type}'. | validation | error | python, regex, validation, mime-type |
| The list of mime types cannot be empty. | validation | error | python, validation, router, mime-type |
| Invalid MIME type or regex pattern '{mime_type}'. | validation | error | python, regex, validation, mime-type |
| File not found: {source} | exception | error | python, filesystem, file-not-found, router |
| Unsupported data source type: {type(source).__name__} | exception | error | python, type-error, validation, router |
| Input must be a dictionary or a list of dictionaries. | validation | error | haystack, json-schema, validation, type-error |
| Document store {type(self.document_store).__name__} does not | exception | error | haystack, async, document-store, documentwriter |
| Pre-init hooks do not support components with variadic posit | exception | error | haystack, component, init-signature, componenterror |
| Output type specifications of 'run' and 'run_async' methods | exception | error | haystack, component, output-types, run-async, componenterror |
| set_input_types()/set_input_type() cannot override the param | exception | error | haystack, component, input-types, sockets, componenterror |
| Parameters of 'run' and 'run_async' methods must be the same | exception | error | python, haystack, component, async, signature-mismatch |
| Method 'run_async' of component '{cls.__name__}' must be a c | exception | error | python, haystack, component, async, coroutine |
| Cannot set input types on a component that doesn't have a kw | exception | error | python, haystack, component, sockets, kwargs |
| Cannot call `set_output_types` on a component that already h | exception | error | python, haystack, component, sockets, output-types, conflict |
| 'output_types' decorator can only be used on 'run' and 'run_ | exception | error | python, decorator, component, haystack |
| {cls.__name__} must have a 'run()' method. See the docs for | exception | error | python, component, haystack, decorator |
| Variadic input '{self.name}' must have a type argument, e.g. | exception | error | python, typing, generics, component-inputs, haystack |
| Either pipeline_snapshot or break_point must be provided. | exception | error | python, breakpoints, debugging, pipeline-resume, haystack |
| Missing 'type' in component '{name}' | exception | error | serialization, yaml, pipeline, haystack |
| Successfully imported module '{module}' but couldn't find '{ | exception | error | serialization, import, registry, pipeline, haystack |
| Component '{component_type}' (name: '{name}') not imported. | exception | error | serialization, import, missing-package, pipeline, haystack |
| Couldn't deserialize component '{name}' of class '{component | exception | error | serialization, deserialization, pipeline, haystack |
| Missing sender in connection: {connection} | exception | error | serialization, connections, pipeline, yaml, haystack |
| Missing receiver in connection: {connection} | exception | error | serialization, connections, pipeline, yaml, haystack |
| Error while unmarshalling serialized pipeline data. This is | exception | error | python, serialization, pipeline |
| Component instance cannot be added to the pipeline more than | exception | error | python, pipeline, api-misuse |
| A component named '{name}' already exists in this pipeline: | validation | error | python, pipeline, naming-conflict |
| '_debug' is a reserved name for debug output. Choose another | validation | error | python, pipeline, naming-conflict |
| {name} is an invalid component name, cannot contain '.' (dot | validation | error | python, pipeline, naming-conflict |
| '{type(instance)}' doesn't seem to be a component. Is this c | exception | error | python, pipeline, api-misuse |
| Component has already been added to this Pipeline under the | exception | error | python, pipeline, api-misuse |
| There is no component named '{name}' in the pipeline. The va | validation | error | python, pipeline, api-misuse |
| Connecting a Component to itself is not supported. | exception | error | python, pipeline, api-misuse |
| Component named {sender_component_name} not found in the pip | validation | error | python, pipeline, api-misuse |
| Component named {receiver_component_name} not found in the p | exception | error | pipeline, haystack, missing-component, valueerror |
| '${sender_component_name}' does not have any output connecti | exception | error | pipeline, haystack, output-types, decorator |
| '${sender}' does not exist. Output connections of ${sender_c | exception | error | pipeline, haystack, socket-name, typo |
| '${receiver} does not exist. Input connections of ${receiver | exception | error | pipeline, haystack, socket-name, typo |
| Cannot connect '${sender_component_name}' with '${receiver_c | exception | error | pipeline, haystack, type-mismatch, connection |
| Cannot connect '${sender_component_name}' with '${receiver_c | exception | error | pipeline, haystack, ambiguous-connection, sockets |
| Connection must have both sender and receiver: ${sender_repr | exception | error | pipeline, haystack, connection, partial-resolution |
| Component named {name} not found in the pipeline. | exception | error | pipeline, haystack, missing-component, valueerror |
| This method is only supported in Jupyter notebooks. Use Pipe | exception | error | pipeline, haystack, jupyter, drawing |
| Component named '${component_name}' not found in the pipelin | validation | error | pipeline, haystack, run-inputs, valueerror |
| Input '${input_name}' not found in component '${component_na | validation | error | haystack, pipeline, validation, valueerror |
| Missing mandatory input '${socket_name}' for component '${co | validation | error | haystack, pipeline, validation, missing-input |
| Maximum run count {self._max_runs_per_component} reached for | exception | error | haystack, pipeline, infinite-loop, cycle |
| Failed to perform conversion between components:\nSender com | exception | error | haystack, pipeline, type-conversion, runtime |
| break_point {break_point} is not a registered component in t | validation | error | haystack, pipeline, breakpoint, validation |
| Invalid pipeline snapshot: components {invalid_ordered_compo | validation | error | haystack, pipeline, snapshot, validation |
| Invalid pipeline snapshot: components {invalid_input_data} i | validation | error | haystack, pipeline, snapshot, validation |
| Invalid pipeline snapshot: components {invalid_component_vis | validation | error | haystack, pipeline, snapshot, validation |
| File not found: {file_path} | exception | error | haystack, file-not-found, snapshot, io |
| Error reading {file_path}: {str(e)} | exception | error | haystack, io, permissions, snapshot |
| Invalid pipeline snapshot from {file_path}: {str(e)} | exception | error | pipeline, resume, deserialization, validation |
| Invalid image format: {params['format']}. Valid options are: | validation | error | mermaid, validation, drawing, params |
| Invalid image type: {params['type']}. Valid options are: {va | validation | error | mermaid, validation, drawing, params |
| Invalid theme: {params['theme']}. Valid options are: {valid_ | validation | error | mermaid, validation, drawing, params |
| Width must be an integer. | validation | error | mermaid, validation, type-error, params |
| Height must be an integer. | validation | error | mermaid, validation, type-error, params |
| Scale must be a number between 1 and 3. | validation | error | mermaid, validation, params |
| Scale is only allowed when width or height is set. | validation | error | mermaid, validation, params |
| Background color must be a string. | validation | error | mermaid, validation, type-error, params |
| Fit must be a boolean. | validation | error | mermaid, validation, type-error, pdf, params |
| Paper size must be a string (e.g., 'a4', 'a3'). | validation | error | python, validation, mermaid, pipeline-drawing |
| Landscape must be a boolean. | validation | error | python, validation, mermaid, pipeline-drawing |
| The Mermaid server returned an empty response; no image will | exception | error | network, http, mermaid, pipeline-drawing |
| The Mermaid server response does not look like a valid {expe | exception | error | network, security, mermaid, content-validation |
| Invalid format: {endpoint_format}. Valid options are 'img', | validation | error | python, validation, mermaid, pipeline-drawing |
| There was an issue with {server_url}, see the stacktrace for | exception | error | network, http, mermaid, pipeline-drawing |
| Pipeline has not finished; iterate the handle first. | exception | error | python, asyncio, concurrency, pipeline |
| Pipeline was cancelled; no result available. | exception | error | python, asyncio, cancellation, pipeline |
| PipelineRuntimeError.from_exception(component_name, instance | exception | error | python, pipeline, component-execution, error-wrapping |
| PipelineRuntimeError.from_invalid_output(component_name, ins | exception | error | python, pipeline, component-contract, type-validation |
| The provided break_point targets the same component and visi | exception | error | pipeline, breakpoint, resume, snapshot |
| BreakpointException.from_triggered_breakpoint(break_point=br | exception | warning | pipeline, breakpoint, control-flow |
| PipelineRuntimeError.from_invalid_output(component_name, ins | exception | error | pipeline, component, type-error, return-type |
| concurrency_limit must be greater than or equal to 1. | validation | error | pipeline, asyncio, validation, argument-error |
| Unknown components in streaming_components: {sorted(unknown) | validation | error | pipeline, streaming, validation, argument-error |
| These components do not support streaming: {sorted(non_strea | validation | error | pipeline, streaming, validation |
| pop from empty queue | exception | error | queue, indexerror, concurrency, internal-api |
| peek at empty queue | exception | error | queue, indexerror, internal-api |
| Cannot determine the value of the init parameter '{param_nam | exception | error | serialization, component, to-dict |
| Component '{name}' of type '{type(component).__name__}' has | exception | error | serialization, python, haystack |
| Component '{name}' of type '{type(component).__name__}' has | exception | error | serialization, python, haystack |
| Component '{name}' of type '{type(component).__name__}' has | exception | error | serialization, python, haystack |
| Missing 'type' in serialization data | exception | error | deserialization, haystack, python |
| Class '{data['type']}' can't be deserialized as '{cls.__name | exception | error | deserialization, haystack, version-migration |
| Refusing to deserialize unknown parameter '{key}' for '{cls. | exception | error | deserialization, haystack, config-validation |
| Refusing to deserialize '{handle}': it resolves to '{name}', | exception | critical | security, deserialization, haystack |
| Refusing to deserialize '{handle}': it traverses into the in | exception | critical | security, deserialization, sandbox-escape |
| Refusing to deserialize '{handle}': it resolves to the built | exception | critical | security, deserialization, builtins-blocked |
| Refusing to deserialize '{handle}': it resolves to an import | exception | critical | serialization, security, deserialization |
| Refusing to deserialize '{handle}': it resolves to a builtin | exception | error | serialization, security, type-annotation |
| Pipeline must be provided to SuperComponent. | validation | error | super-component, pipeline, argument-validation |
| Invalid path format: '{path}'. Expected 'component_name.sock | exception | error | super-component, mapping, path-format |
| input_mapping must be a dictionary | exception | error | super-component, input-mapping, type-validation |
| Input paths for '{wrapper_input_name}' must be a list of str | exception | error | super-component, input-mapping, type-validation |
| Component '{comp_name}' not found in pipeline inputs. Availa | exception | error | super-component, input-mapping, unknown-component |
| Input socket '{socket_name}' not found in component '{comp_n | exception | error | super-component, input-mapping, unknown-socket |
| Type conflict for input '{socket_name}' from component '{com | exception | error | super-component, type-conflict, input-mapping |
| Output names in output_mapping must be strings. | exception | error | super-component, output-mapping, type-validation |
| ID '{document.id}' already exists. | exception | error | document-store, duplicate-id, python |
| Invalid filter syntax. See https://docs.haystack.deepset.ai/ | validation | error | document-store, filters, validation, python |
| Query should be a non-empty string | validation | error | bm25, retrieval, validation, python |
| query_embedding should be a non-empty list of floats. | validation | error | embeddings, retrieval, validation, numpy |
| The embedding size of all Documents should be the same. Plea | exception | error | embeddings, dimension-mismatch, document-store |
| The embedding size of the query should be the same as the em | exception | error | embeddings, dimension-mismatch, retrieval |
| Unknown FilterPolicy type '{filter_policy}'. Supported types | validation | error | filter-policy, enum, validation |
| No inputs provided. | validation | error | evaluation, validation, empty-input |
| Lengths of the inputs should be the same. | validation | error | evaluation, validation, data-alignment |
| Aggregate score missing for {metric}. | validation | error | python, validation, evaluation |
| Individual scores missing for {metric}. | validation | error | python, validation, evaluation |
| Length of individual scores for '{metric}' should be the sam | validation | error | python, validation, evaluation |
| All lists in the JSON must have the same length | validation | error | python, csv, evaluation |
| A file path must be provided in 'csv_file' parameter to save | validation | error | python, csv, argument-validation |
| Invalid output format '{output_format}' provided. Choose fro | validation | error | python, argument-validation, enum |
| Comparative scores can only be computed between EvaluationRu | exception | error | python, type-error, evaluation |
| The 'other' parameter must have 'run_name', 'inputs', and 'r | validation | error | python, attribute-validation, evaluation |
| Detailed reports must be dictionaries. | exception | error | python, type-error, evaluation |
| `max_total_tokens` must be a positive number of tokens, got | validation | error | python, agent, argument-validation, configuration |
| `context_window` must be a positive number of tokens, got {c | validation | error | validation, constructor, config, compaction |
| `compact_at` and `compact_to` must satisfy 0 < compact_to < | validation | error | validation, constructor, config, compaction |
| `min_keep_steps` must be at least 0, got {min_keep_steps}. | validation | error | validation, constructor, config, compaction |
| `min_keep_steps` must be at least 0, got {min_keep_steps}. | validation | error | validation, constructor, config, compaction |
| `approximate_summary_tokens` must be a positive number of to | validation | error | validation, constructor, config, compaction |
| The Chat Generator returned no usable text to use as a conve | exception | error | llm, empty-output, summary, runtime, compaction |
| The generated summary did not reduce the conversation size ( | exception | error | llm, summary, token-budget, runtime, compaction |
| `min_keep_steps` must be at least 1, got {min_keep_steps}. T | validation | error | validation, constructor, config, tool-results, compaction |
| `min_tokens` must be at least 0, got {min_tokens}. | validation | error | validation, constructor, config, tool-results, compaction |
| A FunctionHook requires at least one of `function` or `async | validation | error | validation, constructor, hooks, missing-argument |
| `function` must be a synchronous function. '{function.__name | validation | error | python, async, validation, hooks |
| `async_function` must be a coroutine function defined with ` | validation | error | python, async, validation, hooks |
| Hook function '{func.__name__}' must take a single parameter | validation | error | python, validation, hooks, signature |
| This FunctionHook only has an `async_function` and cannot ru | exception | error | python, async, runtime, hooks |
| Expected one ToolExecutionDecision for each tool call, but r | validation | error | python, validation, hooks, human-in-the-loop, tools |
| No unused ToolExecutionDecision matches tool call {tc.tool_n | validation | error | python, validation, hooks, human-in-the-loop, tools |
| {subject} '{path_like}' resolves outside the store root '{ro | validation | error | python, security, path-traversal, validation |
| Error dumping pipeline to YAML - Ensure that all pipeline co | exception | error | python, yaml, serialization, pipeline |
| Error loading pipeline from YAML - Ensure that all pipeline | exception | error | python, yaml, serialization, pipeline |
| Skill frontmatter is opened with '---' but never closed with | exception | error | python, yaml, frontmatter, parsing, skills |
| File '{path}' in skill '{name}' is not a readable asset. Onl | exception | error | |
| Failed to create JSON schema for the run method of Component | exception | error | pydantic, json-schema, tool-definition, component |
| Function '{function.__name__}': parameter '{param_name}' doe | exception | error | type-hints, tool-definition, python, validation |
| Failed to create JSON schema for function '{function.__name_ | exception | error | pydantic, json-schema, tool-definition |
| The 'pipeline' parameter must be an instance of Pipeline. Go | exception | error | type-check, pipeline, tool-definition |
| Invalid catalog type: {type(catalog)}. Expected Tool, Toolse | exception | error | type-check, toolset, validation |
| Invalid search_tool_parameters_description keys: {invalid_ke | exception | error | validation, configuration, toolset |
| SearchableToolset does not support concatenation. | exception | error | not-implemented, toolset, api-misuse |
| SearchableToolset does not support adding new tools after in | exception | error | not-implemented, toolset, api-misuse |
| Invalid item type: {type(item)}. Must be Tool or str. | exception | error | type-check, toolset, membership |
| Items in the tools list must be Tool or Toolset instances. | exception | error | serialization, type-check, toolset |
| `async_function` must be a coroutine function defined with ` | validation | error | python, async, tool, validation |
| The provided parameters do not define a valid JSON schema | validation | error | python, json-schema, tool, validation |
| outputs_to_state configuration for key '{key}' must be a dic | validation | error | python, tool, config, type-error |
| outputs_to_state source for key '{key}' must be a string. | validation | error | python, tool, config, validation |
| outputs_to_state handler for key '{key}' must be callable | validation | error | python, tool, config, callable |
| outputs_to_state: '{name}' maps state key '{state_key}' to u | validation | error | python, tool, config, validation |
| outputs_to_string source must be a string. | validation | error | python, tool, config, validation |
| outputs_to_string handler must be callable | validation | error | python, tool, config, callable |
| outputs_to_string raw_result must be a boolean. | validation | error | python, tool, config, type-error |
| Invalid outputs_to_string config. When using 'source', 'hand | validation | error | python, tool, config, validation |
| Failed to deserialize data '{payload}' into Pydantic model ' | exception | error | python, pydantic, deserialization, haystack |
| Value '{payload}' is not a valid member of Enum '{value_type | exception | error | python, enum, deserialization, haystack |
| Serialization of instance methods is not supported. | exception | error | python, serialization, callable, haystack |
| Serialization of lambdas is not supported. | exception | error | python, serialization, lambda, callable, haystack |
| Serialization of nested functions is not supported. | exception | error | python, serialization, nested-function, callable, haystack |
| Could not find attribute '{part}' in {container} | exception | error | python, deserialization, attributeerror, callable, haystack |
| The final attribute is not callable: {attr_value} | exception | error | python, deserialization, callable, haystack |
| Could not import '{callable_handle}' as a module or callable | exception | error | python, deserialization, import, module-allowlist, haystack |
| Missing '{key}' in serialization data | exception | error | python, deserialization, pipeline, haystack |
| The value of '{key}' is not a dictionary | exception | error | python, deserialization, pipeline, haystack |
| Missing 'type' in {key} serialization data | exception | error | deserialization, yaml, pipeline, missing-field |
| Class '{serialized_component['type']}' not correctly importe | exception | error | deserialization, import, dependency, class-not-found |
| Unknown device type string '{string}' | validation | error | device, pytorch, gpu, value-error |
| Device id must be >= 0, got {id} | validation | error | device, pytorch, validation, value-error |
| Couldn't convert HuggingFace device map - unexpected device | validation | error | device, huggingface, accelerate, type-error |
| The disk device can only be used as a part of device maps | validation | error | device, gpu, validation, value-error |
| The component device can neither be empty nor contain both a | validation | error | device, validation, state, value-error |
| Only single devices can be converted to PyTorch format | validation | error | device, pytorch, multi-gpu, value-error |
| Only single devices can be converted to spaCy format | validation | error | device, spacy, multi-gpu, value-error |
| Invalid component device type '{type(device).__name__}'. Mus | validation | error | python, device, type-validation, haystack |
| Unknown component device type '{dict['type']}' in serialized | validation | error | python, serialization, deserialization, haystack |
| Device id must be an integer, got {device_id_str} | validation | error | python, device, parsing, haystack |
| Filter value can't be of type {type(filter_value)} using ope | exception | error | python, filters, validation, haystack |
| Can't compare strings using operators '>', '>=', '<', '<='. | exception | error | python, filters, datetime, haystack |
| Filter value must be a `list` when using operator 'in' or 'n | exception | error | python, filters, validation, haystack |
| 'operator' key missing in {condition} | exception | error | python, filters, schema-validation, haystack |
| 'conditions' key missing in {condition} | exception | error | python, filters, schema-validation, haystack |
| Unknown logical operator '{operator}'. Valid operators are: | exception | error | python, filters, validation, haystack |
| 'value' key missing in {condition} | exception | error | haystack, filters, filtererror, missing-key |
| Unknown comparison operator '{operator}'. Valid operators ar | exception | error | haystack, filters, filtererror, invalid-operator |
| A `ChatMessage` must contain at least one `TextContent`, `To | validation | error | haystack, hugging-face, chatmessage, valueerror, empty-content |
| For compatibility with the Hugging Face API, a `ChatMessage` | validation | error | haystack, hugging-face, chatmessage, valueerror, tool-call-result |
| The parameter 'http_client_kwargs' must be a dictionary. | validation | error | haystack, httpx, typeerror, http-client |
| The 'insert' tag requires an expression that evaluates to a | validation | error | haystack, jinja2, template-syntax-error, insert-tag |
| Role must be one of: {', '.join(self.SUPPORTED_ROLES)} | validation | error | haystack, jinja2, template-syntax-error, message-tag, invalid-role |
| name must be a string | exception | error | haystack, jinja2, template-syntax-error, message-tag, name-attribute |
| meta must be a dictionary | exception | error | haystack, jinja2, template-syntax-error, message-tag, meta-attribute |
| Message template produced content that couldn't be parsed in | validation | error | haystack, jinja2, chatmessage, valueerror, template-render |
| The '{% insert %}' expression must evaluate to a ChatMessage | validation | error | jinja2, chat-template, type-mismatch |
| Message content in template is empty or contains only whites | validation | error | jinja2, chat-template, empty-content |
| Found unclosed <haystack_content_part> tag at position {tag_ | validation | error | jinja2, chat-template, malformed-template |
| User message must contain only TextContent, string, ImageCon | validation | error | chat-template, message-validation, content-parts |
| System message must contain a text part. | validation | error | chat-template, message-validation, system-prompt |
| System message must contain only one text part. | validation | error | chat-template, message-validation, system-prompt |
| Assistant message must contain one text part at most. | validation | error | chat-template, message-validation, assistant-message |
| Assistant message must contain at least one text or tool cal | validation | error | chat-template, message-validation, assistant-message |
| Assistant message must contain only text, tool call or reaso | validation | error | chat-template, message-validation, assistant-message |
| Tool message must contain only one tool call result. | validation | error | chat-template, message-validation, tool-message |
| Could not apply arguments {generic_args} to type {main_type} | exception | error | python, deserialization, generics, haystack |
| {e} | exception | error | python, deserialization, import-error, haystack |
| Could not deserialize type: {type_str} | exception | error | python, deserialization, type-resolution, haystack |
| Could not import '{fully_qualified_name}' | exception | error | python, import-error, deserialization, haystack |
| expected token 'name:role' | panic | error | python, jinja2, template-syntax, haystack |
| expected token 'assign' | panic | error | python, jinja2, template-syntax, haystack |
| Could not import '{type_str}' as it may not exist or is not | exception | error | python, deserialization, import-error, haystack |
| expected token 'assign', got ... | panic | error | python, jinja2, template-syntax, haystack |
| Warning: In an upcoming release, this method will require ke | console | warning | deprecation, python, pipeline, keyword-arguments |
| Adding a Toolset to another Toolset is deprecated and will b | console | warning | deprecation, toolset, python |
| Combining Toolsets and Tools with '+' is deprecated and will | console | warning | deprecation, toolset, operator-overloading, python |
| Mutating attribute '{name}' on an instance of '{type(self)._ | console | warning | dataclass, immutability, python, pipeline |
| '{cls.__name__}' is an experimental component and may change | console | info | experimental, deprecation, python, unstable-api |