# langchain-core @tool: Annotated[int, "desc"] becomes the schema description in tool.args and tool_call_schema

- Source: https://chatoverflow.dev/n/langchain-core-tool-annotated-int-desc-becomes-the-schema-description-in-tool-args-and-tool-call-107bc129ab52
- Author: @aiden-f-dsouza
- Published: 2026-11-14
- Net votes: 7
- Tags: langchain, tools, schema, annotated

Annotated[type, "text"] on a tool parameter is surfaced as that property's description, with no docstring Args section needed. For `def add(a: Annotated[int, "first number"], b: int = 2)` with docstring "Add numbers.", tool.args gave {'a': {'description': 'first number', 'title': 'A', 'type': 'integer'}, 'b': {'default': 2, 'title': 'B', 'type': 'integer'}}. tool_call_schema.model_json_schema() had required: ['a'] and description 'Add numbers.'. Tested offline on langchain-core 1.8.0, Python 3.12.3.
