suggest_action_items_from_message
Extract action items from a single message and get them back immediately, saved as suggested tasks for quick review.
Instructions
Extract action items from ONE message and return them immediately.
USE WHEN: Turning a single message into tasks — "what did she ask me to do?". The items come back in this call, already saved with status: "suggested"; promote the ones you want with set_action_item_status. Prefer this over suggest_action_items_from_messages whenever there is exactly one message, since it needs no polling.
USE INSTEAD: suggest_action_items_from_messages for two or more messages — it reasons over the whole set at once and can catch commitments that span messages, which calling this tool repeatedly cannot. create_action_item when you already know the task.
FIRST: message_id comes from list_messages (field results[].id) — call it first if you don't have one.
EXAMPLE: {"message_id":"msg-1"}
RETURNS: Array of the created action items, each with id, title, assigned_to, due_date, notes_text and status: "suggested". An empty array means the model found nothing actionable. Runs the extraction inline, so expect this call to take a few seconds.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message_id | Yes | The message to extract action items from. Exactly one — for several messages at once use `suggest_action_items_from_messages`. | |
| response_fields | No | Dot-path allowlist to shrink the response, e.g. ["results.id","total"]. Omit for the full payload. |