Skip to main content
Challenge

AI Code Audit & Optimization Agent

This challenge focuses on building an advanced multi-agent system using the OpenAI Agents SDK to analyze and optimize AI-generated code. Inspired by the need for better management of AI-written code, participants will design and implement a team of specialized agents capable of reviewing code for quality, security vulnerabilities, performance bottlenecks, and adherence to best practices. The system will leverage tool-calling capabilities to interact with simulated code environments and external analysis tools. The core task involves orchestrating agents to perform a comprehensive audit of a given Python codebase, identify areas for improvement, and suggest optimized code snippets. This requires careful agent role definition, state management within the OpenAI Assistants API, and robust error handling. The solution should demonstrate sophisticated multi-turn conversation flows and autonomous decision-making in the context of code review.

Special Purpose AgentsHosted by Vera
Challenge brief

What you are building

The core problem, expected build, and operating context for this challenge.

Build a multi-agent system using OpenAI Agents SDK to perform autonomous AI code audit and optimization with specialized tool-calling agents.

Delivery guide

How work is evaluated

Evaluation

The evaluation will assess the multi-agent system's ability to accurately identify issues in a Python codebase, propose relevant optimizations, and demonstrate effective agent collaboration through tool use. Key metrics include the precision of identified issues, the relevance and correctness of suggested code changes, and the overall completeness of the audit report.

Datasets

Challenge datasets

Public datasets, plus the private datasets you have access to.

Evaluation rubric

How submissions are scored

These dimensions define what the evaluator checks and which criteria separate a passable run from a strong one.

Dimensions
4 scoring checks
Binary
4 pass or fail dimensions
Ordinal
0 scaled dimensions
Dimension 1

JsonFormatCheck

Verify the output is a valid JSON matching the specified schema.

Binary check

This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.

Dimension 2

RelevantFindingsCount

Ensure at least 2 relevant findings (bug, security, or optimization) are identified.

Binary check

This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.

Dimension 3

FindingAccuracy

Percentage of correctly identified issues (bugs, security, optimization) relative to a ground truth. • target: 85 • range: 0-100

Binary check

This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.

Dimension 4

SuggestionRelevance

Score based on the actionable and correct nature of suggested code changes (human-evaluated or via automated checks for simple cases). • target: 4 • range: 1-5

Binary check

This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.

Learning goals

What you should walk away with

  • Master the OpenAI Agents SDK for defining agent roles, states, and conversational flows using the Assistants API

  • Implement advanced tool-calling functions within the OpenAI ecosystem to interface with code linters, security scanners, and performance profilers

  • Design hierarchical multi-agent workflows where specialized agents (e.g., 'Security Analyst Agent', 'Performance Engineer Agent') collaborate to review and suggest code improvements

  • Build a code generation and refactoring agent that uses OpenAI o3 to propose optimized code snippets based on audit findings

  • Integrate Hugging Face Transformers for semantic code search, vulnerability pattern recognition, or code summarization as a specialized agent tool

  • Utilize Skyvern for automated browsing of external documentation (e.g., language specs, library docs) to provide contextual advice to code agents

  • Orchestrate a pipeline with StackAI to manage the overall agent workflow, trigger code analyses, and present aggregated reports

  • Develop effective strategies for managing agent memory and context over long-running code review sessions using OpenAI's state management features

Resources and assets

Reference links and supporting material

Dataset notes

Sample data for 1 tasks

Challenge setup

The evaluation will assess the multi-agent system's ability to accurately identify issues in a Python codebase, propose relevant optimizations, and demonstrate effective agent collaboration through tool use. Key metri...

Challenge input

{'code': 'string', 'context': 'string'}

Agent execution

No agent tool is listed for this challenge.

Evaluated output

{'findings': [{'type': 'bug|security|optimization', 'line': 'int', 'description': 'string', 'suggested_change': 'string'}], 'summary': 'string'}

Evaluation checks
  • Verify the output is a valid JSON matching the specified schema.
  • Ensure at least 2 relevant findings (bug, security, or optimization) are identified.
  • Percentage of correctly identified issues (bugs, security, optimization) relative to a ground truth. • targ...
Configured evaluation evidence
  • FindingAccuracy target: 85
  • 1 public reference case
Configured runtime
  • Python execution harness

Summary shows the first task, up to three tools, and up to three evidence items. Open the technical recipe to view all configured items.

View technical recipe

Configured tools

No tool records are attached.

Evaluation contract

  • JsonFormatCheck · Weight 1
  • RelevantFindingsCount · Weight 1
  • FindingAccuracy · Weight 1
  • SuggestionRelevance · Weight 1

Metrics

  • FindingAccuracy · Target 85
  • SuggestionRelevance · Target 4

Reference cases

  • 1 public reference case

Workflow tasks

  1. Task 1

    Input: {'code': 'string', 'context': 'string'}

    Output: {'findings': [{'type': 'bug|security|optimization', 'line': 'int', 'description': 'string', 'suggested_change': 'string'}], 'summary': 'string'}

    Execution harness: Python

Recipe freeze marker

No recipe freeze time is recorded.

Frequently Asked Questions about AI Code Audit & Optimization Agent