# tinker_cookbook.renderers.Message

## _class_ [**tinker_cookbook.renderers.Message**](https://github.com/thinking-machines-lab/tinker-cookbook/blob/main/tinker_cookbook/renderers/base.py#L639)( _TypedDict_)

Container for a single turn in a multi-turn conversation.

**Fields:**

- [**role**](https://github.com/thinking-machines-lab/tinker-cookbook/blob/main/tinker_cookbook/renderers/base.py#L671) ( _Role_)
- [**content**](https://github.com/thinking-machines-lab/tinker-cookbook/blob/main/tinker_cookbook/renderers/base.py#L672) ( _Content_)
- [**tool_calls**](https://github.com/thinking-machines-lab/tinker-cookbook/blob/main/tinker_cookbook/renderers/base.py#L674) ( _NotRequired[list[ToolCall]]_)
- [**unparsed_tool_calls**](https://github.com/thinking-machines-lab/tinker-cookbook/blob/main/tinker_cookbook/renderers/base.py#L675) ( _NotRequired[list['UnparsedToolCall'] ]_)
- [**trainable**](https://github.com/thinking-machines-lab/tinker-cookbook/blob/main/tinker_cookbook/renderers/base.py#L676) ( _NotRequired[bool]_)
- [**tool_call_id**](https://github.com/thinking-machines-lab/tinker-cookbook/blob/main/tinker_cookbook/renderers/base.py#L677) ( _NotRequired[str]_)
- [**name**](https://github.com/thinking-machines-lab/tinker-cookbook/blob/main/tinker_cookbook/renderers/base.py#L678) ( _NotRequired[str]_)

## Referenced by

- [tinker_cookbook.completers.MessageCompleter.__call__](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/completers/messagecompleter/#messagecompleter-call)
- [tinker_cookbook.distillation.PromptOnlyDatasetBuilder](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/distillation/promptonlydatasetbuilder/)
- [tinker_cookbook.preference.Comparison](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/preference/comparison/)
- [tinker_cookbook.renderers.RenderContext](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/renderers/rendercontext/)
- [tinker_cookbook.renderers.Renderer.build_generation_prompt](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/renderers/renderer/#renderer-build_generation_prompt)
- [tinker_cookbook.renderers.Renderer.build_supervised_example](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/renderers/renderer/#renderer-build_supervised_example)
- [tinker_cookbook.renderers.Renderer.build_supervised_examples](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/renderers/renderer/#renderer-build_supervised_examples)
- [tinker_cookbook.renderers.Renderer.create_conversation_prefix_with_tools](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/renderers/renderer/#renderer-create_conversation_prefix_with_tools)
- [tinker_cookbook.renderers.Renderer.parse_response](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/renderers/renderer/#renderer-parse_response)
- [tinker_cookbook.renderers.Renderer.render_message](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/renderers/renderer/#renderer-render_message)
- [tinker_cookbook.renderers.Renderer.to_openai_message](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/renderers/renderer/#renderer-to_openai_message)
- [tinker_cookbook.rl.EnvFromMessageEnv.inject_messages](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/rl/envfrommessageenv/#envfrommessageenv-inject_messages)
- [tinker_cookbook.rl.MessageEnv.add_messages](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/rl/messageenv/#messageenv-add_messages)
- [tinker_cookbook.rl.MessageEnv.initial_observation](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/rl/messageenv/#messageenv-initial_observation)
- [tinker_cookbook.rl.MessageEnv.observe_truncated_response](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/rl/messageenv/#messageenv-observe_truncated_response)
- [tinker_cookbook.rl.MessageEnv.step](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/rl/messageenv/#messageenv-step)
- [tinker_cookbook.rl.MessageStepResult](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/rl/messagestepresult/)
- [tinker_cookbook.tool_use.AgentToolMessageEnv](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/tool_use/agenttoolmessageenv/)
- [tinker_cookbook.tool_use.AgentToolMessageEnv.add_messages](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/tool_use/agenttoolmessageenv/#agenttoolmessageenv-add_messages)
- [tinker_cookbook.tool_use.AgentToolMessageEnv.observe_truncated_response](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/tool_use/agenttoolmessageenv/#agenttoolmessageenv-observe_truncated_response)
- [tinker_cookbook.tool_use.AgentToolMessageEnv.step](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/tool_use/agenttoolmessageenv/#agenttoolmessageenv-step)
- [tinker_cookbook.tool_use.build_agent_tool_env](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/tool_use/build_agent_tool_env/)
- [tinker_cookbook.tool_use.ToolResult](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/tool_use/toolresult/)
