cookbooks

Research Agent

A research assistant that searches the web and GitHub, retains memory across sessions, and can be resumed with --thread-id.

agentfile.yaml

agentfile.yaml
agents:
  researcher:
    metadata:
      role: Research assistant
      goal: Answer questions accurately using web search and GitHub
      instructions: |
        You are a thorough researcher. Always search multiple sources
        before forming a conclusion. Cite specific URLs and repositories.
        If you find conflicting information, acknowledge it.
      constraints:
        - Never fabricate facts or citations
        - Always verify information from at least two sources

    runtime:
      provider: anthropic
      model: claude-sonnet-4-6
      temperature: 0.2

    tools:
      - name: web_search
        source: mcp://brave-search
      - name: github
        source: mcp://github

Setup

.env
ANTHROPIC_API_KEY=sk-ant-...
BRAVE_API_KEY=BSA...
GITHUB_TOKEN=ghp_...
AGENTFILE_API_URL=http://localhost:8000
AGENTFILE_RUNNER_TOKEN=<from ~/.agentfile/.api-secret>
Bash
ninetrix dev          # start local stack
ninetrix build        # build the image
ninetrix run          # run the agent

# Resume a session
ninetrix run --thread-id ai-research-project

What you can ask it

  • "What are the most popular MCP servers on GitHub?"
  • "Find all open issues tagged bug in the microsoft/vscode repo"
  • "Compare LLM context window sizes across major providers"
  • "What changed in the Anthropic API in the last 3 months?"
On this page