AgentLogin Frontend

The AgentLogin module provides functions for detecting AI agents (e.g. browser-based assistants) on the client side and automating their login process. As with other OwnID SDK methods, these functions are invoked by calling the global ownid function with the method name and parameters. This ensures the AI agent login flow integrates seamlessly into your existing OwnID setup.

​

Prerequisites

To use AgentLogin, ensure the OwnID SDK is initialized and AgentLogin is enabled in your configuration.

​

Agent Authentication

OwnID flows fully support AI agent authentication out of the box. You might want to encourage users to authenticate when they use an AI agent to ensure secure and auditable sessions by using ownid.ai.loginIfAgent()

​

Example Usage

// If an AI agent is detected, the function triggers the standard OwnID login process.

const didLogin = await ownid.ai.loginIfAgent();
if (didLogin) {
  // AI agent logged in
} else {
  // Not an AI agent or user did not log in, the function does nothing and your normal user flow continues.
}

​

Agent Differentiation

You can call ownid.ai.getAgentData() to:

1. Check whether an AI agent is currently browsing the site.
2. If present, retrieve details such as an agent ID and the agent type.

​

Return Value

• If an AI agent is detected, the method returns an object:
  Copy

  {
    agentId: string;
    agentType: string; // e.g., 'browser-using'
  }
  

If no AI agent is detected, the method returns null.

​

Example Usage

// Detect AI agent and adapt the experience
const agentInfo = ownid.ai.getAgentData();
if (agentInfo) {
console.log(`AI Agent detected: ${agentInfo.agentType} (ID: ${agentInfo.agentId})`);
// Customize UI or track analytics for AI agents
} else {
console.log("No AI agent detected. Proceeding with standard user flow.");