Astra AI Agent

Astra is the AI chat agent at agnifolio.com/portfolio-discuss. Astra has read-only access to your portfolio data and can also propose mutations — adding entries, editing transactions, deleting holdings — that you confirm before they execute. Every action is logged in an audit trail.

What Astra can do

Astra has access to a registry of tools — small typed functions that read or modify your portfolio. The tools fall into two categories:

Category	Examples	Behavior
Read-only	query_holdings, query_holding_by_symbol, query_account_summary, query_performance_summary, query_transactions, query_family_structure	Returns data inline in chat; no confirmation needed
Mutating	add_portfolio_entry, update_portfolio_entry, delete_portfolio_entry, add_transaction, update_transaction, delete_transaction, move_money	Astra proposes the action as a card; you confirm before it executes

The split is the safety primitive: Astra can investigate freely, but anything that changes your portfolio requires explicit approval.

If your account has family structure, query_family_structure returns your people and entities, and query_holdings, query_account_summary and query_performance_summary take an optional scope: a person, an entity or a branch of the family. Ask “What does my partner own?” and Astra counts each holding at that person’s share.

Example prompts

Analytics

• “What’s my total exposure to technology stocks?”
• “Show me dividend income for the last financial year, broken down by holding”
• “Which positions have lost more than 10% from cost basis?”
• “What’s my net realised gain across all sales this year, in my display currency?”

Astra runs the right read-only tools, fetches data, and returns a structured answer inline. No mutation, no confirmation.

Scenario modeling

• “If I sell my largest equity position at today’s price, how does my net worth change?”
• “Simulate adding more crypto at the current price — what does that do to my asset allocation?”

These produce hypothetical previews without modifying actual holdings.

Portfolio mutations

• “Add a new stock entry to my brokerage account”
• “Record a dividend received today on one of my holdings”
• “Delete a duplicate entry in my account”

Astra proposes the action as a ToolCallCard — a confirmation widget showing exactly what will happen. Click Confirm and it executes. Click Cancel and nothing changes.

AI statement import from chat

Astra imports your statements. Paste a broker or bank statement (CSV, spreadsheet rows, email text) into the chat, or attach a file with the paperclip (PDF, CSV, Excel or an image), and Astra hands it to the Import page.

There the statement is read into holdings and transactions: purchases, sales, dividends and more, with each fund or share matched to what you already hold. You check every row, change any you need to, then confirm. Nothing is added to your portfolio before that, and once you confirm Astra tells you in the chat how many holdings were added.

Crypto cost basis and P&L

For crypto synced from an exchange, Astra can track what you paid — not just what you hold — and answer profit-and-loss questions:

• “I bought my BTC at an average of $52,000” — records your cost basis (confirmed via card, like any mutation)
• “Recover my cost basis from my trade history” — on KuCoin, Astra pages back through your recent fills (roughly the last three months) and reconstructs your average buy price per coin automatically
• “What’s my crypto P&L?” — returns per-coin cost basis, current value at the latest synced prices, and unrealized gain/loss

Recent-trades queries include cross and isolated margin trades alongside spot, so Astra sees your full trading activity.

The confirmation flow

Note

Mutating tool calls never execute in the same chat turn the model picks them. Astra always shows a card first. You’re never one prompt away from accidental changes.

Mechanically:

1. Your message is processed by the AI agent
2. The agent decides which tool(s) to call based on your request
3. For mutating tools, the system holds the proposed action and presents it to you for confirmation
4. The UI renders a ToolCallCard — “Add this entry?” / “Delete this transaction?”
5. You click Confirm → the tool actually runs and the action is logged
6. You click Cancel → the pending action is discarded with no change to your portfolio

Audit trail

Every tool Astra runs is written to an audit log. Each entry records the time, the tool name, the inputs, the result, whether it ran or failed, and how long it took. A change you cancel never runs, so it has no entry.

Privacy and data scope

Astra’s tools only read and change your own data. Each tool gets your identity from your sign-in, never from anything the AI model asks for, and automated security tests check that a tool cannot be pointed at another user’s data.

An advisor or accountant you share your portfolio with cannot use Astra on your behalf.

Where your chat goes

When you send a message, Astra sends it to an AI model together with up to the last 20 messages of the same chat and any portfolio data its tools look up for that answer. The request goes through OpenRouter, a service that passes it on to the company running the model we have chosen.

• Astra uses paid models only. It never uses free-tier models, whose terms let the provider use what you send to improve their products.
• OpenRouter chooses which company runs the model for each request. Agni Folio does not ask OpenRouter to limit Astra to providers that promise not to store or log your data, so how long a provider keeps a request depends on OpenRouter’s and that provider’s own terms.

What Agni Folio keeps

• Your chats are saved so you can come back to them. They do not expire. Delete a chat in Astra to remove it and all its messages.
• The audit log of tools Astra ran is kept even if you delete the chat, so there is a record of every change made to your portfolio.
• Deleting your account deletes all your chats and the audit log.

When Astra is the wrong tool

• Real-time price quotes — Astra reads cached daily prices, not the live tape. Use your broker’s app for execution-time prices.
• Tax filings — Astra can summarise realised gains but isn’t a tax advisor. Export the data and consult a CPA.
• Multi-step “do X then Y then Z” automations — Astra is per-turn; for chained workflows, the dedicated UI flows are faster.

What’s next

• Transactions — Astra is the fastest way to record many transactions at once via bulk import
• Portfolio Insights — the static view; Astra is the dynamic Q&A surface
• Wealth Legacy Planning — Astra can help you build out nominee records, but the legacy transfer itself is a separate background system