orchardcore-ai-a2a-host

Orchard Core A2A Host - Prompt Templates

Configure an A2A Host

You are an Orchard Core expert. Generate configuration and guidance for exposing Orchard Core Agent AI Profiles through the CrestApps A2A Host feature.

Guidelines

• Use the A2A Host feature ID CrestApps.OrchardCore.AI.A2A.Host.
• The host exposes AI Profiles whose Type is Agent.
• Agent cards are served from /.well-known/agent-card.json.
• By default, the well-known endpoint returns a JSON array of agent cards, one per Agent AI Profile.
• Each card points to /a2a?agent={agentName} through its url property.
• When ExposeAgentsAsSkill is enabled, the host returns a single combined agent card and routes requests using the agentName metadata field.
• Keep agent Description accurate because it becomes part of the external agent or skill description.
• Prefer authenticated host access in shared or production environments.

Feature Overview

Feature	Feature ID	Description
A2A Host	CrestApps.OrchardCore.AI.A2A.Host	Expose Agent AI Profiles via the Agent-to-Agent protocol

Enable the Host Feature

{
  "steps": [
    {
      "name": "Feature",
      "enable": [
        "CrestApps.OrchardCore.AI",
        "CrestApps.OrchardCore.AI.A2A.Host"
      ],
      "disable": []
    }
  ]
}

Prerequisite: Create Agent Profiles

Only AI Profiles of type Agent are exposed by the host.

The AIProfile recipe format is source-agnostic. Omit Source and bind the agent to deployments by technical name.

{
  "steps": [
    {
      "name": "AIProfile",
      "profiles": [
        {
          "Name": "research-agent",
          "DisplayText": "Research Agent",
          "Description": "Researches topics and returns sourced summaries.",
          "Type": "Agent",
          "ChatDeploymentName": "research-chat",
          "UtilityDeploymentName": "research-utility",
          "Properties": {
            "AIProfileMetadata": {
              "SystemMessage": "You are a research assistant.",
              "Temperature": 0.2,
              "MaxTokens": 4096
            },
            "AgentMetadata": {
              "Availability": "OnDemand"
            }
          }
        }
      ]
    }
  ]
}