Messages#
Choose message roles and distinguish model input from stored history.
Read the walkthrough before consulting individual signatures.
Interface |
Purpose |
|---|---|
Internal extension input, persisted as agent and sent as user to providers. |
|
Model text, reasoning, and complete tool calls. |
|
In-memory encoded image bytes and their MIME type. |
|
One image block in an ordered multimodal message. |
|
Provider-neutral image fidelity requested from a vision-capable model. |
|
Remote or data URL containing an image. |
|
Common base for user, internal agent, assistant, system, and tool roles. |
|
Roles understood by the provider-neutral agent protocol. |
|
Application instructions placed before conversational messages. |
|
One text block in an ordered multimodal message. |
|
A complete model request to invoke a named tool. |
|
One tool result returned to the model. |
|
User text or ordered text/image blocks. |