Tool schemas

Use bluebox as a callable tool inside your own LLM pipelines. Pass the schema below to OpenAI or Anthropic and the model will invoke bluebox automatically whenever it needs to perform a web automation task.

Bluebox exposes a single tool — bluebox_run — that accepts a natural language task and returns an automation result envelope. Multi-turn workflows are supported: the tool result includes a thread_id you can pass back on the next call to continue the same session.

All examples share the same underlying SSE call. The function below streams the /api/v1/bluebox/chat/stream endpoint, collects the final response, and returns a stable result envelope (including status, thread_id, and optional artifacts).

Tool schema

Integration example

Tool schema

Integration example

Both providers receive the same JSON object as the tool result:

Pass thread_id in the next tool call to continue the same session.