Skip to main content

Media Analyze Tool

media_analyze is a native tool that can analyze mixed media through retained provider path.

When To Use It​

Use media_analyze when a bot or workflow needs this capability inside the current workspace. Prefer this tool over ad hoc text handling when the task depends on workspace artifacts, blobs, links, events, channels, forms, media, or operation state.

Inputs And Outputs​

  • Tool name: media_analyze.
  • Input contract: MediaAnalyzeArgs with fields artifact_id, slot, mode, task, output_language.
  • Output contract: MediaAnalyzeOutput with fields state, provider, upstream_provider, model, source_artifact_id, media_kind, content_type, mode, task, run_id, request_id, provider_status, output_language, duration_seconds, text, usage, note.

The caller should provide exact workspace, artifact, blob, channel, or operation references from the current context whenever the contract requires them.

Example Task​

A user can ask the selected workspace bot to run this kind of tool-backed work when the needed source context is visible or named. The bot should return a concise result and point to any artifact, blob, event, message, or operation output that was created or inspected.

Limits And Review​

  • Confirm the bot has access to the workspace and relevant artifacts.
  • Check required references before retrying a failed call.
  • Keep results bounded enough for channel delivery and operation review.
  • Review any durable workspace changes this tool creates before treating them as final.

Media To Add​

  • Table: example media_analyze input fields, output fields, and review action. It helps developers and admins understand the contract without reading raw schemas. Source: a sample operation that uses this tool.