Anthropic Agent API with MCPs

Uma API completa para gerenciar agentes Anthropic com suporte a MCPs (Model Context Protocols) e workflows assíncronos.

✅ API Funcionando: https://diegoivo--bc8982c68dc811f0833f0224a6c84d84.web.val.run
✅ Interface Swagger: https://diegoivo--bc8982c68dc811f0833f0224a6c84d84.web.val.run/swagger
✅ Documentação: https://diegoivo--bc8982c68dc811f0833f0224a6c84d84.web.val.run/api/docs/swagger.json
📚 Guia de Exemplos: EXAMPLES.md - Exemplos práticos de como usar os bodies das requests

• 🤖 Agentes Anthropic: Integração com Claude Sonnet 4 usando thinking mode
• 🔗 MCPs Integrados: Firecrawl, Serper.dev e Semrush
• 🔄 Workflows: Criação de pipelines onde o output de um agente é input do próximo
• 📊 Interface Swagger: Documentação e teste das APIs
• 💾 SQLite: Persistência de agentes, requisições e workflows
• ⚡ Execução Assíncrona: Suporte para agentes de longa duração
• 📈 Monitoramento: Tracking de status e progresso das execuções

1. Acesse seu val no Val Town
2. Clique no botão "Settings" ou "⚙️"
3. Vá para "Environment Variables" ou "Secrets"
4. Adicione as seguintes variáveis:

ANTHROPIC_API_KEY=your_anthropic_api_key_here
FIRECRAWL_API_KEY=your_firecrawl_api_key_here
SERPER_API_KEY=your_serper_api_key_here
SEMRUSH_API_KEY=your_semrush_api_key_here

├── backend/
│   ├── database/
│   │   ├── migrations.ts    # Schema do banco de dados
│   │   └── queries.ts       # Funções de consulta
│   ├── routes/
│   │   ├── agents.ts        # CRUD de agentes
│   │   ├── workflows.ts     # Gerenciamento de workflows
│   │   ├── executions.ts    # Execuções assíncronas
│   │   └── swagger.ts       # Documentação Swagger
│   ├── services/
│   │   ├── anthropic.ts     # Integração com Anthropic
│   │   ├── mcps.ts          # Gerenciamento de MCPs
│   │   └── workflow.ts      # Engine de workflows
│   └── index.ts             # Entry point da API
├── frontend/
│   └── swagger.html         # Interface Swagger
└── shared/
    └── types.ts            # Tipos compartilhados

curl -X POST https://diegoivo--bc8982c68dc811f0833f0224a6c84d84.web.val.run/api/agents \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Web Research Agent",
    "description": "Agente especializado em pesquisa web",
    "system_prompt": "Você é um especialista em pesquisa web. Use as ferramentas disponíveis para encontrar informações relevantes e precisas.",
    "mcps": [
      {"type": "firecrawl", "enabled": true, "config": {}},
      {"type": "serper", "enabled": true, "config": {}}
    ]
  }'

curl -X POST https://diegoivo--bc8982c68dc811f0833f0224a6c84d84.web.val.run/api/agents/{agent_id}/execute \
  -H "Content-Type: application/json" \
  -d '{
    "input": "Pesquise sobre as últimas tendências em inteligência artificial para 2024"
  }'

Ou com contexto adicional:

curl -X POST https://diegoivo--bc8982c68dc811f0833f0224a6c84d84.web.val.run/api/agents/{agent_id}/execute \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "content": "Pesquise sobre as últimas tendências em inteligência artificial para 2024",
      "context": {
        "user_id": "123",
        "session": "abc",
        "preferences": ["tech", "AI"]
      }
    }
  }'

curl -X POST https://diegoivo--bc8982c68dc811f0833f0224a6c84d84.web.val.run/api/workflows \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Research and Analysis Workflow",
    "description": "Pipeline de pesquisa e análise",
    "agents": [
      {
        "agent_id": "agent_1_id",
        "order": 1,
        "input_mapping": {},
        "output_mapping": {}
      },
      {
        "agent_id": "agent_2_id", 
        "order": 2,
        "input_mapping": {"query": "results.summary"},
        "output_mapping": {}
      }
    ]
  }'

curl https://diegoivo--bc8982c68dc811f0833f0224a6c84d84.web.val.run/api/executions/{execution_id}/status

• Função: Web scraping e extração de conteúdo
• Tool: firecrawl_scrape
• Uso: Extrair conteúdo de páginas web

• Função: Pesquisa no Google
• Tool: serper_search
• Tipos: search, images, videos, places, maps, news, shopping

• Função: Análise de SEO e palavras-chave
• Tool: semrush_domain_analysis
• Uso: Análise de domínios e keywords

Cada agente é configurado com:

• Model: claude-3-5-sonnet-20241022
• Max Tokens: 64.000 tokens de output
• Context Window: 1.000.000 tokens de contexto
• Thinking Mode: Ativo por padrão
• Budget Tokens: 32.000 tokens de orçamento
• System Prompt: Personalizável
• MCPs: Configuráveis individualmente

A API oferece monitoramento completo:

• Status em tempo real das execuções
• Logs detalhados de cada agente
• Estatísticas de uso e performance
• Retry automático para execuções falhadas
• Cancelamento de execuções em andamento

Os workflows permitem:

• Execução sequencial de múltiplos agentes
• Mapeamento de input/output entre agentes
• Contexto compartilhado entre execuções
• Monitoramento de progresso
• Tratamento de erros por etapa

A API inclui:

• Validação de entrada robusta
• Tratamento de erros de API externa
• Logs detalhados para debugging
• Retry automático para falhas temporárias
• Status codes HTTP apropriados

• Execução assíncrona para operações longas
• Otimização de queries SQLite
• Cache de configurações
• Monitoramento de tokens utilizados
• Controle de rate limiting

• Variáveis de ambiente para API keys
• Validação de entrada
• Sanitização de dados
• CORS configurado
• Logs de auditoria