Laboratório: Agente de Suporte Interno com Claude Agent SDK e OpenAI Agents SDK (Python) usando MCP

Roteiro para estudo em ambiente de laboratório ou de teste. Execute apenas em equipamentos, redes e contas que você tenha autorização para usar, com backup e homologação próprios. Comandos podem causar indisponibilidade ou perda de dados. Software e marcas citados pertencem aos seus titulares. Termos de Uso.

Duração estimada

120 min

Passos

12

Validações

5

Versões da documentação consultada

Python 3.10 ou superior · Claude Agent SDK a versão estável atual · OpenAI Agents SDK a versão estável atual · FastAPI a versão estável atual · Uvicorn a versão estável atual · requests a versão estável atual

Topologia

Você usará um computador local (192.168.56.10) rodando duas instâncias Python: uma com Claude Agent SDK, outra com OpenAI Agents SDK. Ambas expõem endpoints HTTP (localhost:8001 e localhost:8002) para interação. As ferramentas são scripts Python locais e um conector MCP simulado. Não há dependências externas além das APIs dos provedores (Anthropic e OpenAI), acessadas via internet.

+-------------------+
| Seu computador    |
| 192.168.56.10     |
|                   |
| +-------------+   |
| | Claude      |   |
| | Agent SDK   |<--|---> Internet (Anthropic API)
| | (localhost:8001)|
| +-------------+   |
|                   |
| +-------------+   |
| | OpenAI      |   |
| | Agents SDK  |<--|---> Internet (OpenAI API)
| | (localhost:8002)|
| +-------------+   |
+-------------------+

Equipamentos e software

Roteiro

1. Preparar o ambiente Python

   Crie um ambiente virtual para isolar dependências. Isso evita conflitos e facilita a limpeza.

   python3 -m venv agente-lab
   source agente-lab/bin/activate
   pip install --upgrade pipCopiar

   O que você deve ver: Prompt do shell mostra (agente-lab) e pip atualizado.

2. Instalar Claude Agent SDK e dependências

   Instale o SDK do Claude Agent, FastAPI e Uvicorn para expor o agente via HTTP.

   pip install claude-agent-sdk-python fastapi uvicornCopiar

   O que você deve ver: Pacotes instalados sem erro.

3. Instalar OpenAI Agents SDK e dependências

   Instale o SDK do OpenAI Agents, FastAPI e Uvicorn para expor o agente via HTTP.

   pip install openai-agents openai fastapi uvicornCopiar

   O que você deve ver: Pacotes instalados sem erro.

4. Configurar variáveis de ambiente para segredos

   Defina as chaves de API Anthropic e OpenAI em variáveis de ambiente, nunca em código.

   export ANTHROPIC_API_KEY='sua-chave-aqui'
   export OPENAI_API_KEY='sua-chave-aqui'Copiar

   O que você deve ver: Variáveis disponíveis na sessão (confirme com echo $ANTHROPIC_API_KEY).

5. Criar ferramenta FAQ local (ambos os agentes)

   Implemente uma função Python que consulta um dicionário FAQ local. Isso simula um conhecimento interno.

   faq_data = {'horário': '8h às 18h', 'ramal TI': '1234'}
   def consulta_faq(pergunta):
       return faq_data.get(pergunta.lower(), 'Não encontrado')Copiar

   O que você deve ver: Função retorna resposta correta para perguntas do FAQ.

6. Criar ferramenta de abertura de chamado (ambos os agentes)

   Implemente uma função que simula abrir um chamado, salvando em um arquivo local. Isso permite rastreabilidade.

   def abrir_chamado(usuario, descricao):
       with open('chamados.txt', 'a') as f:
           f.write(f'{usuario}: {descricao}\n')
       return 'Chamado aberto com sucesso.'Copiar

   O que você deve ver: Arquivo chamados.txt criado e atualizado a cada chamada.

