diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index 6d14780..061a498 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -1,131 +1,45 @@ -* xref:get-started:adp-overview.adoc[Overview] -* xref:get-started:byoc-quickstart.adoc[ADP Quickstart] -* xref:agents:index.adoc[Agents] -** xref:agents:overview.adoc[Overview] -** xref:agents:quickstart.adoc[AI Agent Quickstart] -** xref:agents:concepts.adoc[Concepts] -** xref:agents:a2a-concepts.adoc[Agent-to-Agent Concepts] -** xref:agents:create-agent.adoc[Create a Declarative Agent] -** xref:agents:byoa-register.adoc[Register Your Own Agent (BYOA)] -** xref:agents:system-prompts.adoc[System Prompt Best Practices] -** xref:agents:architecture-patterns.adoc[Architecture Patterns] -** xref:agents:integration-overview.adoc[Integration Overview] -** xref:agents:pipeline-integration-patterns.adoc[Pipeline Integration Patterns] -** xref:agents:monitor.adoc[Monitor Agents] -** xref:agents:troubleshoot/index.adoc[Troubleshoot] -*** xref:agents:troubleshoot/troubleshoot-ai-agents.adoc[Troubleshoot AI Agents] -*** xref:agents:tutorials/index.adoc[Tutorials] -**** xref:agents:tutorials/customer-support-agent.adoc[Customer Support Agent] -**** xref:agents:tutorials/transaction-dispute-resolution.adoc[Transaction Dispute Resolution] -* xref:mcp:index.adoc[MCP Servers] -** xref:mcp:overview.adoc[Overview] -** xref:mcp:create-server.adoc[Create a Server] -** xref:mcp:register-remote.adoc[Register a Self-Managed Server] -** xref:mcp:oauth-providers.adoc[Configure an OAuth Provider] -** xref:mcp:user-delegated-oauth.adoc[User-Delegated OAuth] -*** xref:mcp:github-oauth-tutorial.adoc[Tutorial: Set Up GitHub OAuth] -** xref:mcp:test-tools.adoc[Test a Server's Tools] -** xref:mcp:managed/index.adoc[Managed Catalog] -*** xref:mcp:managed/managed-catalog.adoc[Catalog Reference] -*** xref:mcp:managed/bamboohr.adoc[BambooHR] -*** xref:mcp:managed/sql.adoc[SQL] -*** xref:mcp:managed/kafka.adoc[Kafka] -*** xref:mcp:managed/slack.adoc[Slack] -*** xref:mcp:managed/ironclad.adoc[Ironclad] -*** xref:mcp:managed/jira.adoc[Jira] -*** xref:mcp:managed/metabase.adoc[Metabase] -*** xref:mcp:managed/netsuite.adoc[NetSuite] -*** xref:mcp:managed/openapi.adoc[OpenAPI] -*** xref:mcp:managed/ramp.adoc[Ramp] -*** xref:mcp:managed/workday.adoc[Workday] -*** xref:mcp:managed/zendesk.adoc[Zendesk] -* xref:ai-gateway:index.adoc[AI Gateway] -** xref:ai-gateway:overview.adoc[Overview] +* Quickstarts +** xref:get-started:byoc-quickstart.adoc[ADP Quickstart] ** xref:ai-gateway:gateway-quickstart.adoc[AI Gateway Quickstart] -** xref:ai-gateway:gateway-architecture.adoc[Architecture] -** xref:ai-gateway:configure-provider.adoc[Configure Your LLM Provider] -*** xref:ai-gateway:bedrock-setup.adoc[Set Up AWS Bedrock] -** xref:ai-gateway:aggregation.adoc[MCP Aggregation] -** xref:ai-gateway:connect-agent.adoc[Connect Your Agent] -*** xref:ai-gateway:admin/index.adoc[For Admins] -**** xref:ai-gateway:admin/setup-guide.adoc[Setup Guide] -*** xref:ai-gateway:builders/index.adoc[For Builders] -**** xref:ai-gateway:builders/discover-gateways.adoc[Discover Gateways] -* xref:governance:index.adoc[Governance] -** xref:governance:dashboard/index.adoc[Governance Dashboard] -*** xref:governance:dashboard/overview.adoc[Read the Governance Overview] -** xref:governance:guardrails/index.adoc[Guardrails] -*** xref:governance:guardrails/overview.adoc[Overview] -*** xref:governance:guardrails/create-guardrail.adoc[Create a Guardrail] -*** xref:governance:guardrails/types-reference.adoc[Evaluator Types] -*** xref:governance:guardrails/violations.adoc[Read Violations] -*** xref:governance:guardrails/cost-tracking.adoc[Cost Tracking] -** xref:governance:budgets.adoc[Token Budgets and Limits] -** xref:governance:kill-switch.adoc[Kill Switch] -** xref:governance:permissions-overview.adoc[About ADP Permissions] -** xref:governance:permissions-reference.adoc[ADP Permissions Reference] -* xref:observability:index.adoc[Observability] -** xref:observability:concepts.adoc[Concepts] -** xref:observability:transcripts.adoc[Read a Transcript] -** xref:observability:byoa-telemetry.adoc[BYOA Telemetry (OpenTelemetry)] -** xref:observability:ingest-custom-traces.adoc[Ingest Custom Traces] -** xref:observability:metrics.adoc[Metrics] -** xref:observability:logs.adoc[Logs] -* xref:integrations:index.adoc[Integrations] -** xref:integrations:remote-mcp-clients.adoc[Remote MCP Clients] -** xref:integrations:claude-code.adoc[Claude Code] -** xref:integrations:cursor.adoc[Cursor] -** xref:integrations:continue.adoc[Continue] -** xref:integrations:cline.adoc[Cline] -** xref:integrations:copilot.adoc[GitHub Copilot] -* xref:reference:index.adoc[Reference] -** xref:get-started:rpk-install.adoc[Install or Update rpk] -** xref:reference:rpk/index.adoc[rpk Commands] -*** xref:reference:rpk/rpk-ai/rpk-ai.adoc[rpk ai] -**** xref:reference:rpk/rpk-ai/rpk-ai-agent.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-agent-list.adoc[] -**** xref:reference:rpk/rpk-ai/rpk-ai-connection.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-connection-list.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-connection-revoke.adoc[] -**** xref:reference:rpk/rpk-ai/rpk-ai-install.adoc[] -**** xref:reference:rpk/rpk-ai/rpk-ai-llm.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-llm-create.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-llm-delete.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-llm-get.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-llm-list.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-llm-update.adoc[] -**** xref:reference:rpk/rpk-ai/rpk-ai-mcp.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-mcp-create.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-mcp-delete.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-mcp-get.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-mcp-list.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-mcp-tools.adoc[] -****** xref:reference:rpk/rpk-ai/rpk-ai-mcp-tools-call.adoc[] -****** xref:reference:rpk/rpk-ai/rpk-ai-mcp-tools-list.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-mcp-types.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-mcp-update.adoc[] -**** xref:reference:rpk/rpk-ai/rpk-ai-model.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-model-get.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-model-list.adoc[] -**** xref:reference:rpk/rpk-ai/rpk-ai-oauth.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-oauth-create.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-oauth-delete.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-oauth-get.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-oauth-list.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-oauth-update.adoc[] -**** xref:reference:rpk/rpk-ai/rpk-ai-oauth-client.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-oauth-client-create.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-oauth-client-delete.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-oauth-client-get.adoc[] -***** xref:reference:rpk/rpk-ai/rpk-ai-oauth-client-list.adoc[] -**** xref:reference:rpk/rpk-ai/rpk-ai-uninstall.adoc[] -**** xref:reference:rpk/rpk-ai/rpk-ai-upgrade.adoc[] -**** xref:reference:rpk/rpk-ai/rpk-ai-version.adoc[] -*** xref:reference:rpk/rpk-cloud/rpk-cloud.adoc[rpk cloud] -**** xref:reference:rpk/rpk-cloud/rpk-cloud-login.adoc[] -**** xref:reference:rpk/rpk-cloud/rpk-cloud-logout.adoc[] -**** xref:reference:rpk/rpk-cloud/rpk-cloud-cluster.adoc[] -***** xref:reference:rpk/rpk-cloud/rpk-cloud-cluster-select.adoc[] -*** xref:reference:rpk/rpk-profile/rpk-profile.adoc[rpk profile] -*** xref:reference:rpk/rpk-x-options.adoc[rpk -X] +** xref:agents:quickstart.adoc[AI Agent Quickstart] + +* Connect data & tools +** xref:mcp:managed/managed-catalog.adoc[Plug in any app, database, or tool] +** xref:agents:create-agent.adoc[Turn your data source into an agent] +** xref:mcp:create-server.adoc[Build a tool server for your own data] +** xref:mcp:register-remote.adoc[Connect a tool server you host yourself] +** xref:mcp:user-delegated-oauth.adoc[Let agents act as the signed-in user] + +* Monitor & debug +** xref:observability:transcripts.adoc[See what your agent did] +** xref:agents:troubleshoot/troubleshoot-ai-agents.adoc[Investigate a broken run] +** xref:observability:metrics.adoc[Check speed, cost, and errors] +** xref:governance:guardrails/violations.adoc[Review blocked requests] +** xref:observability:byoa-telemetry.adoc[Send telemetry from agents you host] + +* Control & govern +** xref:governance:dashboard/overview.adoc[See all your agents in one place] +** xref:governance:guardrails/overview.adoc[Fix agents calling things they shouldn't] +** xref:governance:guardrails/create-guardrail.adoc[Set safety rules for all agents] +** xref:governance:budgets.adoc[Set spending limits] +** xref:governance:permissions-overview.adoc[Control who can do what] + +* Routing & LLM settings +** xref:ai-gateway:overview.adoc[How the gateway works] +** xref:ai-gateway:configure-provider.adoc[Configure LLM provider] +*** xref:ai-gateway:bedrock-setup.adoc[Set up AWS Bedrock] + +* Concepts +** xref:agents:concepts.adoc[Agents, MCP servers, and data sources] +** xref:ai-gateway:gateway-architecture.adoc[How the AI Gateway works] +** xref:agents:byoa-register.adoc[Declarative vs. BYOA] +** xref:governance:permissions-overview.adoc[How access control works] +** xref:mcp:overview.adoc[What MCP servers expose] +** xref:observability:concepts.adoc[How transcripts and traces work] + +* Settings reference +** xref:governance:permissions-reference.adoc[Roles and permissions matrix] +** xref:governance:guardrails/types-reference.adoc[Safety rule providers] +** xref:get-started:rpk-install.adoc[Install rpk] +** xref:reference:rpk/index.adoc[rpk command reference] ** xref:reference:glossary.adoc[Glossary]