Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
f82dfd0
Merge pull request #264 from microsoft/jeremy-siteops
JeremyVyska Aug 11, 2025
4a0ab33
Upgrade review guideliness
nikolakukrika Sep 16, 2025
7dd5bae
Update index.md
igor-ctrl Oct 1, 2025
17f1863
Adding lattest instructions
nikolakukrika Oct 8, 2025
8626051
Merge pull request #266 from microsoft/features/UpgradeGuidelines
nikolakukrika Oct 9, 2025
4db38ba
Add comprehensive agentic coding documentation
Oct 10, 2025
648d1b0
Fixing menu order
Oct 10, 2025
18938a0
Update Docsy to v0.12.0 for Hugo v0.151.0 compatibility
Oct 10, 2025
c0ed6c9
Merge pull request #267 from microsoft/hugo-updates
JeremyVyska Oct 10, 2025
9794f22
Update GitHub Actions workflow to use Hugo v0.151.0
Oct 10, 2025
b486ac7
Merge pull request #269 from microsoft/hugo-updates
JeremyVyska Oct 10, 2025
28adab2
Update creator information in documentation
JeremyVyska Oct 11, 2025
e6477e4
Add BC Telemetry Buddy (Waldo) to Tools list
Oct 17, 2025
103ce14
Add NAB AL Tools MCP server to Tools list
Oct 17, 2025
8a583c8
Curate videos.md: add 4 starter videos, contributor CTA, and quality …
Oct 17, 2025
0f61791
Add NAB AL Tools MCP page (summary, features, links)
Oct 17, 2025
784ef6d
Add Waldo BC Telemetry Buddy page (summary, links)
Oct 17, 2025
907a8f3
Clean up Articles page: remove placeholders, add CTA and quality chec…
Oct 17, 2025
b0ae28f
Merge pull request #268 from microsoft/agentic-assistance-hub
JeremyVyska Oct 17, 2025
86d86c3
Fixing broken internal links
Oct 17, 2025
86ee402
Reorganizing Agentic/Vibe Section
Oct 17, 2025
e079f2b
Merge pull request #271 from microsoft/main
JeremyVyska Oct 17, 2025
d0ebcff
Merge remote changes - accept incoming al-upgrade.md file
Oct 17, 2025
9055fcb
Adding vibe coding to the index
Oct 17, 2025
2c230e3
Merge pull request #272 from microsoft/agentic-assistance-hub
JeremyVyska Oct 17, 2025
afc35a8
Merge pull request #265 from igor-ctrl/patch-1
TheDoubleH Oct 23, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/hugo.yml
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ jobs:
build:
runs-on: ubuntu-latest
env:
HUGO_VERSION: 0.133.1
HUGO_VERSION: 0.151.0
steps:
- name: Install Hugo CLI
run: |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Manually on Windows 11"
---

This guide will walk You thrugh installing Hugo on a Windows 11 PC. For the official install guide, You can wisit <https://gohugo.io/getting-started/installing/>.
This guide will walk You thrugh installing Hugo on a Windows 11 PC. For the official install guide, You can wisit <https://gohugo.io/gettingstarted/installing/>.

## Download Binaries

Expand Down
2 changes: 1 addition & 1 deletion content/docs/Contributing/InstallHugo/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,6 @@ title: Install Hugo

There are multiple ways to install Hugo for you to properly preview your contributions. Please select the scenario that matches your setup.

For the official install guide, you can visit <https://gohugo.io/getting-started/installing/>
For the official install guide, you can visit <https://gohugo.io/gettingstarted/installing/>

{{< youtube G7umPCU-8xc >}}
2 changes: 1 addition & 1 deletion content/docs/NAVPatterns/_index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
+++
title = "NAV Patterns Archive"
weight = 20
weight = 4
tags = ["C/AL"]
+++

Expand Down
217 changes: 217 additions & 0 deletions content/docs/agentic-coding/CommunityResources/Agents/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,217 @@
---
title: "AI Coding Agents"
linkTitle: "Agents"
weight: 5
description: >
Learn about different AI coding agents and how to use them for AL development
---

## Overview

AI coding agents are intelligent assistants that help you write, review, and improve AL code for Business Central. This section explains the different types of agents available and how to choose the right one for your needs.

## What are AI Coding Agents?

AI coding agents are more than simple autocomplete tools. They can:
- Understand natural language instructions
- Generate complete code implementations
- Explain existing code
- Refactor and improve code quality
- Help debug issues
- Provide learning and guidance

## Available Agents

Explore detailed information about each AI coding agent:

### [GitHub Copilot](github-copilot-agent)
Microsoft's AI pair programmer integrated into VS Code.

**Best For**:
- Inline code completion as you type
- Quick code generation
- Learning AL patterns
- Teams already using GitHub

**Key Features**: Real-time suggestions, multi-file context, AL-aware completions

---

### [GitHub Copilot Chat](github-copilot-chat-agent)
Conversational AI assistant from GitHub with deep VS Code integration.

**Best For**:
- Interactive code discussions
- Code explanations and learning
- Debugging assistance
- Complex refactoring tasks

**Key Features**: Natural language chat, context-aware responses, inline chat

---

### [Claude (via API or Claude.ai)](claude-agent)
Anthropic's AI assistant with strong reasoning capabilities.

**Best For**:
- Complex problem solving
- Detailed code analysis
- Architecture discussions
- Large codebase understanding

