versionhq 1.1.13.0__tar.gz → 1.1.13.1__tar.gz

{versionhq-1.1.13.0 → versionhq-1.1.13.1}/.github/workflows/run_tests.yml

@@ -37,7 +37,7 @@ jobs:
           uv venv --python 3.12.8
           source .venv/bin/activate
           uv lock --upgrade
-          uv sync --all-extras
+          uv sync --all-extras --no-extra pygraphviz
 
       - name: Run tests
         run: uv run pytest tests -vv --cache-clear

{versionhq-1.1.13.0 → versionhq-1.1.13.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: versionhq
-Version: 1.1.13.0
+Version: 1.1.13.1
 Summary: An agentic orchestration framework for building agent networks that handle task automation.
 Author-email: Kuriko Iwai <kuriko@versi0n.io>
 License: MIT License
@@ -74,6 +74,12 @@ Provides-Extra: pandas
 Requires-Dist: pandas>=2.2.3; extra == "pandas"
 Provides-Extra: numpy
 Requires-Dist: numpy>=1.26.4; extra == "numpy"
+Provides-Extra: pygraphviz
+Requires-Dist: pygraphviz>=1.14; extra == "pygraphviz"
+Provides-Extra: networkx
+Requires-Dist: networkx>=3.4.2; extra == "networkx"
+Provides-Extra: matplotlib
+Requires-Dist: matplotlib>=3.10.0; extra == "matplotlib"
 
 # Overview
 
@@ -103,15 +109,21 @@ A Python framework for agentic orchestration that handles complex task automatio
 
 - [Key Features](#key-features)
   - [Agent formation](#agent-formation)
+  - [Graph Theory Concept](#graph-theory-concept)
+  - [Agent optimization](#agent-optimization)
 - [Quick Start](#quick-start)
   - [Package installation](#package-installation)
   - [Forming a agent network](#forming-a-agent-network)
-  - [Customizing AI agents](#customizing-ai-agents)
+  - [Executing tasks](#executing-tasks)
   - [Supervising](#supervising)
 - [Technologies Used](#technologies-used)
 - [Project Structure](#project-structure)
-- [Setting Up](#setting-up)
+- [Setting Up a Project](#setting-up-a-project)
+  - [1. Installing package manager](#1-installing-package-manager)
+  - [2. Installing dependencies](#2-installing-dependencies)
+  - [3. Adding env secrets to .env file](#3-adding-env-secrets-to-env-file)
 - [Contributing](#contributing)
+  - [Steps](#steps)
   - [Package Management with uv](#package-management-with-uv)
   - [Pre-Commit Hooks](#pre-commit-hooks)
   - [Documentation](#documentation)
@@ -144,6 +156,73 @@ You can specify a desired formation or allow the agents to determine it autonomo
 
 <hr />
 
+### Graph Theory Concept
+
+To completely automate task workflows, agents will build a `task-oriented network` by generating `nodes` that represent tasks and connecting them with dependency-defining `edges`.
+
+Each node is triggered by specific events and executed by an assigned agent once all dependencies are met.
+
+While the network automatically reconfigures itself, you retain the ability to direct the agents using `should_reform` variable.
+
+
+The following code snippet demonstrates the `TaskGraph` and its visualization, saving the diagram to the `uploads` directory.
+
+```python
+import versionhq as vhq
+
+task_graph = vhq.TaskGraph(directed=False, should_reform=True) # triggering auto formation
+
+task_a = vhq.Task(description="Research Topic")
+task_b = vhq.Task(description="Outline Post")
+task_c = vhq.Task(description="Write First Draft")
+
+node_a = task_graph.add_task(task=task_a)
+node_b = task_graph.add_task(task=task_b)
+node_c = task_graph.add_task(task=task_c)
+
+task_graph.add_dependency(
+   node_a.identifier, node_b.identifier,
+   type=vhq.DependencyType.FINISH_TO_START, weight=5, description="B depends on A"
+)
+task_graph.add_dependency(
+   node_a.identifier, node_c.identifier,
+   type=vhq.DependencyType.FINISH_TO_FINISH, lag=1, required=False, weight=3
+)
+
+task_graph.visualize()
+```
+
+<hr />
+
+### Agent optimization
+
+Agents are model-agnostic and can handle multiple tasks, leveraging their own and their peers' knowledge sources, memories, and tools.
+
+Agents are optimized during network formation, but customization is possible before or after.
+
+The following code snippet demonstrates agent customization:
+
+```python
+import versionhq as vhq
+
+agent = vhq.Agent(
+   role="Marketing Analyst",
+   goal="my amazing goal"
+) # assuming this agent was created during the network formation
+
+# update the agent
+agent.update(
+   llm="gemini-2.0", # updating LLM (Valid llm_config will be inherited to the new LLM.)
+   tools=[vhq.Tool(func=lambda x: x)], # adding tools
+   max_rpm=3,
+   knowledge_sources=["<KC1>", "<KS2>"], # adding knowledge sources. This will trigger the storage creation.
+   memory_config={"user_id": "0001"}, # adding memories
+   dummy="I am dummy" # <- invalid field will be automatically ignored
+)
+```
+
+<hr />
+
 ## Quick Start
 
 ### Package installation
@@ -169,11 +248,11 @@ You can specify a desired formation or allow the agents to determine it autonomo
    This will form a network with multiple agents on `Formation` and return `TaskOutput` object with output in JSON, plane text, Pydantic model format with evaluation.
 
 
-### Customizing AI agents
+### Executing tasks
 
-You can simply build an agent using `Agent` model.
+You can simply build an agent using `Agent` model and execute the task using `Task` class.
 
-By default, the agent prioritize JSON serializable outputs over plane texts.
+By default, agents prioritize JSON over plane text outputs.
 
 
    ```python
@@ -253,21 +332,29 @@ Tasks can be delegated to a team manager, peers in the team, or completely new a
 
 ## Technologies Used
 
+**Graph Theory (Analysis and Visualization)**
+
+* [NetworkX](https://networkx.org/documentation/stable/reference/introduction.html): A Python package to analyze, create, and manipulate complex graph networks.
+* [Matplotlib](https://matplotlib.org/stable/index.html): Visualization library
+* [Graphviz](https://graphviz.org/about/): Graph visualization software
+
+
 **Schema, Data Validation**
 
 * [Pydantic](https://docs.pydantic.dev/latest/): Data validation and serialization library for Python.
 * [Upstage](https://console.upstage.ai/docs/getting-started/overview): Document processer for ML tasks. (Use `Document Parser API` to extract data from documents)
 * [Docling](https://ds4sd.github.io/docling/): Document parsing
 
+
 **Storage**
 
 * [mem0ai](https://docs.mem0.ai/quickstart#install-package): Agents' memory storage and management.
 * [Chroma DB](https://docs.trychroma.com/): Vector database for storing and querying usage data.
 * [SQLite](https://www.sqlite.org/docs.html): C-language library to implements a small SQL database engine.
 
-**LLM-curation**
+**LLM Integration**
 
-* [LiteLLM](https://docs.litellm.ai/docs/providers): Curation platform to access LLMs
+* [LiteLLM](https://docs.litellm.ai/docs/providers): Integration to diverse LLMs
 
 **Tools**
 
@@ -304,30 +391,30 @@ src/
 │     └── llm/
 │     └── ...
 │
-└── uploads/                  # Local directory that stores uloaded files
+└── uploads/  [.gitignore]    # Local directory to store uploaded files such as graphviz diagrams generatd by `Network` class
 
 ```
 
 <hr />
 
-## Setting Up
+## Setting Up a Project
 
-1. Install `uv` package manager:
+### 1. Installing package manager
 
-      For MacOS:
+   For MacOS:
 
-      ```
-      brew install uv
-      ```
+   ```
+   brew install uv
+   ```
 
-      For Ubuntu/Debian:
+   For Ubuntu/Debian:
+   ```
+   sudo apt-get install uv
+   ```
 
-      ```
-      sudo apt-get install uv
-      ```
 
+### 2. Installing dependencies
 
-2. Install dependencies:
    ```
    uv venv
    source .venv/bin/activate
@@ -335,29 +422,51 @@ src/
    uv sync --all-extras
    ```
 
-* In case of AssertionError/module mismatch, run Python version control using `.pyenv`
-   ```
-   pyenv install 3.12.8
-   pyenv global 3.12.8  (optional: `pyenv global system` to get back to the system default ver.)
-   uv python pin 3.12.8
-   echo 3.12.8 >> .python-version
-   ```
+   - AssertionError/module mismatch errors: Set up default Python version using `.pyenv`
+      ```
+      pyenv install 3.12.8
+      pyenv global 3.12.8  (optional: `pyenv global system` to get back to the system default ver.)
+      uv python pin 3.12.8
+      echo 3.12.8 >> .python-version
+      ```
 
+   - `pygraphviz` related errors: Run the following commands:
+      ```
+      brew install graphviz
+      uv pip install --config-settings="--global-option=build_ext" \
+      --config-settings="--global-option=-I$(brew --prefix graphviz)/include/" \
+      --config-settings="--global-option=-L$(brew --prefix graphviz)/lib/" \
+      pygraphviz
+      ```
+
+      * If the error continues, skip pygraphviz installation by:
+      ```
+      uv sync --all-extras --no-extra pygraphviz
+      ```
+
+   - `torch`/`Docling` related errors: Set up default Python version either `3.11.x` or `3.12.x` (same as AssertionError)
+
+### 3. Adding env secrets to .env file
 
-3. Add secrets to `.env` file in the project root:
+Create `.env` file in the project root and add following:
 
    ```
-   LITELLM_API_KEY=your-litellm-api-key
    OPENAI_API_KEY=your-openai-api-key
+   GEMINI_API_KEY=your-gemini-api-key
+   LITELLM_API_KEY=your-litellm-api-key
    COMPOSIO_API_KEY=your-composio-api-key
    COMPOSIO_CLI_KEY=your-composio-cli-key
-   [LLM_INTERFACE_PROVIDER_OF_YOUR_CHOICE]_API_KEY=your-api-key
+   [OTHER_LLM_INTERFACE_PROVIDER_OF_YOUR_CHOICE]_API_KEY=your-api-key
    ```
 
 <hr />
 
 ## Contributing
 
+`versionhq` is a open source project.
+
+### Steps
+
 1. Create your feature branch (`git checkout -b feature/your-amazing-feature`)
 
 2. Create amazing features
@@ -365,6 +474,7 @@ src/
 3. Add a test funcition to the `tests` directory and run **pytest**.
 
    - Add secret values defined in `.github/workflows/run_test.yml` to your Github `repository secrets` located at settings > secrets & variables > Actions.
+
    - Run a following command:
       ```
       uv run pytest tests -vv --cache-clear
@@ -376,6 +486,8 @@ src/
 
    * Test functions within the files must begin with `test_`.
 
+   * Pytest priorities are `1. playground demo > 2. docs use cases > 3. other features`
+
 
 4. Update `docs` accordingly.
 
@@ -418,7 +530,7 @@ src/
 
 Pre-commit hooks help maintain code quality by running checks for formatting, linting, and other issues before each commit.
 
-* To skip pre-commit hooks (NOT RECOMMENDED)
+* To skip pre-commit hooks
    ```
    git commit --no-verify -m "your-commit-message"
    ```
@@ -427,7 +539,7 @@ Pre-commit hooks help maintain code quality by running checks for formatting, li
 
 * To edit the documentation, see `docs` repository and edit the respective component.
 
-* We use `mkdocs` to update the docs. You can run the doc locally at http://127.0.0.1:8000/:
+* We use `mkdocs` to update the docs. You can run the docs locally at http://127.0.0.1:8000/.
 
    ```
    uv run python3 -m mkdocs serve --clean

{versionhq-1.1.13.0 → versionhq-1.1.13.1}/README.md

@@ -26,15 +26,21 @@ A Python framework for agentic orchestration that handles complex task automatio
 
 - [Key Features](#key-features)
   - [Agent formation](#agent-formation)
+  - [Graph Theory Concept](#graph-theory-concept)
+  - [Agent optimization](#agent-optimization)
 - [Quick Start](#quick-start)
   - [Package installation](#package-installation)
   - [Forming a agent network](#forming-a-agent-network)
-  - [Customizing AI agents](#customizing-ai-agents)
+  - [Executing tasks](#executing-tasks)
   - [Supervising](#supervising)
 - [Technologies Used](#technologies-used)
 - [Project Structure](#project-structure)
-- [Setting Up](#setting-up)
+- [Setting Up a Project](#setting-up-a-project)
+  - [1. Installing package manager](#1-installing-package-manager)
+  - [2. Installing dependencies](#2-installing-dependencies)
+  - [3. Adding env secrets to .env file](#3-adding-env-secrets-to-env-file)
 - [Contributing](#contributing)
+  - [Steps](#steps)
   - [Package Management with uv](#package-management-with-uv)
   - [Pre-Commit Hooks](#pre-commit-hooks)
   - [Documentation](#documentation)
@@ -67,6 +73,73 @@ You can specify a desired formation or allow the agents to determine it autonomo
 
 <hr />
 
+### Graph Theory Concept
+
+To completely automate task workflows, agents will build a `task-oriented network` by generating `nodes` that represent tasks and connecting them with dependency-defining `edges`.
+
+Each node is triggered by specific events and executed by an assigned agent once all dependencies are met.
+
+While the network automatically reconfigures itself, you retain the ability to direct the agents using `should_reform` variable.
+
+
+The following code snippet demonstrates the `TaskGraph` and its visualization, saving the diagram to the `uploads` directory.
+
+```python
+import versionhq as vhq
+
+task_graph = vhq.TaskGraph(directed=False, should_reform=True) # triggering auto formation
+
+task_a = vhq.Task(description="Research Topic")
+task_b = vhq.Task(description="Outline Post")
+task_c = vhq.Task(description="Write First Draft")
+
+node_a = task_graph.add_task(task=task_a)
+node_b = task_graph.add_task(task=task_b)
+node_c = task_graph.add_task(task=task_c)
+
+task_graph.add_dependency(
+   node_a.identifier, node_b.identifier,
+   type=vhq.DependencyType.FINISH_TO_START, weight=5, description="B depends on A"
+)
+task_graph.add_dependency(
+   node_a.identifier, node_c.identifier,
+   type=vhq.DependencyType.FINISH_TO_FINISH, lag=1, required=False, weight=3
+)
+
+task_graph.visualize()
+```
+
+<hr />
+
+### Agent optimization
+
+Agents are model-agnostic and can handle multiple tasks, leveraging their own and their peers' knowledge sources, memories, and tools.
+
+Agents are optimized during network formation, but customization is possible before or after.
+
+The following code snippet demonstrates agent customization:
+
+```python
+import versionhq as vhq
+
+agent = vhq.Agent(
+   role="Marketing Analyst",
+   goal="my amazing goal"
+) # assuming this agent was created during the network formation
+
+# update the agent
+agent.update(
+   llm="gemini-2.0", # updating LLM (Valid llm_config will be inherited to the new LLM.)
+   tools=[vhq.Tool(func=lambda x: x)], # adding tools
+   max_rpm=3,
+   knowledge_sources=["<KC1>", "<KS2>"], # adding knowledge sources. This will trigger the storage creation.
+   memory_config={"user_id": "0001"}, # adding memories
+   dummy="I am dummy" # <- invalid field will be automatically ignored
+)
+```
+
+<hr />
+
 ## Quick Start
 
 ### Package installation
@@ -92,11 +165,11 @@ You can specify a desired formation or allow the agents to determine it autonomo
    This will form a network with multiple agents on `Formation` and return `TaskOutput` object with output in JSON, plane text, Pydantic model format with evaluation.
 
 
-### Customizing AI agents
+### Executing tasks
 
-You can simply build an agent using `Agent` model.
+You can simply build an agent using `Agent` model and execute the task using `Task` class.
 
-By default, the agent prioritize JSON serializable outputs over plane texts.
+By default, agents prioritize JSON over plane text outputs.
 
 
    ```python
@@ -176,21 +249,29 @@ Tasks can be delegated to a team manager, peers in the team, or completely new a
 
 ## Technologies Used
 
+**Graph Theory (Analysis and Visualization)**
+
+* [NetworkX](https://networkx.org/documentation/stable/reference/introduction.html): A Python package to analyze, create, and manipulate complex graph networks.
+* [Matplotlib](https://matplotlib.org/stable/index.html): Visualization library
+* [Graphviz](https://graphviz.org/about/): Graph visualization software
+
+
 **Schema, Data Validation**
 
 * [Pydantic](https://docs.pydantic.dev/latest/): Data validation and serialization library for Python.
 * [Upstage](https://console.upstage.ai/docs/getting-started/overview): Document processer for ML tasks. (Use `Document Parser API` to extract data from documents)
 * [Docling](https://ds4sd.github.io/docling/): Document parsing
 
+
 **Storage**
 
 * [mem0ai](https://docs.mem0.ai/quickstart#install-package): Agents' memory storage and management.
 * [Chroma DB](https://docs.trychroma.com/): Vector database for storing and querying usage data.
 * [SQLite](https://www.sqlite.org/docs.html): C-language library to implements a small SQL database engine.
 
-**LLM-curation**
+**LLM Integration**
 
-* [LiteLLM](https://docs.litellm.ai/docs/providers): Curation platform to access LLMs
+* [LiteLLM](https://docs.litellm.ai/docs/providers): Integration to diverse LLMs
 
 **Tools**
 
@@ -227,30 +308,30 @@ src/
 │     └── llm/
 │     └── ...
 │
-└── uploads/                  # Local directory that stores uloaded files
+└── uploads/  [.gitignore]    # Local directory to store uploaded files such as graphviz diagrams generatd by `Network` class
 
 ```
 
 <hr />
 
-## Setting Up
+## Setting Up a Project
 
-1. Install `uv` package manager:
+### 1. Installing package manager
 
-      For MacOS:
+   For MacOS:
 
-      ```
-      brew install uv
-      ```
+   ```
+   brew install uv
+   ```
 
-      For Ubuntu/Debian:
+   For Ubuntu/Debian:
+   ```
+   sudo apt-get install uv
+   ```
 
-      ```
-      sudo apt-get install uv
-      ```
 
+### 2. Installing dependencies
 
-2. Install dependencies:
    ```
    uv venv
    source .venv/bin/activate
@@ -258,29 +339,51 @@ src/
    uv sync --all-extras
    ```
 
-* In case of AssertionError/module mismatch, run Python version control using `.pyenv`
-   ```
-   pyenv install 3.12.8
-   pyenv global 3.12.8  (optional: `pyenv global system` to get back to the system default ver.)
-   uv python pin 3.12.8
-   echo 3.12.8 >> .python-version
-   ```
+   - AssertionError/module mismatch errors: Set up default Python version using `.pyenv`
+      ```
+      pyenv install 3.12.8
+      pyenv global 3.12.8  (optional: `pyenv global system` to get back to the system default ver.)
+      uv python pin 3.12.8
+      echo 3.12.8 >> .python-version
+      ```
 
+   - `pygraphviz` related errors: Run the following commands:
+      ```
+      brew install graphviz
+      uv pip install --config-settings="--global-option=build_ext" \
+      --config-settings="--global-option=-I$(brew --prefix graphviz)/include/" \
+      --config-settings="--global-option=-L$(brew --prefix graphviz)/lib/" \
+      pygraphviz
+      ```
+
+      * If the error continues, skip pygraphviz installation by:
+      ```
+      uv sync --all-extras --no-extra pygraphviz
+      ```
+
+   - `torch`/`Docling` related errors: Set up default Python version either `3.11.x` or `3.12.x` (same as AssertionError)
+
+### 3. Adding env secrets to .env file
 
-3. Add secrets to `.env` file in the project root:
+Create `.env` file in the project root and add following:
 
    ```
-   LITELLM_API_KEY=your-litellm-api-key
    OPENAI_API_KEY=your-openai-api-key
+   GEMINI_API_KEY=your-gemini-api-key
+   LITELLM_API_KEY=your-litellm-api-key
    COMPOSIO_API_KEY=your-composio-api-key
    COMPOSIO_CLI_KEY=your-composio-cli-key
-   [LLM_INTERFACE_PROVIDER_OF_YOUR_CHOICE]_API_KEY=your-api-key
+   [OTHER_LLM_INTERFACE_PROVIDER_OF_YOUR_CHOICE]_API_KEY=your-api-key
    ```
 
 <hr />
 
 ## Contributing
 
+`versionhq` is a open source project.
+
+### Steps
+
 1. Create your feature branch (`git checkout -b feature/your-amazing-feature`)
 
 2. Create amazing features
@@ -288,6 +391,7 @@ src/
 3. Add a test funcition to the `tests` directory and run **pytest**.
 
    - Add secret values defined in `.github/workflows/run_test.yml` to your Github `repository secrets` located at settings > secrets & variables > Actions.
+
    - Run a following command:
       ```
       uv run pytest tests -vv --cache-clear
@@ -299,6 +403,8 @@ src/
 
    * Test functions within the files must begin with `test_`.
 
+   * Pytest priorities are `1. playground demo > 2. docs use cases > 3. other features`
+
 
 4. Update `docs` accordingly.
 
@@ -341,7 +447,7 @@ src/
 
 Pre-commit hooks help maintain code quality by running checks for formatting, linting, and other issues before each commit.
 
-* To skip pre-commit hooks (NOT RECOMMENDED)
+* To skip pre-commit hooks
    ```
    git commit --no-verify -m "your-commit-message"
    ```
@@ -350,7 +456,7 @@ Pre-commit hooks help maintain code quality by running checks for formatting, li
 
 * To edit the documentation, see `docs` repository and edit the respective component.
 
-* We use `mkdocs` to update the docs. You can run the doc locally at http://127.0.0.1:8000/:
+* We use `mkdocs` to update the docs. You can run the docs locally at http://127.0.0.1:8000/.
 
    ```
    uv run python3 -m mkdocs serve --clean

{versionhq-1.1.13.0 → versionhq-1.1.13.1}/docs/core/Agent.md

@@ -33,7 +33,7 @@ agent = vhq.Agent(
 
 ### Model optimization
 
-`[var]`<bold>`llm: Optional[str | LLM | Dict[str, Any]] = "gpt-4o"`
+`[var]`<bold>`llm: Optional[str | LLM | Dict[str, Any]] = "gpt-4o"`</bold>
 
 You can select a model or model provider that the agent will run on.
 
@@ -49,10 +49,31 @@ agent = vhq.Agent(
 )
 ```
 
+### Switching models
+
+`[class method]`<bold>`update_llm(self, llm: Any = None, llm_config: Optional[Dict[str, Any]] = None) -> Self`<bold>
+
+You can update LLM model and its configuration of the existing agent.
+
+```python
+import versionhq as vhq
+
+agent = vhq.Agent(
+	role="Marketing Analyst",
+	goal="Coping with price competition in saturated markets",
+	llm="gemini-2.0"
+)
+
+agent.update_llm(llm="deepseek", llm_config=dict(max_tokens=3000))
+assert "deepseek-r1" in agent.llm.model
+assert agent.llm.max_tokens == 3000
+```
+
+<hr/>
 
 ### Developer Prompt (System Prompt)
 
-`[var]`<bold>`backstory: Optional[str] = TEMPLATE_BACKSTORY`
+`[var]`<bold>`backstory: Optional[str] = TEMPLATE_BACKSTORY`<bold>
 
 Backstory will be drafted automatically using the given role, goal and other values in the Agent model, and converted into the **developer prompt** when the agent executes the task.
 
@@ -352,7 +373,7 @@ assert "gold" in res.raw  == True
 
 * Reference: <bold>`Knowledge` class</bold>
 
----
+<hr />
 
 ## Memory
 
@@ -425,7 +446,39 @@ import versionhq as vhq
 
 agent = vhq.Agent(
 	role="Marketing Analyst",
-	goal="Coping with increased price competition in saturated markets.",
+	goal="Coping with price competition in saturated markets.",
+)
+```
+
+<hr />
+
+### Updating model values
+
+`[class method]`<bold>`update(self, **kwargs) -> Self`</bold>
+
+You can update values of exsiting agents using `update` class method.
+
+This class method will safely trigger some setups that needs to be run before the agent start executing tasks.
+
+
+```python
+import versionhq as vhq
+
+agent = vhq.Agent(
+    role="Marketing Analyst",
+    goal="Coping with price competition in saturated markets"
+)
+
+tool = vhq.Tool(func=lambda x: x)
+agent.update(
+    tools=[tool],
+    goal="my new goal", # updating the goal (this will trigger updating the developer_prompt.)
+    max_rpm=3,
+    knowledge_sources=["testing", "testing2"], # adding knowledge sources (this will trigger the storage creation.)
+    memory_config={"user_id": "0000"},
+    llm="gemini-2.0", # Updating model (The valid llm_config for the new model will be inherited.)
+    use_developer_prompt=False,
+    dummy="I am dummy" # <- Invalid field will be automatically ignored.
 )
 ```