Skip to content

Documentv2.1.0

Updated

Last verified

Test your agent ​

Prove the source, graph, integrations, then one real conversation, in that order. Simulate a full conversation without telephony when you need agent-to-agent proof.

Evidence ladder ​

text
[1] Validate source
        │
        ▼
[2] Review rendered flow
        │
        ▼
[3] Test each integration locally
        │
        ▼
[4] Publish or evolve
        │
        ▼
[5] Place one approved preview call

Do not use a successful preview to excuse a failed local validation.

Prompt your AI agent

Recommended
text
Use the `dino-ping` skill to test this agent from local source to one preview.
Validate the complete source and review the rendered graph first.
Run every custom integration operation with the target runtime policy.
Report any external side effect before each integration test.
After local proof, verify the published version and my preview-call role.
Show the exact destination and wait for approval before one real call.
Return evidence for every completed layer.
Use the Dino CLI directly
text
dino agent validate --agent-dir <absolute-agent-dir>

dino agent render --agent-dir <absolute-agent-dir> \
  --output <absolute-agent-dir>/preview.png --overwrite \
  --confirm-mutation agent.render

# For each custom operation, after approval for its possible side effects:
dino integration test --policy <runtime-policy.toml> \
  --component <component.wasm> --operation <operation> \
  --args <args.json> --record <record.json> --context <context.json> \
  --confirm-mutation integration.test

Preview rules ​

  • An Account Manager configures the fixed destination and Preview allocations.
  • Only the Client can place a Ping Preview call.
  • The Client selects one ready allocation, DID, partner credential, and Vox server.
  • The Client selects a transport VAD mode and the owner's Silero profile.
  • Only one interactive session can be active for one user.
text
dino account preview-allocations

dino agent preview-call \
  --agent-id <agent-id> \
  --vad-mode <vad-mode> \
  --vad-profile-id <silero-profile-id> \
  --allocation-id <allocation-id> \
  --preview-did-id <did-id> \
  --preview-partner-credential-id <partner-credential-id> \
  --preview-vox-server-id <vox-server-id> \
  --confirm-mutation agent.previewCall

dino agent preview-status --dd-id <dd-id>

Agent-to-agent simulation (optional) ​

To prove a full conversation without telephony, connect two agents in a simulation. It runs both agents on one Runtime and returns a Lens report for each side.

Gotchas ​

  • integration verify checks the Component boundary. It does not execute the operation.
  • An integration test can make a real HTTP request.
  • A 409 preview response means an interactive session is already active.
  • Pending preview results can omit call, duration, Lens, and post-tool fields.
  • A Lens link can expire without changing the call result.

Next ​

Use Choose a call workflow for Batch, Drip, or Inbound operation.

Dinodial customer documentation