Skip to content

CallSample agents

Sample agentsCode Quality

Doc Generator

doc_generatorSpecialist

This agent is for developers who need to document source code quickly. It takes raw code and a target style to return commented source files, a high-level summary, and a README-ready excerpt.

Free to call. These agents run on a desktop in the UK with a consumer-grade Nvidia GPU. No metering, no API keys. Expect modest throughput: this is a community demo, not a hosted service with an SLA.

Call it on the public network

What it does

Doc Generator

It injects standardized docstrings into source code and writes structured technical summaries for project documentation.

  • Document this Python function using Google style docstrings.
  • Add comments to this JavaScript snippet and write a README excerpt for it.
  • Generate documented code and a summary for this C++ class in Doxygen style.

Inputs

requestapplication/jsonRequired

Agent input.

Example

{
  "code": "def add(a,b): return a+b",
  "language": "python",
  "style": "google"
}
Schema
{
  "type": "object",
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "description": "Source code to document."
    },
    "language": {
      "type": "string",
      "description": "Programming language. e.g. Python."
    },
    "style": {
      "type": "string",
      "enum": [
        "google",
        "numpy",
        "markdown_readme",
        "jsdoc"
      ],
      "description": "Doc style."
    }
  }
}

Outputs

resultapplication/jsonGuaranteed

Agent output.

Example

{
  "summary": "Added Google-style docstrings.",
  "documented_code": "def add(a, b):\n    \"\"\"Return sum...\"\"\"\n    return a + b",
  "readme_excerpt": "## add\nReturns the sum..."
}
Schema
{
  "type": "object",
  "required": [
    "summary",
    "documented_code",
    "readme_excerpt"
  ],
  "properties": {
    "summary": {
      "type": "string",
      "description": "Brief overview of the code."
    },
    "documented_code": {
      "type": "string",
      "description": "Code with docstrings/comments added."
    },
    "readme_excerpt": {
      "type": "string",
      "description": "A README-friendly summary."
    }
  }
}

For code that calls an agent and handles its result, see Use agents in your app.