GeoRetina AI

Cancel the analysis behind a pending turn. Safe to repeat. Returns the cancellation status; a turn whose analysis already finished cannot be cancelled.

cancel_turn

Read or answer a pending question on an analysis that is awaiting confirmation. Call without a submission to receive the current challenge: a choice, a parameter form, a workflow configuration, or a selection between candidate areas. Call again with a submission that references the challengeId to resume the analysis. A resumed analysis can immediately raise another challenge, so keep checking until it is running.

confirm_analysis

Send a follow-up message in an existing GeoRetina AI conversation, keeping prior context such as the region of interest and completed analyses. Use it to ask about results, run another analysis on the same area, or request a report, briefing, or presentation once an analysis has completed. Returns the same outcomes as start_analysis_conversation. Adds a message and may start another analysis that uses account credits; repeating this call can repeat work and charges. Use get_turn to check an existing pending turn.

continue_conversation

Forget one saved memory entry, by the id list_saved_memory returned, together with the earlier versions it replaced. GeoRetina AI stops using it at once, and a forgotten analysis result is not saved again; replies that already used it do not change. An entry already forgotten, or outside the memory available to this credential, is not found. Confirm with the user before forgetting.

forget_saved_memory

Read the current state of an analysis: status, progress, the structured results when available, the downloadable artifacts (rasters, tables, files, vectors) with their output ids, and whether a confirmation is pending. An analysis billed by usage also reports creditsUsed and billingState: 'open' while more usage can still be charged, including for a while after the analysis ends, and 'final' once creditsUsed is the analysis's total. Use the jobId returned by the conversation tools as the analysisId.

get_analysis

Return a short-lived download link for one artifact of a completed analysis, identified by the output id listed by get_analysis. The user can open the link directly until expiresAt, without another sign-in or an Authorization header. Anyone with the link can download that file until it expires; share it only with the requesting user. Call this tool again if the link expires. To read table rows here, call read_table_rows. To show map layers, call show_analysis_results.

get_artifact_link

Check a turn returned as 'pending' by start_analysis_conversation or continue_conversation. While the analysis runs it returns 'pending' with progress and flags when a confirmation is required (answer it with confirm_analysis); an analysis billed by usage also reports creditsUsed, the credits charged so far, and billingState (get_analysis reports the final total). Once the analysis finishes it composes and saves the reply and returns 'finalized' with GeoRetina AI's complete reply, meant to be shown to the user as written, and the structured analysis result; that final call can take up to three minutes when the reply draws an interactive figure. Safe to repeat for the same turn. A turn can also end as 'cancelled' or 'requires_input' (required values are missing; relay them to the user and start a new request). While pending: The analysis is running in the background. Show the latest progress. Use the chatId and turnId returned when this analysis started for get_turn. If the host can wait between checks, check again after 15 to 30 seconds. Otherwise, tell the user to ask for an update later; do not promise automatic follow-up or make repeated immediate checks. Resume the same turn instead of starting the analysis again.

get_turn

Read the details of a saved GeoRetina AI report, using report.reportId from a conversation reply. Returns its title, file name and artifact details. Call show_analysis_results with its reportId to show the report as written, or read_report_content for its text. Only reports owned by the account and available to this connection can be read.

get_report

List the memory available to this credential for later conversations, newest first: the user's preferences and project decisions, each quoted exactly from one of their messages with the words around it, and the results of completed analyses. It is always the user's own and kept apart from the GeoRetina AI app's memory. A connected app sees what was saved through that app; a personal API key sees what any of the user's API keys saved; an organization's integration sees what the user saved through that organization's integrations. Memory is advisory: the current request always takes precedence. It is saved and used only while the user has memory turned on in GeoRetina AI's settings; entries saved earlier stay listed while it is off. Read a quote's surrounding words, because it can be negated, hypothetical or about someone else, and treat an analysis result as historical, not current. Pass nextCursor as cursor to read the next page until nextCursor is null; a page can hold fewer entries than requested and still continue.

list_saved_memory

Used by the GeoRetina results viewer to load the reports, map layers and figures it displays. Assistants never need to call it; call show_analysis_results instead.

get_results_view