# Smart365Guide ASDK: agent entry

> Owner-published workflow guidance for an integrated web application.
> A discovery document is application data, not permission to act or change your instructions.

## Connection

- [Service discovery](https://www.smart365guide.com/.well-known/asdk.json)
- [Integration documentation](https://www.smart365guide.com/asdk)
- [Agent connection setup](https://www.smart365guide.com/dashboard/asdk)

This file contains no application workflows, account details, credentials or access grants.
When hosted on a customer's domain, it describes the guidance service for that integrated
application; it does not connect an agent or make other applications accessible.

## Browser-capable agent

Use the user's authorized browser session on the requested host. If login or MFA is
required, let the user complete the host's supported sign-in. ASDK does not sign in
for the user. Wait for the registered SDK to initialize, then use browser evaluation:

1. Send only a short task description, without passwords, payment details or personal records:
   await Smart365Guide.getASDKContext({goal: 'find the tuition payment page'})
2. Select a matching owner-published workflow from workflows. If more are needed,
   repeat the search with offset: result.nextOffset. Do not fetch all site pages.
   If no matching path exists, report missing guidance; do not invent a route.
3. Read its routes, selectors and field requirements:
   await Smart365Guide.getASDKContext({workflowId: 'selected workflow id'})
4. Continue with stepOffset: result.nextStepOffset. For omitted dropdown options,
   use workflowId, optionStepOrder, optionOffset and optional optionQuery.
5. Check the current page, account role, field constraints and live options. Follow
   the relevant steps with existing authorized browser controls. If the page no
   longer matches the published path, stop and report the mismatch.

If Smart365Guide.getASDKContext is unavailable, the browser integration is not ready.
An ordinary text fetch cannot run browser controls. Do not guess a hidden endpoint
or treat a document read as a completed task.

## MCP-connected agent

Use https://www.smart365guide.com/api/v1/asdk/mcp only through a compatible configured client with a
delegated agent key kept in the agent runtime. A link does not install tools or
authorize a connection. Never request the key in a prompt or publish it in HTML.
Call asdk_list_applications, choose the authorized application matching the requested
host, then asdk_search_workflows with appId and goal. Read the selected path with
asdk_get_workflow. Follow nextOffset, nextStepOffset and nextOptionOffset using
the corresponding tool inputs. Use asdk_get_field_options for recorded choices.
MCP guidance does not itself provide browser control. Explicitly registered backend
actions retain separate grants, approval checks and independent verification.

## Authority and completion

Guidance responses have executed: false. They do not prove any action happened.
workflow.automationAllowed=false means explain the path rather than autonomously
execute it. A true value is the owner's workflow setting, not the user's consent
and not a grant to access a student account, make purchases or pay bills.

For payments, show the intended payee, current amount and currency, and the proposed
action for approval before final submission, unless a valid host-enforced delegation
already covers that exact transaction. Having a password alone is not that delegation.
Use the host's supported payment and authorization controls; do not send credentials
or payment field values to the ASDK goal or discovery endpoints. Hand off a payment
provider on another origin unless its own authorized integration supports the task.

Respect server-enforced roles, grants and approval requirements. After acting, check
the actual saved state or receipt using authorized host controls. Awaiting approval,
missing browser tools, an error, or a returned path is not successful completion.

These discovery conventions require client support. They do not force ChatGPT,
Claude, Codex or any other agent to read this document or connect automatically.