Developer tools / generate

Generate your agent files.

Create an action profile or companion discovery files. Edit, copy, and download locally. Your inputs stay in this browser.

One action to start

Use an HTTPS origin with no trailing slash. Your service must implement the advertised tracking, status, and evidence behavior.

Service origin

Action ID

Action description

OpenAPI path

Submit operation ID

Status operation ID

Resource-read operation ID

Tracking window (seconds)

Bindings and evidence

JSON Pointers select values in the response. This starter matches one input field; add more in the JSON when your action needs them.

Status path parameter

Resource path parameter

Resource ID pointer

Request ID pointer

Resource state pointer

Successful states (comma-separated)

Input evidence pointer

Matching resource pointer

agentic.jsonStructure valid

{
  "$schema": "https://ruagentic.org/schemas/agentic-0.1.schema.json",
  "agentic": "0.1.0-draft",
  "origin": "https://support.example",
  "actions": [
    {
      "id": "create-ticket",
      "description": "Create a support ticket and verify the original result.",
      "openapi": "/openapi.json",
      "submit": "createTicket",
      "status": "getRequestStatus",
      "verify": "getTicket",
      "request": {
        "header": "Idempotency-Key",
        "scope": "principal-action",
        "retentionSeconds": 86400
      },
      "bindings": {
        "statusRequestId": "requestId",
        "verifyResourceId": "ticketId"
      },
      "evidence": {
        "resourceIdPointer": "/id",
        "requestIdPointer": "/request_id",
        "statePointer": "/status",
        "successValues": [
          "open",
          "closed"
        ],
        "inputBindings": [
          {
            "inputPointer": "/subject",
            "resourcePointer": "/subject"
          }
        ]
      },
      "recovery": {
        "maxChecks": 3,
        "checkDelayMs": 100,
        "timeoutMs": 3000,
        "retry": "never-automatically"
      }
    }
  ]
}

Next, validate this profile with your OpenAPI file. Then run the service tests to check request tracking and recovery.

Open the validator →Implementation guide →Read as Markdown ↗

What is connected today?

Agentic describes request recovery. These protocols provide other parts of an agent integration.

Protocol	Available here	What remains
MCP	Runnable local tool server	Connect a host using the setup guide; no public MCP endpoint.
WebMCP	Generator, validator, and lab page tools	Requires a browser with a supported WebMCP API.
A2A	AgentCard discovery declaration generator	No hosted A2A agent or task transport.
Agent Auth	Discovery declaration generator and setup guide	No identity, grant, approval, or revocation service.

Connect protocols →