Integração com Agentes de IA
O DataSpoc foi feito para humanos E agentes de IA. Toda funcionalidade disponível na CLI também está disponível programaticamente, para que agentes possam descobrir, consultar e gerenciar seu data lake de forma autônoma.
Três Formas de Conectar
Seção intitulada “Três Formas de Conectar”1. MCP Server
Seção intitulada “1. MCP Server”O Model Context Protocol (MCP) permite que assistentes de IA chamem tools do DataSpoc diretamente. Clientes suportados:
- Claude Desktop --- Faça perguntas sobre seus dados na conversa
- Claude Code --- Consulte seu data lake direto do agente no terminal
- Cursor --- Acesse contexto de dados enquanto programa
- Windsurf --- Integre consultas ao data lake no seu fluxo de trabalho
Veja Configuração MCP para detalhes.
2. Python SDK
Seção intitulada “2. Python SDK”Importe LensClient e PipeClient diretamente nos seus agentes Python:
- CrewAI --- Dê à sua crew acesso a SQL e consultas em linguagem natural
- LangGraph --- Adicione nós de data lake ao seu grafo
- AutoGen --- Permita que agentes consultem e analisem dados de forma autônoma
Veja Python SDK para a referência completa da API.
3. Saída JSON da CLI
Seção intitulada “3. Saída JSON da CLI”Todo comando suporta --output json para saída legível por máquina. Use em shell scripts, pipelines de CI/CD ou qualquer ferramenta de automação.
Veja Saída JSON para exemplos.
O que os Agentes Podem Fazer
Seção intitulada “O que os Agentes Podem Fazer”Com o Lens
Seção intitulada “Com o Lens”| Funcionalidade | MCP Tool | Método SDK | Flag CLI |
|---|---|---|---|
| Descobrir tabelas | list_tables | client.tables() | dataspoc-lens catalog --output json |
| Descrever schema | describe_table | client.schema(table) | dataspoc-lens catalog --table X --output json |
| Executar SQL | query | client.query(sql) | dataspoc-lens query --output json |
| Perguntar em linguagem natural | ask | client.ask(question) | dataspoc-lens ask --output json |
| Verificar status do cache | cache_status | client.cache_status() | dataspoc-lens cache --list --output json |
| Atualizar cache | cache_refresh | client.cache_refresh() | dataspoc-lens cache --refresh |
| Atualizar apenas stale | cache_refresh_stale | client.cache_refresh_stale() | dataspoc-lens cache --refresh-stale |
Com o Pipe
Seção intitulada “Com o Pipe”| Funcionalidade | MCP Tool | Método SDK | Flag CLI |
|---|---|---|---|
| Listar pipelines | list_pipelines | client.pipelines() | dataspoc-pipe status --output json |
| Ver configuração | pipeline_config | client.config(name) | dataspoc-pipe config --output json |
| Executar pipeline | run_pipeline | client.run(name) | dataspoc-pipe run |
| Verificar status | pipeline_status | client.status(name) | dataspoc-pipe status --output json |
| Ver logs | pipeline_logs | client.logs(name) | dataspoc-pipe logs --output json |
| Ler manifest | show_manifest | client.manifest() | dataspoc-pipe manifest --output json |
| Validar configuração | validate_pipeline | client.validate(name) | dataspoc-pipe validate --output json |