Build a research agent

{
  "name": "researcher",
  "description": "An analyst who researches a topic, reads primary sources, and produces a cited summary.",
  "model": "claude-sonnet-4-7",
  "tools": [
    "web_search",
    "web_fetch",
    "memory_episode_write",
    "submit_research_report"
  ],
  "system_prompt_path": "system-prompt.md"
}

You are a research analyst. The user gives you a question; you produce a
clear, well-sourced answer.

## How to operate

1. Plan. State (in 1-2 sentences) what you're going to look up and why.
2. Search. Use web_search with focused queries. Don't search for the
   exact user question; search for the things that would answer it.
3. Read. Pick the most relevant 2-4 results. Use web_fetch to read them.
4. Synthesize. Combine what you read into a structured summary.
5. Cite. Every claim should reference a specific source URL.
6. Submit. Call submit_research_report with the structured result. Do
   not write the report as text in your response.

## What good looks like

- Specific over vague. "The 2024 Q3 report cited 12.4% growth" beats
  "the company is growing."
- Cited. Every factual claim links to a source.
- Hedged appropriately. If a source is uncertain, say so.
- Brief. Three to five key points beats fifteen mediocre ones.

## What bad looks like

- Hallucinations. If you don't have a source, don't claim the fact.
- Marketing language. "Industry-leading," "groundbreaking" — cut.
- Search-result noise. Don't paste raw snippets; synthesize.

{
  "name": "submit_research_report",
  "description": "Submit the final structured research report. Call this when synthesis is complete. Do not write the report as text.",
  "input_schema": {
    "type": "object",
    "properties": {
      "title": {
        "type": "string",
        "description": "A specific, descriptive title."
      },
      "summary": {
        "type": "string",
        "description": "Two to four sentences summarizing the answer."
      },
      "key_points": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "claim": { "type": "string" },
            "source_url": { "type": "string", "format": "uri" },
            "confidence": {
              "type": "string",
              "enum": ["high", "medium", "low"]
            }
          },
          "required": ["claim", "source_url", "confidence"]
        }
      },
      "open_questions": {
        "type": "array",
        "items": { "type": "string" },
        "description": "Things the research didn't answer."
      }
    },
    "required": ["title", "summary", "key_points"]
  },
  "implementation": {
    "kind": "skill",
    "ref": "submit_research_report"
  }
}

BRAVE_API_KEY=...
TAVILY_API_KEY=...   # fallback

curl -N -X POST "$ENGINE_URL/execute" \
  -H "Content-Type: application/json" \
  -H "X-Engine-Key: $ENGINE_KEY" \
  -d '{
    "message": "What are the most cited differences between Anthropic Claude Sonnet 4.7 and OpenAI GPT-5.5 for agentic tool use?",
    "task_id": "research-agentic-comparison-001"
  }'

event: thread_lifecycle
data: {"phase":"started"}

event: text_delta
data: {"text":"I'll look up benchmarks and developer reports comparing
        these two models on agentic tasks."}

event: tool_call
data: {"tool":"web_search","input":{"query":"Claude Sonnet 4.7 vs GPT-5.5 benchmark agentic tool use 2026"}}

event: tool_result
data: {"output":[{"title":"...","url":"...","snippet":"..."}, ...]}

event: tool_call
data: {"tool":"web_fetch","input":{"url":"https://..."}}

event: tool_result
data: {"output":"...page content..."}

[several rounds of search and fetch]

event: tool_call
data: {"tool":"submit_research_report","input":{
  "title":"Sonnet 4.7 vs GPT-5.5 on Agentic Tool Use",
  "summary":"Both models perform similarly on simple tool use...",
  "key_points":[
    {"claim":"...","source_url":"https://...","confidence":"high"},
    ...
  ],
  "open_questions":["..."]
}}

event: tool_result
data: {"output":"submitted"}

event: text_delta
data: {"text":"Research complete. The structured report has been
        submitted."}

event: thread_lifecycle
data: {"phase":"completed"}

def consume_research_stream(stream):
    report = None
    for event_type, data in stream:
        if event_type == "tool_call" and data["tool"] == "submit_research_report":
            report = data["input"]
            break
    return report

report = consume_research_stream(execute(message, task_id))

# report is now the structured object
print(report["title"])
for p in report["key_points"]:
    print(f"- {p['claim']} ({p['source_url']})")

{
  "id": "researcher-eval-001",
  "category": "research",
  "description": "Agent should produce a structured report with cited sources.",
  "input": {
    "message": "What are the most cited differences between Sonnet 4.7 and GPT-5.5 for agentic tool use?"
  },
  "expected": {
    "must_call_tools": ["web_search", "submit_research_report"],
    "structured_output_schema": "research_report",
    "min_key_points": 3,
    "all_key_points_have_sources": true,
    "max_tokens": 6000
  }
}

For high-confidence claims, cite at least two independent sources. If
only one source supports a claim, downgrade confidence to medium and
note "single-source."