ErrLookup › run-llama/llama_index
run-llama/llama_index
LlamaIndex is the leading document agent and OCR platform · Python · 2,180 source files
Analyzed at afd0fef371 on 2026-08-15. 493 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| First argument to Readability constructor should be a docume | exception | error | docstore, serialization, data-corruption, llama-index |
| Aborting parsing document; {numTags} elements found | exception | error | docstore, async, missing-node, llama-index |
| Command failed: {command} {result.stderr} | exception | error | docstore, async, serialization, llama-index |
| Git command failed: {result.stderr} | exception | error | docstore, deserialization, version-mismatch, llama-index |
| Could not extract tool use from input text: {input_text} | exception | error | docstore, legacy, migration, deserialization |
| Could not extract final answer from input text: {input_text} | exception | warning | kvstore, batching, not-implemented, custom-store |
| Could not parse output: {output} | exception | warning | kvstore, async, batching, not-implemented |
| 'handoff' is a reserved tool name. Please use a different na | exception | warning | kvstore, persistence, not-implemented, custom-store |
| Got empty streaming response | exception | warning | kvstore, persistence, not-implemented, factory |
| Must provide either user_msg or chat_history | exception | error | storage-context, serialization, vector-store, llama-index |
| Max iterations of {max_iterations} reached! Either something | exception | error | tools, function-tool, validation, llama-index |
| No tool calls found, cannot aggregate results. | exception | error | tools, function-tool, metadata, llama-index |
| Tool {tool.metadata.name} requires context. CodeActAgent onl | exception | error | tools, deserialization, pickle, llama-index |
| Tool {tool.metadata.name} is not a FunctionTool. CodeActAgen | exception | error | tools, context, workflows, llama-index |
| llm must be a function calling LLM to use handoff | exception | error | tools, async, context, workflows |
| code_execute_fn must be provided for CodeActAgent | exception | error | tools, query-engine, input-validation, llama-index |
| Unknown tool name: {tool_call_result.tool_name} | exception | error | tools, query-plan, multi-hop, llm-output |
| LLM must be a FunctionCallingLLM | exception | error | tools, retriever, empty-input, llama-index |
| At least one agent must be provided | exception | error | tools, retriever, async, empty-input |
| All agents must have a name in a multi-agent workflow | exception | error | agent-workflow, validation, constructor, multi-agent |
| All agents must have a description in a multi-agent workflow | exception | error | agent-workflow, validation, constructor, multi-agent |
| Initial state is not supported per-agent in AgentWorkflow | exception | error | agent-workflow, validation, state, constructor |
| Exactly one root agent must be provided | exception | error | agent-workflow, validation, constructor, multi-agent |
| Root agent {root_agent} not found in provided agents | exception | error | agent-workflow, validation, constructor, typo |
| Handoff prompt must contain {agent_info} | exception | error | agent-workflow, prompt-template, validation, handoff |
| Handoff output prompt must contain {to_agent} and {reason} | exception | error | agent-workflow, prompt-template, validation, handoff |
| State prompt must contain {state} and {msg} | exception | error | agent-workflow, prompt-template, validation, state |
| Got empty streaming response | exception | error | agent-workflow, streaming, llm, transient |
| Must provide either user_msg or chat_history | exception | error | agent-workflow, validation, input, runtime |
| Max iterations of {max_iterations} reached! Either something | exception | error | agent-workflow, loop-guard, max-iterations, runtime |
| No tool calls found, cannot aggregate results. | exception | error | agent-workflow, internal-invariant, events, subclassing |
| Expected ActionReasoningStep, got {reasoning_step} | exception | error | react-agent, structured-output, llm, parsing |
| Detected nested async. Please use nest_asyncio.apply() to al | exception | error | async, event-loop, jupyter, sync-async-bridge |
| This query engine does not support retrieve, use query direc | exception | error | query-engine, api-misuse, retriever |
| This query engine does not support synthesize, use query dir | exception | error | query-engine, api-misuse, response-synthesis |
| This query engine does not support asynthesize, use aquery d | exception | error | query-engine, api-misuse, async, response-synthesis |
| Object {obj} is not retrievable. | exception | error | retriever, recursive-retrieval, index-node, type-dispatch |
| There are {len(self.selections)} selections, please use .ind | exception | warning | selector, pydantic, single-vs-multi, api-misuse |
| There are {len(self.reasons)} selections, please use .reason | exception | error | llama-index, selector, router, multi-select |
| Unexpected type: {type(choice)} | exception | error | llama-index, selector, type-validation, tool-metadata |
| Unexpected type: {type(query)} | exception | error | llama-index, selector, type-validation, query |
| No embeddings to aggregate | exception | error | llama-index, embeddings, empty-input, aggregation |
| embeddings_cache must be of type BaseKVStore | exception | error | llama-index, embeddings, cache, type-validation, config |
| embeddings_cache must be defined | exception | error | llama-index, embeddings, cache, config |
| LLM only supports text inputs | exception | error | llama-index, llm, multimodal, chat-message |
| Invalid message content: {message.content!s} | exception | error | llama-index, llm, chat-message, type-validation |
| Did not find {key}, please add an environment variable `{env | exception | critical | llama-index, config, environment, api-key, credentials |
| The provided image string is not base64-encoded | exception | error | llama-index, image, base64, multimodal |
| image_node.image is neither a string or None. | exception | error | llama-index, image, type-validation, multimodal |
| Could not format attribute {attribute_name} with value {temp | exception | error | llama-index, formatting, templates, multimodal, blocks |
| resolve_image returned zero bytes | exception | error | llama-index, image, empty-input, multimodal |
| resolve_audio returned zero bytes | exception | error | llama-index, audio, empty-input, multimodal |
| resolve_video returned zero bytes | exception | error | llama-index, video, empty-input, multimodal |
| resolve_document returned zero bytes | exception | error | llama-index, document, pdf, empty-input, multimodal |
| CitableBlock content must contain exactly one block when pro | exception | error | llama-index, citation, validation, blocks |
| ChatMessage contains multiple blocks, use 'ChatMessage.block | exception | error | llama-index, chat-message, blocks, migration |
| Cannot add two handlers of the same type {type(new_handler)} | exception | error | llama-index, callbacks, observability, config, duplicates |
| WandbCallbackHandler is not installed. Please install it usi | exception | error | llama-index, callbacks, import-error, optional-dependency, wandb |
| OpenInferenceCallbackHandler is not installed. Please instal | exception | error | llama-index, callbacks, import-error, optional-dependency, openinference |
| ArizePhoenixCallbackHandler is not installed. Please install | exception | error | llama-index, callbacks, import-error, optional-dependency, arize-phoenix |
| HoneyHiveCallbackHandler is not installed. Please install it | exception | error | llama-index, callbacks, import-error, optional-dependency, honeyhive |
| PromptLayerHandler is not installed. Please install it using | exception | error | llama-index, callbacks, import-error, optional-dependency, promptlayer |
| DeepEvalCallbackHandler is not installed. Please install it | exception | error | llama-index, callbacks, import-error, optional-dependency, deepeval |
| ArgillaCallbackHandler is not installed. Please install it u | exception | error | llama-index, callbacks, import-error, optional-dependency, argilla |
| LangfuseCallbackHandler is not installed. Please install it | exception | error | llama-index, callbacks, import-error, optional-dependency, langfuse |
| AgentOpsHandler is not installed. Please install it using `p | exception | error | llama-index, callbacks, import-error, optional-dependency, agentops |
| Literal AI Handler is not installed. Please install it using | exception | error | llama-index, callbacks, import-error, optional-dependency, literalai |
| Opik Handler is not installed. Please install it using `pip | exception | error | llama-index, callbacks, import-error, optional-dependency, opik |
| Eval mode {eval_mode} not supported. | exception | error | llama-index, callbacks, validation, invalid-argument |
| Token budget exceeded! Limit: {self.token_budget}, Current: | exception | error | llama-index, callbacks, token-limit, cost-control |
| system_prompt is not supported for CondenseQuestionChatEngin | exception | error | llama-index, chat-engine, unsupported-argument, condense-question |
| prefix_messages is not supported for CondenseQuestionChatEng | exception | error | llama-index, chat-engine, unsupported-argument, condense-question |
| Streaming is not enabled. Please use chat() instead. | exception | error | llama-index, chat-engine, streaming, query-engine |
| Streaming is not enabled. Please use achat() instead. | exception | error | llama-index, chat-engine, streaming, async |
| Cannot specify both system_prompt and prefix_messages | exception | error | llama-index, chat-engine, conflicting-arguments, validation |
| Cannot specify both system_prompt and prefix_messages | exception | error | llama-index, chat-engine, conflicting-arguments, validation |
| response_gen is only available for streaming responses. Set | exception | error | llama-index, chat-engine, streaming, response-type |
| chat_stream is None. Cannot write to history without chat_st | exception | error | streaming, chat-engine, agents, sync-async-mismatch |
| achat_stream is None. Cannot asynchronously write to history | exception | error | streaming, chat-engine, agents, async, sync-async-mismatch |
| chat_stream is None! | exception | error | streaming, chat-engine, agents, sync-async-mismatch |
| achat_stream is None! | exception | error | streaming, chat-engine, agents, async, sync-async-mismatch |
| File type not supported: {file_path} | exception | error | cli, migration, file-format, upgrade |
| summary field of the index_struct not set. | exception | error | persistence, index, migration, data-model |
| ref_doc_id of node cannot be None when building a document s | exception | error | index, document-summary-index, nodes, data-model |
| Embedding loading requires a class_name | exception | error | embeddings, serialization, persistence |
| Invalid Embedding name: {name} | exception | error | embeddings, serialization, dependencies, registry |
| Unhandled shape {array.shape}. | exception | error | embeddings, pooling, tensor-shape, multi-modal |
| The embedding file {file_path} is empty. | exception | error | embeddings, cache, file-io, data-integrity |
| `llama-index-embeddings-openai` package not found, please ru | exception | critical | embeddings, dependencies, installation, openai, version-change |
| ****** Could not load OpenAI embedding model. If you intend | exception | critical | embeddings, openai, api-key, authentication, environment |
| `llama-index-embeddings-clip` package not found, please run | exception | critical | embeddings, clip, multi-modal, dependencies, installation |
| embed_model must start with str 'local' or of type BaseEmbed | exception | error | embeddings, configuration, huggingface, api-misuse |
| `llama-index-embeddings-huggingface` package not found, plea | exception | critical | embeddings, huggingface, dependencies, installation |
| `llama-index-embeddings-langchain` package not found, please | exception | critical | embeddings, langchain, dependencies, installation, interop |
| query and response must be provided | exception | error | evaluation, api-misuse, validation, llm |
| The response is invalid | exception | error | llm-output, parsing, evaluation, answer-relevancy |
| At least one item in inputs_list must be provided. | exception | error | batch-evaluation, input-validation, llama-index |
| All inputs must have the same length. | exception | error | batch-evaluation, input-validation, length-mismatch |
| eval_kwargs_lists must be a dict. Got {eval_kwargs_lists} | exception | error | batch-evaluation, type-validation, api-misuse |
| nested inner values in eval_kwargs must be a list. Got {eval | exception | error | batch-evaluation, type-validation, nested-kwargs |
| eval_kwargs must be a list or a dict. Got {evaluator}: {eval | exception | error | batch-evaluation, type-validation, api-misuse |
| `queries` must be provided | exception | error | batch-evaluation, input-validation, api-misuse |
| Both query and contexts must be provided | exception | error | evaluation, context-relevancy, input-validation |
| The response is invalid | exception | error | llm-output, parsing, evaluation, context-relevancy |
| query, and response must be provided | exception | error | evaluation, correctness, input-validation |
| Query id {query_id} not in responses | exception | error | dataset, key-mismatch, evaluation |
| Pandas is required to get results dataframes. Please install | exception | error | optional-dependency, pandas, environment |
| contexts and response must be provided | exception | error | evaluation, faithfulness, input-validation |
| The response is invalid | exception | error | llm-output, faithfulness, evaluation, strict-mode |
| query and response must be provided | exception | error | evaluation, guideline, input-validation |
| llama-index-llms-openai is not installed. Please install it | exception | error | optional-dependency, multi-modal, installation, openai |
| contexts and response must be provided | exception | error | multi-modal, faithfulness, input-validation |
| The response is invalid | exception | error | multi-modal, llm-output, faithfulness, strict-mode |
| OpenAIMultiModal is not installed. Please install it using ` | exception | error | import-error, dependency, multi-modal, evaluation, openai |
| query, contexts, and response must be provided | exception | error | validation, evaluation, multi-modal, required-args |
| The response is invalid | exception | error | evaluation, llm-verdict, multi-modal, strict-mode |
| pandas is required for this function. Please install it with | exception | error | import-error, dependency, pandas, evaluation, notebook |
| Metric key {metric_key} not in results_df | exception | error | validation, evaluation, retrieval-metrics, pandas |
| names and results_arr must have same length. | exception | error | validation, evaluation, pandas, required-args |
| Impossible score results. Total amount of votes is 2. | exception | error | evaluation, pairwise, llm-verdict, consensus, float-precision |
| query, response, second_response, and reference must be prov | exception | error | validation, evaluation, pairwise, async, required-args |
| query, contexts, and response must be provided | exception | error | validation, evaluation, relevancy, async, required-args |
| The response is invalid | exception | error | evaluation, relevancy, llm-verdict, async, strict-mode |
| Unsupported mode. | exception | error | validation, evaluation, retrieval, enum, mode |
| Retrieved ids and expected ids must be provided | exception | error | validation, evaluation, retrieval-metrics, hit-rate, required-args |
| Must pass in cohere api key or specify via COHERE_API_KEY en | exception | error | authentication, environment-variables, cohere, configuration |
| Cannot import cohere package, please `pip install cohere`. | exception | error | missing-dependency, cohere, installation, optional-extra |
| Retrieved texts must be provided | exception | error | validation, evaluation, cohere, missing-argument |
| Invalid metric name: {metric} | exception | error | validation, configuration, evaluation, typo |
| Cannot specify both similarity_fn and similarity_mode | exception | error | configuration, evaluation, mutually-exclusive-args, validation |
| Must specify both response and reference | exception | error | validation, evaluation, missing-argument, embeddings |
| Document {doc.node_id} is too large ({token_count} tokens) t | exception | error | validation, context-window, document-processing, token-limit |
| Unknown oversized document strategy: {strategy} | exception | error | configuration, validation, enum-value, document-processing |
| Extractor loading requires a class_name | exception | error | serialization, validation, configuration, missing-key |
| Unknown extractor name: {extractor_name} | exception | error | serialization, unsupported-type, configuration, registry |
| num_nodes must be >= 1 | exception | error | validation, configuration, constructor, off-by-one |
| num_keywords must be >= 1 | exception | error | validation, configuration, constructor, off-by-one |
| questions must be >= 1 | exception | error | validation, configuration, constructor, off-by-one |
| summaries must be one of ['self', 'prev', 'next'] | exception | error | validation, configuration, enum-value, metadata-extraction |
| Only `TextNode` is allowed for `Summary` extractor | exception | error | type-validation, metadata-extraction, async, node-types |
| SimpleGraphStore does not support get_schema | exception | error | not-implemented, graph-store, unsupported-operation, in-memory |
| SimpleGraphStore does not support query | exception | error | not-implemented, graph-store, unsupported-operation, query-language |
| Could not infer node type for data: {node_dict!s} | exception | error | serialization, deserialization, schema-drift, data-corruption |
| Schema not implemented for SimplePropertyGraphStore. | exception | error | not-implemented, property-graph, unsupported-operation, in-memory |
| Structured query not implemented for SimplePropertyGraphStor | exception | error | not-implemented, property-graph, query-language, unsupported-operation |
| Vector query not implemented for SimplePropertyGraphStore. | exception | error | graph-store, vector-query, not-implemented, property-graph |
| Client not implemented for SimplePropertyGraphStore. | exception | error | graph-store, client, not-implemented, property-graph |
| Please install yfiles_jupyter_graphs to visualize the graph: | exception | error | graph-store, visualization, missing-dependency, jupyter, importerror |
| One of nodes, objects, or index_struct must be provided. | exception | error | index, constructor, validation, base-index |
| Only one of nodes or index_struct can be provided. | exception | error | index, constructor, validation, base-index |
| The constructor now takes in a list of Node objects. Since y | exception | error | index, constructor, api-migration, validation, base-index |
| nodes must be a list of Node objects. | exception | error | index, constructor, type-validation, base-index |
| ChatMode.REACT and ChatMode.OPENAI are now deprecated and re | exception | error | chat-engine, deprecation, agents, api-migration |
| Unknown chat mode: {chat_mode} | exception | error | chat-engine, enum, validation, dispatch |
| sql_database must be provided. | exception | error | sql, validation, constructor, struct-store |
| table_name must be specified | exception | error | sql, validation, constructor, table-context |
| ref_doc_id_column {ref_doc_id_column} not in table {table_na | exception | error | sql, validation, schema-mismatch, table-context |
| Invalid number of children. | exception | error | tree-index, validation, constructor |
| Summary must be set for children indices. If the index does | exception | error | composable-graph, validation, summaries |
| indices and index_summaries must have same length! | exception | error | composable-graph, validation, length-mismatch |
| Cannot use embedding retriever if embed_summaries is False | exception | error | document-summary-index, retriever, embeddings, validation |
| Unknown retriever mode: {retriever_mode} | exception | error | document-summary-index, retriever, enum, validation |
| doc_id {doc_id} not in index | exception | error | document-summary-index, lookup, doc-id, validation |
| ref_doc_id of node cannot be None when building a document s | exception | error | document-summary-index, nodes, ref-doc-id, validation |
| Vector store query result should return at least one of node | exception | error | document-summary-index, vector-store, retriever, custom-store |
| EmptyIndex only supports response_mode=generation. | exception | error | llama-index, empty-index, query-engine, configuration |
| Cannot insert into an empty index. | exception | error | llama-index, empty-index, not-implemented, insert |
| Cannot delete from an empty index. | exception | error | llama-index, empty-index, not-implemented, delete |
| ref_doc_info not supported for an empty index. | exception | error | llama-index, empty-index, not-implemented, property |
| Unknown retriever mode: {retriever_mode} | exception | error | llama-index, keyword-table, retriever, configuration, validation |
| Please install nltk: `pip install nltk` | exception | error | llama-index, rake, nltk, optional-dependency, import |
| Please install rake_nltk: `pip install rake_nltk` | exception | error | llama-index, rake, rake-nltk, optional-dependency, import |
| Delete is not supported for KG index yet. | exception | error | llama-index, knowledge-graph, not-implemented, delete |
| Please install networkx to visualize the graph: `pip install | exception | error | llama-index, knowledge-graph, networkx, optional-dependency, visualization |
| kg_rel_map must be found in at least one Node. | exception | error | llama-index, knowledge-graph, retriever, metadata, empty-results |
| Unknown retriever mode: {retriever_mode} | exception | error | llama-index, summary-index, retriever, configuration, validation |
| No index in storage context, check if you specified the righ | exception | error | llama-index, storage, persistence, loading, configuration |
| Expected to load a single index, but got {len(indices)} inst | exception | error | llama-index, storage, persistence, loading, index-id |
| Failed to load index with ID {index_id} | exception | error | llama-index, storage, loading, index-id, validation |
| _build_index_from_nodes not implemented for BaseManagedIndex | exception | error | llama-index, managed-index, not-implemented, insert |
| _delete_node not implemented for BaseManagedIndex. | exception | error | llama-index, managed-index, not-implemented, delete |
| ref_doc_info not implemented for BaseManagedIndex. | exception | error | llama-index, managed-index, not-implemented, property, metadata |
| from_documents not implemented for BaseManagedIndex. | exception | error | llama-index, managed-index, not-implemented, from-documents |
| Cannot initialize from a vector store that does not store te | exception | error | llama-index, multimodal, vector-store, validation, configuration |
| Vector store query result should return at least one of node | exception | error | llama-index, multimodal, retriever, vector-store, custom-integration |
| Calculated available context size {context_size_tokens} was | validation | error | llama-index, prompt, context-window, configuration |
| Chunk size {chunk_size} is not positive. | validation | error | llama-index, prompt, chunking, context-window |
| Ref doc info not implemented for PropertyGraphIndex. All ins | exception | error | llama-index, property-graph, not-implemented, api-limitation |
| Invalid return type. All items in the list must be of the sa | validation | error | llama-index, property-graph, custom-retriever, type-mismatch |
| Invalid return type: {type(result)} | validation | error | llama-index, property-graph, custom-retriever, return-type |
| The provided graph store does not support cypher queries. | validation | error | llama-index, property-graph, cypher, graph-store, capability-check |
| The provided graph store does not support cypher queries. | validation | error | llama-index, property-graph, cypher, text-to-cypher, graph-store |
| No nodes returned by vector_query | exception | error | llama-index, property-graph, vector-store, custom-store, contract |
| Please install scikit-learn to use this feature. | exception | error | llama-index, missing-dependency, sklearn, svm, retriever |
| Unknown query mode: {query_mode} | validation | error | llama-index, query-mode, validation, enum |
| Evaluation is not set. | validation | error | llama-index, query-transform, retry-engine, evaluation |
| Evaluation result must contain response and feedback. | validation | error | llama-index, query-transform, evaluation, retry-engine |
| Delete not implemented for Struct Store Index. | exception | error | llama-index, struct-store, not-implemented, deletion |
| Struct Store Index does not support ref_doc_info. | exception | error | llama-index, struct-store, not-implemented, api-limitation |
| Invalid context table names: {context_keys - set(self.sql_da | validation | error | llama-index, sql, schema-validation, context-container |
| You need to install jsonpath-ng to use this function! | exception | error | llama-index, json, missing-dependency, jsonpath |
| Invalid JSON Path: {expression} | validation | warning | llama-index, json, llm-output, jsonpath, parsing |
| PandasQueryEngine has been moved to `llama-index-experimenta | exception | warning | llama-index, pandas, deprecation, migration, code-execution |
| sql_database must be specified | validation | error | sql, constructor, config, llama-index |
| Not supported | exception | error | sql, api-misuse, retriever, llama-index |
| Unknown query mode: {query_mode} | validation | error | sql, enum, api-misuse, llama-index |
| context_dict must be provided. There is currently no table c | validation | error | sql, prompt-context, config, llama-index |
| custom_prompt must have the following template variables: {d | validation | error | sql, prompt-template, validation, llama-index |
| Unknown SQL parser mode: {sql_parser_mode} | validation | error | sql, enum, retriever, llama-index |
| Unknown retriever mode: {retriever_mode} | validation | error | tree-index, enum, retriever, llama-index |
| Index was constructed without building trees, but retriever | validation | error | tree-index, config, retriever, llama-index |
| Delete not implemented for tree index. | exception | error | tree-index, delete, not-implemented, llama-index |
| Invalid number of children. | validation | error | tree-index, constructor, validation, llama-index |
| Invalid answer line: {answer_line}. Answer line must be of t | validation | warning | llm-output-parsing, choice-select, llama-index |
| Cannot initialize from a vector store that does not store te | exception | error | vector-store, storage, config, llama-index |
| Vector store integrations that store text in the vector stor | exception | error | vector-store, not-implemented, metadata, llama-index |
| extra_filters cannot be OR condition | validation | error | vector-store, metadata-filters, auto-retriever, llama-index |
| Failed to validate query spec. Error: {e}. Got JSON dict: {j | exception | error | auto-retriever, llm-output-parsing, pydantic, llama-index |
| Node ID {node_id} not found in index. | exception | error | vector-store, storage-consistency, retriever, llama-index |
| Node ID {node_id_str} not found in fetched nodes. | exception | error | vector-store, storage-consistency, docstore, llama-index |
| Vector store query result should return at least one of node | exception | error | vector-store, custom-integration, api-contract, llama-index |
| Component {component} is not a supported data sink component | exception | error | ingestion, vector-store, workflow, configuration |
| The enum value {self} is not compatible with component of ty | exception | error | ingestion, vector-store, workflow, type-mismatch |
| Component {component} is not a supported data source compone | exception | error | ingestion, readers, workflow, configuration |
| The enum value {self} is not compatible with component of ty | exception | error | ingestion, readers, workflow, type-mismatch |
| Invalid docstore strategy: {effective_strategy} | exception | error | ingestion, pipeline, docstore, configuration |
| Component {component} is not a supported transformation comp | exception | error | ingestion, transformations, workflow, configuration |
| The enum value {self} is not compatible with component of ty | exception | error | ingestion, transformations, workflow, type-mismatch |
| response must be of type AgentChatResponse or StreamingAgent | validation | error | instrumentation, events, agent, pydantic |
| Response generation timed out after {timeout} seconds | exception | error | streaming, timeout, langchain, llm |
| No prompt provided in positional or keyword arguments | exception | error | llm, callbacks, instrumentation, api-misuse |
| At least one message is required to construct the ChatML pro | exception | error | llm, prompt, chatml, validation |
| get_tool_calls_from_response is not supported by default. | exception | error | llm, function-calling, tools, not-implemented |
| Invalid | exception | error | llm, function-calling, tools, parallel-tool-calls |
| structured_predict expected a {output_cls.__name__} instance | exception | error | llm, structured-output, pydantic, parsing |
| astructured_predict expected a {output_cls.__name__} instanc | exception | error | llm, structured-output, pydantic, async |
| Output parser is not supported for streaming. | exception | error | llama-index, streaming, output-parser, not-implemented |
| LLM loading requires a class_name | exception | error | llama-index, serialization, deserialization, config |
| Invalid LLM name: {llm_name} | exception | error | llama-index, serialization, registry, integration |
| StructuredLLM expected a {self.output_cls.__name__} instance | exception | error | llama-index, structured-output, pydantic, type-error |
| stream_complete is not supported by default. | exception | error | llama-index, structured-output, streaming, not-implemented |
| StructuredLLM expected a {self.output_cls.__name__} instance | exception | error | llama-index, async, structured-output, pydantic, type-error |
| astream_complete is not supported by default. | exception | error | llama-index, async, structured-output, streaming, not-implemented |
| `llama-index-llms-openai` package not found, please run `pip | exception | error | llama-index, install, integration, openai, import-error |
| ****** Could not load OpenAI model. If you intended to use | exception | error | llama-index, openai, api-key, configuration, environment |
| llm must start with str 'local' or of type LLM or BaseLangua | exception | error | llama-index, configuration, llm-resolution, validation |
| `llama-index-llms-llama-cpp` package not found, please run ` | exception | error | llama-index, install, llama-cpp, local-model, import-error |
| `llama-index-llms-langchain` package not found, please run ` | exception | error | llama-index, langchain, install, integration, import-error |
| Malformed partial JSON encountered. | exception | error | llama-index, json, streaming, structured-output, parsing |
| Token limit must be set and greater than 0. | validation | error | llama-index, memory, chat-history, validation, configuration |
| Unexpected kwargs: {kwargs} | exception | error | llama-index, memory, validation, api-misuse, typo |
| Initial token count exceeds token limit | exception | error | llama-index, memory, token-limit, chat-history, validation |
| Token limit for full-text messages must be set and greater t | validation | error | llama-index, memory, summarization, validation, configuration |
| Unexpected keyword arguments: {kwargs} | exception | error | llama-index, memory, validation, api-misuse, typo |
| Initial token count exceeds token limit | exception | error | |
| Token limit must be set and greater than 0. | validation | error | |
| All memory blocks must have unique names. | validation | error | |
| Invalid message type: {type(message_or_blocks)} | exception | error | |
| Invalid content type received from memory block {memory_bloc | exception | error | |
| vector_store must be a BasePydanticVectorStore | validation | error | |
| vector_store must store text to be used as a retrieval memor | validation | error | |
| Unexpected kwargs: {kwargs} | exception | error | |
| Expected 'vector_index' to be an instance of VectorStoreInde | validation | error | |
| Unexpected kwargs: {kwargs} | exception | error | |
| Vector memory does not support get_all method, can only retr | exception | error | |
| bs4 is required to read HTML files. | exception | error | |
| JSON is invalid | exception | error | |
| Texts and metadata_strs must have the same length | exception | error | |
| Parser loading requires a class_name | exception | error | |
| Invalid parser name: {parser_name} | exception | error | |
| Unknown document type: {type(document)} | exception | error | |
| Expected PydanticResponse, got {type(response)} | exception | error | |
| pandas is required for this function. Please install it with | exception | error | |
| Depth cannot be a negative number! | exception | error | |
| There is no root nodes in given nodes! | exception | error | |
| Cannot specify both node_parser_ids and chunk_sizes. | exception | error | |
| Must specify node_parser_map if using node_parser_ids. | exception | error | |
| Level {level} is greater than number of text splitters ({len | exception | error | |
| You must install the `unstructured` and `lxml` package to us | exception | error | |
| You must install the `pandas` package to use this node parse | exception | error | |
| You must install the `lxml` package to use this node parser. | exception | error | |
| Please install tree_sitter_language_pack to use CodeSplitter | exception | error | |
| The installed version of tree-sitter-language-pack is not co | exception | error | |
| Could not parse code with language {self.language}. | exception | error | |
| {language} language is not supported yet! Available language | exception | error | |
| {spacy_model} model is not matching your language: {language | exception | error | |
| Spacy is not installed, please install it with `pip install | exception | error | |
| `llama-index-embeddings-openai` package not found, please ru | exception | error | |
| Got a larger chunk overlap ({chunk_overlap}) than chunk size | validation | error | |
| Metadata length ({metadata_len}) is longer than chunk size ( | validation | error | |
| Single token exceeded chunk size | validation | error | |
| Got a larger chunk overlap ({chunk_overlap}) than chunk size | validation | error | |
| Metadata length ({metadata_len}) is longer than chunk size ( | validation | error | chunking, tokenization, configuration, node-parser |
| Unable to load from persist dir. The object_node_mapping can | exception | error | persistence, object-index, pickle, deserialization |
| Objs is not pickleable | validation | error | persistence, pickle, object-index, serialization |
| Objs cannot be loaded. | validation | error | persistence, pickle, deserialization, object-index |
| FnNodeMapping does not support obj_node_mapping | exception | error | object-index, node-mapping, not-implemented, api-limitation |
| FnNodeMapping does not support persist method. | exception | error | persistence, object-index, not-implemented, api-limitation |
| Must provide sql_database | validation | error | sql, object-index, configuration, validation |
| Metadata must be set | validation | error | sql, node-mapping, metadata, validation |
| This object node mapping does not support persist method. | exception | error | sql, persistence, not-implemented, api-limitation |
| Object must be of type {BaseTool} | validation | error | tools, object-index, type-validation |
| This object node mapping does not support persist method. | exception | error | tools, persistence, not-implemented, object-index |
| Metadata must be set | validation | error | tools, node-mapping, metadata, validation |
| Object must be of type {QueryEngineTool} | validation | error | tools, query-engine, type-validation, object-index |
| Tool name must be set | validation | error | tools, query-engine, validation, metadata |
| Got invalid JSON object. Error: {e_json} {e_yaml}. Got JSON | exception | error | llm, output-parsing, json, yaml, routing |
| Please pip install PyYAML. | exception | error | dependencies, environment, yaml, output-parsing |
| Failed to convert output to JSON: {output!r} | validation | error | llm, output-parsing, json, schema, routing |
| Got invalid JSON object. Error: {e_json} {e_yaml}. Got JSON | exception | error | |
| Please pip install PyYAML. | exception | error | |
| Could not extract json string from output: {text} | validation | error | |
| Playground must be initialized with a nonempty list of Docum | validation | error | |
| Playground must have a non-empty list of indices. | validation | error | |
| Every index in Playground should be an instance of BaseIndex | validation | error | |
| Playground must have a nonzero number of retriever_modes.Ini | validation | error | |
| pandas is required for this function. Please install it with | exception | error | |
| Query bundle must be provided. | validation | error | |
| Spacy is not installed, please install it with `pip install | exception | error | |
| Invalid mode: {v} | validation | error | |
| Invalid mode: {self.mode} | exception | error | |
| Invalid prediction: {raw_pred} | exception | error | |
| Missing query bundle. | exception | error | |
| Invalid mode: {mode} | exception | error | |
| pandas is required for this function. Please install it with | exception | error | |
| Missing query bundle in extra info. | exception | error | |
| metadata is None | exception | error | |
| `llama-index-embeddings-openai` package not found, please ru | exception | error | |
| Optimizer returned zero sentences. | exception | error | |
| Query bundle must be provided. | exception | error | |
| Cannot specify both query_str and query_bundle | exception | error | |
| Cannot import sentence-transformers or torch package, | exception | error | |
| Missing query bundle in extra info. | exception | error | |
| Query bundle must be provided. | exception | error | |
| Structured prediction failed for nodes {idx} - {idx + self.c | exception | error | |
| Cannot specify both query_str and query_bundle | exception | error | |
| Model name {llm.metadata.model_name} does not support functi | exception | error | |
| Must provide either prompt or prompt_template_str. | exception | error | |
| LLM did not return any tool calls for structured output. The | exception | error | |
| Structured output extraction failed: the LLM's tool call cou | exception | error | |
| Structured output extraction failed: expected a {self._outpu | exception | error | |
| stream_call is only supported for LLMs. | exception | error | |
| Must provide either prompt or prompt_template_str. | exception | error | validation, prompt, configuration, program |
| Output parser must be PydanticOutputParser. | exception | error | validation, output-parser, pydantic, program |
| Output parser returned {type(output)} but expected {self._ou | exception | error | runtime, output-parser, type-mismatch, program |
| `llama-index-llms-openai` package cannot be found. Please in | exception | error | dependency, import, optional-package, multimodal |
| Must provide either prompt or prompt_template_str. | exception | error | validation, prompt, configuration, multimodal |
| Must provide either output_cls or output_parser. | exception | error | validation, output-parser, pydantic, multimodal |
| This mode requires the `llama-index-program-lmformatenforcer | exception | error | dependency, import, optional-package, program-mode |
| Unsupported pydantic program mode: {pydantic_program_mode} | exception | error | validation, enum, program-mode, version-skew |
| LLM is required to get tool calls | exception | error | runtime, tool-calls, function-calling, validation |
| Must install `llama_index[langchain]` to use LangchainPrompt | exception | error | dependency, import, langchain, prompt |
| Must provide either template or selector. | exception | error | validation, langchain, prompt, configuration |
| Must provide a LangChainLLM. | exception | error | langchain, llm-wrapper, prompt, runtime |
| Must specify root schema for nested object | exception | error | guidance, json-schema, pydantic, nested-models |
| Key should not be None | exception | error | guidance, json-schema, arrays, pydantic |
| key should not be None | exception | error | llama-index, guidance, pydantic, json-schema, structured-output |
| Unknown schema type {schema_type} | exception | error | llama-index, guidance, pydantic, json-schema, union-types, pydantic-v2 |
| Failed to parse pydantic object from guidance program. Proba | exception | error | llama-index, guidance, output-parsing, pydantic, json, llm-output |
| Prompt key {key} cannot contain ':'. | exception | error | llama-index, prompts, prompt-mixin, naming, validation |
| Module {module_name} not found. | exception | error | llama-index, prompts, prompt-mixin, update-prompts, naming |
| Unsupported content block type: {bank_block.type} | exception | error | llama-index, rich, content-blocks, version-skew, multimodal |
| Unsupported message content type: {type(bank_message.content | exception | error | llama-index, rich, content-type, multimodal, input-validation |
| This query engine does not support _query. | exception | error | llama-index, query-engine, custom-query-engine, api-misuse, not-implemented |
| This query engine does not support _aquery. | exception | error | llama-index, query-engine, async, custom-query-engine, api-misuse |
| Expected Response object, got {type(answer_obj)} instead. | exception | error | llama-index, flare, query-engine, streaming, active-retrieval |
| This query engine does not support retrieve, use query direc | exception | error | llama-index, flare, retriever, query-engine, not-implemented |
| JSONalyzeQueryEngine has been moved to `llama-index-experime | exception | error | llama-index, deprecation, migration, jsonalyze, query-engine, security |
| `llama-index-llms-openai` package cannot be found. Please in | exception | error | llama-index, import-error, openai, optional-dependency, multi-modal |
| Response must be provided to stop function. | exception | error | llama-index, multi-step, stop-function, api-contract, misleading-message |
| Must specify num_steps if early_stopping is False. | exception | error | llama-index, multi-step, query-engine, configuration, validation |
| PandasInstructionParser has been moved to `llama-index-exper | exception | error | llama-index, deprecation, migration, pandas, code-execution, security |
| PandasQueryEngine has been moved to `llama-index-experimenta | exception | error | pandas, deprecation, install, code-execution |
| No source nodes passed evaluation. | exception | error | retrieval, evaluation, retry, relevancy |
| AsyncStreamingResponse not supported in sync code. | exception | error | async, streaming, router, sync-mismatch |
| Failed to select query engine | exception | error | router, selector, llm-output, index-error |
| Node must have a tool_name in metadata. | exception | error | router, metadata, deprecated, nodes |
| Retrieved more than one node. | exception | error | router, retriever, top-k, deprecated |
| sql_query_tool.query_engine must be an instance of BaseSQLTa | exception | error | sql, join, type-validation, constructor |
| Invalid result.ind: {result.ind} | exception | error | sql, join, selector, llm-output |
| sql_query_tool.query_engine must be an instance of BaseSQLTa | exception | error | sql, vector, type-validation, constructor |
| vector_query_tool.query_engine must be an instance of Retrie | exception | error | sql, vector, type-validation, retriever |
| vector_query_tool.query_engine.retriever must be an instance | exception | error | sql, vector, auto-retriever, type-validation |
| `llama-index-question-gen-openai` package cannot be found. P | exception | error | install, optional-dependency, sub-question, import |
| Prompt should have output parser. | exception | error | prompt, output-parser, sub-question, constructor |
| No valid JSON found in output: {output} | exception | error | json, parsing, llm-output, sub-question |
| At least one of requests_per_minute or tokens_per_minute mus | validation | error | rate-limit, config, validation, constructor |
| {self.__class__.__name__} does not provide lazy_load_data me | exception | error | reader, not-implemented, custom-reader, abstractmethod |
| {self.__class__.__name__} does not provide get_permission_in | exception | error | reader, not-implemented, permissions, optional-hook |
| Must provide either `input_dir` or `input_files`. | exception | error | reader, filesystem, config, constructor |
| File {path} does not exist. | exception | error | filesystem, paths, validation, reader |
| Directory {input_dir} does not exist. | exception | error | filesystem, path-validation, directory-reader, initialization |
| No files found in {input_dir}. | exception | error | filesystem, filtering, directory-reader, empty-input |
| Error loading file | exception | error | file-parsing, error-handling, directory-reader, chained-exception |
| Must specify `class_name` in reader data. | exception | error | serialization, deserialization, readers, config |
| Reader class name {class_name} not found. | exception | error | serialization, registry, readers, versioning |
| A retrieved image must have image_path or image_url specifie | exception | error | multimodal, images, notebook, retrieval |
| Unable to stream in Accumulate response mode | exception | error | response-synthesizer, streaming, configuration, async |
| Multimodal synthesis requires a chat LLM. | exception | error | multimodal, llm, configuration, initialization |
| Response must be a string or a generator. Found {type(respon | exception | error | llm, custom-llm, type-error, response-synthesizer |
| Unknown mode: {response_mode} | exception | error | response-synthesizer, configuration, enum, factory |
| Program factory not supported without structured answer filt | exception | error | response-synthesizer, refine, configuration, initialization |
| Invalid fusion mode: {self.mode} | exception | error | retriever, fusion, enum, configuration |
| Root id {root_id} not in retriever_dict, it must be a retrie | exception | error | retriever, recursive-retrieval, initialization, configuration |
| Retriever and query engine ids must not overlap. | exception | error | retriever, recursive-retrieval, initialization, naming |
| Query id {query_id} not found in either `retriever_dict` or | exception | error | retriever, recursive-retrieval, index-nodes, lookup |
| Must be a retriever or query engine. | exception | error | retriever, recursive-retrieval, type-error, type-guard |
| Failed to select retriever | exception | error | retriever, router, selector, llm-parsing |
| Source object must be a single RelatedNodeInfo object | exception | error | schema, nodes, relationships, data-validation |
| Previous object must be a single RelatedNodeInfo object | exception | error | schema, nodes, relationships, data-validation |
| Next object must be a single RelatedNodeInfo object | exception | error | schema, nodes, relationships, data-validation |
| Parent object must be a single RelatedNodeInfo object | exception | error | schema, nodes, relationships, hierarchy |
| Child objects must be a list of RelatedNodeInfo objects. | exception | error | schema, nodes, relationships, hierarchy |
| embedding not set. | exception | error | schema, embeddings, nodes |
| No image found in node. | exception | error | schema, multimodal, images, nodes |
| IndexNode obj is not serializable: {obj} | exception | error | schema, serialization, index-node, recursive-retrieval |
| Score not set. | exception | error | schema, retrieval, scoring |
| Node must be a TextNode to get text. | exception | error | schema, nodes, multimodal, content |
| The specified file path is not an accessible image | exception | error | schema, multimodal, images, file-io, validation |
| The specified URL is not an accessible image | exception | error | schema, multimodal, images, network, validation |
| No image found in the chat message! | exception | error | schema, multimodal, chat, images |
| Prompt should have output parser. | exception | error | selector, llm, prompts, config |
| Unsupported output type: {type} | exception | error | selector, pydantic, structured-output |
| ServiceContext is deprecated. Use llama_index.settings.Setti | exception | critical | deprecation, migration, settings, version-upgrade |
| This class is deprecated. Use any LLM class directly. | exception | error | deprecation, llm, llm-predictor, migration, llama-index |
| Configured node parser does not have chunk size. | exception | error | settings, node-parser, chunking, configuration, llama-index |
| Configured node parser does not have chunk overlap. | exception | error | settings, node-parser, chunking, configuration, llama-index |
| ChatStore loading requires a class_name | exception | error | chat-store, serialization, persistence, validation, llama-index |
| Invalid ChatStore name: {chat_store_name} | exception | error | chat-store, serialization, registry, persistence, llama-index |
| Failed to serialize additional_kwargs value: {value} | exception | error | chat-store, serialization, chat-message, json, llama-index |
| No async database URI or engine provided, cannot initialize | exception | error | chat-store, sql, async, database, configuration, llama-index |
| node_id {node_id} already exists. Set allow_update to True t | exception | error | docstore, ingestion, duplicate, idempotency, llama-index |
| doc_id {doc_id} not found. | exception | error | docstore, not-found, lookup, llama-index |
| ref_doc_id {ref_doc_id} not found. | exception | error | docstore, delete, ref-doc, not-found, llama-index |
| Node {node_id} not found | exception | error | docstore, not-found, node, custom-backend, llama-index |
| Document {node_id} is not a Node. | exception | error | |
| Unknown doc type: {doc_type} | exception | error | |
| Batching not supported by this key-value store. | exception | error | |
| Use subclasses of MutableMappingKVStore (such as SimpleKVSto | exception | error | |
| to_dict only available when using simple doc/index/vector st | exception | error | |
| fn or async_fn must be provided. | validation | error | |
| metadata must be provided | validation | error | |
| Real function is not set! | exception | error | |
| Context is required for this tool | validation | error | |
| Missing query_str in kwargs with parameter name: {self._quer | validation | error | |
| Cannot call query engine without specifying `input` paramete | validation | error | |
| Query plan should have exactly one root node. | validation | error | |
| Cannot call query engine without inputs | validation | error | |
| `as_langchain_tool` not implemented here. | exception | error | langchain, retriever, tool-adapter, not-implemented |
| spec_functions must be of type: List[Union[str, Tuple[str, s | validation | error | tool-spec, validation, python, value-error |
| Tool name cannot be None | validation | error | tool-metadata, load-and-search, validation, value-error |
| fn_schema is None. | validation | error | tool-metadata, schema, pydantic, value-error |
| name is None. | validation | error | tool-metadata, name-required, value-error |
| Tool description exceeds maximum length of 1024 characters. | validation | error | openai, tool-metadata, length-limit, value-error |
| Cannot provide both content and blocks. | validation | error | tool-output, content-blocks, validation, value-error |
| Invalid additional field info: {field_info}. Must be a tuple | validation | error | pydantic, schema-model, validation, value-error |
| stream_call is not supported by default. | exception | error | pydantic-program, streaming, not-implemented |
| astream_call is not supported by default. | exception | error | pydantic-program, streaming, async, not-implemented |
| Please run `pip install boto3 botocore` to use AWS services. | exception | error | aws, boto3, import-error, dependencies |
| Please verify the provided credentials. | validation | error | aws, credentials, boto3, value-error |
| Cannot specify both include_tables and ignore_tables | validation | error | sql, sqlalchemy, table-scoping, value-error |
| include_tables {missing_tables} not found in database | validation | error | sql, schema-validation, text-to-sql, value-error |
| ignore_tables {missing_tables} not found in database | validation | error | sql, schema-validation, text-to-sql, value-error |
| sample_rows_in_table_info must be an integer | validation | error | sql, type-error, configuration |
| table_info must be a dictionary with table names as keys and | validation | error | sql, type-error, configuration, json |
| Statement {command!r} is invalid SQL.\nError: {exc.orig} | exception | error | sql, text-to-sql, sqlalchemy, llm-output-validation |
| `tiktoken` package not found, please run `pip install tiktok | exception | error | tokenizer, tiktoken, import-error, dependencies |
| At least one error to retry needs to be provided | validation | error | retry, llm, configuration, value-error |
| `transformers` package not found, please run `pip install tr | exception | error | dependencies, optional-import, tokenizer, python |
| Invalid data URL format: missing comma separator | validation | error | data-url, validation, binary-data, python |
| No valid source provided to resolve binary data! | validation | error | validation, binary-data, caller-bug, python |
| SimpleVectorStore does not store nodes directly. | exception | error | vector-store, not-implemented, simple-vector-store, python |
| Cannot filter stores that were persisted without metadata. P | validation | error | vector-store, metadata-filters, persistence, version-migration, python |
| Invalid query mode: {query.mode} | validation | error | vector-store, query-mode, not-supported, python |
| No existing {__name__} found at {persist_path}, skipping loa | exception | error | persistence, file-not-found, vector-store, python |
| Vector Store only supports exact match filters. Please use E | exception | error | metadata-filters, legacy-api, vector-store, python |
| get_nodes not implemented | exception | error | vector-store, not-implemented, base-class, python |
| delete_nodes not implemented | exception | error | vector-store, not-implemented, deletion, python |
| clear not implemented | exception | error | vector-store, not-implemented, lifecycle, python |
| Metadata key must be str! | exception | error | metadata, validation, ingestion, python |
| Value for metadata {key} must be one of (str, int, float, No | exception | error | metadata, validation, ingestion, type-error, python |
| Node content not found in metadata dict. | exception | error | metadata, deserialization, vector-store, persistence, python |
| Both metadata_value and value should be strings to be used w | exception | error | metadata-filters, type-error, text-match, python |
| Both metadata_value and value should be strings to be used w | exception | error | metadata-filters, type-error, case-insensitive, python |
| Invalid operator: {operator} | exception | error | metadata-filters, enum, operator, version-skew, python |
| Nested MetadataFilters are not supported. | exception | error | metadata-filters, nested-filters, not-supported, python |
| Invalid filter condition: {filter_condition} | exception | error | metadata-filters, enum, filter-condition, python |
| draw_most_recent_execution function is deprecated and no lon | exception | error | deprecation, versioning, workflow, visualization, python |
| No runs found in workflow | exception | error | workflow, visualization, state-validation, python |
| `treelib` package is missing. Please install it by using `pi | exception | error | missing-dependency, instrumentation, observability, python |
| Cannot sign without private key | exception | error | crypto, signing, identity, agent-mesh, validation |
| Query requires invoker identity but none provided | exception | error | permissions, identity, query-engine, agent-mesh, authorization |
| Query rejected: {verification.reason} | exception | error | permissions, trust-verification, query-engine, agent-mesh, audit |