Skip to content

Schema Markup & Structured Data Enhancements #230

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
devin-ai-integration wants to merge 1 commit into from
Closed

Schema Markup & Structured Data Enhancements #230

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
169 changes: 155 additions & 14 deletions app/layout.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ import { GeistSans } from "geist/font/sans";
import type { ReactNode } from "react";
import type { Metadata } from 'next';
import { validateEnv } from "@/lib/env";
import Script from 'next/script';
import "./global.css";

// Validate environment variables at startup (server-side only)
Expand All @@ -12,18 +13,32 @@ if (typeof window === 'undefined') {

export const metadata: Metadata = {
metadataBase: new URL('https://www.agentuity.dev'),
title: 'Agentuity Docs',
title: 'Agentuity Documentation — Complete guide to AI agent deployment',
description:
'Documentation for Agentuity, the cloud platform purpose-built for deploying, managing, and scaling AI agents.',
'Comprehensive documentation for Agentuity, the cloud platform purpose-built for deploying, managing, and scaling AI agents. Learn how to build, deploy, and manage autonomous agents with our CLI, SDKs, and cloud infrastructure.',
applicationName: 'Agentuity Docs',
authors: [{ name: 'Agentuity, Inc.' }],
keywords: [
'AI',
'Agents',
'Cloud Platform',
'Deployment',
'Management',
'Scaling',
'AI agents documentation',
'artificial intelligence',
'cloud platform',
'agent deployment guide',
'AI infrastructure',
'autonomous agents',
'LangChain integration',
'CrewAI integration',
'agent management',
'AI scaling',
'machine learning operations',
'MLOps',
'agent orchestration',
'AI automation',
'intelligent agents',
'API documentation',
'SDK documentation',
'CLI documentation',
'tutorials',
'examples',
],
referrer: 'origin-when-cross-origin',
creator: 'Agentuity, Inc.',
Expand All @@ -49,17 +64,17 @@ export const metadata: Metadata = {
},
manifest: '/manifest.json',
openGraph: {
title: 'Agentuity Docs',
title: 'Agentuity Documentation — Complete guide to AI agent deployment',
description:
'Documentation for Agentuity, the cloud platform purpose-built for deploying, managing, and scaling AI agents.',
'Comprehensive documentation for Agentuity, the cloud platform purpose-built for deploying, managing, and scaling AI agents. Learn how to build, deploy, and manage autonomous agents.',
url: 'https://www.agentuity.dev',
siteName: 'Agentuity Docs',
images: [
{
url: '/og-image.png',
width: 1200,
height: 630,
alt: 'Agentuity Docs',
alt: 'Agentuity Documentation - Complete guide to AI agent deployment and management',
},
],
locale: 'en_US',
Expand All @@ -69,24 +84,150 @@ export const metadata: Metadata = {
card: 'summary_large_image',
site: '@agentuity',
creator: '@agentuity',
title: 'Agentuity Docs',
title: 'Agentuity Documentation — Complete guide to AI agent deployment',
description:
'Documentation for Agentuity, the cloud platform purpose-built for deploying, managing, and scaling AI agents.',
'Comprehensive documentation for Agentuity, the cloud platform purpose-built for deploying, managing, and scaling AI agents. Learn how to build, deploy, and manage autonomous agents.',
images: ['/og-image.png'],
},
appleWebApp: {
capable: undefined,
title: 'Agentuity Docs',
statusBarStyle: 'black-translucent',
},
abstract: 'Documentation for Agentuity, the cloud platform purpose-built for deploying, managing, and scaling AI agents.',
abstract: 'Comprehensive technical documentation for Agentuity\'s AI agent cloud platform, including API references, SDK guides, CLI documentation, tutorials, and examples for building and deploying autonomous agents',
category: 'technology',
classification: 'Business Software',
};

export default function Layout({ children }: { children: ReactNode }) {
return (
<html lang="en" className={GeistSans.className} suppressHydrationWarning>
<head>
<Script
id="documentation-schema"
type="application/ld+json"
strategy="afterInteractive"
>
{`
{
"@context": "https://schema.org",
"@type": "TechArticle",
"headline": "Agentuity Documentation",
"description": "Comprehensive technical documentation for Agentuity's AI agent cloud platform, including API references, SDK guides, CLI documentation, tutorials, and examples.",
"author": {
"@type": "Organization",
"name": "Agentuity, Inc.",
"url": "https://www.agentuity.com"
},
"publisher": {
"@type": "Organization",
"name": "Agentuity, Inc.",
"logo": {
"@type": "ImageObject",
"url": "https://www.agentuity.dev/og-image.png"
}
},
"datePublished": "2024-01-01",
"dateModified": "2024-12-01",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://www.agentuity.dev"
},
"about": [
{
"@type": "Thing",
"name": "AI Agents",
"description": "Autonomous artificial intelligence systems"
},
{
"@type": "Thing",
"name": "Cloud Computing",
"description": "Distributed computing services over the internet"
},
{
"@type": "Thing",
"name": "Software Development",
"description": "Process of creating and maintaining applications"
}
],
"teaches": [
"How to deploy AI agents to the cloud",
"How to manage and scale autonomous agents",
"How to integrate with AI frameworks like LangChain and CrewAI",
"How to use Agentuity CLI and SDKs",
"How to monitor and debug AI agents"
]
}
`}
</Script>
<Script
id="website-documentation-schema"
type="application/ld+json"
strategy="afterInteractive"
>
{`
{
"@context": "https://schema.org",
"@type": "WebSite",
"name": "Agentuity Documentation",
"url": "https://www.agentuity.dev",
"description": "Technical documentation for Agentuity's AI agent cloud platform",
"publisher": {
"@type": "Organization",
"name": "Agentuity, Inc."
},
"potentialAction": {
"@type": "SearchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://www.agentuity.dev/search?q={search_term_string}"
},
"query-input": "required name=search_term_string"
},
"mainEntity": {
"@type": "CreativeWork",
"name": "AI Agent Platform Documentation",
"description": "Complete technical documentation covering APIs, SDKs, CLI tools, and tutorials for building and deploying AI agents",
"author": {
"@type": "Organization",
"name": "Agentuity, Inc."
},
"audience": {
"@type": "Audience",
"audienceType": "Developers, AI Engineers, Data Scientists, Technical Writers"
},
"genre": "Technical Documentation"
}
}
`}
</Script>
<Script
id="breadcrumb-schema"
type="application/ld+json"
strategy="afterInteractive"
>
{`
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Home",
"item": "https://www.agentuity.com"
},
{
"@type": "ListItem",
"position": 2,
"name": "Documentation",
"item": "https://www.agentuity.dev"
}
]
}
`}
</Script>
</head>
<body className="flex flex-col min-h-screen antialiased">
<RootProvider
theme={{ enabled: true, enableSystem: true }}
Expand Down
61 changes: 59 additions & 2 deletions content/Guides/what-is-an-agent.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,8 +1,65 @@
---
title: What is an Agent?
description: How we define an Agent
description: How we define an Agent - Understanding the difference between APIs and AI agents, and why agents need specialized cloud infrastructure
---

import Script from 'next/script';

<Script
id="faq-schema"
type="application/ld+json"
strategy="afterInteractive"
>
{`
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "What is an AI agent?",
"acceptedAnswer": {
"@type": "Answer",
"text": "An AI agent is more like a smart assistant that can reason, plan, and act independently. Unlike APIs that just respond to commands, agents understand goals, adapt to changing conditions, and decide what to do next based on context. They don't just respond to commands; they can proactively get things done."
}
},
{
"@type": "Question",
"name": "How are agents different from APIs?",
"acceptedAnswer": {
"@type": "Answer",
"text": "APIs are like vending machines — you make a specific request, and they return exactly what you asked for. They're passive and require constant human coordination. Agents are autonomous actors that can decide how to achieve a goal, operate continuously, respond to changing context, and coordinate complex tasks without being told every step."
}
},
{
"@type": "Question",
"name": "Why isn't a traditional chatbot an AI agent?",
"acceptedAnswer": {
"@type": "Answer",
"text": "A traditional chatbot is like a scripted receptionist — it follows predefined rules, matches keywords, and responds with canned answers. An AI agent is more like a smart collaborator that can interpret intent, reason through complex tasks, take independent actions, and adapt in real time. A chatbot talks; an agent thinks and acts."
}
},
{
"@type": "Question",
"name": "What makes building agents different from traditional development?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Traditional development is logic-driven where every behavior is explicitly programmed. Agent development is intent-driven — you use natural language prompts to guide behavior, and the agent interprets these prompts and autonomously figures out what to do. This allows you to build flexible systems with far less code and far more adaptability."
}
},
{
"@type": "Question",
"name": "Why do agents need an agent-native cloud?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Traditional cloud computing is optimized for low latency and sessionless architectures. Agents demand a new paradigm — they focus on long-running, complex tasks that require context and coordination. They are stateful and require both short and long term memory. They need to be centralized, often close to data resources or high-bandwidth GPU clusters."
}
}
]
}
`}
</Script>

> But aren't agents just smart chat bots? 🤖

## Understanding the Difference Between an API and an Agent
Expand Down Expand Up @@ -74,4 +131,4 @@ Learn more details about the differences in today's cloud computing paradigm and

----

If you're a software engineer and you need to build agents, you need to think like an [Agent Builder](/Guides/agent-engineering).
If you're a software engineer and you need to build agents, you need to think like an [Agent Builder](/Guides/agent-engineering).
Loading