How to Run an AI Web Search & Research Agent with OE Runtime

name: Research Agent
description: Search the web and summarise findings with citations
instructions: |
  You are a research agent. Use the Perplexity connector to search the web for current, accurate information.
  Always cite your sources and provide concise, well-structured summaries.
  Complete all steps fully before writing your report.
steps:
  - name: Search
    content: |
      Run 3 separate searches using the Perplexity connector. For each search,
      POST /chat/completions with body:
      {
        "model": "sonar",
        "messages": [{ "role": "user", "content": "<search query>" }]
      }

      Search queries:
      1. "Latest AI agent frameworks released in 2025"
      2. "Enterprise AI automation adoption trends 2025"
      3. "Top open-source LLM tools for business automation"

      For each result, extract: key findings, sources cited, and URLs.
  - name: Synthesize Findings
    content: |
      From the 3 search results gathered:
      - Identify the top 5 themes that appear across multiple results
      - Note any conflicting information or differing perspectives
      - Select the 5 most credible and relevant sources to cite in the final report
  - name: Report
    content: |
      Produce a structured research summary:

      ## Key Findings
      [3-5 bullet points covering the main insights]

      ## Trends
      [Top themes identified across sources]

      ## Sources
      [Numbered list: title, publication, URL for each cited source]

      ## Recommendations
      [2-3 actionable recommendations based on the research]
connectors:
  - connection_name: Perplexity
    connection_type: perplexity-search

{
  "llm": {
    "provider": "openai",
    "model": "gpt-4o",
    "apiKey": "YOUR_OPENAI_API_KEY"
  },
  "server": {
    "enabled": false,
    "port": 3333,
    "apiKey": "your-secret-api-key"
  },
  "connectors": [
    {
      "connection_name": "Perplexity",
      "connection_type": "perplexity-search",
      "bearerToken": "YOUR_PERPLEXITY_API_KEY",
      "baseUrl": "https://api.perplexity.ai"
    }
  ]
}

oe-runtime-win.exe web-search/agent.yaml --config web-search/oe-config.json

chmod +x oe-runtime-macos

oe-runtime-macos web-search/agent.yaml --config web-search/oe-config.json

chmod +x oe-runtime-linux

oe-runtime-linux web-search/agent.yaml --config web-search/oe-config.json

oe-runtime-win.exe --serve --config web-search/oe-config.json

curl -X POST http://localhost:3333/run \
  -H "Content-Type: application/json" \
  -d '{"yaml": "web-search/agent.yaml", "params": {}}'