diff --git a/docs/capabilities/analytics.mdx b/docs/capabilities/analytics.mdx index 31c7355a9..2c9101f68 100644 --- a/docs/capabilities/analytics.mdx +++ b/docs/capabilities/analytics.mdx @@ -1,10 +1,23 @@ --- -title: "Agent Analytics" +title: "Analytics" sidebarTitle: "Analytics" -icon: "chart-line" +icon: "chart-column" --- -Get comprehensive insights into your agent activity with detailed analytics on tool usage, costs, performance, and team productivity. Codegen provides fine-grained visibility into how agents are working across your organization. +What impact are code agents having on your codebase (and your finances) today? How can you better deploy them across your org? +Codegen Analytics was built to answer these questions and more. + + + Analyze cost breakdown + + + + Access detailed analytics on agent performance, costs, and team productivity. + ## Key Metrics @@ -37,18 +50,6 @@ Track the metrics that matter most for your development workflow: - **Trend analysis** - Identify patterns in agent usage and effectiveness - **Cost optimization** - Make informed decisions about model selection and usage -## Access Analytics - -View your organization's analytics dashboard to get started: - - - Access detailed analytics on agent performance, costs, and team productivity. - - ## Use Cases **Performance Optimization** diff --git a/docs/capabilities/capabilities.mdx b/docs/capabilities/capabilities.mdx index 5ae7d28b2..37a2400df 100644 --- a/docs/capabilities/capabilities.mdx +++ b/docs/capabilities/capabilities.mdx @@ -5,59 +5,127 @@ icon: "gear" iconType: "solid" --- -Codegen agents come equipped with versatile tools designed to integrate seamlessly into your development workflow. - -## Integrated Tool Suites - -Deep integrations with the tools your team already uses: - - - - Create and manage pull requests, automated code reviews, run CI/CD - workflows, sync repository changes. - - - Create and update issues automatically, track development progress, link - code changes to tickets. - - - Chat directly in channels, get real-time notifications, share code snippets - and updates. - - - Access workspace documentation, update pages and databases, sync development - information. - - - Access design specifications, extract design assets, convert designs to - code. - - - View broken checks, analyze build logs, automatically fix failing PRs and - wake up on failures. - - - Execute SQL queries directly, analyze database schemas, generate data - insights. - - - -## Core Features - -Fundamental capabilities for comprehensive development support: - - - - Safely run code, install dependencies, and test changes in an isolated - environment. - - - Access up-to-date information, research libraries, find documentation - online. - - - - - These capabilities allow Codegen agents to handle complex tasks across - multiple systems, just like a human developer. - +Codegen agents follow a simple but powerful workflow: they're triggered from your existing tools, work in secure sandboxes to implement changes, create pull requests, and then monitor and fix any issues that arise. This creates a seamless development experience that integrates naturally with your team's existing processes. + +## The Agent Happy Path + +Here's how Codegen agents work from start to finish: + +```mermaid +graph TD + A[Trigger from Integration] --> B[Work in Remote Sandbox] + B --> C[Create Pull Request] + C --> D[Monitor CI Checks] + D --> E[Auto-fix Failed Checks] + E --> D + D --> D1[All checks pass ✓] + D1 --> G[Ready for Review] + G --> F[Respond to Follow-up Questions] + F --> G + + A1[Slack @mention] --> A + A2[Linear issue assignment] --> A + A3[GitHub issue comment] --> A +``` + +### 1. Trigger `@codegen` from Your Tools + +Agents activate seamlessly from the platforms you already use: + +- **[Slack](/integrations/slack)** - Tag `@codegen` in any channel or send a direct message +- **[Linear](/integrations/linear)** - Assign an issue to Codegen or mention it in comments +- **[Jira](/integrations/jira)** - Assign an issue to Codegen or mention it in comments +- **[ClickUp](/integrations/clickup)** - Assign a task to Codegen or mention it in comments +- **[Monday.com](/integrations/monday)** - Assign an item to Codegen or mention it in comments +- **[GitHub](/integrations/github)** - Comment on issues or PRs to request changes +- **[API](http://localhost:3001/api-reference/agents/create-agent-run)** - Programmatically trigger agents for automated workflows + +### 2. Work in Secure Sandboxes + +Once triggered, agents work in **[isolated sandbox environments](/sandboxes/overview)** where they can: + +- Execute code safely without affecting your systems +- Install dependencies and run tests +- Make changes and validate them before committing +- Access your repository context while maintaining security + +### 3. Create and Manage Pull Requests + +Agents create **[GitHub pull requests](/integrations/github)** with: + +- Detailed descriptions explaining the changes +- Links back to the original request (Linear issue, Slack thread, etc.) +- Clean, tested code ready for review +- Proper commit messages following your conventions + +### 4. Monitor and Auto-fix Issues + +The **[Checks Auto-fixer](/capabilities/checks-autofixer)** ensures quality by: + +- Monitoring CI/CD pipeline results in real-time +- Automatically analyzing build failures and test errors +- Pushing targeted fixes to resolve issues +- Retrying up to 3 times before escalating to humans + +### 5. Respond to Follow-ups + +Agents remain active to handle questions and refinements: + +- Respond to PR review comments with additional changes +- Answer questions in the original Slack thread or Linear issue +- Make adjustments based on feedback from team members +- Provide explanations of their implementation decisions + +## Configuration & Customization + +Codegen agents can be customized to match your team's specific workflows and requirements: + +### Model Selection + +Choose from leading AI models and configure custom API keys to optimize performance and cost for your organization. + + + Select LLM providers, configure custom API keys, and optimize performance + settings. + + +### Agent Behavior + +Control how agents interact with users and approach code modifications to ensure they align with your team's preferences. + + + Configure plan proposals, GitHub mention requirements, and interaction + patterns. + + +### Security & Permissions + +Define what actions agents are allowed to perform across your organization with fine-grained permission controls. + + + Control PR creation, rules detection, and enforce security policies like + signed commits. + + + + Start with conservative settings and gradually expand agent capabilities as + your team becomes comfortable with AI assistance. + + +## Learn More + +Dive deeper into specific capabilities: + +- **[Get started with the overview](/introduction/overview)** - Complete introduction to Codegen +- **[Explore integrations](/integrations/integrations)** - See all available platforms and tools +- **[Understand sandboxes](/sandboxes/overview)** - Learn about the secure execution environment +- **[Configure settings](/settings/settings)** - Customize agent behavior and permissions +- **[View analytics](/capabilities/analytics)** - Monitor agent performance and impact diff --git a/docs/capabilities/checks-autofixer.mdx b/docs/capabilities/checks-autofixer.mdx index 3648e6be3..3523255a6 100644 --- a/docs/capabilities/checks-autofixer.mdx +++ b/docs/capabilities/checks-autofixer.mdx @@ -4,7 +4,7 @@ sidebarTitle: "Checks Auto-fixer" icon: "bell" --- -When GitHub checks fail on a Codegen PR, Codegen agents will automatically "wake up", analyze the failure, and push fix commit. +When GitHub checks fail on a Codegen PR, Codegen agents will automatically "wake up", analyze the failure, and push fix commits.