mirror of
https://github.com/crewAIInc/crewAI.git
synced 2026-01-28 09:38:17 +00:00
adjust aop to amp docs lang (#4179)
Some checks failed
CodeQL Advanced / Analyze (actions) (push) Has been cancelled
CodeQL Advanced / Analyze (python) (push) Has been cancelled
Check Documentation Broken Links / Check broken links (push) Has been cancelled
Notify Downstream / notify-downstream (push) Has been cancelled
Mark stale issues and pull requests / stale (push) Has been cancelled
Some checks failed
CodeQL Advanced / Analyze (actions) (push) Has been cancelled
CodeQL Advanced / Analyze (python) (push) Has been cancelled
Check Documentation Broken Links / Check broken links (push) Has been cancelled
Notify Downstream / notify-downstream (push) Has been cancelled
Mark stale issues and pull requests / stale (push) Has been cancelled
* adjust aop to amp docs lang * whoop no print
This commit is contained in:
@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem dados de planilhas por meio do Google Sheets.
|
||||
|
||||
Antes de utilizar a integração com o Google Sheets, certifique-se de que você possui:
|
||||
|
||||
- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa
|
||||
- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa
|
||||
- Uma conta Google com acesso ao Google Sheets
|
||||
- Sua conta Google conectada pela [página de integrações](https://app.crewai.com/crewai_plus/connectors)
|
||||
- Planilhas com cabeçalhos de coluna adequados para operações com dados
|
||||
@@ -22,7 +22,7 @@ Antes de utilizar a integração com o Google Sheets, certifique-se de que você
|
||||
|
||||
### 1. Conecte sua Conta Google
|
||||
|
||||
1. Acesse [Integrações do CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)
|
||||
1. Acesse [Integrações do CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
|
||||
2. Localize **Google Sheets** na seção Integrações de Autenticação
|
||||
3. Clique em **Conectar** e conclua o fluxo OAuth
|
||||
4. Conceda as permissões necessárias para acesso à planilha
|
||||
@@ -37,7 +37,8 @@ uv add crewai-tools
|
||||
### 3. Configuração de variável de ambiente
|
||||
|
||||
<Note>
|
||||
Para usar integrações com `Agent(apps=[])`, você deve definir a variável de ambiente `CREWAI_PLATFORM_INTEGRATION_TOKEN` com seu Enterprise Token.
|
||||
Para usar integrações com `Agent(apps=[])`, você deve definir a variável de
|
||||
ambiente `CREWAI_PLATFORM_INTEGRATION_TOKEN` com seu Enterprise Token.
|
||||
</Note>
|
||||
|
||||
```bash
|
||||
@@ -59,6 +60,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
|
||||
**Parâmetros:**
|
||||
- `spreadsheetId` (string, obrigatório): Planilha - Use as Configurações de Workflow do Portal de Conexão para permitir ao usuário selecionar uma planilha. Por padrão, usa a primeira worksheet da planilha selecionada.
|
||||
- `limit` (string, opcional): Limite de linhas - Limita o número máximo de linhas retornadas.
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="google_sheets/append_values">
|
||||
@@ -76,6 +78,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
|
||||
"columnName4": "columnValue4"
|
||||
}
|
||||
```
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="google_sheets/update_values">
|
||||
@@ -112,6 +115,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
|
||||
"columnName4": "newValue4"
|
||||
}
|
||||
```
|
||||
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
@@ -279,32 +283,38 @@ crew.kickoff()
|
||||
### Problemas Comuns
|
||||
|
||||
**Erros de Permissão**
|
||||
|
||||
- Certifique-se de que sua conta Google tem acesso de edição às planilhas alvo
|
||||
- Verifique se a conexão OAuth inclui os escopos necessários para a API do Google Sheets
|
||||
- Confira se as planilhas estão compartilhadas com a conta autenticada
|
||||
|
||||
**Problemas de Estrutura da Planilha**
|
||||
|
||||
- Certifique-se de que as worksheets têm cabeçalhos de coluna antes de criar ou atualizar linhas
|
||||
- Verifique se os nomes das colunas em `additionalFields` correspondem exatamente aos cabeçalhos
|
||||
- Confirme que a worksheet especificada existe na planilha
|
||||
|
||||
**Problemas de Tipo e Formato de Dados**
|
||||
|
||||
- Garanta que os valores dos dados estejam no formato esperado para cada coluna
|
||||
- Utilize formatos de data adequados nas colunas de data (recomenda-se ISO)
|
||||
- Verifique se valores numéricos estão devidamente formatados para colunas numéricas
|
||||
|
||||
**Problemas com Fórmulas de Filtro**
|
||||
|
||||
- Certifique-se de que as fórmulas de filtro seguem a estrutura JSON correta para forma normal disjuntiva
|
||||
- Use nomes de campos válidos, correspondendo exatamente aos cabeçalhos das colunas
|
||||
- Teste filtros simples antes de criar consultas com múltiplas condições
|
||||
- Verifique se os tipos de operadores correspondem aos tipos de dados das colunas
|
||||
|
||||
**Limites de Linhas e Performance**
|
||||
|
||||
- Fique atento aos limites de linhas ao usar `GOOGLE_SHEETS_GET_ROW`
|
||||
- Considere paginação para grandes volumes de dados
|
||||
- Use filtros específicos para reduzir a quantidade de dados processados
|
||||
|
||||
**Operações de Atualização**
|
||||
|
||||
- Certifique-se de que as condições de filtro identifiquem corretamente as linhas a serem atualizadas
|
||||
- Teste condições de filtro com pequenos conjuntos de dados antes de grandes atualizações
|
||||
- Verifique se todos os campos obrigatórios estão incluídos nas operações de atualização
|
||||
@@ -312,5 +322,6 @@ crew.kickoff()
|
||||
### Obtendo Ajuda
|
||||
|
||||
<Card title="Precisa de Ajuda?" icon="headset" href="mailto:support@crewai.com">
|
||||
Entre em contato com nosso time de suporte para auxílio na configuração ou solução de problemas da integração com o Google Sheets.
|
||||
Entre em contato com nosso time de suporte para auxílio na configuração ou
|
||||
solução de problemas da integração com o Google Sheets.
|
||||
</Card>
|
||||
|
||||
Reference in New Issue
Block a user