> For the complete documentation index, see [llms.txt](https://docs.podigee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.podigee.com/documentation/start-here/ai-agents/start-here/ask-your-first-analytics-question.md). # Ask your first analytics question Request a simple podcast or episode analytics summary through an authorized AI connection. Request a small analytics summary and confirm the date range before you ask the agent to interpret the result. ## Before you start * Complete [Connect and run your first read-only check](/documentation/start-here/ai-agents/start-here/connect-and-run-your-first-read-only-check.md). * Choose one podcast or one published episode. * Choose a date range that is available to your Podigee plan. ## Ask for a podcast summary Ask the agent: > Summarize this podcast's downloads for the last seven days. State the exact date range and data coverage before you interpret the result. Provide the podcast ID when the connection cannot determine the intended podcast from the current conversation. ## Ask for an episode summary For a published episode, ask: > Summarize this episode's first seven days after publication. Separate Podigee data from your own interpretation. The agent can request a publication-relative window when the episode has a valid publication date. With `pdg`, run: ```sh pdg analytics summary --episode --days 7 --json ``` ## Expected result The result identifies the podcast or episode, the requested range, the returned coverage, totals, and a chronological daily series. Dates without a recorded value appear as zero when they are inside the returned range. An agent interpretation is not a Podigee metric. Keep the returned data and the agent's conclusion separate. ## If the range is shorter than expected Check the plan-visible analytics history and the episode publication date. Do not treat a plan limit as a temporary error. Choose an available range or review the applicable upgrade option. If the request combines incompatible range parameters, choose either an explicit date range or a publication-relative range and try again. ## Next step Review [Understand current capabilities and boundaries](/documentation/start-here/ai-agents/start-here/understand-current-capabilities-and-boundaries.md) before you move from read-only questions to account changes. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.podigee.com/documentation/start-here/ai-agents/start-here/ask-your-first-analytics-question.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.