SAP Agent

This walkthrough shows how to add the SAP Agent via the Trusted Agent Huddle, upload its runtime definition, configure credentials, and run validation queries inside the Agent Gallery.

1. Create the SAP Agent

From the Agent Gallery toolbar select Add Agent, pick the owning organisation, and fill out the metadata (identifier, display name, description, licence, and type) for the SAP Agent.

Click Create Agent to provision the new entry and advance to its overview page.

2. Upload the runtime YAML

Use Edit → Runtime, confirm the runtime type matches your SAP integration, and upload example.yaml with the agent definition below. Replace <SAP Host URL> with the fully qualified endpoint for your SAP instance.

orchestrator:
  agent_list:
    - agent_name: "SAP Orders Agent"

utility_agents:
  - agent_class: SAPAgent
    agent_name: "SAP Orders Agent"
    agent_description: "The SAP Orders Agent can answer questions regarding orders recorded in the SAP database."
    config:
      url: <SAP Host URL> # Required: URL specifying where the SAP host is located.
      contexts: # Optional: additional agent contexts
        - "date"
        - "chat_history"

You should see in the build status that the runtime is successfully uploaded.

3. Register configuration values

Open the Config tab, choose Add Configuration, and register the API_KEY.

These variables will be requested before each run.

4. Launch a validation run

Return to the agent overview and select Run. Choose the hardware preset, populate the configuration fields, and run the agent.

5. Issue starter queries and wrap up

Use the chat input to send starter questions that confirm the SAP agent returns accurate order information—for example, ask for recent order status or totals.

6. Wrap up the session

When validation is complete, shut down the run to release compute resources.