ai.md: Rework with more links

Author: adriendupuis

docs/ai/ai.md

@@ -10,8 +10,9 @@ month_change: true
 to make recommendations to product customers and content readers with [Raptor connector](raptor_connector_guide.md),
 or to help editors in the back office with [AI Actions](ai_actions_guide.md).
 It's also open to external AI capabilities through [Model Context Protocol (MCP) servers](mcp_guide.md), allowing agents to interact with the system.
-It's extensible. For example, you can implement new AI actions or new MCP server capabilities.
-To go further, an AI can learn to use the REST API or the PHP API, and help you in your development.
+It's extensible. For example, you can implement [new AI actions](extend_ai_actions.md) or [new MCP server capabilities](mcp_usage.md).
+To go further, an AI agent can learn how to use the [REST API](rest_api_usage.md) or the [GraphQL API](graphql.md).
+Agents (like the ones integrated in IDEs) can even learn the [PHP API](php_api.md) and help you in your development.
 
 [[= cards([
     "ai/ai_actions/ai_actions",