# 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/index.md)
- [tinker_cookbook.preference.Comparison](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/preference/comparison/index.md)
- [tinker_cookbook.renderers.RenderContext](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/renderers/rendercontext/index.md)
- [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/index.md)
- [tinker_cookbook.tool_use.AgentToolMessageEnv](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/tool_use/agenttoolmessageenv/index.md)
- [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/index.md)
- [tinker_cookbook.tool_use.ToolResult](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/tool_use/toolresult/index.md)