**Key Features**: Long context window, strong analytical abilities, helpful explanations

---

### [Cursor](cursor-agent)
AI-first code editor built on VS Code with integrated AI assistance.

**Best For**:
- All-in-one AI coding environment
- Teams wanting deep AI integration
- Multi-model AI access
- Codebase-wide AI context

**Key Features**: Multiple AI models, composer mode, codebase indexing, chat + autocomplete

---

## Comparison Matrix

| Feature | GitHub Copilot | Copilot Chat | Claude | Cursor |
|---------|---------------|--------------|---------|---------|
| **Inline Completion** | ✓✓✓ Excellent | Limited | N/A | ✓✓✓ Excellent |
| **Chat Interface** | N/A | ✓✓✓ Excellent | ✓✓✓ Excellent | ✓✓✓ Excellent |
| **AL Awareness** | ✓✓ Good | ✓✓ Good | ✓ Basic | ✓✓ Good |
| **Code Explanation** | Limited | ✓✓✓ Excellent | ✓✓✓ Excellent | ✓✓✓ Excellent |
| **VS Code Integration** | ✓✓✓ Native | ✓✓✓ Native | ✗ Web/API | ✓✓✓ Fork |
| **Context Window** | Medium | Medium | ✓✓✓ Very Large | Large |
| **Multi-file Editing** | Limited | Limited | Manual | ✓✓✓ Excellent |
| **Pricing** | $10-19/mo | Included | Free/Pro | $20/mo |
| **Team Features** | ✓✓ Good | ✓✓ Good | Limited | ✓ Basic |

**Legend**: ✓✓✓ Excellent | ✓✓ Good | ✓ Basic | Limited | ✗ Not Available | N/A Not Applicable

## Choosing the Right Agent

### For Individual Developers

**Just Starting with AI?**
→ Start with [GitHub Copilot](github-copilot-agent) + [Copilot Chat](github-copilot-chat-agent)
- Easy setup
- Great VS Code integration
- Good AL support
- One subscription for both

**Want Maximum AI Power?**
→ Try [Cursor](cursor-agent)
- Multiple AI models
- Strong codebase understanding
- All-in-one solution
- Advanced features

**Need Deep Analysis?**
→ Use [Claude](claude-agent) for complex tasks
- Long context for large codebases
- Excellent reasoning
- Detailed explanations
- Free tier available

### For Teams

**Microsoft/GitHub Ecosystem?**
→ GitHub Copilot for Business
- Centralized management
- License management
- Organization policies
- Familiar tools

**Maximum Flexibility?**
→ Cursor for Teams
- Multiple AI models
- Strong collaboration
- Advanced features
- Modern interface

**Hybrid Approach?**
→ Combine tools:
- GitHub Copilot for daily coding
- Claude for complex analysis
- Cursor for specific projects

## Using Multiple Agents

Many developers use multiple agents for different tasks:

**Daily Coding**: GitHub Copilot (inline suggestions)
**Learning & Debugging**: Copilot Chat or Cursor Chat
**Complex Problems**: Claude (detailed analysis)
**Refactoring**: Cursor (multi-file editing)

**Example Workflow**:
1. Write code with GitHub Copilot inline suggestions
2. Ask Copilot Chat to explain complex BC patterns
3. Use Claude for architecture review of large features
4. Use Cursor for complex multi-file refactoring

## Getting Started

### New to AI Coding?

1. **Start Simple**: [GitHub Copilot](github-copilot-agent)
2. **Learn the Basics**: [Effective Prompting](../../gettingstarted/effective-prompting)
3. **Try Examples**: [Getting More](../../gettingmore)
4. **Explore Others**: Try Claude or Cursor for comparison

### Already Using AI?

**Expand Your Toolkit**:
- If using Copilot → Try Cursor for advanced features
- If using Claude → Add Copilot for inline completion
- If using Cursor → Use Claude for deep analysis

## Common Questions

### Can I use multiple agents?
Yes! Many developers use different agents for different tasks. They complement each other well.

### Which is best for AL development?
GitHub Copilot has the most AL-specific training, but all agents can be effective with good prompting.

### Are these expensive?
Most are $10-20/month for individual use. GitHub Copilot offers free access for students and open source maintainers.

### Do I need internet?
Yes, all current AI agents require internet connectivity to function.

### Will AI replace AL developers?
No. AI agents are tools to augment your capabilities, not replace your expertise and decision-making.

## Privacy & Security

All agents send code to external services. Consider:
- Review your organization's AI usage policy
- Don't include sensitive data in code
- Use business/enterprise plans for better controls
- Understand each tool's data handling policies

See individual agent pages for specific privacy information.

## Learning Path

1. **Read agent pages** to understand capabilities
2. **Choose one** to start with
3. **Follow setup** instructions
4. **Practice** with examples from [Getting More](../../gettingmore)
5. **Experiment** with others as needed

## Resources

- [Setup Guide](../../gettingstarted/setup) - Environment configuration
- [Effective Prompting](../../gettingstarted/effective-prompting) - Get better results
- [Best Practices](../../gettingstarted/best-practices) - Use AI effectively
- [Limitations](../../gettingstarted/limitations) - Understand constraints

---

**Questions?** Join the discussion at [GitHub Discussions](https://github.com/microsoft/alguidelines/discussions)
Loading