Integração com Asana

Visão Geral

Permita que seus agentes gerenciem tarefas, projetos e a coordenação da equipe através do Asana. Crie tarefas, atualize o status de projetos, gerencie atribuições e otimize o fluxo de trabalho da sua equipe com automação baseada em IA.

Pré-requisitos

Antes de usar a integração com o Asana, assegure-se de ter:

Uma conta CrewAI AMP com assinatura ativa
Uma conta Asana com as permissões apropriadas
Sua conta Asana conectada através da página de Integrações

Configurando a Integração Asana

1. Conecte sua Conta Asana

Acesse CrewAI AMP Integrações
Encontre Asana na seção Integrações de Autenticação
Clique em Conectar e complete o fluxo OAuth
Conceda as permissões necessárias para gerenciamento de tarefas e projetos
Copie seu Token Enterprise em Configurações de Integração

2. Instale o Pacote Necessário

uv add crewai-tools

3. Configuração de variável de ambiente

export CREWAI_PLATFORM_INTEGRATION_TOKEN="seu_enterprise_token"

Ou adicione ao seu arquivo .env:

CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token

Ações Disponíveis

asana/create_comment

Descrição: Cria um comentário no Asana.

Parâmetros:

task (string, obrigatório): ID da Tarefa - O ID da tarefa à qual o comentário será adicionado. O comentário será escrito pelo usuário atualmente autenticado.
text (string, obrigatório): Texto (exemplo: “Este é um comentário.”).

asana/create_project

Descrição: Cria um projeto no Asana.

Parâmetros:

name (string, obrigatório): Nome (exemplo: “Itens para comprar”).
workspace (string, obrigatório): Área de trabalho - Use as Configurações de Fluxo do Portal Connect para permitir que usuários escolham em qual área de trabalho criar projetos. Por padrão, será usada a primeira área de trabalho do usuário se deixado em branco.
team (string, opcional): Equipe - Use as Configurações de Fluxo do Portal Connect para permitir que usuários escolham com qual equipe compartilhar o projeto. Por padrão, será usada a primeira equipe do usuário se deixado em branco.
notes (string, opcional): Notas (exemplo: “Esses são itens que precisamos comprar.”).

asana/get_projects

Descrição: Obtém uma lista de projetos do Asana.

Parâmetros:

archived (string, opcional): Arquivado - Escolha “true” para mostrar projetos arquivados, “false” para exibir apenas projetos ativos ou “default” para mostrar ambos.
- Opções: default, true, false

asana/get_project_by_id

Descrição: Obtém um projeto pelo ID no Asana.

Parâmetros:

projectFilterId (string, obrigatório): ID do Projeto.

asana/create_task

Descrição: Cria uma tarefa no Asana.

Parâmetros:

name (string, obrigatório): Nome (exemplo: “Nome da tarefa”).
workspace (string, opcional): Área de trabalho - Use as Configurações de Fluxo do Portal Connect para permitir que usuários escolham em qual área de trabalho criar tarefas. Por padrão, será usada a primeira área de trabalho do usuário se deixado em branco.
project (string, opcional): Projeto - Use as Configurações de Fluxo do Portal Connect para permitir que usuários escolham em qual projeto criar a tarefa.
notes (string, opcional): Notas.
dueOnDate (string, opcional): Data de Vencimento - A data em que esta tarefa deve ser concluída. Não pode ser usada em conjunto com Due At. (exemplo: “YYYY-MM-DD”).
dueAtDate (string, opcional): Vence Em - A data e hora (timestamp ISO) em que esta tarefa deve ser concluída. Não pode ser usada em conjunto com Due On. (exemplo: “2019-09-15T02:06:58.147Z”).
assignee (string, opcional): Responsável - O ID do usuário Asana a quem esta tarefa será atribuída. Use as Configurações de Fluxo do Portal Connect para permitir que usuários selecionem um responsável.
gid (string, opcional): ID Externo - Um ID da sua aplicação para associar esta tarefa. Você pode usar este ID para sincronizar atualizações com esta tarefa posteriormente.

asana/update_task

Descrição: Atualiza uma tarefa no Asana.

Parâmetros:

taskId (string, obrigatório): ID da Tarefa - O ID da tarefa a ser atualizada.
completeStatus (string, opcional): Status de Conclusão.
- Opções: true, false
name (string, opcional): Nome (exemplo: “Nome da Tarefa”).
notes (string, opcional): Notas.
dueOnDate (string, opcional): Data de Vencimento - A data em que esta tarefa deve ser concluída. Não pode ser usada junto com Due At. (exemplo: “YYYY-MM-DD”).
dueAtDate (string, opcional): Vence Em - A data e hora (timestamp ISO) em que esta tarefa deve ser concluída. Não pode ser usada junto com Due On. (exemplo: “2019-09-15T02:06:58.147Z”).
assignee (string, opcional): Responsável - O ID do usuário Asana a quem esta tarefa será atribuída. Use as Configurações de Fluxo do Portal Connect para permitir que usuários selecionem o responsável.
gid (string, opcional): ID Externo - Um ID da sua aplicação para associar a tarefa. Você pode usar este ID para sincronizar atualizações posteriormente.

