{"__v":0,"_id":"5845a4aa9f6fbb1b0043081a","category":{"__v":0,"_id":"5845a4a89f6fbb1b004307be","project":"54d3007669578e0d002730c9","version":"5845a4a89f6fbb1b004307b7","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-07-30T07:08:52.789Z","from_sync":false,"order":6,"slug":"domains","title":"Domains (Deprecated)"},"parentDoc":null,"project":"54d3007669578e0d002730c9","user":"55a04a395730f40d001104d2","version":{"__v":1,"_id":"5845a4a89f6fbb1b004307b7","project":"54d3007669578e0d002730c9","createdAt":"2016-12-05T17:32:24.708Z","releaseDate":"2016-12-05T17:32:24.708Z","categories":["5845a4a89f6fbb1b004307b8","5845a4a89f6fbb1b004307b9","5845a4a89f6fbb1b004307ba","5845a4a89f6fbb1b004307bb","5845a4a89f6fbb1b004307bc","5845a4a89f6fbb1b004307bd","5845a4a89f6fbb1b004307be","5845a4a89f6fbb1b004307bf","5845a4a89f6fbb1b004307c0"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"25.0.0","version":"25"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-07-30T07:09:58.464Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Domains are being deprecated\",\n  \"body\": \"Domains are being deprecated. If you're currently using domains, please consider using our new [Prebuilt Agents](https://docs.api.ai/docs/prebuilt-agents).\"\n}\n[/block]\n* [How it works](#how-it-works)\n* [Fulfillment](#fulfillment)\n* [Fulfillment Customization](#fulfillment-customization)\n* [Languages](#languages)\n[block:api-header]\n{\n  \"type\": \"basic\"\n}\n[/block]\nDomains are pre-defined knowledge packages. \n\nBy enabling Domains, you can make your agent understand thousands of diverse requests and turn them into actionable data!\n\nHead over to the Domains tab and turn on individual Domains that are relevant for your app:\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/wGQ3aTPS9CeNfUoAamcw_Individual-domains-1.png\",\n        \"Individual-domains-1.png\",\n        \"2112\",\n        \"1592\",\n        \"#32a1d8\",\n        \"\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nAll domains are available for testing in the API.AI console. API requests can be sent for free only to the Small Talk domain.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"How it works\"\n}\n[/block]\nUser's requests are sent for processing to both your agent and the Domains Knowledge Base. For ease of development, you will see both results in the API.AI test console.\n\nIn the runtime, your agent has a preference. If a request is made via the HTTP API or one of the SDK helpers, API.AI will return the agent's response if available. If not, a Domain response will be returned.\n\nHere's a sample response:\n\n```{\n  \"id\": \"c1a973e1-0056-4cd4-9007-ac467c96fe79\",\n  \"timestamp\": \"2016-10-26T09:56:28.298Z\",\n  \"result\": {\n    \"source\": \"domains\",\n    \"resolvedQuery\": \"How are you?\",\n    \"action\": \"smalltalk.greetings\",\n    \"parameters\": {\n      \"simplified\": \"how are you\"\n    },\n    \"metadata\": {},\n    \"fulfillment\": {\n      \"speech\": \"Lovely, thanks.\"\n    },\n    \"score\": 1\n  },\n  \"status\": {\n    \"code\": 200,\n    \"errorType\": \"success\"\n  },\n  \"sessionId\": \"72b152c3-7991-4192-aa58-3213b0aa94bf\"\n}```\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Fulfillment\"\n}\n[/block]\nWe provide pre-defined agent's replies for the Small Talk domain.\n\nThis means that if you turn on the Fulfillment function, your app will be able to support small talk (e.g., \"*Hello!\", \"How are you?*\").\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Fulfillment Customization\"\n}\n[/block]\nBesides using our [built-in domains fulfillment](#fulfillment), you can customize responses to the most popular requests within the <a href=\"https://docs.api.ai/docs/small-talk\" target=\"_blank\">Small Talk</a> domain. This feature is currently available for English, French, Italian, and Russian. \n\nIn the developer console, click Domains in the left side menu, enable the Small Talk domain, and click Customize. You’ll see a list of folders containing sample user requests.\n\nTo add uniqueness to your agent, type in your own speech responses and click 'Save'. These responses will substitute the default responses provided by the Small Talk domain.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/xiSd5ovbQSq6X6jkvjEl_SmallTalk_customize_add_answers.png\",\n        \"SmallTalk_customize_add_answers.png\",\n        \"2260\",\n        \"1394\",\n        \"#ed6c8b\",\n        \"\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nYour agent will give customized responses to the variations of the sample questions. For example:\n\n```{\n  \"id\": \"6cb45bf7-0a39-449b-8b3a-0cfab2a3099f\",\n  \"timestamp\": \"2016-10-26T09:53:49.497Z\",\n  \"result\": {\n    \"source\": \"domains\",\n    \"resolvedQuery\": \"What is your age?\",\n    \"action\": \"smalltalk.person\",\n    \"parameters\": {\n      \"simplified\": \"your age\"\n    },\n    \"metadata\": {},\n    \"fulfillment\": {\n      \"speech\": \"I am 18.\"\n    },\n    \"score\": 1\n  },\n  \"status\": {\n    \"code\": 200,\n    \"errorType\": \"success\"\n  },\n  \"sessionId\": \"72b152c3-7991-4192-aa58-3213b0aa94bf\"\n}```\n\nYour customized responses to Small Talk questions will be automatically transferred to another agent if you <a href=\"https://docs.api.ai/docs/concept-agents#export-and-import\" target=\"_blank\">export and then import/restore the agent</a>. If you don't want to transfer the responses, you can delete the `customDomainsResponses.json` file from the unpacked exported ZIP file, pack the file, and import/restore the agent.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Languages\"\n}\n[/block]\nThe table below displays which domains are supported in which languages. We’re working hard to make more domains available.\n\nDomains are currently available in English, Spanish, French, Japanese, Italian, Portuguese, Brazilian Portuguese, German, and Russian.\n[block:html]\n{\n  \"html\": \"<table>\\n  <tr>\\n    <th>Domains</th>\\n    <th>English</th>\\n    <th>French</th>\\n    <th>Italian</th>\\n    <th>Japanese</th>\\n    <th>Portuguese &<br>Brazilian<br> Portuguese</th>\\n    <th>Russian</th>\\n    <th>Spanish</th>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/apps\\\">Apps</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/authentication-2\\\">Authentication</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/booking\\\">Booking</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/calculator\\\">Calculator</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/calendar\\\">Calendar</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/contacts#contacts-calls\\\">Call</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/device-control\\\">Device Control</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/contacts#contacts-emails\\\">Email</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n\\t<tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/events\\\">Events</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/finance\\\">Finance</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/flights\\\">Flight Schedules</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/language-selection\\\">Language Selection</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/learning\\\">Learning</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/manage-app\\\">Manage App</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/maps-and-points-of-interest#maps-simple-search\\\">Maps</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/media\\\">Media</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/contacts#contacts-messages\\\">Messages</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/news\\\">News</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/notes\\\">Notes</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/maps-and-points-of-interest#maps-places\\\">Points of Interest</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/reminders-and-notifications\\\">Reminders and Notifications</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/shopping\\\">Shopping</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/small-talk\\\">Small Talk</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/smart-home\\\">Smart Home</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/social-networks\\\">Social Networks</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/sports\\\">Sports</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/tasks\\\">Tasks</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/taxi-search\\\">Taxi Search</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/time-dates\\\">Time & Dates</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/translate\\\">Translate</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/tv-listings\\\">TV Listings</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/units-and-formats\\\">Units and Formats</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/user-name-agent-name\\\">User Name & Agent Name</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/weather\\\">Weather</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/web-browsing\\\">Web Browsing</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/web-search\\\">Web Search</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n    <td></td>\\n  </tr>\\n  <tr>\\n    <td><a href=\\\"https://docs.api.ai/docs/encyclopedia-knowledge-wisdom\\\">Wisdom</a></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n    <td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n  \\t<td><center><span class=\\\"icon fa fa-check-square\\\"></span></center></td>\\n  </tr>\\n</table>\"\n}\n[/block]","excerpt":"","slug":"domains","type":"basic","title":"Domains Overview"}
[block:callout] { "type": "warning", "title": "Domains are being deprecated", "body": "Domains are being deprecated. If you're currently using domains, please consider using our new [Prebuilt Agents](https://docs.api.ai/docs/prebuilt-agents)." } [/block] * [How it works](#how-it-works) * [Fulfillment](#fulfillment) * [Fulfillment Customization](#fulfillment-customization) * [Languages](#languages) [block:api-header] { "type": "basic" } [/block] Domains are pre-defined knowledge packages. By enabling Domains, you can make your agent understand thousands of diverse requests and turn them into actionable data! Head over to the Domains tab and turn on individual Domains that are relevant for your app: [block:image] { "images": [ { "image": [ "https://files.readme.io/wGQ3aTPS9CeNfUoAamcw_Individual-domains-1.png", "Individual-domains-1.png", "2112", "1592", "#32a1d8", "" ], "sizing": "full" } ] } [/block] All domains are available for testing in the API.AI console. API requests can be sent for free only to the Small Talk domain. [block:api-header] { "type": "basic", "title": "How it works" } [/block] User's requests are sent for processing to both your agent and the Domains Knowledge Base. For ease of development, you will see both results in the API.AI test console. In the runtime, your agent has a preference. If a request is made via the HTTP API or one of the SDK helpers, API.AI will return the agent's response if available. If not, a Domain response will be returned. Here's a sample response: ```{ "id": "c1a973e1-0056-4cd4-9007-ac467c96fe79", "timestamp": "2016-10-26T09:56:28.298Z", "result": { "source": "domains", "resolvedQuery": "How are you?", "action": "smalltalk.greetings", "parameters": { "simplified": "how are you" }, "metadata": {}, "fulfillment": { "speech": "Lovely, thanks." }, "score": 1 }, "status": { "code": 200, "errorType": "success" }, "sessionId": "72b152c3-7991-4192-aa58-3213b0aa94bf" }``` [block:api-header] { "type": "basic", "title": "Fulfillment" } [/block] We provide pre-defined agent's replies for the Small Talk domain. This means that if you turn on the Fulfillment function, your app will be able to support small talk (e.g., "*Hello!", "How are you?*"). [block:api-header] { "type": "basic", "title": "Fulfillment Customization" } [/block] Besides using our [built-in domains fulfillment](#fulfillment), you can customize responses to the most popular requests within the <a href="https://docs.api.ai/docs/small-talk" target="_blank">Small Talk</a> domain. This feature is currently available for English, French, Italian, and Russian. In the developer console, click Domains in the left side menu, enable the Small Talk domain, and click Customize. You’ll see a list of folders containing sample user requests. To add uniqueness to your agent, type in your own speech responses and click 'Save'. These responses will substitute the default responses provided by the Small Talk domain. [block:image] { "images": [ { "image": [ "https://files.readme.io/xiSd5ovbQSq6X6jkvjEl_SmallTalk_customize_add_answers.png", "SmallTalk_customize_add_answers.png", "2260", "1394", "#ed6c8b", "" ], "sizing": "full" } ] } [/block] Your agent will give customized responses to the variations of the sample questions. For example: ```{ "id": "6cb45bf7-0a39-449b-8b3a-0cfab2a3099f", "timestamp": "2016-10-26T09:53:49.497Z", "result": { "source": "domains", "resolvedQuery": "What is your age?", "action": "smalltalk.person", "parameters": { "simplified": "your age" }, "metadata": {}, "fulfillment": { "speech": "I am 18." }, "score": 1 }, "status": { "code": 200, "errorType": "success" }, "sessionId": "72b152c3-7991-4192-aa58-3213b0aa94bf" }``` Your customized responses to Small Talk questions will be automatically transferred to another agent if you <a href="https://docs.api.ai/docs/concept-agents#export-and-import" target="_blank">export and then import/restore the agent</a>. If you don't want to transfer the responses, you can delete the `customDomainsResponses.json` file from the unpacked exported ZIP file, pack the file, and import/restore the agent. [block:api-header] { "type": "basic", "title": "Languages" } [/block] The table below displays which domains are supported in which languages. We’re working hard to make more domains available. Domains are currently available in English, Spanish, French, Japanese, Italian, Portuguese, Brazilian Portuguese, German, and Russian. [block:html] { "html": "<table>\n <tr>\n <th>Domains</th>\n <th>English</th>\n <th>French</th>\n <th>Italian</th>\n <th>Japanese</th>\n <th>Portuguese &<br>Brazilian<br> Portuguese</th>\n <th>Russian</th>\n <th>Spanish</th>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/apps\">Apps</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/authentication-2\">Authentication</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/booking\">Booking</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/calculator\">Calculator</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/calendar\">Calendar</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/contacts#contacts-calls\">Call</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/device-control\">Device Control</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/contacts#contacts-emails\">Email</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n\t<tr>\n <td><a href=\"https://docs.api.ai/docs/events\">Events</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/finance\">Finance</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/flights\">Flight Schedules</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/language-selection\">Language Selection</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/learning\">Learning</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/manage-app\">Manage App</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/maps-and-points-of-interest#maps-simple-search\">Maps</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/media\">Media</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/contacts#contacts-messages\">Messages</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/news\">News</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/notes\">Notes</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/maps-and-points-of-interest#maps-places\">Points of Interest</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/reminders-and-notifications\">Reminders and Notifications</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/shopping\">Shopping</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/small-talk\">Small Talk</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/smart-home\">Smart Home</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/social-networks\">Social Networks</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/sports\">Sports</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/tasks\">Tasks</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/taxi-search\">Taxi Search</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/time-dates\">Time & Dates</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/translate\">Translate</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/tv-listings\">TV Listings</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/units-and-formats\">Units and Formats</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/user-name-agent-name\">User Name & Agent Name</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/weather\">Weather</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/web-browsing\">Web Browsing</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/web-search\">Web Search</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td></td>\n <td></td>\n <td></td>\n </tr>\n <tr>\n <td><a href=\"https://docs.api.ai/docs/encyclopedia-knowledge-wisdom\">Wisdom</a></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n <td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n \t<td><center><span class=\"icon fa fa-check-square\"></span></center></td>\n </tr>\n</table>" } [/block]