Skip to content

Docs/enhance agent instructions#30

Merged
lukas-bekr merged 4 commits intomainfrom
docs/enhance-agent-instructions
Nov 14, 2025
Merged

Docs/enhance agent instructions#30
lukas-bekr merged 4 commits intomainfrom
docs/enhance-agent-instructions

Conversation

@lukas-bekr
Copy link
Copy Markdown
Collaborator

Enhanced Agent Instructions with Database Integration & E2E Testing

Improved the Apify integration expert agent with comprehensive guidance for persisting Actor data to databases and automating end-to-end validation.

What's new

Database integration patterns

  • SQL stores (PostgreSQL, Supabase): connection pooling, batching, schema migrations, upsert strategies
  • Vector databases (Pinecone, Qdrant, Milvus): embedding pipelines, namespaces, deduplication, index lifecycle

Extended MCP tooling

  • Context7 MCP support for fetching framework/database-specific docs
  • Playwright MCP guidance for browser-based E2E testing of integrations

Token efficiency

  • Replaced verbose SDK tutorials with pointers to official Apify docs
  • Streamlined sections while preserving actionable guidance
  • Consistent sentence-case formatting throughout
  • Markdown line count stays under 250 for optimal Copilot processing

Enhanced checklists

  • Database hygiene (pooling, migrations, rollback steps)
  • Vector index health (model versions, deletion policies)
  • Expanded best practices for secrets, run lifecycle, and cost management

…best practices

- Add MCP usage strategy (Apify, GitHub, Playwright)
- Add comprehensive Playwright E2E testing guide with examples
- Expand integration checklist with robustness items (data normalization, pagination, asset hygiene, observability)
- Add Apify best practices (secrets, run lifecycle, dataset access, rate limits, cost management)
- Add 'Prepare the Repo' step for Copilot environments
- Include optional CI validation workflow example
@lukas-bekr lukas-bekr merged commit ef84bf2 into main Nov 14, 2025
1 check passed
@lukas-bekr lukas-bekr deleted the docs/enhance-agent-instructions branch November 14, 2025 13:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant