{"title":"Cousteau","description":"Connect data for Cousteau with guides for product analytics, OpenTelemetry, HTTP ingestion, object storage, external catalogs, and business context.","order":200,"askSuggestions":["Why is Cousteau waiting for data?","How do I focus Cousteau on a specific problem?","How do I pause Cousteau's investigations?"],"navigation":true,"routeId":"cousteau","body":{"code":"var Component=(()=>{var g=Object.create;var a=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var v=Object.getPrototypeOf,b=Object.prototype.hasOwnProperty;var m=(t,e)=>()=>(e||t((e={exports:{}}).exports,e),e.exports),w=(t,e)=>{for(var i in e)a(t,i,{get:e[i],enumerable:!0})},r=(t,e,i,s)=>{if(e&&typeof e==\"object\"||typeof e==\"function\")for(let o of p(e))!b.call(t,o)&&o!==i&&a(t,o,{get:()=>e[o],enumerable:!(s=f(e,o))||s.enumerable});return t};var x=(t,e,i)=>(i=t!=null?g(v(t)):{},r(e||!t||!t.__esModule?a(i,\"default\",{value:t,enumerable:!0}):i,t)),k=t=>r(a({},\"__esModule\",{value:!0}),t);var d=m((j,c)=>{c.exports=_jsx_runtime});var C={};w(C,{default:()=>u,frontmatter:()=>y});var n=x(d()),y={title:\"Cousteau\",routeId:\"cousteau\",description:\"Connect data for Cousteau with guides for product analytics, OpenTelemetry, HTTP ingestion, object storage, external catalogs, and business context.\",order:200,askSuggestions:[\"Why is Cousteau waiting for data?\",\"How do I focus Cousteau on a specific problem?\",\"How do I pause Cousteau's investigations?\"]};function l(t){let e={a:\"a\",h1:\"h1\",h2:\"h2\",li:\"li\",ol:\"ol\",p:\"p\",strong:\"strong\",ul:\"ul\",...t.components},{DocsPreviewDocument:i,DocsPreviewSection:s}=e;return i||h(\"DocsPreviewDocument\",!0),s||h(\"DocsPreviewSection\",!0),(0,n.jsxs)(i,{anchors:\"cousteau set-up-an-investigation verify-an-investigation troubleshooting connect-data continue-with-your-data\",children:[(0,n.jsxs)(s,{sectionId:\"cousteau\",anchors:\"\",ancestors:\"\",index:\"0\",children:[(0,n.jsx)(e.h1,{id:\"cousteau\",children:\"Cousteau\"}),`\n`,(0,n.jsx)(e.p,{children:\"Cousteau is Altertable\\u2019s autonomous product investigation agent. Connect the data you want it to investigate. Start with one source and add others as needed. The guides below explain how to send data, connect an existing database, or add business context.\"}),`\n`]}),(0,n.jsxs)(s,{sectionId:\"set-up-an-investigation\",anchors:\"\",ancestors:\"\",index:\"1\",children:[(0,n.jsx)(e.h2,{id:\"set-up-an-investigation\",children:\"Set up an investigation\"}),`\n`,(0,n.jsxs)(e.p,{children:[\"Cousteau is enabled when an environment is created. It needs relevant data before it can investigate. Open \",(0,n.jsx)(e.strong,{children:\"Cousteau\"}),\" in that environment to check its status, focus areas, and findings.\"]}),`\n`,(0,n.jsxs)(e.ol,{children:[`\n`,(0,n.jsx)(e.li,{children:\"Connect one source using the guides below and verify a known record with SQL.\"}),`\n`,(0,n.jsxs)(e.li,{children:[\"Open Cousteau and create a focus area with a concrete title, such as \",(0,n.jsx)(e.strong,{children:\"Checkout errors\"}),\".\"]}),`\n`,(0,n.jsxs)(e.li,{children:[\"Add guidelines describing the relevant tables, business definitions, and signals to investigate. Add shared \",(0,n.jsx)(e.a,{href:\"/docs/agents/knowledge/entries\",children:\"knowledge\"}),\" for context that should apply beyond this focus area.\"]}),`\n`,(0,n.jsx)(e.li,{children:\"Review the focus area's task and findings as investigations run. The global investigation is scheduled every six hours.\"}),`\n`]}),`\n`,(0,n.jsx)(e.p,{children:\"Users with permission to manage bots can enable or disable Cousteau from its menu. Disabling pauses its tasks and triggers; enabling resumes the global task and active focus areas. Archive a focus area when it no longer needs monitoring.\"}),`\n`]}),(0,n.jsxs)(s,{sectionId:\"verify-an-investigation\",anchors:\"\",ancestors:\"\",index:\"2\",children:[(0,n.jsx)(e.h2,{id:\"verify-an-investigation\",children:\"Verify an investigation\"}),`\n`,(0,n.jsxs)(e.p,{children:[\"Check the task's latest run and open a finding. Confirm the source tables, time range, and evidence against a direct SQL query. A \",(0,n.jsx)(e.strong,{children:\"waiting for data\"}),\" state means you should verify the connected source before expecting findings. A run without a finding is not proof that no issue exists.\"]}),`\n`]}),(0,n.jsxs)(s,{sectionId:\"troubleshooting\",anchors:\"\",ancestors:\"\",index:\"3\",children:[(0,n.jsx)(e.h2,{id:\"troubleshooting\",children:\"Troubleshooting\"}),`\n`,(0,n.jsxs)(e.ul,{children:[`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Waiting for data:\"}),\" query the source in the same environment and confirm that it contains usable records.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"No recent runs:\"}),\" check whether Cousteau is disabled and inspect its task status.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Findings miss business context:\"}),\" add relevant knowledge and make the focus-area guidelines more specific.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Enable or edit controls are unavailable:\"}),\" ask an administrator to check your permissions.\"]}),`\n`]}),`\n`]}),(0,n.jsxs)(s,{sectionId:\"connect-data\",anchors:\"\",ancestors:\"\",index:\"4\",children:[(0,n.jsx)(e.h2,{id:\"connect-data\",children:\"Connect data\"}),`\n`,(0,n.jsxs)(e.ul,{children:[`\n`,(0,n.jsx)(e.li,{children:(0,n.jsx)(e.a,{href:\"/docs/product-analytics/setup\",children:\"Product analytics\"})}),`\n`,(0,n.jsx)(e.li,{children:(0,n.jsx)(e.a,{href:\"/docs/opentelemetry/setup\",children:\"OpenTelemetry\"})}),`\n`,(0,n.jsx)(e.li,{children:(0,n.jsx)(e.a,{href:\"/docs/lakehouse/ingest/http-api\",children:\"HTTP API\"})}),`\n`,(0,n.jsx)(e.li,{children:(0,n.jsx)(e.a,{href:\"/docs/lakehouse/ingest/object-storage\",children:\"Object storage\"})}),`\n`,(0,n.jsx)(e.li,{children:(0,n.jsx)(e.a,{href:\"/docs/lakehouse/external-catalogs\",children:\"External catalogs\"})}),`\n`,(0,n.jsx)(e.li,{children:(0,n.jsx)(e.a,{href:\"/docs/agents/knowledge/entries\",children:\"Business context and knowledge\"})}),`\n`]}),`\n`]}),(0,n.jsxs)(s,{sectionId:\"continue-with-your-data\",anchors:\"\",ancestors:\"\",index:\"5\",children:[(0,n.jsx)(e.h2,{id:\"continue-with-your-data\",children:\"Continue with your data\"}),`\n`,(0,n.jsxs)(e.p,{children:[\"Use \",(0,n.jsx)(e.a,{href:\"/docs/agents/ask\",children:\"Ask Altertable\"}),\" to investigate a question, or create a \",(0,n.jsx)(e.a,{href:\"/docs/automation/tasks\",children:\"task\"}),\" for a recurring check.\"]})]})]})}function u(t={}){let{wrapper:e}=t.components||{};return e?(0,n.jsx)(e,{...t,children:(0,n.jsx)(l,{...t})}):l(t)}function h(t,e){throw new Error(\"Expected \"+(e?\"component\":\"object\")+\" `\"+t+\"` to be defined: you likely forgot to import, pass, or provide it.\")}return k(C);})();\n;return Component;"},"_id":"docs/automation/cousteau.mdx","_raw":{"sourceFilePath":"docs/automation/cousteau.mdx","sourceFileName":"cousteau.mdx","sourceFileDir":"docs/automation","contentType":"mdx","flattenedPath":"docs/automation/cousteau"},"type":"Docs","path":"/automation/cousteau","level":2,"parent":"automation"}