Human in the loop

import { Outcrawl } from '@outcrawl/sdk';

const oc = new Outcrawl();
const run = oc.agent.job('<id>');
let state = await run.control('take'); // the run holds at its next step boundary
while (state.pause?.reason !== 'control') {
  await new Promise((wake) => setTimeout(wake, 2000));
  state = await run.status();
}
console.log(state.pause.viewerUrl); // open it, press take control in the player

// ... do the step yourself ...

await run.control('release'); // the agent resumes on whatever page you left it on

import asyncio
from outcrawl import Outcrawl

async def main():
    async with Outcrawl() as oc:
        run = oc.agent.job("<id>")
        state = await run.control("take")  # the run holds at its next step boundary
        while (state.get("pause") or {}).get("reason") != "control":
            await asyncio.sleep(2)
            state = await run.status()
        print(state["pause"].get("viewerUrl"))  # open it, press take control in the player

        # ... do the step yourself ...

        await run.control("release")  # the agent resumes on whatever page you left it on

asyncio.run(main())

curl -X POST https://api.outcrawl.ai/v1/agent/<id>/control \
  -H "Authorization: Bearer ock_YOUR_KEY_ID.YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"action": "take"}'

import { Outcrawl } from '@outcrawl/sdk';

const oc = new Outcrawl();
await oc.agent.answer('<id>', 'the blue one');

import asyncio
from outcrawl import Outcrawl

async def main():
    async with Outcrawl() as oc:
        await oc.agent.answer("<id>", "the blue one")

asyncio.run(main())

curl -X POST https://api.outcrawl.ai/v1/agent/<id>/answer \
  -H "Authorization: Bearer ock_YOUR_KEY_ID.YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"answer": "the blue one"}'