asana/get_tasks

Descrição: Obtém uma lista de tarefas no Asana.

Parâmetros:

workspace (string, opcional): Área de trabalho - O ID da área de trabalho para filtrar tarefas. Use as Configurações de Fluxo do Portal Connect para permitir que usuários selecionem uma área de trabalho.
project (string, opcional): Projeto - O ID do projeto para filtrar as tarefas. Use as Configurações de Fluxo do Portal Connect para permitir que usuários selecionem um projeto.
assignee (string, opcional): Responsável - O ID do responsável para filtrar tarefas. Use as Configurações de Fluxo do Portal Connect para permitir que usuários selecionem um responsável.
completedSince (string, opcional): Concluída desde - Retorna apenas tarefas que estejam incompletas ou que tenham sido concluídas desde este horário (timestamp ISO ou Unix). (exemplo: “2014-04-25T16:15:47-04:00”).

asana/get_tasks_by_id

Descrição: Obtém uma lista de tarefas pelo ID no Asana.

Parâmetros:

taskId (string, obrigatório): ID da Tarefa.

asana/get_task_by_external_id

Descrição: Obtém uma tarefa pelo ID externo no Asana.

Parâmetros:

gid (string, obrigatório): ID Externo - O ID que esta tarefa está associada ou sincronizada, de sua aplicação.

asana/add_task_to_section

Descrição: Adiciona uma tarefa a uma seção no Asana.

Parâmetros:

sectionId (string, obrigatório): ID da Seção - O ID da seção à qual a tarefa será adicionada.
taskId (string, obrigatório): ID da Tarefa - O ID da tarefa. (exemplo: “1204619611402340”).
beforeTaskId (string, opcional): Antes da Tarefa - O ID de uma tarefa nesta seção antes da qual esta tarefa será inserida. Não pode ser usada junto com After Task ID. (exemplo: “1204619611402340”).
afterTaskId (string, opcional): Após a Tarefa - O ID de uma tarefa nesta seção após a qual esta tarefa será inserida. Não pode ser usada junto com Before Task ID. (exemplo: “1204619611402340”).

asana/get_teams

Descrição: Obtém uma lista de equipes no Asana.

Parâmetros:

workspace (string, obrigatório): Área de trabalho - Retorna as equipes nesta área de trabalho visíveis para o usuário autorizado.

asana/get_workspaces

Descrição: Obtém uma lista de áreas de trabalho do Asana.

Parâmetros: Nenhum obrigatório.

Exemplos de Uso

Configuração Básica do Agente Asana

from crewai import Agent, Task, Crew

# Create an agent with Asana capabilities
asana_agent = Agent(
    role="Project Manager",
    goal="Manage tasks and projects in Asana efficiently",
    backstory="An AI assistant specialized in project management and task coordination.",
    apps=['asana']
)

# Task to create a new project
create_project_task = Task(
    description="Create a new project called 'Q1 Marketing Campaign' in the Marketing workspace",
    agent=asana_agent,
    expected_output="Confirmation that the project was created successfully with project ID"
)

# Run the task
crew = Crew(
    agents=[asana_agent],
    tasks=[create_project_task]
)

crew.kickoff()

Filtrando Ferramentas Específicas do Asana

task_manager_agent = Agent(
    role="Task Manager",
    goal="Create and manage tasks efficiently",
    backstory="An AI assistant that focuses on task creation and management.",
    apps=['asana']
)

# Task to create and assign a task
task_management = Task(
    description="Create a task called 'Review quarterly reports' and assign it to the appropriate team member",
    agent=task_manager_agent,
    expected_output="Task created and assigned successfully"
)

crew = Crew(
    agents=[task_manager_agent],
    tasks=[task_management]
)

crew.kickoff()

Gerenciamento Avançado de Projetos

from crewai import Agent, Task, Crew

project_coordinator = Agent(
    role="Project Coordinator",
    goal="Coordinate project activities and track progress",
    backstory="An experienced project coordinator who ensures projects run smoothly.",
    apps=['asana']
)

# Complex task involving multiple Asana operations
coordination_task = Task(
    description="""
    1. Get all active projects in the workspace
    2. For each project, get the list of incomplete tasks
    3. Create a summary report task in the 'Management Reports' project
    4. Add comments to overdue tasks to request status updates
    """,
    agent=project_coordinator,
    expected_output="Summary report created and status update requests sent for overdue tasks"
)

crew = Crew(
    agents=[project_coordinator],
    tasks=[coordination_task]
)

crew.kickoff()