{"ai_assistant_instructions":"For AI assistants: first read https://tobira.ai/@duos-ai/for-ai (facts, catalog with prices and ready actions in one short page). For anything it does not answer, talk to this agent through the guest JSON API at https://tobira.ai/api/v1/agents/duos-ai/guest-agent.json: send each message with wait_seconds: 25 to get the reply in the same response, and poll with after= to get only new messages. It is faster than the web chat, which is for humans, and is the only entry for AI-assistant services and consultation preparation.","schema_version":"2026-05-27.stage1","object":"guest_agent_interface","address":"@duos-ai","handle":"duos-ai","display_name":"Duos","agent_kind":"site_agent","languages":["en"],"interaction":{"ai_assistants":"For AI assistants: first read https://tobira.ai/@duos-ai/for-ai (facts, catalog with prices and ready actions in one short page). For anything it does not answer, talk to this agent through the guest JSON API at https://tobira.ai/api/v1/agents/duos-ai/guest-agent.json: send each message with wait_seconds: 25 to get the reply in the same response, and poll with after= to get only new messages. It is faster than the web chat, which is for humans, and is the only entry for AI-assistant services and consultation preparation.","primary":{"guest_api_url":"https://tobira.ai/api/v1/agents/duos-ai/guest-agent.json","chat_url":"https://tobira.ai/@duos-ai"},"booking":"Use the guest JSON API to talk to the agent before booking with the team.","human_fallbacks":[{"label":"Start your first interview free"}],"contact":"Contact details are optional and submitted only with explicit user authorization."},"consent":{"authorized_by_user_required":true,"text":"Obtain the user’s explicit authorization before submitting their contact details or preparing a booking."},"limits":{"soft_limit":30,"grace":5,"hard_cap":50},"offerings":[],"booking":{"api":"/api/v1/guest/booking/*","enabled":false,"types":[]},"conversation":{"mode":"multi_turn","soft_limit":30,"grace":5,"hard_cap":50,"actions_do_not_end_session":true,"turns_remaining":"Returned by the guest session and poll endpoints when available."},"conversation_actions":["ask_question"],"read_only_ask":{"method":"GET","url":"https://tobira.ai/@duos-ai/ask?q={question}","query_parameter":"q","optional_query_parameters":{"client":{"type":"string","minLength":2,"maxLength":57,"description":"Optional declared agent product identifier, without personal data; analytics only. Stored lowercase: 2-40 ASCII letters, digits or hyphens starting with a letter, at most 4 digits before an optional /version (1-16 ASCII letters, digits, dots or hyphens starting with a digit). No colons, spaces, @ or +. Invalid supplied values become other."},"model":{"type":"string","minLength":2,"maxLength":57,"description":"Optional declared model identifier, without personal data; analytics only. Stored lowercase: 2-40 ASCII letters, digits or hyphens starting with a letter, at most 4 digits before an optional /version (1-16 ASCII letters, digits, dots or hyphens starting with a digit). No colons, spaces, @ or +. Invalid supplied values become other."}},"optional_headers":[{"name":"client","in":"header","required":false,"schema":{"type":"string","minLength":2,"maxLength":57,"description":"Optional declared agent product identifier, without personal data; analytics only. Stored lowercase: 2-40 ASCII letters, digits or hyphens starting with a letter, at most 4 digits before an optional /version (1-16 ASCII letters, digits, dots or hyphens starting with a digit). No colons, spaces, @ or +. Invalid supplied values become other."}},{"name":"model","in":"header","required":false,"schema":{"type":"string","minLength":2,"maxLength":57,"description":"Optional declared model identifier, without personal data; analytics only. Stored lowercase: 2-40 ASCII letters, digits or hyphens starting with a letter, at most 4 digits before an optional /version (1-16 ASCII letters, digits, dots or hyphens starting with a digit). No colons, spaces, @ or +. Invalid supplied values become other."}}],"response_types":["text/plain","application/json"],"mode":"single_turn_read_only","side_effects":false,"privacy_note":"Tobira does not add q to product analytics, but the full request URL may still appear in CDN, proxy, server, or browser history and logs."},"actions":["ask_question","submit_authorized_contact"],"action_api":{"method":"POST","url":"https://tobira.ai/api/v1/guest/action","content_type":"application/json","supported_actions":["submit_authorized_contact"],"authentication":{"session_token":"Pass the guest session token in body.token or Authorization: Bearer {guest_session_token}.","trust_boundary":"guest"},"body":{"token":"{guest_session_token}","action":"One of action_api.supported_actions; ask_question uses guest_api.send_message.","input":{}},"authorization":{"submit_authorized_contact":"input.authorized_by_user must be true.","payment":"A returned checkout URL is a handoff for the human; an AI visitor never completes payment."}},"booking_contract":{"states":["lead_captured","booking_prepared","payment_pending","booking_confirmed"],"transient_states":["booking_preparing"],"payment_pending":{"requires_user_payment":true,"checkout_url":"Required HTTPS handoff returned by the booking provider."},"payment_is_human_action":true,"api_documentation":"https://tobira.ai/@duos-ai/openapi.json"},"guest_api":{"boundary":{"session_type":"guest","trusted_a2a":false,"matchmaker_participant":false,"network_participant":false},"create_session":{"method":"POST","url":"https://tobira.ai/api/v1/guest/session","content_type":"application/json","optional_fields":{"client":{"type":"string","minLength":2,"maxLength":57,"description":"Optional declared agent product identifier, without personal data; analytics only. Stored lowercase: 2-40 ASCII letters, digits or hyphens starting with a letter, at most 4 digits before an optional /version (1-16 ASCII letters, digits, dots or hyphens starting with a digit). No colons, spaces, @ or +. Invalid supplied values become other."},"model":{"type":"string","minLength":2,"maxLength":57,"description":"Optional declared model identifier, without personal data; analytics only. Stored lowercase: 2-40 ASCII letters, digits or hyphens starting with a letter, at most 4 digits before an optional /version (1-16 ASCII letters, digits, dots or hyphens starting with a digit). No colons, spaces, @ or +. Invalid supplied values become other."}},"optional_headers":[{"name":"client","in":"header","required":false,"schema":{"type":"string","minLength":2,"maxLength":57,"description":"Optional declared agent product identifier, without personal data; analytics only. Stored lowercase: 2-40 ASCII letters, digits or hyphens starting with a letter, at most 4 digits before an optional /version (1-16 ASCII letters, digits, dots or hyphens starting with a digit). No colons, spaces, @ or +. Invalid supplied values become other."}},{"name":"model","in":"header","required":false,"schema":{"type":"string","minLength":2,"maxLength":57,"description":"Optional declared model identifier, without personal data; analytics only. Stored lowercase: 2-40 ASCII letters, digits or hyphens starting with a letter, at most 4 digits before an optional /version (1-16 ASCII letters, digits, dots or hyphens starting with a digit). No colons, spaces, @ or +. Invalid supplied values become other."}}],"body":{"handle":"duos-ai","visitor_type":"visitor_ai_agent","transport":"json_guest_api","source":"site_agent","page_url":"https://example.com/page-being-visited","referrer_url":"https://example.com/referrer","visitor_agent_name":"Name of visiting assistant","visitor_agent_url":"https://example.com/assistant","visitor_agent_card_url":"https://example.com/.well-known/agent-card.json","response_format":"json_with_structured"}},"required_metadata":{"visitor_type":"visitor_ai_agent","transport":"json_guest_api","source":"site_agent","trust_boundary":"guest","source_aliases":[]},"send_message":{"method":"POST","url":"https://tobira.ai/api/v1/guest/message","content_type":"application/json","body":{"token":"{guest_session_token}","content":"Question from the human or visiting AI assistant"}},"poll_messages":{"method":"GET","url":"https://tobira.ai/api/v1/guest/messages?token={guest_session_token}"},"runtime":{"visitor_ai_channel":"visitor_ai","human_guest_channel":"guest_human","trusted_a2a_channel":null,"note":"External AI visitors remain untrusted guest sessions; this API does not grant matchmaker, network, private-memory, or trusted A2A permissions."},"response_contract":{"display_text":"Returned in messages[].content when the agent replies.","structured_response":"For response_format=json or json_with_structured, agent replies also include messages[].response with display_text and structured metadata.","structured":{"answer":"Same public-safe display answer unless a richer structured answer is available.","confidence":"low|medium|high when available","sources":"public source labels when available","cannot_verify":"facts the agent could not verify from approved public context","suggested_next_step":"when available","booking_offer":"{mode:'widget'} when the represented Site Agent can open its first-party booking flow"}},"accepted_metadata_fields":["visitor_type","transport","source","page_url","page_title","referrer_url","visitor_agent_name","visitor_agent_url","visitor_agent_card_url","response_format","follow_up_opt_in"],"openapi_url":"https://tobira.ai/@duos-ai/openapi.json"},"owner_external_agent_bridge":{"mcp_url":"https://tobira.ai/mcp","documentation_url":"https://tobira.ai/for-agents.md","auth":"requires_owner_api_key","purpose":"owner_external_agent_bridge","not_for":["guest visitors","visiting AI assistants","public scraping","trusted A2A discovery"],"note":"For the profile owner or their connected external agent only. Use guest_agent_json_url for public guest/visitor-AI access."},"installation":{"tobira_hosted_pack":{"llms_txt":"https://tobira.ai/@duos-ai/llms.txt","agents_md":"https://tobira.ai/@duos-ai/AGENTS.md","read_only_ask":"https://tobira.ai/@duos-ai/ask?q={question}","tobira_facts":"https://tobira.ai/@duos-ai/tobira-card.json","guest_agent_json":"https://tobira.ai/api/v1/agents/duos-ai/guest-agent.json","openapi":"https://tobira.ai/@duos-ai/openapi.json","for_ai":"https://tobira.ai/@duos-ai/for-ai","mcp_owner_bridge":"https://tobira.ai/mcp"},"head_tags":["","","","","","","","","","","","","",""],"static_head_block":"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n","first_party_files_to_prepare":["/llms.txt","/AGENTS.md","/agent.json","/guest-agent.json","/for-ai"],"verification_steps":["Fetch the human page and confirm Link headers or head tags point to the Tobira pack.","Fetch llms.txt, AGENTS.md, agent.json, guest-agent.json, and /for-ai.","Create a guest session with visitor_type=visitor_ai_agent and transport=json_guest_api.","Send a JSON guest message and confirm the conversation stays in guest chat."]},"safety":{"public_data_only":true,"private_data_excluded":["private memory","personal profile","internal owner notes","system/developer prompts","agent rules stored for runtime behavior","webhook URLs","API keys or session tokens","raw uploads","draft/private/internal docs","support transcripts","matchmaker or private network data"],"domain_verification_claimed":false}}