7. Criar ferramenta de busca web (ambos os agentes)

   Implemente uma função que faz uma busca simples na web (exemplo: consulta um endpoint público). Use requests.

   import requests
   def busca_web(termo):
       r = requests.get(f'https://duckduckgo.com/html/?q={termo}')
       if r.status_code == 200:
           return 'Busca realizada.'
       return 'Erro na busca.'Copiar

   O que você deve ver: Função retorna 'Busca realizada.' para termos válidos.

8. Implementar agente com Claude Agent SDK

   Monte o agente Claude com as três ferramentas e prompt de sistema versionado. Exponha endpoint HTTP.

   Consulte a documentação oficial do Claude Agent SDK para o padrão de registro de ferramentas e integração FastAPI. Exemplo básico:
   from claude_agent_sdk import Agent
   from fastapi import FastAPI
   app = FastAPI()
   agent = Agent(system_prompt='v1: Suporte interno', tools=[consulta_faq, abrir_chamado, busca_web])
   @app.post('/claude')
   def chat_claude(input: dict):
       return agent.run(input['mensagem'])Copiar

   O que você deve ver: Endpoint /claude ativo em localhost:8001, aceitando POST com campo mensagem.

9. Implementar agente com OpenAI Agents SDK

   Monte o agente OpenAI com as mesmas ferramentas e prompt de sistema versionado. Exponha endpoint HTTP.

   Consulte a documentação oficial do OpenAI Agents SDK para o padrão de registro de ferramentas e integração FastAPI. Exemplo básico:
   from openai_agents import Agent
   from fastapi import FastAPI
   app = FastAPI()
   agent = Agent(name='suporte-interno', instructions='v1: Suporte interno', tools=[consulta_faq, abrir_chamado, busca_web])
   @app.post('/openai')
   def chat_openai(input: dict):
       return agent.run(input['mensagem'])Copiar

   O que você deve ver: Endpoint /openai ativo em localhost:8002, aceitando POST com campo mensagem.

10. Integrar MCP (Model Context Protocol) nos dois agentes

    Implemente um endpoint MCP mínimo para ambos, permitindo interoperabilidade. Isso conecta agentes a fluxos externos.

    Consulte https://modelcontextprotocol.io/docs para o payload MCP mínimo. Exemplo:
    @app.post('/mcp')
    def mcp_endpoint(input: dict):
        # parse input segundo MCP
        return agent.run(input['mensagem'])Copiar

    O que você deve ver: Endpoint /mcp ativo em ambos, aceitando payload MCP mínimo.

11. Ativar tracing e logs

    Configure logs detalhados para todas as ações dos agentes e ferramentas. Isso é obrigatório para revisão e auditoria.

    import logging
    logging.basicConfig(level=logging.INFO)
    # Adicione logging.info em cada função de ferramenta e entrada/saída do agente.Copiar

    O que você deve ver: Arquivo ou console mostra logs das execuções.

12. Rodar ambos os agentes simultaneamente

    Inicie os servidores FastAPI/Uvicorn em portas distintas para Claude (8001) e OpenAI (8002).

    uvicorn claude_app:app --host 0.0.0.0 --port 8001 &
    uvicorn openai_app:app --host 0.0.0.0 --port 8002 &Copiar

    O que você deve ver: Ambos os endpoints ativos e acessíveis via curl ou Postman.

Como saber que funcionou

Troubleshooting

Segurança e hardening

• Nunca exponha segredos em código ou logs
• Restrinja acesso às portas HTTP a redes confiáveis
• Implemente revisão humana para ações irreversíveis
• Garanta minimização de dados pessoais conforme LGPD
• Limite permissões dos arquivos de log e chamados.txt

Checklist final

• Ambos os agentes respondem corretamente às três ferramentas
• Endpoints HTTP ativos e acessíveis
• Logs detalhados registrados
• Arquivo chamados.txt atualizado
• MCP aceito e processado por ambos os agentes