> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Asana

> Gerenciamento de projetos e tarefas

## Configuração

<img src="https://mintcdn.com/automationanywhere/KYLkRhJ6hNNnwL4a/img/agents-toolkits/31.1.jpg?fit=max&auto=format&n=KYLkRhJ6hNNnwL4a&q=85&s=cd560ab51f528861716a9c0c887e6afc" alt="Configuração do Asana com autenticação, workspace padrão e seleção de ferramentas" width="1280" height="627" data-path="img/agents-toolkits/31.1.jpg" />

<img src="https://mintcdn.com/automationanywhere/KYLkRhJ6hNNnwL4a/img/agents-toolkits/31.2.jpg?fit=max&auto=format&n=KYLkRhJ6hNNnwL4a&q=85&s=9973d4b86c0a6086221a8efb13a517d2" alt="Ferramentas Criar Tarefa e Atualizar Tarefa do Asana" width="1280" height="89" data-path="img/agents-toolkits/31.2.jpg" />

* **Autenticação**: OAuth
* **Workspace Padrão**: Configuração opcional
* **Acesso**: Acesso completo de leitura/gravação a tarefas, projetos e workspaces

## Ferramentas Disponíveis (8/8)

* **Obter Projetos**: Listar todos os projetos no workspace.
* **Obter Workspaces**: Listar todos os workspaces acessíveis aos usuários.
* **Obter Campos Personalizados**: Recuperar campos personalizados definidos no workspace ou projeto.
* **Obter Usuários**: Listar todos os usuários no workspace.
* **Obter Tarefas**: Consultar tarefas por projeto, responsável ou data de vencimento.
* **Obter Tarefas do Usuário**: Recuperar tarefas atribuídas a um usuário específico.
* **Criar Tarefa**: Criar tarefas com nome, responsável, data de vencimento e descrição.
* **Atualizar Tarefa**: Modificar propriedades da tarefa, incluindo status e responsável.

## Casos de Uso

* **Gerenciamento de Tarefas**: Criar automaticamente tarefas a partir de e-mails ou solicitações de clientes.
* **Acompanhamento de Projetos**: Monitorar o progresso do projeto e enviar atualizações de status.
* **Criação Automatizada de Tarefas**: Gerar tarefas recorrentes para fluxos de trabalho.
* **Relatórios de Status**: Consultar taxas de conclusão de tarefas e gerar relatórios.
* **Planejamento de Sprint**: Criar e organizar tarefas para sprints de desenvolvimento.

## Limites de Taxa

Monitore respostas HTTP 429 e implemente atrasos de retry-after. Use paginação para conjuntos de resultados grandes (padrão: 100 itens por página).

## Problemas Comuns e Soluções

* **Tarefa Não Encontrada**: Verifique se o GID da tarefa está correto e se o usuário tem acesso ao projeto da tarefa.
* **Permissão Negada**: Certifique-se de que o usuário possui o nível de acesso apropriado ao projeto (comentarista, editor, administrador).
* **Erros de Campos Personalizados**: Verifique se o tipo do campo personalizado corresponde ao valor sendo definido (número, texto, enum).
* **Limite de Taxa**: Implemente backoff exponencial e respeite o cabeçalho Retry-After nas respostas 429.
