Framework for orchestrating role-playing, autonomous AI agents. By fostering collaborative intelligence, CrewAI empowers agents to work together seamlessly, tackling complex tasks.
adjust aop to amp docs lang (#4179)
Lorenze Jay25c0c030ce03
diff --git a/README.md b/README.mdindex 56652dd9d..c832d0025 100644--- a/README.md+++ b/README.md@@ -62,9 +62,9 @@With over 100,000 developers certified through our community courses at [learn.crewai.com](https://learn.crewai.com), CrewAI is rapidly becoming thestandard for enterprise-ready AI automation.-# CrewAI AOP Suite+# CrewAI AMP Suite-CrewAI AOP Suite is a comprehensive bundle tailored for organizations that require secure, scalable, and easy-to-manage agent-driven automation.+CrewAI AMP Suite is a comprehensive bundle tailored for organizations that require secure, scalable, and easy-to-manage agent-driven automation.You can try one part of the suite the [Crew Control Plane for free](https://app.crewai.com)@@ -76,9 +76,9 @@ You can try one part of the suite the [Crew Control Plane for free](https://app.- **Advanced Security**: Built-in robust security and compliance measures ensuring safe deployment and management.- **Actionable Insights**: Real-time analytics and reporting to optimize performance and decision-making.- **24/7 Support**: Dedicated enterprise support to ensure uninterrupted operation and quick resolution of issues.-- **On-premise and Cloud Deployment Options**: Deploy CrewAI AOP on-premise or in the cloud, depending on your security and compliance requirements.+- **On-premise and Cloud Deployment Options**: Deploy CrewAI AMP on-premise or in the cloud, depending on your security and compliance requirements.-CrewAI AOP is designed for enterprises seeking a powerful, reliable solution to transform complex business processes into efficient,+CrewAI AMP is designed for enterprises seeking a powerful, reliable solution to transform complex business processes into efficient,intelligent automations.## Table of contents@@ -124,7 +124,8 @@ Setup and run your first CrewAI agents by following this tutorial.[](https://www.youtube.com/watch?v=-kSOTtYzgEw "CrewAI Getting Started Tutorial")###- Learning Resources++Learning ResourcesLearn CrewAI through our comprehensive courses:@@ -141,6 +142,7 @@ CrewAI offers two powerful, complementary approaches that work seamlessly togeth- Dynamic task delegation and collaboration- Specialized roles with defined goals and expertise- Flexible problem-solving approaches+2. **Flows**: Production-ready, event-driven workflows that deliver precise control over complex automations. Flows provide:- Fine-grained control over execution paths for real-world scenarios@@ -187,6 +189,7 @@ If you encounter issues during installation or usage, here are some common solut- Install tiktoken explicitly: `uv pip install 'crewai[embeddings]'`- If using embedchain or other tools: `uv pip install 'crewai[tools]'`+2. **Failed building wheel for tiktoken**- Ensure Rust compiler is installed (see installation steps above)@@ -270,7 +273,7 @@ reporting_analyst:**tasks.yaml**-```yaml+````yaml# src/my_project/config/tasks.yamlresearch_task:description: >@@ -290,7 +293,7 @@ reporting_task:Formatted as markdown without '```'agent: reporting_analystoutput_file: report.md-```+````**crew.py**@@ -556,7 +559,7 @@ Please refer to the [Connect CrewAI to LLMs](https://docs.crewai.com/how-to/LLM-- **LangGraph**: While LangGraph provides a foundation for building agent workflows, its approach requires significant boilerplate code and complex state management patterns. The framework's tight coupling with LangChain can limit flexibility when implementing custom agent behaviors or integrating with external systems.-*P.S. CrewAI demonstrates significant performance advantages over LangGraph, executing 5.76x faster in certain cases like this QA task example ([see comparison](https://github.com/crewAIInc/crewAI-examples/tree/main/Notebooks/CrewAI%20Flows%20%26%20Langgraph/QA%20Agent)) while achieving higher evaluation scores with faster completion times in certain coding tasks, like in this example ([detailed analysis](https://github.com/crewAIInc/crewAI-examples/blob/main/Notebooks/CrewAI%20Flows%20%26%20Langgraph/Coding%20Assistant/coding_assistant_eval.ipynb)).*+_P.S. CrewAI demonstrates significant performance advantages over LangGraph, executing 5.76x faster in certain cases like this QA task example ([see comparison](https://github.com/crewAIInc/crewAI-examples/tree/main/Notebooks/CrewAI%20Flows%20%26%20Langgraph/QA%20Agent)) while achieving higher evaluation scores with faster completion times in certain coding tasks, like in this example ([detailed analysis](https://github.com/crewAIInc/crewAI-examples/blob/main/Notebooks/CrewAI%20Flows%20%26%20Langgraph/Coding%20Assistant/coding_assistant_eval.ipynb))._- **Autogen**: While Autogen excels at creating conversational agents capable of working together, it lacks an inherent concept of process. In Autogen, orchestrating agents' interactions requires additional programming, which can become complex and cumbersome as the scale of tasks grows.- **ChatDev**: ChatDev introduced the idea of processes into the realm of AI agents, but its implementation is quite rigid. Customizations in ChatDev are limited and not geared towards production environments, which can hinder scalability and flexibility in real-world applications.@@ -674,9 +677,9 @@ CrewAI is released under the [MIT License](https://github.com/crewAIInc/crewAI/b### Enterprise Features-- [What additional features does CrewAI AOP offer?](#q-what-additional-features-does-crewai-amp-offer)-- [Is CrewAI AOP available for cloud and on-premise deployments?](#q-is-crewai-amp-available-for-cloud-and-on-premise-deployments)-- [Can I try CrewAI AOP for free?](#q-can-i-try-crewai-amp-for-free)+- [What additional features does CrewAI AMP offer?](#q-what-additional-features-does-crewai-amp-offer)+- [Is CrewAI AMP available for cloud and on-premise deployments?](#q-is-crewai-amp-available-for-cloud-and-on-premise-deployments)+- [Can I try CrewAI AMP for free?](#q-can-i-try-crewai-amp-for-free)### Q: What exactly is CrewAI?@@ -732,17 +735,17 @@ A: Check out practical examples in the [CrewAI-examples repository](https://githA: Contributions are warmly welcomed! Fork the repository, create your branch, implement your changes, and submit a pull request. See the Contribution section of the README for detailed guidelines.-### Q: What additional features does CrewAI AOP offer?+### Q: What additional features does CrewAI AMP offer?-A: CrewAI AOP provides advanced features such as a unified control plane, real-time observability, secure integrations, advanced security, actionable insights, and dedicated 24/7 enterprise support.+A: CrewAI AMP provides advanced features such as a unified control plane, real-time observability, secure integrations, advanced security, actionable insights, and dedicated 24/7 enterprise support.-### Q: Is CrewAI AOP available for cloud and on-premise deployments?+### Q: Is CrewAI AMP available for cloud and on-premise deployments?-A: Yes, CrewAI AOP supports both cloud-based and on-premise deployment options, allowing enterprises to meet their specific security and compliance requirements.+A: Yes, CrewAI AMP supports both cloud-based and on-premise deployment options, allowing enterprises to meet their specific security and compliance requirements.-### Q: Can I try CrewAI AOP for free?+### Q: Can I try CrewAI AMP for free?-A: Yes, you can explore part of the CrewAI AOP Suite by accessing the [Crew Control Plane](https://app.crewai.com) for free.+A: Yes, you can explore part of the CrewAI AMP Suite by accessing the [Crew Control Plane](https://app.crewai.com) for free.### Q: Does CrewAI support fine-tuning or training custom models?@@ -762,7 +765,7 @@ A: CrewAI is highly scalable, supporting simple automations and large-scale ente### Q: Does CrewAI offer debugging and monitoring tools?-A: Yes, CrewAI AOP includes advanced debugging, tracing, and real-time observability features, simplifying the management and troubleshooting of your automations.+A: Yes, CrewAI AMP includes advanced debugging, tracing, and real-time observability features, simplifying the management and troubleshooting of your automations.### Q: What programming languages does CrewAI support?diff --git a/docs/docs.json b/docs/docs.jsonindex 29a35f1c2..d9e5762a1 100644--- a/docs/docs.json+++ b/docs/docs.json@@ -329,7 +329,7 @@]},{- "tab": "AOP",+ "tab": "AMP","icon": "briefcase","groups": [{@@ -759,7 +759,7 @@]},{- "tab": "AOP",+ "tab": "AMP","icon": "briefcase","groups": [{diff --git a/docs/en/api-reference/introduction.mdx b/docs/en/api-reference/introduction.mdxindex 5c4597721..45ccac71e 100644--- a/docs/en/api-reference/introduction.mdx+++ b/docs/en/api-reference/introduction.mdx@@ -1,19 +1,19 @@---title: "Introduction"-description: "Complete reference for the CrewAI AOP REST API"+description: "Complete reference for the CrewAI AMP REST API"icon: "code"mode: "wide"----# CrewAI AOP API+# CrewAI AMP API-Welcome to the CrewAI AOP API reference. This API allows you to programmatically interact with your deployed crews, enabling integration with your applications, workflows, and services.+Welcome to the CrewAI AMP API reference. This API allows you to programmatically interact with your deployed crews, enabling integration with your applications, workflows, and services.## Quick Start<Steps><Step title="Get Your API Credentials">- Navigate to your crew's detail page in the CrewAI AOP dashboard and copy your Bearer Token from the Status tab.+ Navigate to your crew's detail page in the CrewAI AMP dashboard and copy your Bearer Token from the Status tab.</Step><Step title="Discover Required Inputs">@@ -48,7 +48,7 @@ curl -H "Authorization: Bearer YOUR_CREW_TOKEN" \<Tip>You can find both token types in the Status tab of your crew's detail page in- the CrewAI AOP dashboard.+ the CrewAI AMP dashboard.</Tip>## Base URL@@ -84,7 +84,7 @@ The API uses standard HTTP status codes:## Interactive Testing<Info>- **Why no "Send" button?** Since each CrewAI AOP user has their own unique crew+ **Why no "Send" button?** Since each CrewAI AMP user has their own unique crewURL, we use **reference mode** instead of an interactive playground to avoidconfusion. This shows you exactly what the requests should look like withoutnon-functional send buttons.diff --git a/docs/en/concepts/agents.mdx b/docs/en/concepts/agents.mdxindex e032e3f5f..5240c5a9f 100644--- a/docs/en/concepts/agents.mdx+++ b/docs/en/concepts/agents.mdx@@ -8,6 +8,7 @@ mode: "wide"## Overview of an AgentIn the CrewAI framework, an `Agent` is an autonomous unit that can:+- Perform specific tasks- Make decisions based on its role and goal- Use tools to accomplish objectives@@ -16,15 +17,19 @@ In the CrewAI framework, an `Agent` is an autonomous unit that can:- Delegate tasks when allowed<Tip>-Think of an agent as a specialized team member with specific skills, expertise, and responsibilities. For example, a `Researcher` agent might excel at gathering and analyzing information, while a `Writer` agent might be better at creating content.+ Think of an agent as a specialized team member with specific skills,+ expertise, and responsibilities. For example, a `Researcher` agent might excel+ at gathering and analyzing information, while a `Writer` agent might be better+ at creating content.</Tip><Note type="info" title="Enterprise Enhancement: Visual Agent Builder">-CrewAI AOP includes a Visual Agent Builder that simplifies agent creation and configuration without writing code. Design your agents visually and test them in real-time.+CrewAI AMP includes a Visual Agent Builder that simplifies agent creation and configuration without writing code. Design your agents visually and test them in real-time.The Visual Agent Builder enables:+- Intuitive agent configuration with form-based interfaces- Real-time testing and validation- Template library with pre-configured agent types@@ -33,36 +38,36 @@ The Visual Agent Builder enables:## Agent Attributes-| Attribute | Parameter | Type | Description |-| :-------------------------------------- | :----------------------- | :---------------------------- | :------------------------------------------------------------------------------------------------------------------- |-| **Role** | `role` | `str` | Defines the agent's function and expertise within the crew. |-| **Goal** | `goal` | `str` | The individual objective that guides the agent's decision-making. |-| **Backstory** | `backstory` | `str` | Provides context and personality to the agent, enriching interactions. |-| **LLM** _(optional)_ | `llm` | `Union[str, LLM, Any]` | Language model that powers the agent. Defaults to the model specified in `OPENAI_MODEL_NAME` or "gpt-4". |-| **Tools** _(optional)_ | `tools` | `List[BaseTool]` | Capabilities or functions available to the agent. Defaults to an empty list. |-| **Function Calling LLM** _(optional)_ | `function_calling_llm` | `Optional[Any]` | Language model for tool calling, overrides crew's LLM if specified. |-| **Max Iterations** _(optional)_ | `max_iter` | `int` | Maximum iterations before the agent must provide its best answer. Default is 20. |-| **Max RPM** _(optional)_ | `max_rpm` | `Optional[int]` | Maximum requests per minute to avoid rate limits. |-| **Max Execution Time** _(optional)_ | `max_execution_time` | `Optional[int]` | Maximum time (in seconds) for task execution. |-| **Verbose** _(optional)_ | `verbose` | `bool` | Enable detailed execution logs for debugging. Default is False. |-| **Allow Delegation** _(optional)_ | `allow_delegation` | `bool` | Allow the agent to delegate tasks to other agents. Default is False. |-| **Step Callback** _(optional)_ | `step_callback` | `Optional[Any]` | Function called after each agent step, overrides crew callback. |-| **Cache** _(optional)_ | `cache` | `bool` | Enable caching for tool usage. Default is True. |-| **System Template** _(optional)_ | `system_template` | `Optional[str]` | Custom system prompt template for the agent. |-| **Prompt Template** _(optional)_ | `prompt_template` | `Optional[str]` | Custom prompt template for the agent. |-| **Response Template** _(optional)_ | `response_template` | `Optional[str]` | Custom response template for the agent. |-| **Allow Code Execution** _(optional)_ | `allow_code_execution` | `Optional[bool]` | Enable code execution for the agent. Default is False. |-| **Max Retry Limit** _(optional)_ | `max_retry_limit` | `int` | Maximum number of retries when an error occurs. Default is 2. |-| **Respect Context Window** _(optional)_ | `respect_context_window` | `bool` | Keep messages under context window size by summarizing. Default is True. |-| **Code Execution Mode** _(optional)_ | `code_execution_mode` | `Literal["safe", "unsafe"]` | Mode for code execution: 'safe' (using Docker) or 'unsafe' (direct). Default is 'safe'. |-| **Multimodal** _(optional)_ | `multimodal` | `bool` | Whether the agent supports multimodal capabilities. Default is False. |-| **Inject Date** _(optional)_ | `inject_date` | `bool` | Whether to automatically inject the current date into tasks. Default is False. |-| **Date Format** _(optional)_ | `date_format` | `str` | Format string for date when inject_date is enabled. Default is "%Y-%m-%d" (ISO format). |-| **Reasoning** _(optional)_ | `reasoning` | `bool` | Whether the agent should reflect and create a plan before executing a task. Default is False. |-| **Max Reasoning Attempts** _(optional)_ | `max_reasoning_attempts` | `Optional[int]` | Maximum number of reasoning attempts before executing the task. If None, will try until ready. |-| **Embedder** _(optional)_ | `embedder` | `Optional[Dict[str, Any]]` | Configuration for the embedder used by the agent. |-| **Knowledge Sources** _(optional)_ | `knowledge_sources` | `Optional[List[BaseKnowledgeSource]]` | Knowledge sources available to the agent. |-| **Use System Prompt** _(optional)_ | `use_system_prompt` | `Optional[bool]` | Whether to use system prompt (for o1 model support). Default is True. |+| Attribute | Parameter | Type | Description |+| :-------------------------------------- | :----------------------- | :------------------------------------ | :------------------------------------------------------------------------------------------------------- |+| **Role** | `role` | `str` | Defines the agent's function and expertise within the crew. |+| **Goal** | `goal` | `str` | The individual objective that guides the agent's decision-making. |+| **Backstory** | `backstory` | `str` | Provides context and personality to the agent, enriching interactions. |+| **LLM** _(optional)_ | `llm` | `Union[str, LLM, Any]` | Language model that powers the agent. Defaults to the model specified in `OPENAI_MODEL_NAME` or "gpt-4". |+| **Tools** _(optional)_ | `tools` | `List[BaseTool]` | Capabilities or functions available to the agent. Defaults to an empty list. |+| **Function Calling LLM** _(optional)_ | `function_calling_llm` | `Optional[Any]` | Language model for tool calling, overrides crew's LLM if specified. |+| **Max Iterations** _(optional)_ | `max_iter` | `int` | Maximum iterations before the agent must provide its best answer. Default is 20. |+| **Max RPM** _(optional)_ | `max_rpm` | `Optional[int]` | Maximum requests per minute to avoid rate limits. |+| **Max Execution Time** _(optional)_ | `max_execution_time` | `Optional[int]` | Maximum time (in seconds) for task execution. |+| **Verbose** _(optional)_ | `verbose` | `bool` | Enable detailed execution logs for debugging. Default is False. |+| **Allow Delegation** _(optional)_ | `allow_delegation` | `bool` | Allow the agent to delegate tasks to other agents. Default is False. |+| **Step Callback** _(optional)_ | `step_callback` | `Optional[Any]` | Function called after each agent step, overrides crew callback. |+| **Cache** _(optional)_ | `cache` | `bool` | Enable caching for tool usage. Default is True. |+| **System Template** _(optional)_ | `system_template` | `Optional[str]` | Custom system prompt template for the agent. |+| **Prompt Template** _(optional)_ | `prompt_template` | `Optional[str]` | Custom prompt template for the agent. |+| **Response Template** _(optional)_ | `response_template` | `Optional[str]` | Custom response template for the agent. |+| **Allow Code Execution** _(optional)_ | `allow_code_execution` | `Optional[bool]` | Enable code execution for the agent. Default is False. |+| **Max Retry Limit** _(optional)_ | `max_retry_limit` | `int` | Maximum number of retries when an error occurs. Default is 2. |+| **Respect Context Window** _(optional)_ | `respect_context_window` | `bool` | Keep messages under context window size by summarizing. Default is True. |+| **Code Execution Mode** _(optional)_ | `code_execution_mode` | `Literal["safe", "unsafe"]` | Mode for code execution: 'safe' (using Docker) or 'unsafe' (direct). Default is 'safe'. |+| **Multimodal** _(optional)_ | `multimodal` | `bool` | Whether the agent supports multimodal capabilities. Default is False. |+| **Inject Date** _(optional)_ | `inject_date` | `bool` | Whether to automatically inject the current date into tasks. Default is False. |+| **Date Format** _(optional)_ | `date_format` | `str` | Format string for date when inject_date is enabled. Default is "%Y-%m-%d" (ISO format). |+| **Reasoning** _(optional)_ | `reasoning` | `bool` | Whether the agent should reflect and create a plan before executing a task. Default is False. |+| **Max Reasoning Attempts** _(optional)_ | `max_reasoning_attempts` | `Optional[int]` | Maximum number of reasoning attempts before executing the task. If None, will try until ready. |+| **Embedder** _(optional)_ | `embedder` | `Optional[Dict[str, Any]]` | Configuration for the embedder used by the agent. |+| **Knowledge Sources** _(optional)_ | `knowledge_sources` | `Optional[List[BaseKnowledgeSource]]` | Knowledge sources available to the agent. |+| **Use System Prompt** _(optional)_ | `use_system_prompt` | `Optional[bool]` | Whether to use system prompt (for o1 model support). Default is True. |## Creating Agents@@ -137,7 +142,8 @@ class LatestAiDevelopmentCrew():```<Note>-The names you use in your YAML files (`agents.yaml`) should match the method names in your Python code.+ The names you use in your YAML files (`agents.yaml`) should match the method+ names in your Python code.</Note>### Direct Code Definition@@ -184,6 +190,7 @@ agent = Agent(Let's break down some key parameter combinations for common use cases:#### Basic Research Agent+```python Coderesearch_agent = Agent(role="Research Analyst",@@ -195,6 +202,7 @@ research_agent = Agent(```#### Code Development Agent+```python Codedev_agent = Agent(role="Senior Python Developer",@@ -208,6 +216,7 @@ dev_agent = Agent(```#### Long-Running Analysis Agent+```python Codeanalysis_agent = Agent(role="Data Analyst",@@ -221,6 +230,7 @@ analysis_agent = Agent(```#### Custom Template Agent+```python Codecustom_agent = Agent(role="Customer Service Representative",@@ -236,6 +246,7 @@ custom_agent = Agent(```#### Date-Aware Agent with Reasoning+```python Codestrategic_agent = Agent(role="Market Analyst",@@ -250,6 +261,7 @@ strategic_agent = Agent(```#### Reasoning Agent+```python Codereasoning_agent = Agent(role="Strategic Planner",@@ -263,6 +275,7 @@ reasoning_agent = Agent(```#### Multimodal Agent+```python Codemultimodal_agent = Agent(role="Visual Content Analyst",@@ -276,52 +289,64 @@ multimodal_agent = Agent(### Parameter Details#### Critical Parameters+- `role`, `goal`, and `backstory` are required and shape the agent's behavior- `llm` determines the language model used (default: OpenAI's GPT-4)#### Memory and Context+- `memory`: Enable to maintain conversation history- `respect_context_window`: Prevents token limit issues- `knowledge_sources`: Add domain-specific knowledge bases#### Execution Control+- `max_iter`: Maximum attempts before giving best answer- `max_execution_time`: Timeout in seconds- `max_rpm`: Rate limiting for API calls- `max_retry_limit`: Retries on error#### Code Execution+- `allow_code_execution`: Must be True to run code- `code_execution_mode`:- `"safe"`: Uses Docker (recommended for production)- `"unsafe"`: Direct execution (use only in trusted environments)<Note>- This runs a default Docker image. If you want to configure the docker image, the checkout the Code Interpreter Tool in the tools section.- Add the code interpreter tool as a tool in the agent as a tool parameter.- </Note>+ This runs a default Docker image. If you want to configure the docker image,+ the checkout the Code Interpreter Tool in the tools section. Add the code+ interpreter tool as a tool in the agent as a tool parameter.+</Note>#### Advanced Features+- `multimodal`: Enable multimodal capabilities for processing text and visual content- `reasoning`: Enable agent to reflect and create plans before executing tasks- `inject_date`: Automatically inject current date into task descriptions#### Templates+- `system_template`: Defines agent's core behavior- `prompt_template`: Structures input format- `response_template`: Formats agent responses<Note>-When using custom templates, ensure that both `system_template` and `prompt_template` are defined. The `response_template` is optional but recommended for consistent output formatting.+ When using custom templates, ensure that both `system_template` and+ `prompt_template` are defined. The `response_template` is optional but+ recommended for consistent output formatting.</Note><Note>-When using custom templates, you can use variables like `{role}`, `{goal}`, and `{backstory}` in your templates. These will be automatically populated during execution.+ When using custom templates, you can use variables like `{role}`, `{goal}`,+ and `{backstory}` in your templates. These will be automatically populated+ during execution.</Note>## Agent ToolsAgents can be equipped with various tools to enhance their capabilities. CrewAI supports tools from:+- [CrewAI Toolkit](https://github.com/joaomdmoura/crewai-tools)- [LangChain Tools](https://python.langchain.com/docs/integrations/tools)@@ -360,7 +385,8 @@ analyst = Agent(```<Note>-When `memory` is enabled, the agent will maintain context across multiple interactions, improving its ability to handle complex, multi-step tasks.+ When `memory` is enabled, the agent will maintain context across multiple+ interactions, improving its ability to handle complex, multi-step tasks.</Note>## Context Window Management@@ -390,6 +416,7 @@ smart_agent = Agent(```**What happens when context limits are exceeded:**+- ⚠️ **Warning message**: `"Context length exceeded. Summarizing content to fit the model context window."`- 🔄 **Automatic summarization**: CrewAI intelligently summarizes the conversation history- ✅ **Continued execution**: Task execution continues seamlessly with the summarized context@@ -411,6 +438,7 @@ strict_agent = Agent(```**What happens when context limits are exceeded:**+- ❌ **Error message**: `"Context length exceeded. Consider using smaller text or RAG tools from crewai_tools."`- 🛑 **Execution stops**: Task execution halts immediately- 🔧 **Manual intervention required**: You need to modify your approach@@ -418,6 +446,7 @@ strict_agent = Agent(### Choosing the Right Setting#### Use `respect_context_window=True` (Default) when:+- **Processing large documents** that might exceed context limits- **Long-running conversations** where some summarization is acceptable- **Research tasks** where general context is more important than exact details@@ -436,6 +465,7 @@ document_processor = Agent(```#### Use `respect_context_window=False` when:+- **Precision is critical** and information loss is unacceptable- **Legal or medical tasks** requiring complete context- **Code review** where missing details could introduce bugs@@ -458,6 +488,7 @@ precision_agent = Agent(When dealing with very large datasets, consider these strategies:#### 1. Use RAG Tools+```python Codefrom crewai_tools import RagTool@@ -475,6 +506,7 @@ rag_agent = Agent(```#### 2. Use Knowledge Sources+```python Code# Use knowledge sources instead of large promptsknowledge_agent = Agent(@@ -498,6 +530,7 @@ knowledge_agent = Agent(### Troubleshooting Context Issues**If you're getting context limit errors:**+```python Code# Quick fix: Enable automatic handlingagent.respect_context_window = True@@ -511,6 +544,7 @@ agent.tools = [RagTool()]```**If automatic summarization loses important information:**+```python Code# Disable auto-summarization and use RAG insteadagent = Agent(@@ -524,7 +558,10 @@ agent = Agent(```<Note>-The context window management feature works automatically in the background. You don't need to call any special functions - just set `respect_context_window` to your preferred behavior and CrewAI handles the rest!+ The context window management feature works automatically in the background.+ You don't need to call any special functions - just set+ `respect_context_window` to your preferred behavior and CrewAI handles the+ rest!</Note>## Direct Agent Interaction with `kickoff()`@@ -556,10 +593,10 @@ print(result.raw)### Parameters and Return Values-| Parameter | Type | Description |-| :---------------- | :---------------------------------- | :------------------------------------------------------------------------ |-| `messages` | `Union[str, List[Dict[str, str]]]` | Either a string query or a list of message dictionaries with role/content |-| `response_format` | `Optional[Type[Any]]` | Optional Pydantic model for structured output |+| Parameter | Type | Description |+| :---------------- | :--------------------------------- | :------------------------------------------------------------------------ |+| `messages` | `Union[str, List[Dict[str, str]]]` | Either a string query or a list of message dictionaries with role/content |+| `response_format` | `Optional[Type[Any]]` | Optional Pydantic model for structured output |The method returns a `LiteAgentOutput` object with the following properties:@@ -621,28 +658,34 @@ asyncio.run(main())```<Note>-The `kickoff()` method uses a `LiteAgent` internally, which provides a simpler execution flow while preserving all of the agent's configuration (role, goal, backstory, tools, etc.).+ The `kickoff()` method uses a `LiteAgent` internally, which provides a simpler+ execution flow while preserving all of the agent's configuration (role, goal,+ backstory, tools, etc.).</Note>## Important Considerations and Best Practices### Security and Code Execution+- When using `allow_code_execution`, be cautious with user input and always validate it- Use `code_execution_mode: "safe"` (Docker) in production environments- Consider setting appropriate `max_execution_time` limits to prevent infinite loops### Performance Optimization+- Use `respect_context_window: true` to prevent token limit issues- Set appropriate `max_rpm` to avoid rate limiting- Enable `cache: true` to improve performance for repetitive tasks- Adjust `max_iter` and `max_retry_limit` based on task complexity### Memory and Context Management+- Leverage `knowledge_sources` for domain-specific information- Configure `embedder` when using custom embedding models- Use custom templates (`system_template`, `prompt_template`, `response_template`) for fine-grained control over agent behavior### Advanced Features+- Enable `reasoning: true` for agents that need to plan and reflect before executing complex tasks- Set appropriate `max_reasoning_attempts` to control planning iterations (None for unlimited attempts)- Use `inject_date: true` to provide agents with current date awareness for time-sensitive tasks@@ -650,6 +693,7 @@ The `kickoff()` method uses a `LiteAgent` internally, which provides a simpler e- Enable `multimodal: true` for agents that need to process both text and visual content### Agent Collaboration+- Enable `allow_delegation: true` when agents need to work together- Use `step_callback` to monitor and log agent interactions- Consider using different LLMs for different purposes:@@ -657,6 +701,7 @@ The `kickoff()` method uses a `LiteAgent` internally, which provides a simpler e- `function_calling_llm` for efficient tool usage### Date Awareness and Reasoning+- Use `inject_date: true` to provide agents with current date awareness for time-sensitive tasks- Customize the date format with `date_format` using standard Python datetime format codes- Valid format codes include: %Y (year), %m (month), %d (day), %B (full month name), etc.@@ -664,22 +709,26 @@ The `kickoff()` method uses a `LiteAgent` internally, which provides a simpler e- Enable `reasoning: true` for complex tasks that benefit from upfront planning and reflection### Model Compatibility+- Set `use_system_prompt: false` for older models that don't support system messages- Ensure your chosen `llm` supports the features you need (like function calling)## Troubleshooting Common Issues1. **Rate Limiting**: If you're hitting API rate limits:+- Implement appropriate `max_rpm`- Use caching for repetitive operations- Consider batching requests2. **Context Window Errors**: If you're exceeding context limits:+- Enable `respect_context_window`- Use more efficient prompts- Clear agent memory periodically3. **Code Execution Issues**: If code execution fails:+- Verify Docker is installed for safe mode- Check execution permissions- Review code sandbox settingsdiff --git a/docs/en/concepts/cli.mdx b/docs/en/concepts/cli.mdxindex 7493faca5..5c507f614 100644--- a/docs/en/concepts/cli.mdx+++ b/docs/en/concepts/cli.mdx@@ -5,7 +5,12 @@ icon: terminalmode: "wide"----<Warning>Since release 0.140.0, CrewAI AOP started a process of migrating their login provider. As such, the authentication flow via CLI was updated. Users that use Google to login, or that created their account after July 3rd, 2025 will be unable to log in with older versions of the `crewai` library.</Warning>+<Warning>+ Since release 0.140.0, CrewAI AMP started a process of migrating their login+ provider. As such, the authentication flow via CLI was updated. Users that use+ Google to login, or that created their account after July 3rd, 2025 will be+ unable to log in with older versions of the `crewai` library.+</Warning>## Overview@@ -41,6 +46,7 @@ crewai create [OPTIONS] TYPE NAME- `NAME`: Name of the crew or flowExample:+```shell Terminalcrewai create crew my_new_crewcrewai create flow my_new_flow@@ -57,6 +63,7 @@ crewai version [OPTIONS]- `--tools`: (Optional) Show the installed version of CrewAI toolsExample:+```shell Terminalcrewai versioncrewai version --tools@@ -74,6 +81,7 @@ crewai train [OPTIONS]- `-f, --filename TEXT`: Path to a custom file for training (default: "trained_agents_data.pkl")Example:+```shell Terminalcrewai train -n 10 -f my_training_data.pkl```@@ -89,6 +97,7 @@ crewai replay [OPTIONS]- `-t, --task_id TEXT`: Replay the crew from this task ID, including all subsequent tasksExample:+```shell Terminalcrewai replay -t task_123456```@@ -118,6 +127,7 @@ crewai reset-memories [OPTIONS]- `-a, --all`: Reset ALL memoriesExample:+```shell Terminalcrewai reset-memories --long --shortcrewai reset-memories --all@@ -135,6 +145,7 @@ crewai test [OPTIONS]- `-m, --model TEXT`: LLM Model to run the tests on the Crew (default: "gpt-4o-mini")Example:+```shell Terminalcrewai test -n 5 -m gpt-3.5-turbo```@@ -148,12 +159,16 @@ crewai run```<Note>-Starting from version 0.103.0, the `crewai run` command can be used to run both standard crews and flows. For flows, it automatically detects the type from pyproject.toml and runs the appropriate command. This is now the recommended way to run both crews and flows.+ Starting from version 0.103.0, the `crewai run` command can be used to run+ both standard crews and flows. For flows, it automatically detects the type+ from pyproject.toml and runs the appropriate command. This is now the+ recommended way to run both crews and flows.</Note><Note>-Make sure to run these commands from the directory where your CrewAI project is set up.-Some commands may require additional configuration or setup within your project structure.+ Make sure to run these commands from the directory where your CrewAI project+ is set up. Some commands may require additional configuration or setup within+ your project structure.</Note>### 9. Chat@@ -165,6 +180,7 @@ After receiving the results, you can continue interacting with the assistant for```shell Terminalcrewai chat```+<Note>Ensure you execute these commands from your CrewAI project's root directory.</Note>@@ -182,28 +198,30 @@ def crew(self) -> Crew:chat_llm="gpt-4o", # LLM for chat orchestration)```+</Note>### 10. Deploy-Deploy the crew or flow to [CrewAI AOP](https://app.crewai.com).+Deploy the crew or flow to [CrewAI AMP](https://app.crewai.com).++- **Authentication**: You need to be authenticated to deploy to CrewAI AMP.+ You can login or create an account with:-- **Authentication**: You need to be authenticated to deploy to CrewAI AOP.- You can login or create an account with:- ```shell Terminal- crewai login- ```+ ```shell Terminal+ crewai login+ ```- **Create a deployment**: Once you are authenticated, you can create a deployment for your crew or flow from the root of your localproject.- ```shell Terminal- crewai deploy create- ```- - Reads your local project configuration.- - Prompts you to confirm the environment variables (like `OPENAI_API_KEY`, `SERPER_API_KEY`) found locally. These will be securely stored with the deployment on the Enterprise platform. Ensure your sensitive keys are correctly configured locally (e.g., in a `.env` file) before running this.+ ```shell Terminal+ crewai deploy create+ ```+ - Reads your local project configuration.+ - Prompts you to confirm the environment variables (like `OPENAI_API_KEY`, `SERPER_API_KEY`) found locally. These will be securely stored with the deployment on the Enterprise platform. Ensure your sensitive keys are correctly configured locally (e.g., in a `.env` file) before running this.### 11. Organization Management-Manage your CrewAI AOP organizations.+Manage your CrewAI AMP organizations.```shell Terminalcrewai org [COMMAND] [OPTIONS]@@ -212,65 +230,80 @@ crewai org [COMMAND] [OPTIONS]#### Commands:- `list`: List all organizations you belong to+```shell Terminalcrewai org list```- `current`: Display your currently active organization+```shell Terminalcrewai org current```- `switch`: Switch to a specific organization+```shell Terminalcrewai org switch <organization_id>```<Note>-You must be authenticated to CrewAI AOP to use these organization management commands.+ You must be authenticated to CrewAI AMP to use these organization management+ commands.</Note>- **Create a deployment** (continued):- - Links the deployment to the corresponding remote GitHub repository (it usually detects this automatically).-- **Deploy the Crew**: Once you are authenticated, you can deploy your crew or flow to CrewAI AOP.- ```shell Terminal- crewai deploy push- ```- - Initiates the deployment process on the CrewAI AOP platform.- - Upon successful initiation, it will output the Deployment created successfully! message along with the Deployment Name and a unique Deployment ID (UUID).+ - Links the deployment to the corresponding remote GitHub repository (it usually detects this automatically).++- **Deploy the Crew**: Once you are authenticated, you can deploy your crew or flow to CrewAI AMP.++ ```shell Terminal+ crewai deploy push+ ```++ - Initiates the deployment process on the CrewAI AMP platform.+ - Upon successful initiation, it will output the Deployment created successfully! message along with the Deployment Name and a unique Deployment ID (UUID).- **Deployment Status**: You can check the status of your deployment with:- ```shell Terminal- crewai deploy status- ```- This fetches the latest deployment status of your most recent deployment attempt (e.g., `Building Images for Crew`, `Deploy Enqueued`, `Online`).++ ```shell Terminal+ crewai deploy status+ ```++ This fetches the latest deployment status of your most recent deployment attempt (e.g., `Building Images for Crew`, `Deploy Enqueued`, `Online`).- **Deployment Logs**: You can check the logs of your deployment with:- ```shell Terminal- crewai deploy logs- ```- This streams the deployment logs to your terminal.++ ```shell Terminal+ crewai deploy logs+ ```++ This streams the deployment logs to your terminal.- **List deployments**: You can list all your deployments with:- ```shell Terminal- crewai deploy list- ```- This lists all your deployments.++ ```shell Terminal+ crewai deploy list+ ```++ This lists all your deployments.- **Delete a deployment**: You can delete a deployment with:- ```shell Terminal- crewai deploy remove- ```- This deletes the deployment from the CrewAI AOP platform.++ ```shell Terminal+ crewai deploy remove+ ```++ This deletes the deployment from the CrewAI AMP platform.- **Help Command**: You can get help with the CLI with:- ```shell Terminal- crewai deploy --help- ```- This shows the help message for the CrewAI Deploy CLI.+ ```shell Terminal+ crewai deploy --help+ ```+ This shows the help message for the CrewAI Deploy CLI.-Watch this video tutorial for a step-by-step demonstration of deploying your crew to [CrewAI AOP](http://app.crewai.com) using the CLI.+Watch this video tutorial for a step-by-step demonstration of deploying your crew to [CrewAI AMP](http://app.crewai.com) using the CLI.<iframeclassName="w-full aspect-video rounded-xl"@@ -283,25 +316,27 @@ Watch this video tutorial for a step-by-step demonstration of deploying your cre### 11. Login-Authenticate with CrewAI AOP using a secure device code flow (no email entry required).+Authenticate with CrewAI AMP using a secure device code flow (no email entry required).```shell Terminalcrewai login```What happens:+- A verification URL and short code are displayed in your terminal- Your browser opens to the verification URL- Enter/confirm the code to complete authenticationNotes:+- The OAuth2 provider and domain are configured via `crewai config` (defaults use `login.crewai.com`)- After successful login, the CLI also attempts to authenticate to the Tool Repository automatically- If you reset your configuration, run `crewai login` again to re-authenticate### 12. API Keys-When running ```crewai create crew``` command, the CLI will show you a list of available LLM providers to choose from, followed by model selection for your chosen provider.+When running `crewai create crew` command, the CLI will show you a list of available LLM providers to choose from, followed by model selection for your chosen provider.Once you've selected an LLM provider and model, you will be prompted for API keys.@@ -309,11 +344,11 @@ Once you've selected an LLM provider and model, you will be prompted for API keyHere's a list of the most popular LLM providers suggested by the CLI:-* OpenAI-* Groq-* Anthropic-* Google Gemini-* SambaNova+- OpenAI+- Groq+- Anthropic+- Google Gemini+- SambaNovaWhen you select a provider, the CLI will then show you available models for that provider and prompt you to enter your API key.@@ -325,7 +360,7 @@ When you select a provider, the CLI will prompt you to enter the Key name and thSee the following link for each provider's key name:-* [LiteLLM Providers](https://docs.litellm.ai/docs/providers)+- [LiteLLM Providers](https://docs.litellm.ai/docs/providers)### 13. Configuration Management@@ -338,23 +373,26 @@ crewai config [COMMAND] [OPTIONS]#### Commands:- `list`: Display all CLI configuration parameters+```shell Terminalcrewai config list```- `set`: Set a CLI configuration parameter+```shell Terminalcrewai config set <key> <value>```- `reset`: Reset all CLI configuration parameters to default values+```shell Terminalcrewai config reset```#### Available Configuration Parameters-- `enterprise_base_url`: Base URL of the CrewAI AOP instance+- `enterprise_base_url`: Base URL of the CrewAI AMP instance- `oauth2_provider`: OAuth2 provider used for authentication (e.g., workos, okta, auth0)- `oauth2_audience`: OAuth2 audience value, typically used to identify the target API or resource- `oauth2_client_id`: OAuth2 client ID issued by the provider, used during authentication requests@@ -363,43 +401,48 @@ crewai config reset#### ExamplesDisplay current configuration:+```shell Terminalcrewai config list```Example output:-| Setting | Value | Description |+| Setting | Value | Description || :------------------ | :----------------------- | :---------------------------------------------------------- |-| enterprise_base_url | https://app.crewai.com | Base URL of the CrewAI AOP instance |-| org_name | Not set | Name of the currently active organization |-| org_uuid | Not set | UUID of the currently active organization |-| oauth2_provider | workos | OAuth2 provider (e.g., workos, okta, auth0) |-| oauth2_audience | client_01YYY | Audience identifying the target API/resource |-| oauth2_client_id | client_01XXX | OAuth2 client ID issued by the provider |-| oauth2_domain | login.crewai.com | Provider domain (e.g., your-org.auth0.com) |+| enterprise_base_url | https://app.crewai.com | Base URL of the CrewAI AMP instance |+| org_name | Not set | Name of the currently active organization |+| org_uuid | Not set | UUID of the currently active organization |+| oauth2_provider | workos | OAuth2 provider (e.g., workos, okta, auth0) |+| oauth2_audience | client_01YYY | Audience identifying the target API/resource |+| oauth2_client_id | client_01XXX | OAuth2 client ID issued by the provider |+| oauth2_domain | login.crewai.com | Provider domain (e.g., your-org.auth0.com) |Set the enterprise base URL:+```shell Terminalcrewai config set enterprise_base_url https://my-enterprise.crewai.com```Set OAuth2 provider:+```shell Terminalcrewai config set oauth2_provider auth0```Set OAuth2 domain:+```shell Terminalcrewai config set oauth2_domain my-company.auth0.com```Reset all configuration to defaults:+```shell Terminalcrewai config reset```<Tip>-After resetting configuration, re-run `crewai login` to authenticate again.+ After resetting configuration, re-run `crewai login` to authenticate again.</Tip>### 14. Trace Management@@ -413,16 +456,19 @@ crewai traces [COMMAND]#### Commands:- `enable`: Enable trace collection for crew/flow executions+```shell Terminalcrewai traces enable```- `disable`: Disable trace collection for crew/flow executions+```shell Terminalcrewai traces disable```- `status`: Show current trace collection status+```shell Terminalcrewai traces status```@@ -432,19 +478,23 @@ crewai traces statusTrace collection is controlled by checking three settings in priority order:1. **Explicit flag in code** (highest priority - can enable OR disable):+```pythoncrew = Crew(agents=[...], tasks=[...], tracing=True) # Always enablecrew = Crew(agents=[...], tasks=[...], tracing=False) # Always disablecrew = Crew(agents=[...], tasks=[...]) # Check lower priorities (default)```+- `tracing=True` will **always enable** tracing (overrides everything)- `tracing=False` will **always disable** tracing (overrides everything)- `tracing=None` or omitted will check lower priority settings2. **Environment variable** (second priority):+```envCREWAI_TRACING_ENABLED=true```+- Checked only if `tracing` is not explicitly set to `True` or `False` in code- Set to `true` or `1` to enable tracing@@ -462,21 +512,30 @@ Trace collection is controlled by checking three settings in priority order:- Run `crewai traces enable`**To disable tracing**, use any ONE of these methods:+- Set `tracing=False` in your Crew/Flow code (overrides everything), OR- Remove or set to `false` the `CREWAI_TRACING_ENABLED` env var, OR- Run `crewai traces disable`Higher priority settings override lower ones.+</Note><Tip>-For more information about tracing, see the [Tracing documentation](/observability/tracing).+ For more information about tracing, see the [Tracing+ documentation](/observability/tracing).</Tip><Tip>-CrewAI CLI handles authentication to the Tool Repository automatically when adding packages to your project. Just append `crewai` before any `uv` command to use it. E.g. `crewai uv add requests`. For more information, see [Tool Repository](https://docs.crewai.com/enterprise/features/tool-repository) docs.+ CrewAI CLI handles authentication to the Tool Repository automatically when+ adding packages to your project. Just append `crewai` before any `uv` command+ to use it. E.g. `crewai uv add requests`. For more information, see [Tool+ Repository](https://docs.crewai.com/enterprise/features/tool-repository) docs.</Tip><Note>-Configuration settings are stored in `~/.config/crewai/settings.json`. Some settings like organization name and UUID are read-only and managed through authentication and organization commands. Tool repository related settings are hidden and cannot be set directly by users.+ Configuration settings are stored in `~/.config/crewai/settings.json`. Some+ settings like organization name and UUID are read-only and managed through+ authentication and organization commands. Tool repository related settings are+ hidden and cannot be set directly by users.</Note>diff --git a/docs/en/concepts/event-listener.mdx b/docs/en/concepts/event-listener.mdxindex adb2533da..9d9587967 100644--- a/docs/en/concepts/event-listener.mdx+++ b/docs/en/concepts/event-listener.mdx@@ -1,6 +1,6 @@----title: 'Event Listeners'-description: 'Tap into CrewAI events to build custom integrations and monitoring'+title: "Event Listeners"+description: "Tap into CrewAI events to build custom integrations and monitoring"icon: spinnermode: "wide"---@@ -20,11 +20,12 @@ CrewAI uses an event bus architecture to emit events throughout the execution liWhen specific actions occur in CrewAI (like a Crew starting execution, an Agent completing a task, or a tool being used), the system emits corresponding events. You can register handlers for these events to execute custom code when they occur.<Note type="info" title="Enterprise Enhancement: Prompt Tracing">-CrewAI AOP provides a built-in Prompt Tracing feature that leverages the event system to track, store, and visualize all prompts, completions, and associated metadata. This provides powerful debugging capabilities and transparency into your agent operations.+CrewAI AMP provides a built-in Prompt Tracing feature that leverages the event system to track, store, and visualize all prompts, completions, and associated metadata. This provides powerful debugging capabilities and transparency into your agent operations.With Prompt Tracing you can:+- View the complete history of all prompts sent to your LLM- Track token usage and costs- Debug agent reasoning failures@@ -274,7 +275,6 @@ The structure of the event object depends on the event type, but all events inheAdditional fields vary by event type. For example, `CrewKickoffCompletedEvent` includes `crew_name` and `output` fields.-## Advanced Usage: Scoped HandlersFor temporary event handling (useful for testing or specific operations), you can use the `scoped_handlers` context manager:diff --git a/docs/en/concepts/tasks.mdx b/docs/en/concepts/tasks.mdxindex fc69f07e2..df67e06e1 100644--- a/docs/en/concepts/tasks.mdx+++ b/docs/en/concepts/tasks.mdx@@ -14,11 +14,12 @@ Tasks provide all necessary details for execution, such as a description, the agTasks within CrewAI can be collaborative, requiring multiple agents to work together. This is managed through the task properties and orchestrated by the Crew's process, enhancing teamwork and efficiency.<Note type="info" title="Enterprise Enhancement: Visual Task Builder">-CrewAI AOP includes a Visual Task Builder in Crew Studio that simplifies complex task creation and chaining. Design your task flows visually and test them in real-time without writing code.+CrewAI AMP includes a Visual Task Builder in Crew Studio that simplifies complex task creation and chaining. Design your task flows visually and test them in real-time without writing code.The Visual Task Builder enables:+- Drag-and-drop task creation- Visual task dependencies and flow- Real-time testing and validation@@ -28,10 +29,12 @@ The Visual Task Builder enables:### Task Execution FlowTasks can be executed in two ways:+- **Sequential**: Tasks are executed in the order they are defined- **Hierarchical**: Tasks are assigned to agents based on their roles and expertiseThe execution flow is defined when creating the crew:+```python Codecrew = Crew(agents=[agent1, agent2],@@ -42,30 +45,31 @@ crew = Crew(## Task Attributes-| Attribute | Parameters | Type | Description |-| :------------------------------- | :---------------- | :---------------------------- | :------------------------------------------------------------------------------------------------------------------- |-| **Description** | `description` | `str` | A clear, concise statement of what the task entails. |-| **Expected Output** | `expected_output` | `str` | A detailed description of what the task's completion looks like. |-| **Name** _(optional)_ | `name` | `Optional[str]` | A name identifier for the task. |-| **Agent** _(optional)_ | `agent` | `Optional[BaseAgent]` | The agent responsible for executing the task. |-| **Tools** _(optional)_ | `tools` | `List[BaseTool]` | The tools/resources the agent is limited to use for this task. |-| **Context** _(optional)_ | `context` | `Optional[List["Task"]]` | Other tasks whose outputs will be used as context for this task. |-| **Async Execution** _(optional)_ | `async_execution` | `Optional[bool]` | Whether the task should be executed asynchronously. Defaults to False. |-| **Human Input** _(optional)_ | `human_input` | `Optional[bool]` | Whether the task should have a human review the final answer of the agent. Defaults to False. |-| **Markdown** _(optional)_ | `markdown` | `Optional[bool]` | Whether the task should instruct the agent to return the final answer formatted in Markdown. Defaults to False. |-| **Config** _(optional)_ | `config` | `Optional[Dict[str, Any]]` | Task-specific configuration parameters. |-| **Output File** _(optional)_ | `output_file` | `Optional[str]` | File path for storing the task output. |-| **Create Directory** _(optional)_ | `create_directory` | `Optional[bool]` | Whether to create the directory for output_file if it doesn't exist. Defaults to True. |-| **Output JSON** _(optional)_ | `output_json` | `Optional[Type[BaseModel]]` | A Pydantic model to structure the JSON output. |-| **Output Pydantic** _(optional)_ | `output_pydantic` | `Optional[Type[BaseModel]]` | A Pydantic model for task output. |-| **Callback** _(optional)_ | `callback` | `Optional[Any]` | Function/object to be executed after task completion. |-| **Guardrail** _(optional)_ | `guardrail` | `Optional[Callable]` | Function to validate task output before proceeding to next task. |-| **Guardrails** _(optional)_ | `guardrails` | `Optional[List[Callable] | List[str]]` | List of guardrails to validate task output before proceeding to next task. |-| **Guardrail Max Retries** _(optional)_ | `guardrail_max_retries` | `Optional[int]` | Maximum number of retries when guardrail validation fails. Defaults to 3. |+| Attribute | Parameters | Type | Description |+| :------------------------------------- | :---------------------- | :-------------------------- | :-------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |+| **Description** | `description` | `str` | A clear, concise statement of what the task entails. |+| **Expected Output** | `expected_output` | `str` | A detailed description of what the task's completion looks like. |+| **Name** _(optional)_ | `name` | `Optional[str]` | A name identifier for the task. |+| **Agent** _(optional)_ | `agent` | `Optional[BaseAgent]` | The agent responsible for executing the task. |+| **Tools** _(optional)_ | `tools` | `List[BaseTool]` | The tools/resources the agent is limited to use for this task. |+| **Context** _(optional)_ | `context` | `Optional[List["Task"]]` | Other tasks whose outputs will be used as context for this task. |+| **Async Execution** _(optional)_ | `async_execution` | `Optional[bool]` | Whether the task should be executed asynchronously. Defaults to False. |+| **Human Input** _(optional)_ | `human_input` | `Optional[bool]` | Whether the task should have a human review the final answer of the agent. Defaults to False. |+| **Markdown** _(optional)_ | `markdown` | `Optional[bool]` | Whether the task should instruct the agent to return the final answer formatted in Markdown. Defaults to False. |+| **Config** _(optional)_ | `config` | `Optional[Dict[str, Any]]` | Task-specific configuration parameters. |+| **Output File** _(optional)_ | `output_file` | `Optional[str]` | File path for storing the task output. |+| **Create Directory** _(optional)_ | `create_directory` | `Optional[bool]` | Whether to create the directory for output_file if it doesn't exist. Defaults to True. |+| **Output JSON** _(optional)_ | `output_json` | `Optional[Type[BaseModel]]` | A Pydantic model to structure the JSON output. |+| **Output Pydantic** _(optional)_ | `output_pydantic` | `Optional[Type[BaseModel]]` | A Pydantic model for task output. |+| **Callback** _(optional)_ | `callback` | `Optional[Any]` | Function/object to be executed after task completion. |+| **Guardrail** _(optional)_ | `guardrail` | `Optional[Callable]` | Function to validate task output before proceeding to next task. |+| **Guardrails** _(optional)_ | `guardrails` | `Optional[List[Callable] | List[str]]` | List of guardrails to validate task output before proceeding to next task. |+| **Guardrail Max Retries** _(optional)_ | `guardrail_max_retries` | `Optional[int]` | Maximum number of retries when guardrail validation fails. Defaults to 3. |<Note type="warning" title="Deprecated: max_retries">The task attribute `max_retries` is deprecated and will be removed in v1.0.0.- Use `guardrail_max_retries` instead to control retry attempts when a guardrail fails.+ Use `guardrail_max_retries` instead to control retry attempts when a guardrail+ fails.</Note>## Creating Tasks@@ -87,7 +91,7 @@ crew.kickoff(inputs={'topic': 'AI Agents'})Here's an example of how to configure tasks using YAML:-```yaml tasks.yaml+````yaml tasks.yamlresearch_task:description: >Conduct a thorough research about {topic}@@ -107,7 +111,7 @@ reporting_task:agent: reporting_analystmarkdown: trueoutput_file: report.md-```+````To use this YAML configuration in your code, create a crew class that inherits from `CrewBase`:@@ -165,7 +169,8 @@ class LatestAiDevelopmentCrew():```<Note>-The names you use in your YAML files (`agents.yaml` and `tasks.yaml`) should match the method names in your Python code.+ The names you use in your YAML files (`agents.yaml` and `tasks.yaml`) should+ match the method names in your Python code.</Note>### Direct Code Definition (Alternative)@@ -202,7 +207,8 @@ reporting_task = Task(```<Tip>- Directly specify an `agent` for assignment or let the `hierarchical` CrewAI's process decide based on roles, availability, etc.+ Directly specify an `agent` for assignment or let the `hierarchical` CrewAI's+ process decide based on roles, availability, etc.</Tip>## Task Output@@ -224,7 +230,7 @@ By default, the `TaskOutput` will only include the `raw` output. A `TaskOutput`| **JSON Dict** | `json_dict` | `Optional[Dict[str, Any]]` | A dictionary representing the JSON output of the task. || **Agent** | `agent` | `str` | The agent that executed the task. || **Output Format** | `output_format` | `OutputFormat` | The format of the task output, with options including RAW, JSON, and Pydantic. The default is RAW. |-| **Messages** | `messages` | `list[LLMMessage]` | The messages from the last task execution. |+| **Messages** | `messages` | `list[LLMMessage]` | The messages from the last task execution. |### Task Methods and Properties@@ -287,12 +293,13 @@ formatted_task = Task(```When `markdown=True`, the agent will receive additional instructions to format the output using:+- `#` for headers- `**text**` for bold text- `*text*` for italic text- `-` or `*` for bullet points- `` `code` `` for inline code-- ``` ```language ``` for code blocks+- ` `language ``` for code blocks### YAML Configuration with Markdown@@ -303,7 +310,7 @@ analysis_task:expected_output: >A comprehensive analysis with charts and key findingsagent: analyst- markdown: true # Enable markdown formatting+ markdown: true # Enable markdown formattingoutput_file: analysis.md```@@ -315,7 +322,9 @@ analysis_task:- **Cross-Platform Compatibility**: Markdown is universally supported<Note>-The markdown formatting instructions are automatically added to the task prompt when `markdown=True`, so you don't need to specify formatting requirements in your task description.+ The markdown formatting instructions are automatically added to the task+ prompt when `markdown=True`, so you don't need to specify formatting+ requirements in your task description.</Note>## Task Dependencies and Context@@ -383,6 +392,7 @@ blog_task = Task(Instead of writing custom validation functions, you can use string descriptions that leverage LLM-based validation. When you provide a string to the `guardrail` or `guardrails` parameter, CrewAI automatically creates an `LLMGuardrail` that uses the agent's LLM to validate the output based on your description.**Requirements**:+- The task must have an `agent` assigned (the guardrail uses the agent's LLM)- Provide a clear, descriptive string explaining the validation criteria@@ -399,11 +409,13 @@ blog_task = Task(```LLM-based guardrails are particularly useful for:+- **Complex validation logic** that's difficult to express programmatically- **Subjective criteria** like tone, style, or quality assessments- **Natural language requirements** that are easier to describe than codeThe LLM guardrail will:+1. Analyze the task output against your description2. Return `(True, output)` if the output complies with the criteria3. Return `(False, feedback)` with specific feedback if validation fails@@ -431,6 +443,7 @@ research_task = Task(You can apply multiple guardrails to a task using the `guardrails` parameter. Multiple guardrails are executed sequentially, with each guardrail receiving the output from the previous one. This allows you to chain validation and transformation steps.The `guardrails` parameter accepts:+- A list of guardrail functions or string descriptions- A single guardrail function or string (same as `guardrail`)@@ -480,6 +493,7 @@ blog_task = Task(```In this example, the guardrails execute in order:+1. `validate_word_count` checks the word count2. `validate_no_profanity` checks for inappropriate language (using the output from step 1)3. `format_output` formats the final result (using the output from step 2)@@ -522,6 +536,7 @@ This approach combines the precision of programmatic validation with the flexibi### Guardrail Function Requirements1. **Function Signature**:+- Must accept exactly one parameter (the task output)- Should return a tuple of `(bool, Any)`- Type hints are recommended but optional@@ -530,11 +545,10 @@ This approach combines the precision of programmatic validation with the flexibi- On success: it returns a tuple of `(bool, Any)`. For example: `(True, validated_result)`- On Failure: it returns a tuple of `(bool, str)`. For example: `(False, "Error message explain the failure")`--### Error Handling Best Practices1. **Structured Error Responses**:+```python Codefrom crewai import TaskOutput, LLMGuardrail@@ -550,11 +564,13 @@ def validate_with_context(result: TaskOutput) -> Tuple[bool, Any]:```2. **Error Categories**:+- Use specific error codes- Include relevant context- Provide actionable feedback3. **Validation Chain**:+```python Codefrom typing import Any, Dict, List, Tuple, Unionfrom crewai import TaskOutput@@ -581,6 +597,7 @@ def complex_validation(result: TaskOutput) -> Tuple[bool, Any]:### Handling Guardrail ResultsWhen a guardrail returns `(False, error)`:+1. The error is sent back to the agent2. The agent attempts to fix the issue3. The process repeats until:@@ -588,6 +605,7 @@ When a guardrail returns `(False, error)`:- Maximum retries are reached (`guardrail_max_retries`)Example with retry handling:+```python Codefrom typing import Optional, Tuple, Unionfrom crewai import TaskOutput, Task@@ -613,10 +631,12 @@ task = Task(## Getting Structured Consistent Outputs from Tasks<Note>-It's also important to note that the output of the final task of a crew becomes the final output of the actual crew itself.+ It's also important to note that the output of the final task of a crew+ becomes the final output of the actual crew itself.</Note>### Using `output_pydantic`+The `output_pydantic` property allows you to define a Pydantic model that the task output should conform to. This ensures that the output is not only structured but also validated according to the Pydantic model.Here's an example demonstrating how to use output_pydantic:@@ -686,18 +706,22 @@ print("Accessing Properties - Option 5")print("Blog:", result)```+In this example:-* A Pydantic model Blog is defined with title and content fields.-* The task task1 uses the output_pydantic property to specify that its output should conform to the Blog model.-* After executing the crew, you can access the structured output in multiple ways as shown.++- A Pydantic model Blog is defined with title and content fields.+- The task task1 uses the output_pydantic property to specify that its output should conform to the Blog model.+- After executing the crew, you can access the structured output in multiple ways as shown.#### Explanation of Accessing the Output-1. Dictionary-Style Indexing: You can directly access the fields using result["field_name"]. This works because the CrewOutput class implements the __getitem__ method.++1. Dictionary-Style Indexing: You can directly access the fields using result["field_name"]. This works because the CrewOutput class implements the **getitem** method.2. Directly from Pydantic Model: Access the attributes directly from the result.pydantic object.3. Using to_dict() Method: Convert the output to a dictionary and access the fields.4. Printing the Entire Object: Simply print the result object to see the structured output.### Using `output_json`+The `output_json` property allows you to define the expected output in JSON format. This ensures that the task's output is a valid JSON structure that can be easily parsed and used in your application.Here's an example demonstrating how to use `output_json`:@@ -757,14 +781,15 @@ print("Blog:", result)```In this example:-* A Pydantic model Blog is defined with title and content fields, which is used to specify the structure of the JSON output.-* The task task1 uses the output_json property to indicate that it expects a JSON output conforming to the Blog model.-* After executing the crew, you can access the structured JSON output in two ways as shown.++- A Pydantic model Blog is defined with title and content fields, which is used to specify the structure of the JSON output.+- The task task1 uses the output_json property to indicate that it expects a JSON output conforming to the Blog model.+- After executing the crew, you can access the structured JSON output in two ways as shown.#### Explanation of Accessing the Output-1. Accessing Properties Using Dictionary-Style Indexing: You can access the fields directly using result["field_name"]. This is possible because the CrewOutput class implements the __getitem__ method, allowing you to treat the output like a dictionary. In this option, we're retrieving the title and content from the result.-2. Printing the Entire Blog Object: By printing result, you get the string representation of the CrewOutput object. Since the __str__ method is implemented to return the JSON output, this will display the entire output as a formatted string representing the Blog object.+1. Accessing Properties Using Dictionary-Style Indexing: You can access the fields directly using result["field_name"]. This is possible because the CrewOutput class implements the **getitem** method, allowing you to treat the output like a dictionary. In this option, we're retrieving the title and content from the result.+2. Printing the Entire Blog Object: By printing result, you get the string representation of the CrewOutput object. Since the **str** method is implemented to return the JSON output, this will display the entire output as a formatted string representing the Blog object.---@@ -954,8 +979,6 @@ While creating and executing tasks, certain validation mechanisms are in place tThese validations help in maintaining the consistency and reliability of task executions within the crewAI framework.--## Creating Directories when Saving FilesThe `create_directory` parameter controls whether CrewAI should automatically create directories when saving task outputs to files. This feature is particularly useful for organizing outputs and ensuring that file paths are correctly structured, especially when working with complex project hierarchies.@@ -1002,7 +1025,7 @@ analysis_task:A comprehensive financial report with quarterly insightsagent: financial_analystoutput_file: reports/quarterly/q4_2024_analysis.pdf- create_directory: true # Automatically create 'reports/quarterly/' directory+ create_directory: true # Automatically create 'reports/quarterly/' directoryaudit_task:description: >@@ -1011,18 +1034,20 @@ audit_task:A compliance audit reportagent: auditoroutput_file: audit/compliance_report.md- create_directory: false # Directory must already exist+ create_directory: false # Directory must already exist```### Use Cases**Automatic Directory Creation (`create_directory=True`):**+- Development and prototyping environments- Dynamic report generation with date-based folders- Automated workflows where directory structure may vary- Multi-tenant applications with user-specific folders**Manual Directory Management (`create_directory=False`):**+- Production environments with strict file system controls- Security-sensitive applications where directories must be pre-configured- Systems with specific permission requirementsdiff --git a/docs/en/concepts/tools.mdx b/docs/en/concepts/tools.mdxindex fdbf73d63..1023d1281 100644--- a/docs/en/concepts/tools.mdx+++ b/docs/en/concepts/tools.mdx@@ -17,9 +17,10 @@ This includes tools from the [CrewAI Toolkit](https://github.com/joaomdmoura/creenabling everything from simple searches to complex interactions and effective teamwork among agents.<Note type="info" title="Enterprise Enhancement: Tools Repository">-CrewAI AOP provides a comprehensive Tools Repository with pre-built integrations for common business systems and APIs. Deploy agents with enterprise tools in minutes instead of days.+CrewAI AMP provides a comprehensive Tools Repository with pre-built integrations for common business systems and APIs. Deploy agents with enterprise tools in minutes instead of days.The Enterprise Tools Repository includes:+- Pre-built connectors for popular enterprise systems- Custom tool creation interface- Version control and sharing capabilitiesdiff --git a/docs/en/enterprise/features/rbac.mdx b/docs/en/enterprise/features/rbac.mdxindex e7687c2e0..216a29d39 100644--- a/docs/en/enterprise/features/rbac.mdx+++ b/docs/en/enterprise/features/rbac.mdx@@ -7,10 +7,10 @@ mode: "wide"## Overview-RBAC in CrewAI AOP enables secure, scalable access management through a combination of organization‑level roles and automation‑level visibility controls.+RBAC in CrewAI AMP enables secure, scalable access management through a combination of organization‑level roles and automation‑level visibility controls.<Frame>- <img src="/images/enterprise/users_and_roles.png" alt="RBAC overview in CrewAI AOP" />+ <img src="/images/enterprise/users_and_roles.png" alt="RBAC overview in CrewAI AMP" /></Frame>@@ -28,10 +28,11 @@ You can configure users and roles in Settings → Roles.<Steps><Step title="Open Roles settings">- Go to <b>Settings → Roles</b> in CrewAI AOP.+ Go to <b>Settings → Roles</b> in CrewAI AMP.</Step><Step title="Choose a role type">- Use a predefined role (<b>Owner</b>, <b>Member</b>) or click <b>Create role</b> to define a custom one.+ Use a predefined role (<b>Owner</b>, <b>Member</b>) or click{" "}+ <b>Create role</b> to define a custom one.</Step><Step title="Assign to members">Select users and assign the role. You can change this anytime.@@ -40,10 +41,10 @@ You can configure users and roles in Settings → Roles.### Configuration summary-| Area | Where to configure | Options |-|:---|:---|:---|-| Users & Roles | Settings → Roles | Predefined: Owner, Member; Custom roles |-| Automation visibility | Automation → Settings → Visibility | Private; Whitelist users/roles |+| Area | Where to configure | Options |+| :-------------------- | :--------------------------------- | :-------------------------------------- |+| Users & Roles | Settings → Roles | Predefined: Owner, Member; Custom roles |+| Automation visibility | Automation → Settings → Visibility | Private; Whitelist users/roles |## Automation‑level Access Control@@ -70,30 +71,34 @@ You can configure automation‑level access control in Automation → SettingsNavigate to <b>Automation → Settings → Visibility</b>.</Step><Step title="Set visibility">- Choose <b>Private</b> to restrict access. The organization owner always retains access.+ Choose <b>Private</b> to restrict access. The organization owner always+ retains access.</Step><Step title="Whitelist access">- Add specific users and roles allowed to view, run, and access logs/metrics/settings.+ Add specific users and roles allowed to view, run, and access+ logs/metrics/settings.</Step><Step title="Save and verify">- Save changes, then confirm that non‑whitelisted users cannot view or run the automation.+ Save changes, then confirm that non‑whitelisted users cannot view or run the+ automation.</Step></Steps>### Private visibility: access outcomes-| Action | Owner | Whitelisted user/role | Not whitelisted |-|:---|:---|:---|:---|-| View automation | ✓ | ✓ | ✗ |-| Run automation/API | ✓ | ✓ | ✗ |-| Access logs/metrics/settings | ✓ | ✓ | ✗ |+| Action | Owner | Whitelisted user/role | Not whitelisted |+| :--------------------------- | :---- | :-------------------- | :-------------- |+| View automation | ✓ | ✓ | ✗ |+| Run automation/API | ✓ | ✓ | ✗ |+| Access logs/metrics/settings | ✓ | ✓ | ✗ |<Tip>-The organization owner always has access. In private mode, only whitelisted users and roles can view, run, and access logs/metrics/settings.+ The organization owner always has access. In private mode, only whitelisted+ users and roles can view, run, and access logs/metrics/settings.</Tip><Frame>- <img src="/images/enterprise/visibility.png" alt="Automation Visibility settings in CrewAI AOP" />+ <img src="/images/enterprise/visibility.png" alt="Automation Visibility settings in CrewAI AMP" /></Frame>diff --git a/docs/en/enterprise/features/tools-and-integrations.mdx b/docs/en/enterprise/features/tools-and-integrations.mdxindex 65abf2225..682f231c5 100644--- a/docs/en/enterprise/features/tools-and-integrations.mdx+++ b/docs/en/enterprise/features/tools-and-integrations.mdx@@ -18,222 +18,226 @@ Tools & Integrations is the central hub for connecting third‑party apps and ma<Tabs><Tab title="Integrations" icon="plug">- ## Agent Apps (Integrations)-- Connect enterprise‑grade applications (e.g., Gmail, Google Drive, HubSpot, Slack) via OAuth to enable agent actions.-- <Steps>- <Step title="Connect">- Click <b>Connect</b> on an app and complete OAuth.- </Step>- <Step title="Configure">- Optionally adjust scopes, triggers, and action availability.- </Step>- <Step title="Use in Agents">- Connected services become available as tools for your agents.- </Step>- </Steps>-- <Frame>- - </Frame>-- ### Connect your Account-- 1. Go to <Link href="https://app.crewai.com/crewai_plus/connectors">Integrations</Link>- 2. Click <b>Connect</b> on the desired service- 3. Complete the OAuth flow and grant scopes- 4. Copy your Enterprise Token from <Link href="https://app.crewai.com/crewai_plus/settings/integrations">Integration Settings</Link>-- <Frame>- - </Frame>-- ### Install Integration Tools-- To use the integrations locally, you need to install the latest `crewai-tools` package.-- ```bash- uv add crewai-tools- ```+## Agent Apps (Integrations)++Connect enterprise‑grade applications (e.g., Gmail, Google Drive, HubSpot, Slack) via OAuth to enable agent actions.++{" "}+<Steps>+ <Step title="Connect">+ Click <b>Connect</b> on an app and complete OAuth.+ </Step>+ <Step title="Configure">+ Optionally adjust scopes, triggers, and action availability.+ </Step>+ <Step title="Use in Agents">+ Connected services become available as tools for your agents.+ </Step>+</Steps>++{" "}+<Frame></Frame>++### Connect your Account++1. Go to <Link href="https://app.crewai.com/crewai_plus/connectors">Integrations</Link>+2. Click <b>Connect</b> on the desired service+3. Complete the OAuth flow and grant scopes+4. Copy your Enterprise Token from <Link href="https://app.crewai.com/crewai_plus/settings/integrations">Integration Settings</Link>++{" "}+<Frame>+ +</Frame>- ### Environment Variable Setup+### Install Integration Tools++To use the integrations locally, you need to install the latest `crewai-tools` package.++```bash+uv add crewai-tools+```++### Environment Variable Setup++{" "}+<Note>+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.+</Note>++```bash+export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"+```++Or add it to your `.env` file:++```+CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token+```++### Usage Example++{" "}+<Tip>+ Use the new streamlined approach to integrate enterprise apps. Simply specify+ the app and its actions directly in the Agent configuration.+</Tip>++```python+from crewai import Agent, Task, Crew++# Create an agent with Gmail capabilities+email_agent = Agent(+ role="Email Manager",+ goal="Manage and organize email communications",+ backstory="An AI assistant specialized in email management and communication.",+ apps=['gmail', 'gmail/send_email'] # Using canonical name 'gmail'+)++# Task to send an email+email_task = Task(+ description="Draft and send a follow-up email to [email protected] about the project update",+ agent=email_agent,+ expected_output="Confirmation that email was sent successfully"+)++# Run the task+crew = Crew(+ agents=[email_agent],+ tasks=[email_task]+)++# Run the crew+crew.kickoff()+```++### Filtering Tools++```python+from crewai import Agent, Task, Crew++# Create agent with specific Gmail actions only+gmail_agent = Agent(+ role="Gmail Manager",+ goal="Manage gmail communications and notifications",+ backstory="An AI assistant that helps coordinate gmail communications.",+ apps=['gmail/fetch_emails'] # Using canonical name with specific action+)++notification_task = Task(+ description="Find the email from [email protected]",+ agent=gmail_agent,+ expected_output="Email found from [email protected]"+)++crew = Crew(+ agents=[gmail_agent],+ tasks=[notification_task]+)+```++On a deployed crew, you can specify which actions are available for each integration from the service settings page.++{" "}+<Frame>+ +</Frame>- <Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.- </Note>+### Scoped Deployments (multi‑user orgs)- ```bash- export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"- ```-- Or add it to your `.env` file:+You can scope each integration to a specific user. For example, a crew that connects to Google can use a specific user’s Gmail account.- ```- CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- ```+{" "}+<Tip>Useful when different teams/users must keep data access separated.</Tip>- ### Usage Example-- <Tip>- Use the new streamlined approach to integrate enterprise apps. Simply specify the app and its actions directly in the Agent configuration.- </Tip>-- ```python- from crewai import Agent, Task, Crew-- # Create an agent with Gmail capabilities- email_agent = Agent(- role="Email Manager",- goal="Manage and organize email communications",- backstory="An AI assistant specialized in email management and communication.",- apps=['gmail', 'gmail/send_email'] # Using canonical name 'gmail'- )+Use the `user_bearer_token` to scope authentication to the requesting user. If the user isn’t logged in, the crew won’t use connected integrations. Otherwise it falls back to the default bearer token configured for the deployment.- # Task to send an email- email_task = Task(- description="Draft and send a follow-up email to [email protected] about the project update",- agent=email_agent,- expected_output="Confirmation that email was sent successfully"- )+{" "}+<Frame></Frame>- # Run the task- crew = Crew(- agents=[email_agent],- tasks=[email_task]- )+{" "}+<div id="catalog"></div>+### Catalog- # Run the crew- crew.kickoff()- ```+#### Communication & Collaboration- ### Filtering Tools+- Gmail — Manage emails and drafts+- Slack — Workspace notifications and alerts+- Microsoft — Office 365 and Teams integration- ```python- from crewai import Agent, Task, Crew+#### Project Management- # Create agent with specific Gmail actions only- gmail_agent = Agent(- role="Gmail Manager",- goal="Manage gmail communications and notifications",- backstory="An AI assistant that helps coordinate gmail communications.",- apps=['gmail/fetch_emails'] # Using canonical name with specific action- )+- Jira — Issue tracking and project management+- ClickUp — Task and productivity management+- Asana — Team task and project coordination+- Notion — Page and database management+- Linear — Software project and bug tracking+- GitHub — Repository and issue management- notification_task = Task(- description="Find the email from [email protected]",- agent=gmail_agent,- expected_output="Email found from [email protected]"- )+#### Customer Relationship Management- crew = Crew(- agents=[gmail_agent],- tasks=[notification_task]- )- ```+- Salesforce — CRM account and opportunity management+- HubSpot — Sales pipeline and contact management+- Zendesk — Customer support ticket management- On a deployed crew, you can specify which actions are available for each integration from the service settings page.+#### Business & Finance- <Frame>- - </Frame>+- Stripe — Payment processing and customer management+- Shopify — E‑commerce store and product management- ### Scoped Deployments (multi‑user orgs)+#### Productivity & Storage- You can scope each integration to a specific user. For example, a crew that connects to Google can use a specific user’s Gmail account.+- Google Sheets — Spreadsheet data synchronization+- Google Calendar — Event and schedule management+- Box — File storage and document management- <Tip>- Useful when different teams/users must keep data access separated.- </Tip>+…and more to come!- Use the `user_bearer_token` to scope authentication to the requesting user. If the user isn’t logged in, the crew won’t use connected integrations. Otherwise it falls back to the default bearer token configured for the deployment.+ </Tab>+ <Tab title="Internal Tools" icon="toolbox">- <Frame>- - </Frame>+## Internal Tools- <div id="catalog"></div>- ### Catalog+Create custom tools locally, publish them on CrewAI AMP Tool Repository and use them in your agents.- #### Communication & Collaboration- - Gmail — Manage emails and drafts- - Slack — Workspace notifications and alerts- - Microsoft — Office 365 and Teams integration-- #### Project Management- - Jira — Issue tracking and project management- - ClickUp — Task and productivity management- - Asana — Team task and project coordination- - Notion — Page and database management- - Linear — Software project and bug tracking- - GitHub — Repository and issue management-- #### Customer Relationship Management- - Salesforce — CRM account and opportunity management- - HubSpot — Sales pipeline and contact management- - Zendesk — Customer support ticket management-- #### Business & Finance- - Stripe — Payment processing and customer management- - Shopify — E‑commerce store and product management-- #### Productivity & Storage- - Google Sheets — Spreadsheet data synchronization- - Google Calendar — Event and schedule management- - Box — File storage and document management-- …and more to come!+{" "}+<Tip>+ Before running the commands below, make sure you log in to your CrewAI AMP+ account by running this command: ```bash crewai login ```+</Tip>- </Tab>- <Tab title="Internal Tools" icon="toolbox">+{" "}+<Frame>+ +</Frame>- ## Internal Tools-- Create custom tools locally, publish them on CrewAI AOP Tool Repository and use them in your agents.-- <Tip>- Before running the commands below, make sure you log in to your CrewAI AOP account by running this command:- ```bash- crewai login- ```- </Tip>-- <Frame>- - </Frame>-- <Steps>- <Step title="Create">- Create a new tool locally.- ```bash- crewai tool create your-tool- ```- </Step>- <Step title="Publish">- Publish the tool to the CrewAI AOP Tool Repository.- ```bash- crewai tool publish- ```- </Step>- <Step title="Install">- Install the tool from the CrewAI AOP Tool Repository.- ```bash- crewai tool install your-tool- ```- </Step>- </Steps>-- Manage:-- - Name and description- - Visibility (Private / Public)- - Required environment variables- - Version history and downloads- - Team and role access-- <Frame>- - </Frame>+{" "}+<Steps>+ <Step title="Create">+ Create a new tool locally. ```bash crewai tool create your-tool ```+ </Step>+ <Step title="Publish">+ Publish the tool to the CrewAI AMP Tool Repository. ```bash crewai tool+ publish ```+ </Step>+ <Step title="Install">+ Install the tool from the CrewAI AMP Tool Repository. ```bash crewai tool+ install your-tool ```+ </Step>+</Steps>++Manage:++- Name and description+- Visibility (Private / Public)+- Required environment variables+- Version history and downloads+- Team and role access++{" "}+<Frame></Frame></Tab></Tabs>@@ -241,10 +245,18 @@ Tools & Integrations is the central hub for connecting third‑party apps and ma## Related<CardGroup cols={2}>- <Card title="Tool Repository" href="/en/enterprise/guides/tool-repository#tool-repository" icon="toolbox">+ <Card+ title="Tool Repository"+ href="/en/enterprise/guides/tool-repository#tool-repository"+ icon="toolbox"+ >Create, publish, and version custom tools for your organization.</Card>- <Card title="Webhook Automation" href="/en/enterprise/guides/webhook-automation" icon="bolt">+ <Card+ title="Webhook Automation"+ href="/en/enterprise/guides/webhook-automation"+ icon="bolt"+ >Automate workflows and integrate with external platforms and services.</Card></CardGroup>diff --git a/docs/en/enterprise/features/traces.mdx b/docs/en/enterprise/features/traces.mdxindex acfe7e365..4f2d4cf50 100644--- a/docs/en/enterprise/features/traces.mdx+++ b/docs/en/enterprise/features/traces.mdx@@ -11,7 +11,7 @@ Traces provide comprehensive visibility into your crew executions, helping you m## What are Traces?-Traces in CrewAI AOP are detailed execution records that capture every aspect of your crew's operation, from initial inputs to final outputs. They record:+Traces in CrewAI AMP are detailed execution records that capture every aspect of your crew's operation, from initial inputs to final outputs. They record:- Agent thoughts and reasoning- Task execution details@@ -20,15 +20,13 @@ Traces in CrewAI AOP are detailed execution records that capture every aspect of- Execution times- Cost estimates-<Frame>- -</Frame>+<Frame></Frame>## Accessing Traces<Steps><Step title="Navigate to the Traces Tab">- Once in your CrewAI AOP dashboard, click on the **Traces** to view all execution records.+ Once in your CrewAI AMP dashboard, click on the **Traces** to view all execution records.</Step><Step title="Select an Execution">@@ -51,9 +49,7 @@ The top section displays high-level metrics about the execution:- **Execution Time**: Total duration of the crew run- **Estimated Cost**: Approximate cost based on token usage-<Frame>- -</Frame>+<Frame></Frame>### 2. Tasks & Agents@@ -64,33 +60,25 @@ This section shows all tasks and agents that were part of the crew execution:- Status (completed/failed)- Individual execution time of the task-<Frame>- -</Frame>+<Frame></Frame>### 3. Final OutputDisplays the final result produced by the crew after all tasks are completed.-<Frame>- -</Frame>+<Frame></Frame>### 4. Execution TimelineA visual representation of when each task started and ended, helping you identify bottlenecks or parallel execution patterns.-<Frame>- -</Frame>+<Frame></Frame>### 5. Detailed Task ViewWhen you click on a specific task in the timeline or task list, you'll see:-<Frame>- -</Frame>+<Frame></Frame>- **Task Key**: Unique identifier for the task- **Task ID**: Technical identifier in the system@@ -104,7 +92,6 @@ When you click on a specific task in the timeline or task list, you'll see:- **Input**: Any input provided to this task from previous tasks- **Output**: The actual result produced by the agent-## Using Traces for DebuggingTraces are invaluable for troubleshooting issues with your crews:@@ -121,6 +108,7 @@ Traces are invaluable for troubleshooting issues with your crews:<Frame></Frame>+</Step><Step title="Optimize Performance">@@ -130,6 +118,7 @@ Traces are invaluable for troubleshooting issues with your crews:- Excessive token usage- Redundant tool operations- Unnecessary API calls+</Step><Step title="Improve Cost Efficiency">@@ -139,6 +128,7 @@ Traces are invaluable for troubleshooting issues with your crews:- Refine prompts to be more concise- Cache frequently accessed information- Structure tasks to minimize redundant operations+</Step></Steps>@@ -153,5 +143,6 @@ CrewAI batches trace uploads to reduce overhead on high-volume runs:This yields more stable tracing under load while preserving detailed task/agent telemetry.<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with trace analysis or any other CrewAI AOP features.+ Contact our support team for assistance with trace analysis or any other+ CrewAI AMP features.</Card>diff --git a/docs/en/enterprise/features/webhook-streaming.mdx b/docs/en/enterprise/features/webhook-streaming.mdxindex b6c282b1f..304f33912 100644--- a/docs/en/enterprise/features/webhook-streaming.mdx+++ b/docs/en/enterprise/features/webhook-streaming.mdx@@ -8,7 +8,7 @@ mode: "wide"## OverviewEnterprise Event Streaming lets you receive real-time webhook updates about your crews and flows deployed to-CrewAI AOP, such as model calls, tool usage, and flow steps.+CrewAI AMP, such as model calls, tool usage, and flow steps.## Usage@@ -16,7 +16,7 @@ When using the Kickoff API, include a `webhooks` object to your request, for exa```json{- "inputs": {"foo": "bar"},+ "inputs": { "foo": "bar" },"webhooks": {"events": ["crew_kickoff_started", "llm_call_started"],"url": "https://your.endpoint/webhook",@@ -46,8 +46,8 @@ Each webhook sends a list of events:"data": {"model": "gpt-4","messages": [- {"role": "system", "content": "You are an assistant."},- {"role": "user", "content": "Summarize this article."}+ { "role": "system", "content": "You are an assistant." },+ { "role": "user", "content": "Summarize this article." }]}}@@ -65,104 +65,109 @@ CrewAI supports both system events and custom events in Enterprise Event Streami### Flow Events:- - `flow_created`- - `flow_started`- - `flow_finished`- - `flow_plot`- - `method_execution_started`- - `method_execution_finished`- - `method_execution_failed`+- `flow_created`+- `flow_started`+- `flow_finished`+- `flow_plot`+- `method_execution_started`+- `method_execution_finished`+- `method_execution_failed`### Agent Events:- - `agent_execution_started`- - `agent_execution_completed`- - `agent_execution_error`- - `lite_agent_execution_started`- - `lite_agent_execution_completed`- - `lite_agent_execution_error`- - `agent_logs_started`- - `agent_logs_execution`- - `agent_evaluation_started`- - `agent_evaluation_completed`- - `agent_evaluation_failed`+- `agent_execution_started`+- `agent_execution_completed`+- `agent_execution_error`+- `lite_agent_execution_started`+- `lite_agent_execution_completed`+- `lite_agent_execution_error`+- `agent_logs_started`+- `agent_logs_execution`+- `agent_evaluation_started`+- `agent_evaluation_completed`+- `agent_evaluation_failed`### Crew Events:- - `crew_kickoff_started`- - `crew_kickoff_completed`- - `crew_kickoff_failed`- - `crew_train_started`- - `crew_train_completed`- - `crew_train_failed`- - `crew_test_started`- - `crew_test_completed`- - `crew_test_failed`- - `crew_test_result`+- `crew_kickoff_started`+- `crew_kickoff_completed`+- `crew_kickoff_failed`+- `crew_train_started`+- `crew_train_completed`+- `crew_train_failed`+- `crew_test_started`+- `crew_test_completed`+- `crew_test_failed`+- `crew_test_result`### Task Events:- - `task_started`- - `task_completed`- - `task_failed`- - `task_evaluation`+- `task_started`+- `task_completed`+- `task_failed`+- `task_evaluation`### Tool Usage Events:- - `tool_usage_started`- - `tool_usage_finished`- - `tool_usage_error`- - `tool_validate_input_error`- - `tool_selection_error`- - `tool_execution_error`+- `tool_usage_started`+- `tool_usage_finished`+- `tool_usage_error`+- `tool_validate_input_error`+- `tool_selection_error`+- `tool_execution_error`### LLM Events:- - `llm_call_started`- - `llm_call_completed`- - `llm_call_failed`- - `llm_stream_chunk`+- `llm_call_started`+- `llm_call_completed`+- `llm_call_failed`+- `llm_stream_chunk`### LLM Guardrail Events:- - `llm_guardrail_started`- - `llm_guardrail_completed`+- `llm_guardrail_started`+- `llm_guardrail_completed`### Memory Events:- - `memory_query_started`- - `memory_query_completed`- - `memory_query_failed`- - `memory_save_started`- - `memory_save_completed`- - `memory_save_failed`- - `memory_retrieval_started`- - `memory_retrieval_completed`+- `memory_query_started`+- `memory_query_completed`+- `memory_query_failed`+- `memory_save_started`+- `memory_save_completed`+- `memory_save_failed`+- `memory_retrieval_started`+- `memory_retrieval_completed`### Knowledge Events:- - `knowledge_search_query_started`- - `knowledge_search_query_completed`- - `knowledge_search_query_failed`- - `knowledge_query_started`- - `knowledge_query_completed`- - `knowledge_query_failed`+- `knowledge_search_query_started`+- `knowledge_search_query_completed`+- `knowledge_search_query_failed`+- `knowledge_query_started`+- `knowledge_query_completed`+- `knowledge_query_failed`### Reasoning Events:- - `agent_reasoning_started`- - `agent_reasoning_completed`- - `agent_reasoning_failed`+- `agent_reasoning_started`+- `agent_reasoning_completed`+- `agent_reasoning_failed`Event names match the internal event bus. See GitHub for the full list of events.You can emit your own custom events, and they will be delivered through the webhook stream alongside system events.<CardGroup>- <Card title="GitHub" icon="github" href="https://github.com/crewAIInc/crewAI/tree/main/src/crewai/utilities/events">- Full list of events- </Card>-<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with webhook integration or troubleshooting.-</Card>+ <Card+ title="GitHub"+ icon="github"+ href="https://github.com/crewAIInc/crewAI/tree/main/src/crewai/utilities/events"+ >+ Full list of events+ </Card>+ <Card title="Need Help?" icon="headset" href="mailto:[email protected]">+ Contact our support team for assistance with webhook integration or+ troubleshooting.+ </Card></CardGroup>diff --git a/docs/en/enterprise/guides/automation-triggers.mdx b/docs/en/enterprise/guides/automation-triggers.mdxindex 3e1863d3d..395d8f74d 100644--- a/docs/en/enterprise/guides/automation-triggers.mdx+++ b/docs/en/enterprise/guides/automation-triggers.mdx@@ -1,11 +1,11 @@---title: "Triggers Overview"-description: "Understand how CrewAI AOP triggers work, how to manage them, and where to find integration-specific playbooks"+description: "Understand how CrewAI AMP triggers work, how to manage them, and where to find integration-specific playbooks"icon: "face-smile"mode: "wide"----CrewAI AOP triggers connect your automations to real-time events across the tools your teams already use. Instead of polling systems or relying on manual kickoffs, triggers listen for changes—new emails, calendar updates, CRM status changes—and immediately launch the crew or flow you specify.+CrewAI AMP triggers connect your automations to real-time events across the tools your teams already use. Instead of polling systems or relying on manual kickoffs, triggers listen for changes—new emails, calendar updates, CRM status changes—and immediately launch the crew or flow you specify.<Frame>@@ -20,37 +20,61 @@ Deep-dive guides walk through setup and sample workflows for each integration:<a href="/en/enterprise/guides/gmail-trigger">Enable crews when emails arrive or threads update.</a></Card>- <Card title="Google Calendar Trigger" icon="calendar-days">- <a href="/en/enterprise/guides/google-calendar-trigger">React to calendar events as they are created, updated, or cancelled.</a>- </Card>-- <Card title="Google Drive Trigger" icon="folder-open">- <a href="/en/enterprise/guides/google-drive-trigger">Handle Drive file uploads, edits, and deletions.</a>- </Card>-- <Card title="Outlook Trigger" icon="envelope-open">- <a href="/en/enterprise/guides/outlook-trigger">Automate responses to new Outlook messages and calendar updates.</a>- </Card>-- <Card title="OneDrive Trigger" icon="cloud">- <a href="/en/enterprise/guides/onedrive-trigger">Audit file activity and sharing changes in OneDrive.</a>- </Card>-- <Card title="Microsoft Teams Trigger" icon="comments">- <a href="/en/enterprise/guides/microsoft-teams-trigger">Kick off workflows when new Teams chats start.</a>- </Card>-- <Card title="HubSpot Trigger" icon="hubspot">- <a href="/en/enterprise/guides/hubspot-trigger">Launch automations from HubSpot workflows and lifecycle events.</a>- </Card>-- <Card title="Salesforce Trigger" icon="salesforce">- <a href="/en/enterprise/guides/salesforce-trigger">Connect Salesforce processes to CrewAI for CRM automation.</a>- </Card>-- <Card title="Slack Trigger" icon="slack">- <a href="/en/enterprise/guides/slack-trigger">Start crews directly from Slack slash commands.</a>- </Card>+{" "}+<Card title="Google Calendar Trigger" icon="calendar-days">+ <a href="/en/enterprise/guides/google-calendar-trigger">+ React to calendar events as they are created, updated, or cancelled.+ </a>+</Card>++{" "}+<Card title="Google Drive Trigger" icon="folder-open">+ <a href="/en/enterprise/guides/google-drive-trigger">+ Handle Drive file uploads, edits, and deletions.+ </a>+</Card>++{" "}+<Card title="Outlook Trigger" icon="envelope-open">+ <a href="/en/enterprise/guides/outlook-trigger">+ Automate responses to new Outlook messages and calendar updates.+ </a>+</Card>++{" "}+<Card title="OneDrive Trigger" icon="cloud">+ <a href="/en/enterprise/guides/onedrive-trigger">+ Audit file activity and sharing changes in OneDrive.+ </a>+</Card>++{" "}+<Card title="Microsoft Teams Trigger" icon="comments">+ <a href="/en/enterprise/guides/microsoft-teams-trigger">+ Kick off workflows when new Teams chats start.+ </a>+</Card>++{" "}+<Card title="HubSpot Trigger" icon="hubspot">+ <a href="/en/enterprise/guides/hubspot-trigger">+ Launch automations from HubSpot workflows and lifecycle events.+ </a>+</Card>++{" "}+<Card title="Salesforce Trigger" icon="salesforce">+ <a href="/en/enterprise/guides/salesforce-trigger">+ Connect Salesforce processes to CrewAI for CRM automation.+ </a>+</Card>++{" "}+<Card title="Slack Trigger" icon="slack">+ <a href="/en/enterprise/guides/slack-trigger">+ Start crews directly from Slack slash commands.+ </a>+</Card><Card title="Zapier Trigger" icon="bolt"><a href="/en/enterprise/guides/zapier-trigger">Bridge CrewAI with thousands of Zapier-supported apps.</a>@@ -76,7 +100,10 @@ To access and manage your automation triggers:2. Click on the **Triggers** tab to view all available trigger integrations<Frame caption="Example of available automation triggers for a Gmail deployment">- <img src="/images/enterprise/list-available-triggers.png" alt="List of available automation triggers" />+ <img+ src="/images/enterprise/list-available-triggers.png"+ alt="List of available automation triggers"+ /></Frame>This view shows all the trigger integrations available for your deployment, along with their current connection status.@@ -86,7 +113,10 @@ This view shows all the trigger integrations available for your deployment, alonEach trigger can be easily enabled or disabled using the toggle switch:<Frame caption="Enable or disable triggers with toggle">- <img src="/images/enterprise/trigger-selected.png" alt="Enable or disable triggers with toggle" />+ <img+ src="/images/enterprise/trigger-selected.png"+ alt="Enable or disable triggers with toggle"+ /></Frame>- **Enabled (blue toggle)**: The trigger is active and will automatically execute your deployment when the specified events occur@@ -99,7 +129,10 @@ Simply click the toggle to change the trigger state. Changes take effect immediaTrack the performance and history of your triggered executions:<Frame caption="List of executions triggered by automation">- <img src="/images/enterprise/list-executions.png" alt="List of executions triggered by automation" />+ <img+ src="/images/enterprise/list-executions.png"+ alt="List of executions triggered by automation"+ /></Frame>## Building Trigger-Driven Automations@@ -130,6 +163,7 @@ crewai triggers list```This command displays all triggers available based on your connected integrations, showing:+- Integration name and connection status- Available trigger types- Trigger names and descriptions@@ -149,6 +183,7 @@ crewai triggers run microsoft_onedrive/file_changed```This command:+- Executes your crew locally- Passes a complete, realistic trigger payload- Simulates exactly how your crew will be called in production@@ -161,7 +196,6 @@ This command:- If your crew expects parameters that aren't in the trigger payload, execution may fail</Warning>-### Triggers with CrewYour existing crew definitions work seamlessly with triggers, you just need to have a task to parse the received payload:@@ -193,10 +227,12 @@ class MyAutomatedCrew:The crew will automatically receive and can access the trigger payload through the standard CrewAI context mechanisms.<Note>- Crew and Flow inputs can include `crewai_trigger_payload`. CrewAI automatically injects this payload:- - Tasks: appended to the first task's description by default ("Trigger Payload: {crewai_trigger_payload}")- - Control via `allow_crewai_trigger_context`: set `True` to always inject, `False` to never inject- - Flows: any `@start()` method that accepts a `crewai_trigger_payload` parameter will receive it+ Crew and Flow inputs can include `crewai_trigger_payload`. CrewAI+ automatically injects this payload: - Tasks: appended to the first task's+ description by default ("Trigger Payload: {crewai_trigger_payload}") - Control+ via `allow_crewai_trigger_context`: set `True` to always inject, `False` to+ never inject - Flows: any `@start()` method that accepts a+ `crewai_trigger_payload` parameter will receive it</Note>### Integration with Flows@@ -264,17 +300,20 @@ def delegate_to_crew(self, crewai_trigger_payload: dict = None):## Troubleshooting**Trigger not firing:**+- Verify the trigger is enabled in your deployment's Triggers tab- Check integration connection status under Tools & Integrations- Ensure all required environment variables are properly configured**Execution failures:**+- Check the execution logs for error details- Use `crewai triggers run <trigger_name>` to test locally and see the exact payload structure- Verify your crew can handle the `crewai_trigger_payload` parameter- Ensure your crew doesn't expect parameters that aren't included in the trigger payload**Development issues:**+- Always test with `crewai triggers run <trigger>` before deploying to see the complete payload- Remember that `crewai run` does NOT simulate trigger calls—use `crewai triggers run` instead- Use `crewai triggers list` to verify which triggers are available for your connected integrationsdiff --git a/docs/en/enterprise/guides/azure-openai-setup.mdx b/docs/en/enterprise/guides/azure-openai-setup.mdxindex 2e78fd37f..3d0be69d9 100644--- a/docs/en/enterprise/guides/azure-openai-setup.mdx+++ b/docs/en/enterprise/guides/azure-openai-setup.mdx@@ -19,8 +19,8 @@ This guide walks you through connecting Azure OpenAI with Crew Studio for seamle</Frame></Step>- <Step title="Configure CrewAI AOP Connection">- 4. In another tab, open `CrewAI AOP > LLM Connections`. Name your LLM Connection, select Azure as the provider, and choose the same model you selected in Azure.+ <Step title="Configure CrewAI AMP Connection">+ 4. In another tab, open `CrewAI AMP > LLM Connections`. Name your LLM Connection, select Azure as the provider, and choose the same model you selected in Azure.5. On the same page, add environment variables from step 3:- One named `AZURE_DEPLOYMENT_TARGET_URL` (using the Target URI). The URL should look like this: https://your-deployment.openai.azure.com/openai/deployments/gpt-4o/chat/completions?api-version=2024-08-01-preview- Another named `AZURE_API_KEY` (using the Key).@@ -28,7 +28,7 @@ This guide walks you through connecting Azure OpenAI with Crew Studio for seamle</Step><Step title="Set Default Configuration">- 7. In `CrewAI AOP > Settings > Defaults > Crew Studio LLM Settings`, set the new LLM Connection and model as defaults.+ 7. In `CrewAI AMP > Settings > Defaults > Crew Studio LLM Settings`, set the new LLM Connection and model as defaults.</Step><Step title="Configure Network Access">@@ -37,6 +37,7 @@ This guide walks you through connecting Azure OpenAI with Crew Studio for seamle- Navigate to `Resource Management > Networking`.- Ensure that `Allow access from all networks` is enabled. If this setting is restricted, CrewAI may be blocked from accessing your Azure OpenAI endpoint.</Step>+</Steps>## Verification@@ -46,6 +47,7 @@ You're all set! Crew Studio will now use your Azure OpenAI connection. Test the## TroubleshootingIf you encounter issues:+- Verify the Target URI format matches the expected pattern- Check that the API key is correct and has proper permissions- Ensure network access is configured to allow CrewAI connectionsdiff --git a/docs/en/enterprise/guides/build-crew.mdx b/docs/en/enterprise/guides/build-crew.mdxindex 21de9b1fa..de2a63088 100644--- a/docs/en/enterprise/guides/build-crew.mdx+++ b/docs/en/enterprise/guides/build-crew.mdx@@ -7,7 +7,7 @@ mode: "wide"## Overview-[CrewAI AOP](https://app.crewai.com) streamlines the process of **creating**, **deploying**, and **managing** your AI agents in production environments.+[CrewAI AMP](https://app.crewai.com) streamlines the process of **creating**, **deploying**, and **managing** your AI agents in production environments.## Getting Started@@ -22,21 +22,27 @@ mode: "wide"### Installation and Setup-<Card title="Follow Standard Installation" icon="wrench" href="/en/installation">- Follow our standard installation guide to set up CrewAI CLI and create your first project.+<Card+ title="Follow Standard Installation"+ icon="wrench"+ href="/en/installation"+>+ Follow our standard installation guide to set up CrewAI CLI and create your+ first project.</Card>### Building Your Crew<Card title="Quickstart Tutorial" icon="rocket" href="/en/quickstart">- Follow our quickstart guide to create your first agent crew using YAML configuration.+ Follow our quickstart guide to create your first agent crew using YAML+ configuration.</Card>## Support and ResourcesFor Enterprise-specific support or questions, contact our dedicated support team at [[email protected]](mailto:[email protected]).-<Card title="Schedule a Demo" icon="calendar" href="mailto:[email protected]">- Book time with our team to learn more about Enterprise features and how they can benefit your organization.+ Book time with our team to learn more about Enterprise features and how they+ can benefit your organization.</Card>diff --git a/docs/en/enterprise/guides/capture_telemetry_logs.mdx b/docs/en/enterprise/guides/capture_telemetry_logs.mdxindex 60804b5fd..597853772 100644--- a/docs/en/enterprise/guides/capture_telemetry_logs.mdx+++ b/docs/en/enterprise/guides/capture_telemetry_logs.mdx@@ -1,11 +1,11 @@---title: "Open Telemetry Logs"-description: "Understand how to capture telemetry logs from your CrewAI AOP deployments"+description: "Understand how to capture telemetry logs from your CrewAI AMP deployments"icon: "magnifying-glass-chart"mode: "wide"----CrewAI AOP provides a powerful way to capture telemetry logs from your deployments. This allows you to monitor the performance of your agents and workflows, and to debug issues that may arise.+CrewAI AMP provides a powerful way to capture telemetry logs from your deployments. This allows you to monitor the performance of your agents and workflows, and to debug issues that may arise.## Prerequisites@@ -14,22 +14,17 @@ CrewAI AOP provides a powerful way to capture telemetry logs from your deploymenYour organization should have ENTERPRISE OTEL SETUP enabled</Card><Card title="OTEL collector setup" icon="server">- Your organization should have an OTEL collector setup or a provider like Datadog log intake setup+ Your organization should have an OTEL collector setup or a provider like+ Datadog log intake setup</Card></CardGroup>-## How to capture telemetry logs1. Go to settings/organization tab2. Configure your OTEL collector setup3. Save--Example to setup OTEL log collection capture to Datadog.--<Frame>- -</Frame>+<Frame></Frame>diff --git a/docs/en/enterprise/guides/deploy-crew.mdx b/docs/en/enterprise/guides/deploy-crew.mdxindex 296bf519b..8e4c77e41 100644--- a/docs/en/enterprise/guides/deploy-crew.mdx+++ b/docs/en/enterprise/guides/deploy-crew.mdx@@ -1,22 +1,26 @@---title: "Deploy Crew"-description: "Deploying a Crew on CrewAI AOP"+description: "Deploying a Crew on CrewAI AMP"icon: "rocket"mode: "wide"---<Note>-After creating a crew locally or through Crew Studio, the next step is deploying it to the CrewAI AOP platform. This guide covers multiple deployment methods to help you choose the best approach for your workflow.+ After creating a crew locally or through Crew Studio, the next step is+ deploying it to the CrewAI AMP platform. This guide covers multiple deployment+ methods to help you choose the best approach for your workflow.</Note>## Prerequisites<CardGroup cols={2}><Card title="Crew Ready for Deployment" icon="users">- You should have a working crew either built locally or created through Crew Studio+ You should have a working crew either built locally or created through Crew+ Studio</Card><Card title="GitHub Repository" icon="github">- Your crew code should be in a GitHub repository (for GitHub integration method)+ Your crew code should be in a GitHub repository (for GitHub integration+ method)</Card></CardGroup>@@ -39,10 +43,10 @@ The CLI provides the fastest way to deploy locally developed crews to the Enterp</Step><Step title="Authenticate with the Enterprise Platform">- First, you need to authenticate your CLI with the CrewAI AOP platform:+ First, you need to authenticate your CLI with the CrewAI AMP platform:```bash- # If you already have a CrewAI AOP account, or want to create one:+ # If you already have a CrewAI AMP account, or want to create one:crewai login```@@ -105,38 +109,38 @@ The CLI provides the fastest way to deploy locally developed crews to the EnterpThe CrewAI CLI offers several commands to manage your deployments:- ```bash- # List all your deployments- crewai deploy list+```bash+# List all your deployments+crewai deploy list- # Get the status of your deployment- crewai deploy status+# Get the status of your deployment+crewai deploy status- # View the logs of your deployment- crewai deploy logs+# View the logs of your deployment+crewai deploy logs- # Push updates after code changes- crewai deploy push+# Push updates after code changes+crewai deploy push- # Remove a deployment- crewai deploy remove <deployment_id>- ```+# Remove a deployment+crewai deploy remove <deployment_id>+```## Option 2: Deploy Directly via Web Interface-You can also deploy your crews directly through the CrewAI AOP web interface by connecting your GitHub account. This approach doesn't require using the CLI on your local machine.+You can also deploy your crews directly through the CrewAI AMP web interface by connecting your GitHub account. This approach doesn't require using the CLI on your local machine.<Steps><Step title="Pushing to GitHub">- You need to push your crew to a GitHub repository. If you haven't created a crew yet, you can [follow this tutorial](/en/quickstart).+You need to push your crew to a GitHub repository. If you haven't created a crew yet, you can [follow this tutorial](/en/quickstart).</Step>- <Step title="Connecting GitHub to CrewAI AOP">+ <Step title="Connecting GitHub to CrewAI AMP">- 1. Log in to [CrewAI AOP](https://app.crewai.com)+ 1. Log in to [CrewAI AMP](https://app.crewai.com)2. Click on the button "Connect GitHub"<Frame>@@ -194,7 +198,7 @@ For automated deployments in CI/CD pipelines, you can use the CrewAI API to trig<Steps><Step title="Get Your Personal Access Token">- Navigate to your CrewAI AOP account settings to generate an API token:+ Navigate to your CrewAI AMP account settings to generate an API token:1. Go to [app.crewai.com](https://app.crewai.com)2. Click on **Settings** → **Account** → **Personal Access Token**@@ -207,7 +211,7 @@ For automated deployments in CI/CD pipelines, you can use the CrewAI API to trigLocate the unique identifier for your deployed crew:- 1. Go to **Automations** in your CrewAI AOP dashboard+ 1. Go to **Automations** in your CrewAI AMP dashboard2. Select your existing automation/crew3. Click on **Additional Details**4. Copy the **UUID** - this identifies your specific crew deployment@@ -238,7 +242,6 @@ For automated deployments in CI/CD pipelines, you can use the CrewAI API to trigIf your automation was first created connected to Git, the API will automatically pull the latest changes from your repository before redeploying.</Info>-</Step><Step title="GitHub Actions Integration Example">@@ -276,12 +279,14 @@ For automated deployments in CI/CD pipelines, you can use the CrewAI API to trig</Tip></Step>+</Steps>## ⚠️ Environment Variable Security Requirements<Warning>-**Important**: CrewAI AOP has security restrictions on environment variable names that can cause deployment failures if not followed.+ **Important**: CrewAI AMP has security restrictions on environment variable+ names that can cause deployment failures if not followed.</Warning>### Blocked Environment Variable Patterns@@ -289,12 +294,14 @@ For automated deployments in CI/CD pipelines, you can use the CrewAI API to trigFor security reasons, the following environment variable naming patterns are **automatically filtered** and will cause deployment issues:**Blocked Patterns:**+- Variables ending with `_TOKEN` (e.g., `MY_API_TOKEN`)- Variables ending with `_PASSWORD` (e.g., `DB_PASSWORD`)- Variables ending with `_SECRET` (e.g., `API_SECRET`)- Variables ending with `_KEY` in certain contexts**Specific Blocked Variables:**+- `GITHUB_USER`, `GITHUB_TOKEN`- `AWS_REGION`, `AWS_DEFAULT_REGION`- Various internal CrewAI system variables@@ -302,6 +309,7 @@ For security reasons, the following environment variable naming patterns are **a### Allowed ExceptionsSome variables are explicitly allowed despite matching blocked patterns:+- `AZURE_AD_TOKEN`- `AZURE_OPENAI_AD_TOKEN`- `ENTERPRISE_ACTION_TOKEN`@@ -331,7 +339,8 @@ API_CONFIG=secret1234. **Document changes**: Keep track of renamed variables for your team<Tip>-If you encounter deployment failures with cryptic environment variable errors, check your variable names against these patterns first.+ If you encounter deployment failures with cryptic environment variable errors,+ check your variable names against these patterns first.</Tip>### Interact with Your Deployed Crew@@ -339,6 +348,7 @@ If you encounter deployment failures with cryptic environment variable errors, cOnce deployment is complete, you can access your crew through:1. **REST API**: The platform generates a unique HTTPS endpoint with these key routes:+- `/inputs`: Lists the required input parameters- `/kickoff`: Initiates an execution with provided inputs- `/status/{kickoff_id}`: Checks the execution status@@ -378,5 +388,6 @@ The Enterprise platform also offers:- **Crew Studio**: Build crews through a chat interface without writing code<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with deployment issues or questions about the Enterprise platform.+ Contact our support team for assistance with deployment issues or questions+ about the Enterprise platform.</Card>diff --git a/docs/en/enterprise/guides/enable-crew-studio.mdx b/docs/en/enterprise/guides/enable-crew-studio.mdxindex 3a8191e6b..9d3a257e0 100644--- a/docs/en/enterprise/guides/enable-crew-studio.mdx+++ b/docs/en/enterprise/guides/enable-crew-studio.mdx@@ -1,12 +1,13 @@---title: "Enable Crew Studio"-description: "Enabling Crew Studio on CrewAI AOP"+description: "Enabling Crew Studio on CrewAI AMP"icon: "comments"mode: "wide"---<Tip>-Crew Studio is a powerful **no-code/low-code** tool that allows you to quickly scaffold or build Crews through a conversational interface.+ Crew Studio is a powerful **no-code/low-code** tool that allows you to quickly+ scaffold or build Crews through a conversational interface.</Tip>## What is Crew Studio?@@ -24,7 +25,7 @@ With Crew Studio, you can:- Select appropriate tools- Configure necessary inputs- Generate downloadable code for customization-- Deploy directly to the CrewAI AOP platform+- Deploy directly to the CrewAI AMP platform## Configuration Steps@@ -32,7 +33,7 @@ Before you can start using Crew Studio, you need to configure your LLM connectio<Steps><Step title="Set Up LLM Connection">- Go to the **LLM Connections** tab in your CrewAI AOP dashboard and create a new LLM connection.+ Go to the **LLM Connections** tab in your CrewAI AMP dashboard and create a new LLM connection.<Note>Feel free to use any LLM provider you want that is supported by CrewAI.@@ -52,6 +53,7 @@ Before you can start using Crew Studio, you need to configure your LLM connectio<Frame></Frame>+</Step><Step title="Verify Connection Added">@@ -60,6 +62,7 @@ Before you can start using Crew Studio, you need to configure your LLM connectio<Frame></Frame>+</Step><Step title="Configure LLM Defaults">@@ -73,6 +76,7 @@ Before you can start using Crew Studio, you need to configure your LLM connectio<Frame></Frame>+</Step></Steps>@@ -82,7 +86,7 @@ Now that you've configured your LLM connection and default settings, you're read<Steps><Step title="Access Studio">- Navigate to the **Studio** section in your CrewAI AOP dashboard.+ Navigate to the **Studio** section in your CrewAI AMP dashboard.</Step><Step title="Start a Conversation">@@ -93,6 +97,7 @@ Now that you've configured your LLM connection and default settings, you're read```The Crew Assistant will ask clarifying questions to better understand your requirements.+</Step><Step title="Review Generated Crew">@@ -104,14 +109,16 @@ Now that you've configured your LLM connection and default settings, you're read- Tools to be usedThis is your opportunity to refine the configuration before proceeding.+</Step><Step title="Deploy or Download">Once you're satisfied with the configuration, you can:- Download the generated code for local customization- - Deploy the crew directly to the CrewAI AOP platform+ - Deploy the crew directly to the CrewAI AMP platform- Modify the configuration and regenerate the crew+</Step><Step title="Test Your Crew">@@ -120,7 +127,9 @@ Now that you've configured your LLM connection and default settings, you're read</Steps><Tip>-For best results, provide clear, detailed descriptions of what you want your crew to accomplish. Include specific inputs and expected outputs in your description.+ For best results, provide clear, detailed descriptions of what you want your+ crew to accomplish. Include specific inputs and expected outputs in your+ description.</Tip>## Example Workflow@@ -134,27 +143,33 @@ Here's a typical workflow for creating a crew with Crew Studio:```mdI need a crew that can analyze financial news and provide investment recommendations```- </Step>- <Step title="Answer Questions">- Respond to clarifying questions from the Crew Assistant to refine your requirements.</Step>+{" "}+<Step title="Answer Questions">+ Respond to clarifying questions from the Crew Assistant to refine your+ requirements.+</Step>+<Step title="Review the Plan">Review the generated crew plan, which might include:- A Research Agent to gather financial news- An Analysis Agent to interpret the data- A Recommendations Agent to provide investment advice- </Step>- <Step title="Approve or Modify">- Approve the plan or request changes if necessary.</Step>- <Step title="Download or Deploy">- Download the code for customization or deploy directly to the platform.- </Step>+{" "}+<Step title="Approve or Modify">+ Approve the plan or request changes if necessary.+</Step>++{" "}+<Step title="Download or Deploy">+ Download the code for customization or deploy directly to the platform.+</Step><Step title="Test and Refine">Test your crew with sample inputs and refine as needed.@@ -162,5 +177,6 @@ Here's a typical workflow for creating a crew with Crew Studio:</Steps><Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with Crew Studio or any other CrewAI AOP features.+ Contact our support team for assistance with Crew Studio or any other CrewAI+ AMP features.</Card>diff --git a/docs/en/enterprise/guides/gmail-trigger.mdx b/docs/en/enterprise/guides/gmail-trigger.mdxindex 50414039f..68c513aa1 100644--- a/docs/en/enterprise/guides/gmail-trigger.mdx+++ b/docs/en/enterprise/guides/gmail-trigger.mdx@@ -10,17 +10,21 @@ mode: "wide"Use the Gmail Trigger to kick off your deployed crews when Gmail events happen in connected accounts, such as receiving a new email or messages matching a label/filter.<Tip>- Make sure Gmail is connected in Tools & Integrations and the trigger is enabled for your deployment.+ Make sure Gmail is connected in Tools & Integrations and the trigger is+ enabled for your deployment.</Tip>## Enabling the Gmail Trigger-1. Open your deployment in CrewAI AOP+1. Open your deployment in CrewAI AMP2. Go to the **Triggers** tab3. Locate **Gmail** and switch the toggle to enable<Frame>- <img src="/images/enterprise/trigger-selected.png" alt="Enable or disable triggers with toggle" />+ <img+ src="/images/enterprise/trigger-selected.png"+ alt="Enable or disable triggers with toggle"+ /></Frame>## Example: Process new emails@@ -68,7 +72,9 @@ crewai triggers run gmail/new_email_receivedThe `crewai triggers run` command will execute your crew with a complete Gmail payload, allowing you to test your parsing logic before deployment.<Warning>- Use `crewai triggers run gmail/new_email_received` (not `crewai run`) to simulate trigger execution during development. After deployment, your crew will automatically receive the trigger payload.+ Use `crewai triggers run gmail/new_email_received` (not `crewai run`) to+ simulate trigger execution during development. After deployment, your crew+ will automatically receive the trigger payload.</Warning>## Monitoring Executions@@ -76,7 +82,10 @@ The `crewai triggers run` command will execute your crew with a complete Gmail pTrack history and performance of triggered runs:<Frame>- <img src="/images/enterprise/list-executions.png" alt="List of executions triggered by automation" />+ <img+ src="/images/enterprise/list-executions.png"+ alt="List of executions triggered by automation"+ /></Frame>## Troubleshootingdiff --git a/docs/en/enterprise/guides/google-calendar-trigger.mdx b/docs/en/enterprise/guides/google-calendar-trigger.mdxindex 8d22527f0..5a5f66a2b 100644--- a/docs/en/enterprise/guides/google-calendar-trigger.mdx+++ b/docs/en/enterprise/guides/google-calendar-trigger.mdx@@ -10,17 +10,21 @@ mode: "wide"Use the Google Calendar trigger to launch automations whenever calendar events change. Common use cases include briefing a team before a meeting, notifying stakeholders when a critical event is cancelled, or summarizing daily schedules.<Tip>- Make sure Google Calendar is connected in **Tools & Integrations** and enabled for the deployment you want to automate.+ Make sure Google Calendar is connected in **Tools & Integrations** and enabled+ for the deployment you want to automate.</Tip>## Enabling the Google Calendar Trigger-1. Open your deployment in CrewAI AOP+1. Open your deployment in CrewAI AMP2. Go to the **Triggers** tab3. Locate **Google Calendar** and switch the toggle to enable<Frame>- <img src="/images/enterprise/calendar-trigger.png" alt="Enable or disable triggers with toggle" />+ <img+ src="/images/enterprise/calendar-trigger.png"+ alt="Enable or disable triggers with toggle"+ /></Frame>## Example: Summarize meeting details@@ -54,7 +58,9 @@ crewai triggers run google_calendar/event_changedThe `crewai triggers run` command will execute your crew with a complete Calendar payload, allowing you to test your parsing logic before deployment.<Warning>- Use `crewai triggers run google_calendar/event_changed` (not `crewai run`) to simulate trigger execution during development. After deployment, your crew will automatically receive the trigger payload.+ Use `crewai triggers run google_calendar/event_changed` (not `crewai run`) to+ simulate trigger execution during development. After deployment, your crew+ will automatically receive the trigger payload.</Warning>## Monitoring Executions@@ -62,7 +68,10 @@ The `crewai triggers run` command will execute your crew with a complete CalendaThe **Executions** list in the deployment dashboard tracks every triggered run and surfaces payload metadata, output summaries, and errors.<Frame>- <img src="/images/enterprise/list-executions.png" alt="List of executions triggered by automation" />+ <img+ src="/images/enterprise/list-executions.png"+ alt="List of executions triggered by automation"+ /></Frame>## Troubleshootingdiff --git a/docs/en/enterprise/guides/google-drive-trigger.mdx b/docs/en/enterprise/guides/google-drive-trigger.mdxindex f64f6a1b9..0baf1cae3 100644--- a/docs/en/enterprise/guides/google-drive-trigger.mdx+++ b/docs/en/enterprise/guides/google-drive-trigger.mdx@@ -10,17 +10,21 @@ mode: "wide"Trigger your automations when files are created, updated, or removed in Google Drive. Typical workflows include summarizing newly uploaded content, enforcing sharing policies, or notifying owners when critical files change.<Tip>- Connect Google Drive in **Tools & Integrations** and confirm the trigger is enabled for the automation you want to monitor.+ Connect Google Drive in **Tools & Integrations** and confirm the trigger is+ enabled for the automation you want to monitor.</Tip>## Enabling the Google Drive Trigger-1. Open your deployment in CrewAI AOP+1. Open your deployment in CrewAI AMP2. Go to the **Triggers** tab3. Locate **Google Drive** and switch the toggle to enable<Frame>- <img src="/images/enterprise/gdrive-trigger.png" alt="Enable or disable triggers with toggle" />+ <img+ src="/images/enterprise/gdrive-trigger.png"+ alt="Enable or disable triggers with toggle"+ /></Frame>## Example: Summarize file activity@@ -51,7 +55,9 @@ crewai triggers run google_drive/file_changedThe `crewai triggers run` command will execute your crew with a complete Drive payload, allowing you to test your parsing logic before deployment.<Warning>- Use `crewai triggers run google_drive/file_changed` (not `crewai run`) to simulate trigger execution during development. After deployment, your crew will automatically receive the trigger payload.+ Use `crewai triggers run google_drive/file_changed` (not `crewai run`) to+ simulate trigger execution during development. After deployment, your crew+ will automatically receive the trigger payload.</Warning>## Monitoring Executions@@ -59,7 +65,10 @@ The `crewai triggers run` command will execute your crew with a complete Drive pTrack history and performance of triggered runs with the **Executions** list in the deployment dashboard.<Frame>- <img src="/images/enterprise/list-executions.png" alt="List of executions triggered by automation" />+ <img+ src="/images/enterprise/list-executions.png"+ alt="List of executions triggered by automation"+ /></Frame>## Troubleshootingdiff --git a/docs/en/enterprise/guides/hubspot-trigger.mdx b/docs/en/enterprise/guides/hubspot-trigger.mdxindex 88f427216..9dfae4fba 100644--- a/docs/en/enterprise/guides/hubspot-trigger.mdx+++ b/docs/en/enterprise/guides/hubspot-trigger.mdx@@ -5,48 +5,57 @@ icon: "hubspot"mode: "wide"----This guide provides a step-by-step process to set up HubSpot triggers for CrewAI AOP, enabling you to initiate crews directly from HubSpot Workflows.+This guide provides a step-by-step process to set up HubSpot triggers for CrewAI AMP, enabling you to initiate crews directly from HubSpot Workflows.## Prerequisites-- A CrewAI AOP account+- A CrewAI AMP account- A HubSpot account with the [HubSpot Workflows](https://knowledge.hubspot.com/workflows/create-workflows) feature## Setup Steps<Steps>- <Step title="Connect your HubSpot account with CrewAI AOP">- - Log in to your `CrewAI AOP account > Triggers`- - Select `HubSpot` from the list of available triggers- - Choose the HubSpot account you want to connect with CrewAI AOP- - Follow the on-screen prompts to authorize CrewAI AOP access to your HubSpot account- - A confirmation message will appear once HubSpot is successfully connected with CrewAI AOP- </Step>- <Step title="Create a HubSpot Workflow">- - Log in to your `HubSpot account > Automations > Workflows > New workflow`- - Select the workflow type that fits your needs (e.g., Start from scratch)- - In the workflow builder, click the Plus (+) icon to add a new action.- - Choose `Integrated apps > CrewAI > Kickoff a Crew`.- - Select the Crew you want to initiate.- - Click `Save` to add the action to your workflow- <Frame>- <img src="/images/enterprise/hubspot-workflow-1.png" alt="HubSpot Workflow 1" />- </Frame>- </Step>- <Step title="Use Crew results with other actions">- - After the Kickoff a Crew step, click the Plus (+) icon to add a new action.- - For example, to send an internal email notification, choose `Communications > Send internal email notification`- - In the Body field, click `Insert data`, select `View properties or action outputs from > Action outputs > Crew Result` to include Crew data in the email- <Frame>- <img src="/images/enterprise/hubspot-workflow-2.png" alt="HubSpot Workflow 2" />- </Frame>- - Configure any additional actions as needed- - Review your workflow steps to ensure everything is set up correctly- - Activate the workflow- <Frame>- <img src="/images/enterprise/hubspot-workflow-3.png" alt="HubSpot Workflow 3" />- </Frame>- </Step>+ <Step title="Connect your HubSpot account with CrewAI AMP">+ - Log in to your `CrewAI AMP account > Triggers` - Select `HubSpot` from the+ list of available triggers - Choose the HubSpot account you want to connect+ with CrewAI AMP - Follow the on-screen prompts to authorize CrewAI AMP+ access to your HubSpot account - A confirmation message will appear once+ HubSpot is successfully connected with CrewAI AMP+ </Step>+ <Step title="Create a HubSpot Workflow">+ - Log in to your `HubSpot account > Automations > Workflows > New workflow`+ - Select the workflow type that fits your needs (e.g., Start from scratch) -+ In the workflow builder, click the Plus (+) icon to add a new action. -+ Choose `Integrated apps > CrewAI > Kickoff a Crew`. - Select the Crew you+ want to initiate. - Click `Save` to add the action to your workflow+ <Frame>+ <img+ src="/images/enterprise/hubspot-workflow-1.png"+ alt="HubSpot Workflow 1"+ />+ </Frame>+ </Step>+ <Step title="Use Crew results with other actions">+ - After the Kickoff a Crew step, click the Plus (+) icon to add a new+ action. - For example, to send an internal email notification, choose+ `Communications > Send internal email notification` - In the Body field,+ click `Insert data`, select `View properties or action outputs from > Action+ outputs > Crew Result` to include Crew data in the email+ <Frame>+ <img+ src="/images/enterprise/hubspot-workflow-2.png"+ alt="HubSpot Workflow 2"+ />+ </Frame>+ - Configure any additional actions as needed - Review your workflow+ steps to ensure everything is set up correctly - Activate the workflow+ <Frame>+ <img+ src="/images/enterprise/hubspot-workflow-3.png"+ alt="HubSpot Workflow 3"+ />+ </Frame>+ </Step></Steps>For more detailed information on available actions and customization options, refer to the [HubSpot Workflows Documentation](https://knowledge.hubspot.com/workflows/create-workflows).diff --git a/docs/en/enterprise/guides/kickoff-crew.mdx b/docs/en/enterprise/guides/kickoff-crew.mdxindex c13be821f..ba2408333 100644--- a/docs/en/enterprise/guides/kickoff-crew.mdx+++ b/docs/en/enterprise/guides/kickoff-crew.mdx@@ -1,25 +1,23 @@---title: "Kickoff Crew"-description: "Kickoff a Crew on CrewAI AOP"+description: "Kickoff a Crew on CrewAI AMP"icon: "flag-checkered"mode: "wide"---## Overview-Once you've deployed your crew to the CrewAI AOP platform, you can kickoff executions through the web interface or the API. This guide covers both approaches.+Once you've deployed your crew to the CrewAI AMP platform, you can kickoff executions through the web interface or the API. This guide covers both approaches.## Method 1: Using the Web Interface### Step 1: Navigate to Your Deployed Crew-1. Log in to [CrewAI AOP](https://app.crewai.com)+1. Log in to [CrewAI AMP](https://app.crewai.com)2. Click on the crew name from your projects list3. You'll be taken to the crew's detail page-<Frame>- -</Frame>+<Frame></Frame>### Step 2: Initiate Execution@@ -31,9 +29,7 @@ From your crew's detail page, you have two options to kickoff an execution:2. Enter the required input parameters for your crew in the JSON editor3. Click the `Send Request` button-<Frame>- -</Frame>+<Frame></Frame>#### Option B: Using the Visual Interface@@ -41,9 +37,7 @@ From your crew's detail page, you have two options to kickoff an execution:2. Enter the required inputs in the form fields3. Click the `Run Crew` button-<Frame>- -</Frame>+<Frame></Frame>### Step 3: Monitor Execution Progress@@ -52,9 +46,7 @@ After initiating the execution:1. You'll receive a response containing a `kickoff_id` - **copy this ID**2. This ID is essential for tracking your execution-<Frame>- -</Frame>+<Frame></Frame>### Step 4: Check Execution Status@@ -64,11 +56,10 @@ To monitor the progress of your execution:2. Paste the `kickoff_id` into the designated field3. Click the "Get Status" button-<Frame>- -</Frame>+<Frame></Frame>The status response will show:+- Current execution state (`running`, `completed`, etc.)- Details about which tasks are in progress- Any outputs produced so far@@ -83,7 +74,7 @@ Once execution is complete:## Method 2: Using the API-You can also kickoff crews programmatically using the CrewAI AOP REST API.+You can also kickoff crews programmatically using the CrewAI AMP REST API.### Authentication@@ -122,7 +113,7 @@ curl -X GET \The response will be a JSON object containing an array of required input parameters, for example:```json-{"inputs":["topic","current_year"]}+{ "inputs": ["topic", "current_year"] }```This example shows that this particular crew requires two inputs: `topic` and `current_year`.@@ -142,7 +133,7 @@ curl -X POST \The response will include a `kickoff_id` that you'll need for tracking:```json-{"kickoff_id":"abcd1234-5678-90ef-ghij-klmnopqrstuv"}+{ "kickoff_id": "abcd1234-5678-90ef-ghij-klmnopqrstuv" }```### Step 3: Check Execution Status@@ -182,5 +173,6 @@ If an execution fails:3. Look for LLM responses and tool usage in the trace details<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with execution issues or questions about the Enterprise platform.+ Contact our support team for assistance with execution issues or questions+ about the Enterprise platform.</Card>diff --git a/docs/en/enterprise/guides/microsoft-teams-trigger.mdx b/docs/en/enterprise/guides/microsoft-teams-trigger.mdxindex 5c9bf0b15..8b69c65b2 100644--- a/docs/en/enterprise/guides/microsoft-teams-trigger.mdx+++ b/docs/en/enterprise/guides/microsoft-teams-trigger.mdx@@ -10,17 +10,21 @@ mode: "wide"Use the Microsoft Teams trigger to start automations whenever a new chat is created. Common patterns include summarizing inbound requests, routing urgent messages to support teams, or creating follow-up tasks in other systems.<Tip>- Confirm Microsoft Teams is connected under **Tools & Integrations** and enabled in the **Triggers** tab for your deployment.+ Confirm Microsoft Teams is connected under **Tools & Integrations** and+ enabled in the **Triggers** tab for your deployment.</Tip>## Enabling the Microsoft Teams Trigger-1. Open your deployment in CrewAI AOP+1. Open your deployment in CrewAI AMP2. Go to the **Triggers** tab3. Locate **Microsoft Teams** and switch the toggle to enable<Frame caption="Microsoft Teams trigger connection">- <img src="/images/enterprise/msteams-trigger.png" alt="Enable or disable triggers with toggle" />+ <img+ src="/images/enterprise/msteams-trigger.png"+ alt="Enable or disable triggers with toggle"+ /></Frame>## Example: Summarize a new chat thread@@ -52,7 +56,9 @@ crewai triggers run microsoft_teams/teams_message_createdThe `crewai triggers run` command will execute your crew with a complete Teams payload, allowing you to test your parsing logic before deployment.<Warning>- Use `crewai triggers run microsoft_teams/teams_message_created` (not `crewai run`) to simulate trigger execution during development. After deployment, your crew will automatically receive the trigger payload.+ Use `crewai triggers run microsoft_teams/teams_message_created` (not `crewai+ run`) to simulate trigger execution during development. After deployment, your+ crew will automatically receive the trigger payload.</Warning>## Troubleshootingdiff --git a/docs/en/enterprise/guides/onedrive-trigger.mdx b/docs/en/enterprise/guides/onedrive-trigger.mdxindex 8fe5bb2fd..a9280f5b1 100644--- a/docs/en/enterprise/guides/onedrive-trigger.mdx+++ b/docs/en/enterprise/guides/onedrive-trigger.mdx@@ -10,17 +10,21 @@ mode: "wide"Start automations when files change inside OneDrive. You can generate audit summaries, notify security teams about external sharing, or update downstream line-of-business systems with new document metadata.<Tip>- Connect OneDrive in **Tools & Integrations** and toggle the trigger on for your deployment.+ Connect OneDrive in **Tools & Integrations** and toggle the trigger on for+ your deployment.</Tip>## Enabling the OneDrive Trigger-1. Open your deployment in CrewAI AOP+1. Open your deployment in CrewAI AMP2. Go to the **Triggers** tab3. Locate **OneDrive** and switch the toggle to enable<Frame caption="Microsoft OneDrive trigger connection">- <img src="/images/enterprise/onedrive-trigger.png" alt="Enable or disable triggers with toggle" />+ <img+ src="/images/enterprise/onedrive-trigger.png"+ alt="Enable or disable triggers with toggle"+ /></Frame>## Example: Audit file permissions@@ -51,7 +55,9 @@ crewai triggers run microsoft_onedrive/file_changedThe `crewai triggers run` command will execute your crew with a complete OneDrive payload, allowing you to test your parsing logic before deployment.<Warning>- Use `crewai triggers run microsoft_onedrive/file_changed` (not `crewai run`) to simulate trigger execution during development. After deployment, your crew will automatically receive the trigger payload.+ Use `crewai triggers run microsoft_onedrive/file_changed` (not `crewai run`)+ to simulate trigger execution during development. After deployment, your crew+ will automatically receive the trigger payload.</Warning>## Troubleshootingdiff --git a/docs/en/enterprise/guides/outlook-trigger.mdx b/docs/en/enterprise/guides/outlook-trigger.mdxindex 3bc28817b..ce1bd30a0 100644--- a/docs/en/enterprise/guides/outlook-trigger.mdx+++ b/docs/en/enterprise/guides/outlook-trigger.mdx@@ -10,17 +10,21 @@ mode: "wide"Automate responses when Outlook delivers a new message or when an event is removed from the calendar. Teams commonly route escalations, file tickets, or alert attendees of cancellations.<Tip>- Connect Outlook in **Tools & Integrations** and ensure the trigger is enabled for your deployment.+ Connect Outlook in **Tools & Integrations** and ensure the trigger is enabled+ for your deployment.</Tip>## Enabling the Outlook Trigger-1. Open your deployment in CrewAI AOP+1. Open your deployment in CrewAI AMP2. Go to the **Triggers** tab3. Locate **Outlook** and switch the toggle to enable<Frame caption="Microsoft Outlook trigger connection">- <img src="/images/enterprise/outlook-trigger.png" alt="Enable or disable triggers with toggle" />+ <img+ src="/images/enterprise/outlook-trigger.png"+ alt="Enable or disable triggers with toggle"+ /></Frame>## Example: Summarize a new email@@ -51,7 +55,9 @@ crewai triggers run microsoft_outlook/email_receivedThe `crewai triggers run` command will execute your crew with a complete Outlook payload, allowing you to test your parsing logic before deployment.<Warning>- Use `crewai triggers run microsoft_outlook/email_received` (not `crewai run`) to simulate trigger execution during development. After deployment, your crew will automatically receive the trigger payload.+ Use `crewai triggers run microsoft_outlook/email_received` (not `crewai run`)+ to simulate trigger execution during development. After deployment, your crew+ will automatically receive the trigger payload.</Warning>## Troubleshootingdiff --git a/docs/en/enterprise/guides/react-component-export.mdx b/docs/en/enterprise/guides/react-component-export.mdxindex 94a00d820..47012db8d 100644--- a/docs/en/enterprise/guides/react-component-export.mdx+++ b/docs/en/enterprise/guides/react-component-export.mdx@@ -1,11 +1,11 @@---title: "React Component Export"-description: "Learn how to export and integrate CrewAI AOP React components into your applications"+description: "Learn how to export and integrate CrewAI AMP React components into your applications"icon: "react"mode: "wide"----This guide explains how to export CrewAI AOP crews as React components and integrate them into your own applications.+This guide explains how to export CrewAI AMP crews as React components and integrate them into your own applications.## Exporting a React Component@@ -17,6 +17,7 @@ This guide explains how to export CrewAI AOP crews as React components and integ<img src="/images/enterprise/export-react-component.png" alt="Export React Component" /></Frame></Step>+</Steps>## Setting Up Your React Environment@@ -83,6 +84,7 @@ To run this React component locally, you'll need to set up a React development e```- This will start the development server, and your default web browser should open automatically to http://localhost:3000, where you'll see your React app running.</Step>+</Steps>## Customization@@ -90,10 +92,16 @@ To run this React component locally, you'll need to set up a React development eYou can then customise the `CrewLead.jsx` to add color, title etc<Frame>- <img src="/images/enterprise/customise-react-component.png" alt="Customise React Component" />+ <img+ src="/images/enterprise/customise-react-component.png"+ alt="Customise React Component"+ /></Frame><Frame>- <img src="/images/enterprise/customise-react-component-2.png" alt="Customise React Component" />+ <img+ src="/images/enterprise/customise-react-component-2.png"+ alt="Customise React Component"+ /></Frame>## Next Stepsdiff --git a/docs/en/enterprise/guides/salesforce-trigger.mdx b/docs/en/enterprise/guides/salesforce-trigger.mdxindex 9dc563061..4b0010edb 100644--- a/docs/en/enterprise/guides/salesforce-trigger.mdx+++ b/docs/en/enterprise/guides/salesforce-trigger.mdx@@ -5,7 +5,7 @@ icon: "salesforce"mode: "wide"----CrewAI AOP can be triggered from Salesforce to automate customer relationship management workflows and enhance your sales operations.+CrewAI AMP can be triggered from Salesforce to automate customer relationship management workflows and enhance your sales operations.## Overview@@ -31,7 +31,7 @@ Salesforce is a leading customer relationship management (CRM) platform that helTo set up Salesforce triggers:-1. **Contact Support**: Reach out to CrewAI AOP support for assistance with Salesforce trigger setup+1. **Contact Support**: Reach out to CrewAI AMP support for assistance with Salesforce trigger setup2. **Review Requirements**: Ensure you have the necessary Salesforce permissions and API access3. **Configure Connection**: Work with the support team to establish the connection between CrewAI and your Salesforce instance4. **Test Triggers**: Verify the triggers work correctly with your specific use cases@@ -47,4 +47,4 @@ Common Salesforce + CrewAI trigger scenarios include:## Next Steps-For detailed setup instructions and advanced configuration options, please contact CrewAI AOP support who can provide tailored guidance for your specific Salesforce environment and business needs.+For detailed setup instructions and advanced configuration options, please contact CrewAI AMP support who can provide tailored guidance for your specific Salesforce environment and business needs.diff --git a/docs/en/enterprise/guides/team-management.mdx b/docs/en/enterprise/guides/team-management.mdxindex 166f0e21f..c9258cd4d 100644--- a/docs/en/enterprise/guides/team-management.mdx+++ b/docs/en/enterprise/guides/team-management.mdx@@ -1,40 +1,39 @@---title: "Team Management"-description: "Learn how to invite and manage team members in your CrewAI AOP organization"+description: "Learn how to invite and manage team members in your CrewAI AMP organization"icon: "users"mode: "wide"----As an administrator of a CrewAI AOP account, you can easily invite new team members to join your organization. This guide will walk you through the process step-by-step.+As an administrator of a CrewAI AMP account, you can easily invite new team members to join your organization. This guide will walk you through the process step-by-step.## Inviting Team Members<Steps>- <Step title="Access the Settings Page">- - Log in to your CrewAI AOP account- - Look for the gear icon (⚙️) in the top right corner of the dashboard- - Click on the gear icon to access the **Settings** page:- <Frame caption="Settings page">- <img src="/images/enterprise/settings-page.png" alt="Settings Page" />- </Frame>- </Step>- <Step title="Navigate to the Members Section">- - On the Settings page, you'll see a `Members` tab- - Click on the `Members` tab to access the **Members** page:- <Frame caption="Members tab">- <img src="/images/enterprise/members-tab.png" alt="Members Tab" />- </Frame>- </Step>- <Step title="Invite New Members">- - In the Members section, you'll see a list of current members (including yourself)- - Locate the `Email` input field- - Enter the email address of the person you want to invite- - Click the `Invite` button to send the invitation- </Step>- <Step title="Repeat as Needed">- - You can repeat this process to invite multiple team members- - Each invited member will receive an email invitation to join your organization- </Step>+ <Step title="Access the Settings Page">+ - Log in to your CrewAI AMP account - Look for the gear icon (⚙️) in the top+ right corner of the dashboard - Click on the gear icon to access the+ **Settings** page:+ <Frame caption="Settings page">+ <img src="/images/enterprise/settings-page.png" alt="Settings Page" />+ </Frame>+ </Step>+ <Step title="Navigate to the Members Section">+ - On the Settings page, you'll see a `Members` tab - Click on the `Members`+ tab to access the **Members** page:+ <Frame caption="Members tab">+ <img src="/images/enterprise/members-tab.png" alt="Members Tab" />+ </Frame>+ </Step>+ <Step title="Invite New Members">+ - In the Members section, you'll see a list of current members (including+ yourself) - Locate the `Email` input field - Enter the email address of the+ person you want to invite - Click the `Invite` button to send the invitation+ </Step>+ <Step title="Repeat as Needed">+ - You can repeat this process to invite multiple team members - Each invited+ member will receive an email invitation to join your organization+ </Step></Steps>## Adding Roles@@ -42,40 +41,44 @@ As an administrator of a CrewAI AOP account, you can easily invite new team membYou can add roles to your team members to control their access to different parts of the platform.<Steps>- <Step title="Access the Settings Page">- - Log in to your CrewAI AOP account- - Look for the gear icon (⚙️) in the top right corner of the dashboard- - Click on the gear icon to access the **Settings** page:- <Frame>- <img src="/images/enterprise/settings-page.png" alt="Settings Page" />- </Frame>- </Step>- <Step title="Navigate to the Members Section">- - On the Settings page, you'll see a `Roles` tab- - Click on the `Roles` tab to access the **Roles** page.- <Frame>- <img src="/images/enterprise/roles-tab.png" alt="Roles Tab" />- </Frame>- - Click on the `Add Role` button to add a new role.- - Enter the details and permissions of the role and click the `Create Role` button to create the role.- <Frame>- <img src="/images/enterprise/add-role-modal.png" alt="Add Role Modal" />- </Frame>- </Step>- <Step title="Add Roles to Members">- - In the Members section, you'll see a list of current members (including yourself)- <Frame>- <img src="/images/enterprise/member-accepted-invitation.png" alt="Member Accepted Invitation" />- </Frame>- - Once the member has accepted the invitation, you can add a role to them.- - Navigate back to `Roles` tab- - Go to the member you want to add a role to and under the `Role` column, click on the dropdown- - Select the role you want to add to the member- - Click the `Update` button to save the role- <Frame>- <img src="/images/enterprise/assign-role.png" alt="Add Role to Member" />- </Frame>- </Step>+ <Step title="Access the Settings Page">+ - Log in to your CrewAI AMP account - Look for the gear icon (⚙️) in the top+ right corner of the dashboard - Click on the gear icon to access the+ **Settings** page:+ <Frame>+ <img src="/images/enterprise/settings-page.png" alt="Settings Page" />+ </Frame>+ </Step>+ <Step title="Navigate to the Members Section">+ - On the Settings page, you'll see a `Roles` tab - Click on the `Roles` tab+ to access the **Roles** page.+ <Frame>+ <img src="/images/enterprise/roles-tab.png" alt="Roles Tab" />+ </Frame>+ - Click on the `Add Role` button to add a new role. - Enter the+ details and permissions of the role and click the `Create Role` button to+ create the role.+ <Frame>+ <img src="/images/enterprise/add-role-modal.png" alt="Add Role Modal" />+ </Frame>+ </Step>+ <Step title="Add Roles to Members">+ - In the Members section, you'll see a list of current members (including+ yourself)+ <Frame>+ <img+ src="/images/enterprise/member-accepted-invitation.png"+ alt="Member Accepted Invitation"+ />+ </Frame>+ - Once the member has accepted the invitation, you can add a role to+ them. - Navigate back to `Roles` tab - Go to the member you want to add a+ role to and under the `Role` column, click on the dropdown - Select the role+ you want to add to the member - Click the `Update` button to save the role+ <Frame>+ <img src="/images/enterprise/assign-role.png" alt="Add Role to Member" />+ </Frame>+ </Step></Steps>## Important Notes@@ -85,4 +88,4 @@ You can add roles to your team members to control their access to different part- **Invitation Acceptance**: Invited members will need to accept the invitation to join your organization- **Email Notifications**: You may want to inform your team members to check their email (including spam folders) for the invitation-By following these steps, you can easily expand your team and collaborate more effectively within your CrewAI AOP organization.+By following these steps, you can easily expand your team and collaborate more effectively within your CrewAI AMP organization.diff --git a/docs/en/enterprise/guides/tool-repository.mdx b/docs/en/enterprise/guides/tool-repository.mdxindex 6a28d74bb..850d4efe8 100644--- a/docs/en/enterprise/guides/tool-repository.mdx+++ b/docs/en/enterprise/guides/tool-repository.mdx@@ -20,11 +20,11 @@ The repository is not a version control system. Use Git to track code changes anBefore using the Tool Repository, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account+- A [CrewAI AMP](https://app.crewai.com) account- [CrewAI CLI](/en/concepts/cli#cli) installed- uv>=0.5.0 installed. Check out [how to upgrade](https://docs.astral.sh/uv/getting-started/installation/#upgrading-uv)- [Git](https://git-scm.com) installed and configured-- Access permissions to publish or install tools in your CrewAI AOP organization+- Access permissions to publish or install tools in your CrewAI AMP organization## Installing Tools@@ -54,11 +54,11 @@ researcher = Agent(## Adding other packages after installing a tool-After installing a tool from the CrewAI AOP Tool Repository, you need to use the `crewai uv` command to add other packages to your project.+After installing a tool from the CrewAI AMP Tool Repository, you need to use the `crewai uv` command to add other packages to your project.Using pure `uv` commands will fail due to authentication to tool repository being handled by the CLI. By using the `crewai uv` command, you can add other packages to your project without having to worry about authentication.Any `uv` command can be used with the `crewai uv` command, making it a powerful tool for managing your project's dependencies without the hassle of managing authentication through environment variables or other methods.-Say that you have installed a custom tool from the CrewAI AOP Tool Repository called "my-tool":+Say that you have installed a custom tool from the CrewAI AMP Tool Repository called "my-tool":```bashcrewai tool install my-tool@@ -131,13 +131,13 @@ crewai tool publishTo delete a tool:-1. Go to [CrewAI AOP](https://app.crewai.com)+1. Go to [CrewAI AMP](https://app.crewai.com)2. Navigate to **Tools**3. Select the tool4. Click **Delete**<Warning>-Deletion is permanent. Deleted tools cannot be restored or re-installed.+ Deletion is permanent. Deleted tools cannot be restored or re-installed.</Warning>## Security Checks@@ -146,8 +146,9 @@ Every published version undergoes automated security checks, and are only availaYou can check the security check status of a tool at:-`CrewAI AOP > Tools > Your Tool > Versions`+`CrewAI AMP > Tools > Your Tool > Versions`<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with API integration or troubleshooting.+ Contact our support team for assistance with API integration or+ troubleshooting.</Card>diff --git a/docs/en/enterprise/guides/update-crew.mdx b/docs/en/enterprise/guides/update-crew.mdxindex 2d40173a3..991b3248a 100644--- a/docs/en/enterprise/guides/update-crew.mdx+++ b/docs/en/enterprise/guides/update-crew.mdx@@ -1,13 +1,14 @@---title: "Update Crew"-description: "Updating a Crew on CrewAI AOP"+description: "Updating a Crew on CrewAI AMP"icon: "pencil"mode: "wide"---<Note>-After deploying your crew to CrewAI AOP, you may need to make updates to the code, security settings, or configuration.-This guide explains how to perform these common update operations.+ After deploying your crew to CrewAI AMP, you may need to make updates to the+ code, security settings, or configuration. This guide explains how to perform+ these common update operations.</Note>## Why Update Your Crew?@@ -15,6 +16,7 @@ This guide explains how to perform these common update operations.CrewAI won't automatically pick up GitHub updates by default, so you'll need to manually trigger updates, unless you checked the `Auto-update` option when deploying your crew.There are several reasons you might want to update your crew deployment:+- You want to update the code with a latest commit you pushed to GitHub- You want to reset the bearer token for security reasons- You want to update environment variables@@ -23,12 +25,10 @@ There are several reasons you might want to update your crew deployment:When you've pushed new commits to your GitHub repository and want to update your deployment:-1. Navigate to your crew in the CrewAI AOP platform+1. Navigate to your crew in the CrewAI AMP platform2. Click on the `Re-deploy` button on your crew details page-<Frame>- -</Frame>+<Frame></Frame>This will trigger an update that you can track using the progress bar. The system will pull the latest code from your repository and rebuild your deployment.@@ -36,16 +36,15 @@ This will trigger an update that you can track using the progress bar. The systeIf you need to generate a new bearer token (for example, if you suspect the current token might have been compromised):-1. Navigate to your crew in the CrewAI AOP platform+1. Navigate to your crew in the CrewAI AMP platform2. Find the `Bearer Token` section3. Click the `Reset` button next to your current token-<Frame>- -</Frame>+<Frame></Frame><Warning>-Resetting your bearer token will invalidate the previous token immediately. Make sure to update any applications or scripts that are using the old token.+ Resetting your bearer token will invalidate the previous token immediately.+ Make sure to update any applications or scripts that are using the old token.</Warning>## 3. Updating Environment Variables@@ -69,7 +68,8 @@ To update the environment variables for your crew:5. Finally, click the `Update Deployment` button at the bottom of the page to apply the changes<Note>-Updating environment variables will trigger a new deployment, but this will only update the environment configuration and not the code itself.+ Updating environment variables will trigger a new deployment, but this will+ only update the environment configuration and not the code itself.</Note>## After Updating@@ -81,9 +81,11 @@ After performing any update:3. Once complete, test your crew to ensure the changes are working as expected<Tip>-If you encounter any issues after updating, you can view deployment logs in the platform or contact support for assistance.+ If you encounter any issues after updating, you can view deployment logs in+ the platform or contact support for assistance.</Tip><Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with updating your crew or troubleshooting deployment issues.+ Contact our support team for assistance with updating your crew or+ troubleshooting deployment issues.</Card>diff --git a/docs/en/enterprise/guides/webhook-automation.mdx b/docs/en/enterprise/guides/webhook-automation.mdxindex 3cab2fbd2..399ce0728 100644--- a/docs/en/enterprise/guides/webhook-automation.mdx+++ b/docs/en/enterprise/guides/webhook-automation.mdx@@ -1,17 +1,17 @@---title: "Webhook Automation"-description: "Automate CrewAI AOP workflows using webhooks with platforms like ActivePieces, Zapier, and Make.com"+description: "Automate CrewAI AMP workflows using webhooks with platforms like ActivePieces, Zapier, and Make.com"icon: "webhook"mode: "wide"----CrewAI AOP allows you to automate your workflow using webhooks. This article will guide you through the process of setting up and using webhooks to kickoff your crew execution, with a focus on integration with ActivePieces, a workflow automation platform similar to Zapier and Make.com.+CrewAI AMP allows you to automate your workflow using webhooks. This article will guide you through the process of setting up and using webhooks to kickoff your crew execution, with a focus on integration with ActivePieces, a workflow automation platform similar to Zapier and Make.com.## Setting Up Webhooks<Steps><Step title="Accessing the Kickoff Interface">- - Navigate to the CrewAI AOP dashboard+ - Navigate to the CrewAI AMP dashboard- Look for the `/kickoff` section, which is used to start the crew execution<Frame><img src="/images/enterprise/kickoff-interface.png" alt="Kickoff Interface" />@@ -44,7 +44,7 @@ CrewAI AOP allows you to automate your workflow using webhooks. This article wil3. Add an HTTP action step- Set the action to `Send HTTP request`- Use `POST` as the method- - Set the URL to your CrewAI AOP kickoff endpoint+ - Set the URL to your CrewAI AMP kickoff endpoint- Add necessary headers (e.g., `Bearer Token`)<Frame><img src="/images/enterprise/activepieces-headers.png" alt="ActivePieces Headers" />@@ -76,6 +76,7 @@ CrewAI AOP allows you to automate your workflow using webhooks. This article wil<img src="/images/enterprise/activepieces-email.png" alt="ActivePieces Email" /></Frame></Step>+</Steps>## Webhook Output Examples@@ -152,4 +153,5 @@ CrewAI AOP allows you to automate your workflow using webhooks. This article wil}```</Tab>+</Tabs>diff --git a/docs/en/enterprise/guides/zapier-trigger.mdx b/docs/en/enterprise/guides/zapier-trigger.mdxindex c7cfd70f1..74400b884 100644--- a/docs/en/enterprise/guides/zapier-trigger.mdx+++ b/docs/en/enterprise/guides/zapier-trigger.mdx@@ -5,11 +5,11 @@ icon: "bolt"mode: "wide"----This guide will walk you through the process of setting up Zapier triggers for CrewAI AOP, allowing you to automate workflows between CrewAI AOP and other applications.+This guide will walk you through the process of setting up Zapier triggers for CrewAI AMP, allowing you to automate workflows between CrewAI AMP and other applications.## Prerequisites-- A CrewAI AOP account+- A CrewAI AMP account- A Zapier account- A Slack account (for this specific example)@@ -32,7 +32,7 @@ This guide will walk you through the process of setting up Zapier triggers for C- Connect your Slack account if you haven't already.</Step>- <Step title="Configure the CrewAI AOP Action">+ <Step title="Configure the CrewAI AMP Action">- Add a new action step to your Zap.- Choose CrewAI+ as your action app and Kickoff as the Action Event@@ -41,8 +41,8 @@ This guide will walk you through the process of setting up Zapier triggers for C</Frame></Step>- <Step title="Connect your CrewAI AOP account">- - Connect your CrewAI AOP account.+ <Step title="Connect your CrewAI AMP account">+ - Connect your CrewAI AMP account.- Select the appropriate Crew for your workflow.<Frame>@@ -51,8 +51,8 @@ This guide will walk you through the process of setting up Zapier triggers for C- Configure the inputs for the Crew using the data from the Slack message.</Step>- <Step title="Format the CrewAI AOP Output">- - Add another action step to format the text output from CrewAI AOP.+ <Step title="Format the CrewAI AMP Output">+ - Add another action step to format the text output from CrewAI AMP.- Use Zapier's formatting tools to convert the Markdown output to HTML.<Frame>@@ -67,7 +67,7 @@ This guide will walk you through the process of setting up Zapier triggers for C- Add a final action step to send the formatted output via email.- Choose your preferred email service (e.g., Gmail, Outlook).- Configure the email details, including recipient, subject, and body.- - Insert the formatted CrewAI AOP output into the email body.+ - Insert the formatted CrewAI AMP output into the email body.<Frame><img src="/images/enterprise/zapier-7.png" alt="Zapier 7" />@@ -93,12 +93,13 @@ This guide will walk you through the process of setting up Zapier triggers for C<img src="/images/enterprise/zapier-9.png" alt="Zapier 12" /></Frame></Step>+</Steps>## Tips for Success-- Ensure that your CrewAI AOP inputs are correctly mapped from the Slack message.+- Ensure that your CrewAI AMP inputs are correctly mapped from the Slack message.- Test your Zap thoroughly before turning it on to catch any potential issues.- Consider adding error handling steps to manage potential failures in the workflow.-By following these steps, you'll have successfully set up Zapier triggers for CrewAI AOP, allowing for automated workflows triggered by Slack messages and resulting in email notifications with CrewAI AOP output.+By following these steps, you'll have successfully set up Zapier triggers for CrewAI AMP, allowing for automated workflows triggered by Slack messages and resulting in email notifications with CrewAI AMP output.diff --git a/docs/en/enterprise/integrations/asana.mdx b/docs/en/enterprise/integrations/asana.mdxindex 9a858cb15..4b025b674 100644--- a/docs/en/enterprise/integrations/asana.mdx+++ b/docs/en/enterprise/integrations/asana.mdx@@ -13,7 +13,7 @@ Enable your agents to manage tasks, projects, and team coordination through AsanBefore using the Asana integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- An Asana account with appropriate permissions- Connected your Asana account through the [Integrations page](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Before using the Asana integration, ensure you have:### 1. Connect Your Asana Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **Asana** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for task and project management@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -58,6 +60,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `task` (string, required): Task ID - The ID of the Task the comment will be added to. The comment will be authored by the currently authenticated user.- `text` (string, required): Text (example: "This is a comment.").+</Accordion><Accordion title="asana/create_project">@@ -68,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `workspace` (string, required): Workspace - Use Connect Portal Workflow Settings to allow users to select which Workspace to create Projects in. Defaults to the user's first Workspace if left blank.- `team` (string, optional): Team - Use Connect Portal Workflow Settings to allow users to select which Team to share this Project with. Defaults to the user's first Team if left blank.- `notes` (string, optional): Notes (example: "These are things we need to purchase.").+</Accordion><Accordion title="asana/get_projects">@@ -76,6 +80,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `archived` (string, optional): Archived - Choose "true" to show archived projects, "false" to display only active projects, or "default" to show both archived and active projects.- Options: `default`, `true`, `false`+</Accordion><Accordion title="asana/get_project_by_id">@@ -83,6 +88,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `projectFilterId` (string, required): Project ID.+</Accordion><Accordion title="asana/create_task">@@ -97,6 +103,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `dueAtDate` (string, optional): Due At - The date and time (ISO timestamp) at which this task is due. Cannot be used together with Due On. (example: "2019-09-15T02:06:58.147Z").- `assignee` (string, optional): Assignee - The ID of the Asana user this task will be assigned to. Use Connect Portal Workflow Settings to allow users to select an Assignee.- `gid` (string, optional): External ID - An ID from your application to associate this task with. You can use this ID to sync updates to this task later.+</Accordion><Accordion title="asana/update_task">@@ -112,6 +119,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `dueAtDate` (string, optional): Due At - The date and time (ISO timestamp) at which this task is due. Cannot be used together with Due On. (example: "2019-09-15T02:06:58.147Z").- `assignee` (string, optional): Assignee - The ID of the Asana user this task will be assigned to. Use Connect Portal Workflow Settings to allow users to select an Assignee.- `gid` (string, optional): External ID - An ID from your application to associate this task with. You can use this ID to sync updates to this task later.+</Accordion><Accordion title="asana/get_tasks">@@ -122,6 +130,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `project` (string, optional): Project - The ID of the Project to filter tasks on. Use Connect Portal Workflow Settings to allow users to select a Project.- `assignee` (string, optional): Assignee - The ID of the assignee to filter tasks on. Use Connect Portal Workflow Settings to allow users to select an Assignee.- `completedSince` (string, optional): Completed since - Only return tasks that are either incomplete or that have been completed since this time (ISO or Unix timestamp). (example: "2014-04-25T16:15:47-04:00").+</Accordion><Accordion title="asana/get_tasks_by_id">@@ -129,6 +138,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `taskId` (string, required): Task ID.+</Accordion><Accordion title="asana/get_task_by_external_id">@@ -136,6 +146,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `gid` (string, required): External ID - The ID that this task is associated or synced with, from your application.+</Accordion><Accordion title="asana/add_task_to_section">@@ -146,6 +157,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `taskId` (string, required): Task ID - The ID of the task. (example: "1204619611402340").- `beforeTaskId` (string, optional): Before Task ID - The ID of a task in this section that this task will be inserted before. Cannot be used with After Task ID. (example: "1204619611402340").- `afterTaskId` (string, optional): After Task ID - The ID of a task in this section that this task will be inserted after. Cannot be used with Before Task ID. (example: "1204619611402340").+</Accordion><Accordion title="asana/get_teams">@@ -153,12 +165,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `workspace` (string, required): Workspace - Returns the teams in this workspace visible to the authorized user.+</Accordion><Accordion title="asana/get_workspaces">**Description:** Get a list of workspaces in Asana.**Parameters:** None required.+</Accordion></AccordionGroup>diff --git a/docs/en/enterprise/integrations/box.mdx b/docs/en/enterprise/integrations/box.mdxindex 311f79594..d6e80898b 100644--- a/docs/en/enterprise/integrations/box.mdx+++ b/docs/en/enterprise/integrations/box.mdx@@ -13,7 +13,7 @@ Enable your agents to manage files, folders, and documents through Box. Upload fBefore using the Box integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A Box account with appropriate permissions- Connected your Box account through the [Integrations page](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Before using the Box integration, ensure you have:### 1. Connect Your Box Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **Box** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for file and folder management@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -66,6 +68,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token}```- `file` (string, required): File URL - Files must be smaller than 50MB in size. (example: "https://picsum.photos/200/300").+</Accordion><Accordion title="box/save_file_from_object">@@ -75,6 +78,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `file` (string, required): File - Accepts a File Object containing file data. Files must be smaller than 50MB in size.- `fileName` (string, required): File Name (example: "qwerty.png").- `folder` (string, optional): Folder - Use Connect Portal Workflow Settings to allow users to select the File's Folder destination. Defaults to the user's root folder if left blank.+</Accordion><Accordion title="box/get_file_by_id">@@ -82,6 +86,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `fileId` (string, required): File ID - The unique identifier that represents a file. (example: "12345").+</Accordion><Accordion title="box/list_files">@@ -107,6 +112,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token]}```+</Accordion><Accordion title="box/create_folder">@@ -120,6 +126,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"id": "123456"}```+</Accordion><Accordion title="box/move_folder">@@ -134,6 +141,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"id": "123456"}```+</Accordion><Accordion title="box/get_folder_by_id">@@ -141,6 +149,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `folderId` (string, required): Folder ID - The unique identifier that represents a folder. (example: "0").+</Accordion><Accordion title="box/search_folders">@@ -166,6 +175,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token]}```+</Accordion><Accordion title="box/delete_folder">@@ -174,6 +184,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `folderId` (string, required): Folder ID - The unique identifier that represents a folder. (example: "0").- `recursive` (boolean, optional): Recursive - Delete a folder that is not empty by recursively deleting the folder and all of its content.+</Accordion></AccordionGroup>diff --git a/docs/en/enterprise/integrations/clickup.mdx b/docs/en/enterprise/integrations/clickup.mdxindex 4df08011e..cc83388cb 100644--- a/docs/en/enterprise/integrations/clickup.mdx+++ b/docs/en/enterprise/integrations/clickup.mdx@@ -13,7 +13,7 @@ Enable your agents to manage tasks, projects, and productivity workflows throughBefore using the ClickUp integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A ClickUp account with appropriate permissions- Connected your ClickUp account through the [Integrations page](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Before using the ClickUp integration, ensure you have:### 1. Connect Your ClickUp Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **ClickUp** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for task and project management@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -75,6 +77,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token}```Available fields: `space_ids%5B%5D`, `project_ids%5B%5D`, `list_ids%5B%5D`, `statuses%5B%5D`, `include_closed`, `assignees%5B%5D`, `tags%5B%5D`, `due_date_gt`, `due_date_lt`, `date_created_gt`, `date_created_lt`, `date_updated_gt`, `date_updated_lt`+</Accordion><Accordion title="clickup/get_task_in_list">@@ -83,6 +86,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `listId` (string, required): List - Select a List to get tasks from. Use Connect Portal User Settings to allow users to select a ClickUp List.- `taskFilterFormula` (string, optional): Search for tasks that match specified filters. For example: name=task1.+</Accordion><Accordion title="clickup/create_task">@@ -96,6 +100,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `assignees` (string, optional): Assignees - Select a Member (or an array of member IDs) to be assigned to this task. Use Connect Portal User Settings to allow users to select a ClickUp Member.- `dueDate` (string, optional): Due Date - Specify a date for this task to be due on.- `additionalFields` (string, optional): Additional Fields - Specify additional fields to include on this task as JSON.+</Accordion><Accordion title="clickup/update_task">@@ -110,6 +115,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `assignees` (string, optional): Assignees - Select a Member (or an array of member IDs) to be assigned to this task. Use Connect Portal User Settings to allow users to select a ClickUp Member.- `dueDate` (string, optional): Due Date - Specify a date for this task to be due on.- `additionalFields` (string, optional): Additional Fields - Specify additional fields to include on this task as JSON.+</Accordion><Accordion title="clickup/delete_task">@@ -117,6 +123,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `taskId` (string, required): Task ID - The ID of the task to delete.+</Accordion><Accordion title="clickup/get_list">@@ -124,6 +131,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `spaceId` (string, required): Space ID - The ID of the space containing the lists.+</Accordion><Accordion title="clickup/get_custom_fields_in_list">@@ -131,6 +139,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `listId` (string, required): List ID - The ID of the list to get custom fields from.+</Accordion><Accordion title="clickup/get_all_fields_in_list">@@ -138,6 +147,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `listId` (string, required): List ID - The ID of the list to get all fields from.+</Accordion><Accordion title="clickup/get_space">@@ -145,6 +155,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `spaceId` (string, optional): Space ID - The ID of the space to retrieve.+</Accordion><Accordion title="clickup/get_folders">@@ -152,12 +163,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `spaceId` (string, required): Space ID - The ID of the space containing the folders.+</Accordion><Accordion title="clickup/get_member">**Description:** Get Member information in ClickUp.**Parameters:** None required.+</Accordion></AccordionGroup>@@ -284,5 +297,6 @@ crew.kickoff()### Getting Help<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with ClickUp integration setup or troubleshooting.+ Contact our support team for assistance with ClickUp integration setup or+ troubleshooting.</Card>diff --git a/docs/en/enterprise/integrations/github.mdx b/docs/en/enterprise/integrations/github.mdxindex 1f35f824d..1d4c9760f 100644--- a/docs/en/enterprise/integrations/github.mdx+++ b/docs/en/enterprise/integrations/github.mdx@@ -13,7 +13,7 @@ Enable your agents to manage repositories, issues, and releases through GitHub.Before using the GitHub integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A GitHub account with appropriate repository permissions- Connected your GitHub account through the [Integrations page](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Before using the GitHub integration, ensure you have:### 1. Connect Your GitHub Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **GitHub** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for repository and issue management@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -61,6 +63,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `title` (string, required): Issue Title - Specify the title of the issue to create.- `body` (string, optional): Issue Body - Specify the body contents of the issue to create.- `assignees` (string, optional): Assignees - Specify the assignee(s)' GitHub login as an array of strings for this issue. (example: `["octocat"]`).+</Accordion><Accordion title="github/update_issue">@@ -75,6 +78,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `assignees` (string, optional): Assignees - Specify the assignee(s)' GitHub login as an array of strings for this issue. (example: `["octocat"]`).- `state` (string, optional): State - Specify the updated state of the issue.- Options: `open`, `closed`+</Accordion><Accordion title="github/get_issue_by_number">@@ -84,6 +88,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `owner` (string, required): Owner - Specify the name of the account owner of the associated repository for this Issue. (example: "abc").- `repo` (string, required): Repository - Specify the name of the associated repository for this Issue.- `issue_number` (string, required): Issue Number - Specify the number of the issue to fetch.+</Accordion><Accordion title="github/lock_issue">@@ -95,6 +100,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `issue_number` (string, required): Issue Number - Specify the number of the issue to lock.- `lock_reason` (string, required): Lock Reason - Specify a reason for locking the issue or pull request conversation.- Options: `off-topic`, `too heated`, `resolved`, `spam`+</Accordion><Accordion title="github/search_issue">@@ -122,6 +128,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token}```Available fields: `assignee`, `creator`, `mentioned`, `labels`+</Accordion><Accordion title="github/create_release">@@ -140,6 +147,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `discussion_category_name` (string, optional): Discussion Category Name - If specified, a discussion of the specified category is created and linked to the release. The value must be a category that already exists in the repository.- `generate_release_notes` (string, optional): Release Notes - Specify whether the created release should automatically create release notes using the provided name and body specified.- Options: `true`, `false`+</Accordion><Accordion title="github/update_release">@@ -159,6 +167,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `discussion_category_name` (string, optional): Discussion Category Name - If specified, a discussion of the specified category is created and linked to the release. The value must be a category that already exists in the repository.- `generate_release_notes` (string, optional): Release Notes - Specify whether the created release should automatically create release notes using the provided name and body specified.- Options: `true`, `false`+</Accordion><Accordion title="github/get_release_by_id">@@ -168,6 +177,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `owner` (string, required): Owner - Specify the name of the account owner of the associated repository for this Release. (example: "abc").- `repo` (string, required): Repository - Specify the name of the associated repository for this Release.- `id` (string, required): Release ID - Specify the release ID of the release to fetch.+</Accordion><Accordion title="github/get_release_by_tag_name">@@ -177,6 +187,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `owner` (string, required): Owner - Specify the name of the account owner of the associated repository for this Release. (example: "abc").- `repo` (string, required): Repository - Specify the name of the associated repository for this Release.- `tag_name` (string, required): Name - Specify the tag of the release to fetch. (example: "v1.0.0").+</Accordion><Accordion title="github/delete_release">@@ -186,6 +197,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `owner` (string, required): Owner - Specify the name of the account owner of the associated repository for this Release. (example: "abc").- `repo` (string, required): Repository - Specify the name of the associated repository for this Release.- `id` (string, required): Release ID - Specify the ID of the release to delete.+</Accordion></AccordionGroup>@@ -314,5 +326,6 @@ crew.kickoff()### Getting Help<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with GitHub integration setup or troubleshooting.+ Contact our support team for assistance with GitHub integration setup or+ troubleshooting.</Card>diff --git a/docs/en/enterprise/integrations/gmail.mdx b/docs/en/enterprise/integrations/gmail.mdxindex b9520a19f..681b6c53c 100644--- a/docs/en/enterprise/integrations/gmail.mdx+++ b/docs/en/enterprise/integrations/gmail.mdx@@ -13,7 +13,7 @@ Enable your agents to manage emails, contacts, and drafts through Gmail. Send emBefore using the Gmail integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A Gmail account with appropriate permissions- Connected your Gmail account through the [Integrations page](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Before using the Gmail integration, ensure you have:### 1. Connect Your Gmail Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **Gmail** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for email and contact management@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -62,6 +64,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `pageToken` (string, optional): Page token to retrieve a specific page of results.- `labelIds` (array, optional): Only return messages with labels that match all of the specified label IDs.- `includeSpamTrash` (boolean, optional): Include messages from SPAM and TRASH in the results. (default: false)+</Accordion><Accordion title="gmail/send_email">@@ -77,6 +80,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `from` (string, optional): Sender email address (if different from authenticated user).- `replyTo` (string, optional): Reply-to email address.- `threadId` (string, optional): Thread ID if replying to an existing conversation.+</Accordion><Accordion title="gmail/delete_email">@@ -85,6 +89,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `userId` (string, required): The user's email address or 'me' for the authenticated user.- `id` (string, required): The ID of the message to delete.+</Accordion><Accordion title="gmail/create_draft">@@ -94,6 +99,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `userId` (string, required): The user's email address or 'me' for the authenticated user.- `message` (object, required): Message object containing the draft content.- `raw` (string, required): Base64url encoded email message.+</Accordion><Accordion title="gmail/get_message">@@ -104,6 +110,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `id` (string, required): The ID of the message to retrieve.- `format` (string, optional): The format to return the message in. Options: "full", "metadata", "minimal", "raw". (default: "full")- `metadataHeaders` (array, optional): When given and format is METADATA, only include headers specified.+</Accordion><Accordion title="gmail/get_attachment">@@ -113,6 +120,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `userId` (string, required): The user's email address or 'me' for the authenticated user. (default: "me")- `messageId` (string, required): The ID of the message containing the attachment.- `id` (string, required): The ID of the attachment to retrieve.+</Accordion><Accordion title="gmail/fetch_thread">@@ -123,6 +131,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `id` (string, required): The ID of the thread to retrieve.- `format` (string, optional): The format to return the messages in. Options: "full", "metadata", "minimal". (default: "full")- `metadataHeaders` (array, optional): When given and format is METADATA, only include headers specified.+</Accordion><Accordion title="gmail/modify_thread">@@ -133,6 +142,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `id` (string, required): The ID of the thread to modify.- `addLabelIds` (array, optional): A list of IDs of labels to add to this thread.- `removeLabelIds` (array, optional): A list of IDs of labels to remove from this thread.+</Accordion><Accordion title="gmail/trash_thread">@@ -141,6 +151,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `userId` (string, required): The user's email address or 'me' for the authenticated user. (default: "me")- `id` (string, required): The ID of the thread to trash.+</Accordion><Accordion title="gmail/untrash_thread">@@ -149,6 +160,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `userId` (string, required): The user's email address or 'me' for the authenticated user. (default: "me")- `id` (string, required): The ID of the thread to untrash.+</Accordion></AccordionGroup>@@ -286,5 +298,6 @@ crew.kickoff()### Getting Help<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with Gmail integration setup or troubleshooting.+ Contact our support team for assistance with Gmail integration setup or+ troubleshooting.</Card>diff --git a/docs/en/enterprise/integrations/google_calendar.mdx b/docs/en/enterprise/integrations/google_calendar.mdxindex fc0478011..e3c35f2ef 100644--- a/docs/en/enterprise/integrations/google_calendar.mdx+++ b/docs/en/enterprise/integrations/google_calendar.mdx@@ -13,7 +13,7 @@ Enable your agents to manage calendar events, schedules, and availability througBefore using the Google Calendar integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A Google account with Google Calendar access- Connected your Google account through the [Integrations page](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Before using the Google Calendar integration, ensure you have:### 1. Connect Your Google Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **Google Calendar** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for calendar access@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -69,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `timeZone` (string, optional): Time zone used in the response. The default is UTC.- `groupExpansionMax` (integer, optional): Maximal number of calendar identifiers to be provided for a single group. Maximum: 100- `calendarExpansionMax` (integer, optional): Maximal number of calendars for which FreeBusy information is to be provided. Maximum: 50+</Accordion><Accordion title="google_calendar/create_event">@@ -117,6 +120,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token```- `visibility` (string, optional): Visibility of the event. Options: default, public, private, confidential. Default: default- `transparency` (string, optional): Whether the event blocks time on the calendar. Options: opaque, transparent. Default: opaque+</Accordion><Accordion title="google_calendar/view_events">@@ -136,6 +140,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `timeZone` (string, optional): Time zone used in the response.- `updatedMin` (string, optional): Lower bound for an event's last modification time (RFC3339) to filter by.- `iCalUID` (string, optional): Specifies an event ID in the iCalendar format to be provided in the response.+</Accordion><Accordion title="google_calendar/update_event">@@ -148,6 +153,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `description` (string, optional): Updated event description- `start_dateTime` (string, optional): Updated start time- `end_dateTime` (string, optional): Updated end time+</Accordion><Accordion title="google_calendar/delete_event">@@ -156,6 +162,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `calendarId` (string, required): Calendar ID- `eventId` (string, required): Event ID to delete+</Accordion><Accordion title="google_calendar/view_calendar_list">@@ -167,6 +174,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `showDeleted` (boolean, optional): Whether to include deleted calendar list entries in the result. Default: false- `showHidden` (boolean, optional): Whether to show hidden entries. Default: false- `minAccessRole` (string, optional): The minimum access role for the user in the returned entries. Options: freeBusyReader, owner, reader, writer+</Accordion></AccordionGroup>@@ -327,22 +335,26 @@ crew.kickoff()### Common Issues**Authentication Errors**+- Ensure your Google account has the necessary permissions for calendar access- Verify that the OAuth connection includes all required scopes for Google Calendar API- Check if calendar sharing settings allow the required access level**Event Creation Issues**+- Verify that time formats are correct (RFC3339 format)- Ensure attendee email addresses are properly formatted- Check that the target calendar exists and is accessible- Verify time zones are correctly specified**Availability and Time Conflicts**+- Use proper RFC3339 format for time ranges when checking availability- Ensure time zones are consistent across all operations- Verify that calendar IDs are correct when checking multiple calendars**Event Updates and Deletions**+- Verify that event IDs are correct and events exist- Ensure you have edit permissions for the events- Check that calendar ownership allows modifications@@ -350,5 +362,6 @@ crew.kickoff()### Getting Help<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with Google Calendar integration setup or troubleshooting.+ Contact our support team for assistance with Google Calendar integration setup+ or troubleshooting.</Card>diff --git a/docs/en/enterprise/integrations/google_contacts.mdx b/docs/en/enterprise/integrations/google_contacts.mdxindex 1a5c1309b..2e8de6aaf 100644--- a/docs/en/enterprise/integrations/google_contacts.mdx+++ b/docs/en/enterprise/integrations/google_contacts.mdx@@ -13,7 +13,7 @@ Enable your agents to manage contacts and directory information through Google CBefore using the Google Contacts integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A Google account with Google Contacts access- Connected your Google account through the [Integrations page](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Before using the Google Contacts integration, ensure you have:### 1. Connect Your Google Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **Google Contacts** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for contacts and directory access@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -61,6 +63,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `personFields` (string, optional): Fields to include (e.g., 'names,emailAddresses,phoneNumbers'). Default: names,emailAddresses,phoneNumbers- `requestSyncToken` (boolean, optional): Whether the response should include a sync token. Default: false- `sortOrder` (string, optional): The order in which the connections should be sorted. Options: LAST_MODIFIED_ASCENDING, LAST_MODIFIED_DESCENDING, FIRST_NAME_ASCENDING, LAST_NAME_ASCENDING+</Accordion><Accordion title="google_contacts/search_contacts">@@ -72,6 +75,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `pageSize` (integer, optional): Number of results to return. Minimum: 1, Maximum: 30- `pageToken` (string, optional): Token specifying which result page to return.- `sources` (array, optional): The sources to search in. Options: READ_SOURCE_TYPE_CONTACT, READ_SOURCE_TYPE_PROFILE. Default: READ_SOURCE_TYPE_CONTACT+</Accordion><Accordion title="google_contacts/list_directory_people">@@ -84,6 +88,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `readMask` (string, optional): Fields to read (e.g., 'names,emailAddresses')- `requestSyncToken` (boolean, optional): Whether the response should include a sync token. Default: false- `mergeSources` (array, optional): Additional data to merge into the directory people responses. Options: CONTACT+</Accordion><Accordion title="google_contacts/search_directory_people">@@ -94,6 +99,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `sources` (string, required): Directory sources (use 'DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE')- `pageSize` (integer, optional): Number of results to return- `readMask` (string, optional): Fields to read+</Accordion><Accordion title="google_contacts/list_other_contacts">@@ -104,6 +110,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `pageToken` (string, optional): Token specifying which result page to return.- `readMask` (string, optional): Fields to read- `requestSyncToken` (boolean, optional): Whether the response should include a sync token. Default: false+</Accordion><Accordion title="google_contacts/search_other_contacts">@@ -113,6 +120,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `query` (string, required): Search query- `readMask` (string, required): Fields to read (e.g., 'names,emailAddresses')- `pageSize` (integer, optional): Number of results+</Accordion><Accordion title="google_contacts/get_person">@@ -121,6 +129,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `resourceName` (string, required): The resource name of the person to get (e.g., 'people/c123456789')- `personFields` (string, optional): Fields to include (e.g., 'names,emailAddresses,phoneNumbers'). Default: names,emailAddresses,phoneNumbers+</Accordion><Accordion title="google_contacts/create_contact">@@ -174,6 +183,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token}]```+</Accordion><Accordion title="google_contacts/update_contact">@@ -185,6 +195,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `names` (array, optional): Person's names- `emailAddresses` (array, optional): Email addresses- `phoneNumbers` (array, optional): Phone numbers+</Accordion><Accordion title="google_contacts/delete_contact">@@ -192,6 +203,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `resourceName` (string, required): The resource name of the person to delete (e.g., 'people/c123456789')+</Accordion><Accordion title="google_contacts/batch_get_people">@@ -200,6 +212,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `resourceNames` (array, required): Resource names of people to get. Maximum: 200 items- `personFields` (string, optional): Fields to include (e.g., 'names,emailAddresses,phoneNumbers'). Default: names,emailAddresses,phoneNumbers+</Accordion><Accordion title="google_contacts/list_contact_groups">@@ -209,6 +222,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `pageSize` (integer, optional): Number of contact groups to return. Minimum: 1, Maximum: 1000- `pageToken` (string, optional): Token specifying which result page to return.- `groupFields` (string, optional): Fields to include (e.g., 'name,memberCount,clientData'). Default: name,memberCount+</Accordion></AccordionGroup>@@ -377,36 +391,43 @@ crew.kickoff()### Common Issues**Permission Errors**+- Ensure your Google account has appropriate permissions for contacts access- Verify that the OAuth connection includes required scopes for Google Contacts API- Check that directory access permissions are granted for organization contacts**Resource Name Format Issues**+- Ensure resource names follow the correct format (e.g., 'people/c123456789' for contacts)- Verify that contact group resource names use the format 'contactGroups/groupId'- Check that resource names exist and are accessible**Search and Query Issues**+- Ensure search queries are properly formatted and not empty- Use appropriate readMask fields for the data you need- Verify that search sources are correctly specified (contacts vs profiles)**Contact Creation and Updates**+- Ensure required fields are provided when creating contacts- Verify that email addresses and phone numbers are properly formatted- Check that updatePersonFields parameter includes all fields being updated**Directory Access Issues**+- Ensure you have appropriate permissions to access organization directory- Verify that directory sources are correctly specified- Check that your organization allows API access to directory information**Pagination and Limits**+- Be mindful of page size limits (varies by endpoint)- Use pageToken for pagination through large result sets- Respect API rate limits and implement appropriate delays**Contact Groups and Organization**+- Ensure contact group names are unique when creating new groups- Verify that contacts exist before adding them to groups- Check that you have permissions to modify contact groups@@ -414,5 +435,6 @@ crew.kickoff()### Getting Help<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with Google Contacts integration setup or troubleshooting.+ Contact our support team for assistance with Google Contacts integration setup+ or troubleshooting.</Card>diff --git a/docs/en/enterprise/integrations/google_docs.mdx b/docs/en/enterprise/integrations/google_docs.mdxindex 1e464e085..0445cfe79 100644--- a/docs/en/enterprise/integrations/google_docs.mdx+++ b/docs/en/enterprise/integrations/google_docs.mdx@@ -13,7 +13,7 @@ Enable your agents to create, edit, and manage Google Docs documents with text mBefore using the Google Docs integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A Google account with Google Docs access- Connected your Google account through the [Integrations page](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Before using the Google Docs integration, ensure you have:### 1. Connect Your Google Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **Google Docs** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for document access@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -57,6 +59,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `title` (string, optional): The title for the new document.+</Accordion><Accordion title="google_docs/get_document">@@ -66,6 +69,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `documentId` (string, required): The ID of the document to retrieve.- `includeTabsContent` (boolean, optional): Whether to include tab content. Default is `false`.- `suggestionsViewMode` (string, optional): The suggestions view mode to apply to the document. Enum: `DEFAULT_FOR_CURRENT_ACCESS`, `PREVIEW_SUGGESTIONS_ACCEPTED`, `PREVIEW_WITHOUT_SUGGESTIONS`. Default is `DEFAULT_FOR_CURRENT_ACCESS`.+</Accordion><Accordion title="google_docs/batch_update">@@ -75,6 +79,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `documentId` (string, required): The ID of the document to update.- `requests` (array, required): A list of updates to apply to the document. Each item is an object representing a request.- `writeControl` (object, optional): Provides control over how write requests are executed. Contains `requiredRevisionId` (string) and `targetRevisionId` (string).+</Accordion><Accordion title="google_docs/insert_text">@@ -84,6 +89,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `documentId` (string, required): The ID of the document to update.- `text` (string, required): The text to insert.- `index` (integer, optional): The zero-based index where to insert the text. Default is `1`.+</Accordion><Accordion title="google_docs/replace_text">@@ -94,6 +100,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `containsText` (string, required): The text to find and replace.- `replaceText` (string, required): The text to replace it with.- `matchCase` (boolean, optional): Whether the search should respect case. Default is `false`.+</Accordion><Accordion title="google_docs/delete_content_range">@@ -103,6 +110,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `documentId` (string, required): The ID of the document to update.- `startIndex` (integer, required): The start index of the range to delete.- `endIndex` (integer, required): The end index of the range to delete.+</Accordion><Accordion title="google_docs/insert_page_break">@@ -111,6 +119,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `documentId` (string, required): The ID of the document to update.- `index` (integer, optional): The zero-based index where to insert the page break. Default is `1`.+</Accordion><Accordion title="google_docs/create_named_range">@@ -121,6 +130,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `name` (string, required): The name for the named range.- `startIndex` (integer, required): The start index of the range.- `endIndex` (integer, required): The end index of the range.+</Accordion></AccordionGroup>@@ -216,29 +226,35 @@ crew.kickoff()### Common Issues**Authentication Errors**+- Ensure your Google account has the necessary permissions for Google Docs access.- Verify that the OAuth connection includes all required scopes (`https://www.googleapis.com/auth/documents`).**Document ID Issues**+- Double-check document IDs for correctness.- Ensure the document exists and is accessible to your account.- Document IDs can be found in the Google Docs URL.**Text Insertion and Range Operations**+- When using `insert_text` or `delete_content_range`, ensure index positions are valid.- Remember that Google Docs uses zero-based indexing.- The document must have content at the specified index positions.**Batch Update Request Formatting**+- When using `batch_update`, ensure the `requests` array is correctly formatted according to the Google Docs API documentation.- Complex updates require specific JSON structures for each request type.**Replace Text Operations**+- For `replace_text`, ensure the `containsText` parameter exactly matches the text you want to replace.- Use `matchCase` parameter to control case sensitivity.### Getting Help<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with Google Docs integration setup or troubleshooting.+ Contact our support team for assistance with Google Docs integration setup or+ troubleshooting.</Card>diff --git a/docs/en/enterprise/integrations/google_drive.mdx b/docs/en/enterprise/integrations/google_drive.mdxindex 664fd2816..977c4e729 100644--- a/docs/en/enterprise/integrations/google_drive.mdx+++ b/docs/en/enterprise/integrations/google_drive.mdx@@ -13,7 +13,7 @@ Enable your agents to manage files and folders through Google Drive. Upload, dowBefore using the Google Drive integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A Google account with Google Drive access- Connected your Google account through the [Integrations page](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Before using the Google Drive integration, ensure you have:### 1. Connect Your Google Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **Google Drive** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for file and folder management@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -57,6 +59,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `file_id` (string, required): The ID of the file to retrieve.+</Accordion><Accordion title="google_drive/list_files">@@ -68,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `page_token` (string, optional): Token for retrieving the next page of results.- `order_by` (string, optional): Sort order (example: "name", "createdTime desc", "modifiedTime").- `spaces` (string, optional): Comma-separated list of spaces to query (drive, appDataFolder, photos).+</Accordion><Accordion title="google_drive/upload_file">@@ -79,6 +83,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `mime_type` (string, optional): MIME type of the file (example: "text/plain", "application/pdf").- `parent_folder_id` (string, optional): ID of the parent folder where the file should be created.- `description` (string, optional): Description of the file.+</Accordion><Accordion title="google_drive/download_file">@@ -87,6 +92,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `file_id` (string, required): The ID of the file to download.- `mime_type` (string, optional): MIME type for export (required for Google Workspace documents).+</Accordion><Accordion title="google_drive/create_folder">@@ -96,6 +102,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `name` (string, required): Name of the folder to create.- `parent_folder_id` (string, optional): ID of the parent folder where the new folder should be created.- `description` (string, optional): Description of the folder.+</Accordion><Accordion title="google_drive/delete_file">@@ -103,6 +110,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `file_id` (string, required): The ID of the file to delete.+</Accordion><Accordion title="google_drive/share_file">@@ -116,6 +124,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `domain` (string, optional): The domain to share with (required for domain type).- `send_notification_email` (boolean, optional): Whether to send a notification email (default: true).- `email_message` (string, optional): A plain text custom message to include in the notification email.+</Accordion><Accordion title="google_drive/update_file">@@ -129,6 +138,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `description` (string, optional): New description for the file.- `add_parents` (string, optional): Comma-separated list of parent folder IDs to add.- `remove_parents` (string, optional): Comma-separated list of parent folder IDs to remove.+</Accordion></AccordionGroup>diff --git a/docs/en/enterprise/integrations/google_sheets.mdx b/docs/en/enterprise/integrations/google_sheets.mdxindex 0ec827326..7d54d6532 100644--- a/docs/en/enterprise/integrations/google_sheets.mdx+++ b/docs/en/enterprise/integrations/google_sheets.mdx@@ -13,7 +13,7 @@ Enable your agents to manage spreadsheet data through Google Sheets. Read rows,Before using the Google Sheets integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A Google account with Google Sheets access- Connected your Google account through the [Integrations page](https://app.crewai.com/crewai_plus/connectors)- Spreadsheets with proper column headers for data operations@@ -22,7 +22,7 @@ Before using the Google Sheets integration, ensure you have:### 1. Connect Your Google Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **Google Sheets** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for spreadsheet access@@ -37,7 +37,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -61,6 +63,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `ranges` (array, optional): The ranges to retrieve from the spreadsheet.- `includeGridData` (boolean, optional): True if grid data should be returned. Default: false- `fields` (string, optional): The fields to include in the response. Use this to improve performance by only returning needed data.+</Accordion><Accordion title="google_sheets/get_values">@@ -72,6 +75,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `valueRenderOption` (string, optional): How values should be represented in the output. Options: FORMATTED_VALUE, UNFORMATTED_VALUE, FORMULA. Default: FORMATTED_VALUE- `dateTimeRenderOption` (string, optional): How dates, times, and durations should be represented in the output. Options: SERIAL_NUMBER, FORMATTED_STRING. Default: SERIAL_NUMBER- `majorDimension` (string, optional): The major dimension that results should use. Options: ROWS, COLUMNS. Default: ROWS+</Accordion><Accordion title="google_sheets/update_values">@@ -88,6 +92,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token]```- `valueInputOption` (string, optional): How the input data should be interpreted. Options: RAW, USER_ENTERED. Default: USER_ENTERED+</Accordion><Accordion title="google_sheets/append_values">@@ -105,6 +110,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token```- `valueInputOption` (string, optional): How the input data should be interpreted. Options: RAW, USER_ENTERED. Default: USER_ENTERED- `insertDataOption` (string, optional): How the input data should be inserted. Options: OVERWRITE, INSERT_ROWS. Default: INSERT_ROWS+</Accordion><Accordion title="google_sheets/create_spreadsheet">@@ -122,6 +128,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token}]```+</Accordion></AccordionGroup>@@ -319,31 +326,37 @@ crew.kickoff()### Common Issues**Permission Errors**+- Ensure your Google account has edit access to the target spreadsheets- Verify that the OAuth connection includes required scopes for Google Sheets API- Check that spreadsheets are shared with the authenticated account**Spreadsheet Structure Issues**+- Ensure worksheets have proper column headers before creating or updating rows- Verify that range notation (A1 format) is correct for the target cells- Check that the specified spreadsheet ID exists and is accessible**Data Type and Format Issues**+- Ensure data values match the expected format for each column- Use proper date formats for date columns (ISO format recommended)- Verify that numeric values are properly formatted for number columns**Range and Cell Reference Issues**+- Use proper A1 notation for ranges (e.g., "A1:C10", "Sheet1!A1:B5")- Ensure range references don't exceed the actual spreadsheet dimensions- Verify that sheet names in range references match actual sheet names**Value Input and Rendering Options**+- Choose appropriate `valueInputOption` (RAW vs USER_ENTERED) for your data- Select proper `valueRenderOption` based on how you want data formatted- Consider `dateTimeRenderOption` for consistent date/time handling**Spreadsheet Creation Issues**+- Ensure spreadsheet titles are unique and follow naming conventions- Verify that sheet properties are properly structured when creating sheets- Check that you have permissions to create new spreadsheets in your account@@ -351,5 +364,6 @@ crew.kickoff()### Getting Help<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with Google Sheets integration setup or troubleshooting.+ Contact our support team for assistance with Google Sheets integration setup+ or troubleshooting.</Card>diff --git a/docs/en/enterprise/integrations/google_slides.mdx b/docs/en/enterprise/integrations/google_slides.mdxindex dc3c0191e..350d21bf9 100644--- a/docs/en/enterprise/integrations/google_slides.mdx+++ b/docs/en/enterprise/integrations/google_slides.mdx@@ -13,7 +13,7 @@ Enable your agents to create, edit, and manage Google Slides presentations. CreaBefore using the Google Slides integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A Google account with Google Slides access- Connected your Google account through the [Integrations page](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Before using the Google Slides integration, ensure you have:### 1. Connect Your Google Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **Google Slides** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for presentations, spreadsheets, and drive access@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -57,6 +59,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `title` (string, required): The title of the presentation.+</Accordion><Accordion title="google_slides/get_presentation">@@ -65,6 +68,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `presentationId` (string, required): The ID of the presentation to retrieve.- `fields` (string, optional): The fields to include in the response. Use this to improve performance by only returning needed data.+</Accordion><Accordion title="google_slides/batch_update_presentation">@@ -89,6 +93,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"requiredRevisionId": "revision_id_string"}```+</Accordion><Accordion title="google_slides/get_page">@@ -97,6 +102,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `presentationId` (string, required): The ID of the presentation.- `pageObjectId` (string, required): The ID of the page to retrieve.+</Accordion><Accordion title="google_slides/get_thumbnail">@@ -105,6 +111,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `presentationId` (string, required): The ID of the presentation.- `pageObjectId` (string, required): The ID of the page for thumbnail generation.+</Accordion><Accordion title="google_slides/import_data_from_sheet">@@ -114,6 +121,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `presentationId` (string, required): The ID of the presentation.- `sheetId` (string, required): The ID of the Google Sheet to import from.- `dataRange` (string, required): The range of data to import from the sheet.+</Accordion><Accordion title="google_slides/upload_file_to_drive">@@ -122,6 +130,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `file` (string, required): The file data to upload.- `presentationId` (string, required): The ID of the presentation to link the uploaded file.+</Accordion><Accordion title="google_slides/link_file_to_presentation">@@ -130,6 +139,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `presentationId` (string, required): The ID of the presentation.- `fileId` (string, required): The ID of the file to link.+</Accordion><Accordion title="google_slides/get_all_presentations">@@ -138,6 +148,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `pageSize` (integer, optional): The number of presentations to return per page.- `pageToken` (string, optional): A token for pagination.+</Accordion><Accordion title="google_slides/delete_presentation">@@ -145,6 +156,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `presentationId` (string, required): The ID of the presentation to delete.+</Accordion></AccordionGroup>@@ -346,36 +358,43 @@ crew.kickoff()### Common Issues**Permission Errors**+- Ensure your Google account has appropriate permissions for Google Slides- Verify that the OAuth connection includes required scopes for presentations, spreadsheets, and drive access- Check that presentations are shared with the authenticated account**Presentation ID Issues**+- Verify that presentation IDs are correct and presentations exist- Ensure you have access permissions to the presentations you're trying to modify- Check that presentation IDs are properly formatted**Content Update Issues**+- Ensure batch update requests are properly formatted according to Google Slides API specifications- Verify that object IDs for slides and elements exist in the presentation- Check that write control revision IDs are current if using optimistic concurrency**Data Import Issues**+- Verify that Google Sheet IDs are correct and accessible- Ensure data ranges are properly specified using A1 notation- Check that you have read permissions for the source spreadsheets**File Upload and Linking Issues**+- Ensure file data is properly encoded for upload- Verify that Drive file IDs are correct when linking files- Check that you have appropriate Drive permissions for file operations**Page and Thumbnail Operations**+- Verify that page object IDs exist in the specified presentation- Ensure presentations have content before attempting to generate thumbnails- Check that page structure is valid for thumbnail generation**Pagination and Listing Issues**+- Use appropriate page sizes for listing presentations- Implement proper pagination using page tokens for large result sets- Handle empty result sets gracefully@@ -383,5 +402,6 @@ crew.kickoff()### Getting Help<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with Google Slides integration setup or troubleshooting.+ Contact our support team for assistance with Google Slides integration setup+ or troubleshooting.</Card>diff --git a/docs/en/enterprise/integrations/hubspot.mdx b/docs/en/enterprise/integrations/hubspot.mdxindex a49a2f2c8..f5f4279c0 100644--- a/docs/en/enterprise/integrations/hubspot.mdx+++ b/docs/en/enterprise/integrations/hubspot.mdx@@ -13,7 +13,7 @@ Enable your agents to manage companies and contacts within HubSpot. Create new rBefore using the HubSpot integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription.+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription.- A HubSpot account with appropriate permissions.- Connected your HubSpot account through the [Integrations page](https://app.crewai.com/crewai_plus/connectors).@@ -21,7 +21,7 @@ Before using the HubSpot integration, ensure you have:### 1. Connect Your HubSpot Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors).+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors).2. Find **HubSpot** in the Authentication Integrations section.3. Click **Connect** and complete the OAuth flow.4. Grant the necessary permissions for company and contact management.@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -115,6 +117,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `web_technologies` (string, optional): Web Technologies used. Must be one of the predefined values.- `website` (string, optional): Website URL.- `founded_year` (string, optional): Year Founded.+</Accordion><Accordion title="hubspot/create_contact">@@ -214,6 +217,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `hs_whatsapp_phone_number` (string, optional): WhatsApp Phone Number.- `work_email` (string, optional): Work email.- `hs_googleplusid` (string, optional): googleplus ID.+</Accordion><Accordion title="hubspot/create_deal">@@ -229,6 +233,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `dealtype` (string, optional): The type of deal. Available values: `newbusiness`, `existingbusiness`.- `description` (string, optional): A description of the deal.- `hs_priority` (string, optional): The priority of the deal. Available values: `low`, `medium`, `high`.+</Accordion><Accordion title="hubspot/create_record_engagements">@@ -246,6 +251,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `hs_meeting_body` (string, optional): The description for the meeting. (Used for `MEETING`)- `hs_meeting_start_time` (string, optional): The start time of the meeting. (Used for `MEETING`)- `hs_meeting_end_time` (string, optional): The end time of the meeting. (Used for `MEETING`)+</Accordion><Accordion title="hubspot/update_company">@@ -263,6 +269,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `numberofemployees` (number, optional): Number of Employees.- `annualrevenue` (number, optional): Annual Revenue.- `description` (string, optional): Description.+</Accordion><Accordion title="hubspot/create_record_any">@@ -271,6 +278,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `recordType` (string, required): The object type ID of the custom object.- Additional parameters depend on the custom object's schema.+</Accordion><Accordion title="hubspot/update_contact">@@ -285,6 +293,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `company` (string, optional): Company Name.- `jobtitle` (string, optional): Job Title.- `lifecyclestage` (string, optional): Lifecycle Stage.+</Accordion><Accordion title="hubspot/update_deal">@@ -298,6 +307,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `pipeline` (string, optional): The pipeline the deal belongs to.- `closedate` (string, optional): The date the deal is expected to close.- `dealtype` (string, optional): The type of deal.+</Accordion><Accordion title="hubspot/update_record_engagements">@@ -309,6 +319,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `hs_task_subject` (string, optional): The title of the task.- `hs_task_body` (string, optional): The notes for the task.- `hs_task_status` (string, optional): The status of the task.+</Accordion><Accordion title="hubspot/update_record_any">@@ -318,6 +329,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `recordId` (string, required): The ID of the record to update.- `recordType` (string, required): The object type ID of the custom object.- Additional parameters depend on the custom object's schema.+</Accordion><Accordion title="hubspot/list_companies">@@ -325,6 +337,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `paginationParameters` (object, optional): Use `pageCursor` to fetch subsequent pages.+</Accordion><Accordion title="hubspot/list_contacts">@@ -332,6 +345,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `paginationParameters` (object, optional): Use `pageCursor` to fetch subsequent pages.+</Accordion><Accordion title="hubspot/list_deals">@@ -339,6 +353,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `paginationParameters` (object, optional): Use `pageCursor` to fetch subsequent pages.+</Accordion><Accordion title="hubspot/get_records_engagements">@@ -347,6 +362,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `objectName` (string, required): The type of engagement to fetch (e.g., "notes").- `paginationParameters` (object, optional): Use `pageCursor` to fetch subsequent pages.+</Accordion><Accordion title="hubspot/get_records_any">@@ -355,6 +371,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `recordType` (string, required): The object type ID of the custom object.- `paginationParameters` (object, optional): Use `pageCursor` to fetch subsequent pages.+</Accordion><Accordion title="hubspot/get_company">@@ -362,6 +379,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `recordId` (string, required): The ID of the company to retrieve.+</Accordion><Accordion title="hubspot/get_contact">@@ -369,6 +387,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `recordId` (string, required): The ID of the contact to retrieve.+</Accordion><Accordion title="hubspot/get_deal">@@ -376,6 +395,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `recordId` (string, required): The ID of the deal to retrieve.+</Accordion><Accordion title="hubspot/get_record_by_id_engagements">@@ -383,6 +403,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `recordId` (string, required): The ID of the engagement to retrieve.+</Accordion><Accordion title="hubspot/get_record_by_id_any">@@ -391,6 +412,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `recordType` (string, required): The object type ID of the custom object.- `recordId` (string, required): The ID of the record to retrieve.+</Accordion><Accordion title="hubspot/search_companies">@@ -399,6 +421,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `filterFormula` (object, optional): A filter in disjunctive normal form (OR of ANDs).- `paginationParameters` (object, optional): Use `pageCursor` to fetch subsequent pages.+</Accordion><Accordion title="hubspot/search_contacts">@@ -407,6 +430,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `filterFormula` (object, optional): A filter in disjunctive normal form (OR of ANDs).- `paginationParameters` (object, optional): Use `pageCursor` to fetch subsequent pages.+</Accordion><Accordion title="hubspot/search_deals">@@ -415,6 +439,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `filterFormula` (object, optional): A filter in disjunctive normal form (OR of ANDs).- `paginationParameters` (object, optional): Use `pageCursor` to fetch subsequent pages.+</Accordion><Accordion title="hubspot/search_records_engagements">@@ -423,6 +448,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `engagementFilterFormula` (object, optional): A filter for engagements.- `paginationParameters` (object, optional): Use `pageCursor` to fetch subsequent pages.+</Accordion><Accordion title="hubspot/search_records_any">@@ -432,6 +458,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `recordType` (string, required): The object type ID to search.- `filterFormula` (string, optional): The filter formula to apply.- `paginationParameters` (object, optional): Use `pageCursor` to fetch subsequent pages.+</Accordion><Accordion title="hubspot/delete_record_companies">@@ -439,6 +466,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `recordId` (string, required): The ID of the company to delete.+</Accordion><Accordion title="hubspot/delete_record_contacts">@@ -446,6 +474,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `recordId` (string, required): The ID of the contact to delete.+</Accordion><Accordion title="hubspot/delete_record_deals">@@ -453,6 +482,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `recordId` (string, required): The ID of the deal to delete.+</Accordion><Accordion title="hubspot/delete_record_engagements">@@ -460,6 +490,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `recordId` (string, required): The ID of the engagement to delete.+</Accordion><Accordion title="hubspot/delete_record_any">@@ -468,6 +499,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `recordType` (string, required): The object type ID of the custom object.- `recordId` (string, required): The ID of the record to delete.+</Accordion><Accordion title="hubspot/get_contacts_by_list_id">@@ -476,6 +508,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `listId` (string, required): The ID of the list to get contacts from.- `paginationParameters` (object, optional): Use `pageCursor` for subsequent pages.+</Accordion><Accordion title="hubspot/describe_action_schema">@@ -484,6 +517,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `recordType` (string, required): The object type ID (e.g., 'companies').- `operation` (string, required): The operation type (e.g., 'CREATE_RECORD').+</Accordion></AccordionGroup>@@ -577,5 +611,6 @@ crew.kickoff()### Getting Help<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with HubSpot integration setup or troubleshooting.+ Contact our support team for assistance with HubSpot integration setup or+ troubleshooting.</Card>diff --git a/docs/en/enterprise/integrations/jira.mdx b/docs/en/enterprise/integrations/jira.mdxindex c4a66f975..0f9164014 100644--- a/docs/en/enterprise/integrations/jira.mdx+++ b/docs/en/enterprise/integrations/jira.mdx@@ -13,7 +13,7 @@ Enable your agents to manage issues, projects, and workflows through Jira. CreatBefore using the Jira integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A Jira account with appropriate project permissions- Connected your Jira account through the [Integrations page](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Before using the Jira integration, ensure you have:### 1. Connect Your Jira Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **Jira** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for issue and project management@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -70,6 +72,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"customfield_10001": "value"}```+</Accordion><Accordion title="jira/update_issue">@@ -85,6 +88,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- Options: `description`, `descriptionJSON`- `description` (string, optional): Description - A detailed description of the issue. This field appears only when 'descriptionType' = 'description'.- `additionalFields` (string, optional): Additional Fields - Specify any other fields that should be included in JSON format.+</Accordion><Accordion title="jira/get_issue_by_key">@@ -92,6 +96,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `issueKey` (string, required): Issue Key (example: "TEST-1234").+</Accordion><Accordion title="jira/filter_issues">@@ -118,6 +123,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token```Available operators: `$stringExactlyMatches`, `$stringDoesNotExactlyMatch`, `$stringIsIn`, `$stringIsNotIn`, `$stringContains`, `$stringDoesNotContain`, `$stringGreaterThan`, `$stringLessThan`- `limit` (string, optional): Limit results - Limit the maximum number of issues to return. Defaults to 10 if left blank.+</Accordion><Accordion title="jira/search_by_jql">@@ -131,12 +137,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"pageCursor": "cursor_string"}```+</Accordion><Accordion title="jira/update_issue_any">**Description:** Update any issue in Jira. Use DESCRIBE_ACTION_SCHEMA to get properties schema for this function.**Parameters:** No specific parameters - use JIRA_DESCRIBE_ACTION_SCHEMA first to get the expected schema.+</Accordion><Accordion title="jira/describe_action_schema">@@ -146,6 +154,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `issueTypeId` (string, required): Issue Type ID.- `projectKey` (string, required): Project key.- `operation` (string, required): Operation Type value, for example CREATE_ISSUE or UPDATE_ISSUE.+</Accordion><Accordion title="jira/get_projects">@@ -158,6 +167,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"pageCursor": "cursor_string"}```+</Accordion><Accordion title="jira/get_issue_types_by_project">@@ -165,12 +175,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `project` (string, required): Project key.+</Accordion><Accordion title="jira/get_issue_types">**Description:** Get all Issue Types in Jira.**Parameters:** None required.+</Accordion><Accordion title="jira/get_issue_status_by_project">@@ -178,6 +190,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `project` (string, required): Project key.+</Accordion><Accordion title="jira/get_all_assignees_by_project">@@ -185,6 +198,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `project` (string, required): Project key.+</Accordion></AccordionGroup>@@ -348,31 +362,37 @@ crew.kickoff()### Common Issues**Permission Errors**+- Ensure your Jira account has necessary permissions for the target projects- Verify that the OAuth connection includes required scopes for Jira API- Check if you have create/edit permissions for issues in the specified projects**Invalid Project or Issue Keys**+- Double-check project keys and issue keys for correct format (e.g., "PROJ-123")- Ensure projects exist and are accessible to your account- Verify that issue keys reference existing issues**Issue Type and Status Issues**+- Use JIRA_GET_ISSUE_TYPES_BY_PROJECT to get valid issue types for a project- Use JIRA_GET_ISSUE_STATUS_BY_PROJECT to get valid statuses- Ensure issue types and statuses are available in the target project**JQL Query Problems**+- Test JQL queries in Jira's issue search before using in API calls- Ensure field names in JQL are spelled correctly and exist in your Jira instance- Use proper JQL syntax for complex queries**Custom Fields and Schema Issues**+- Use JIRA_DESCRIBE_ACTION_SCHEMA to get the correct schema for complex issue types- Ensure custom field IDs are correct (e.g., "customfield_10001")- Verify that custom fields are available in the target project and issue type**Filter Formula Issues**+- Ensure filter formulas follow the correct JSON structure for disjunctive normal form- Use valid field names that exist in your Jira configuration- Test simple filters before building complex multi-condition queries@@ -380,5 +400,6 @@ crew.kickoff()### Getting Help<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with Jira integration setup or troubleshooting.+ Contact our support team for assistance with Jira integration setup or+ troubleshooting.</Card>diff --git a/docs/en/enterprise/integrations/linear.mdx b/docs/en/enterprise/integrations/linear.mdxindex 0c05f3d31..083c630ce 100644--- a/docs/en/enterprise/integrations/linear.mdx+++ b/docs/en/enterprise/integrations/linear.mdx@@ -13,7 +13,7 @@ Enable your agents to manage issues, projects, and development workflows throughBefore using the Linear integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A Linear account with appropriate workspace permissions- Connected your Linear account through the [Integrations page](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Before using the Linear integration, ensure you have:### 1. Connect Your Linear Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **Linear** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for issue and project management@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -70,6 +72,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"labelIds": ["a70bdf0f-530a-4887-857d-46151b52b47c"]}```+</Accordion><Accordion title="linear/update_issue">@@ -90,6 +93,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"labelIds": ["a70bdf0f-530a-4887-857d-46151b52b47c"]}```+</Accordion><Accordion title="linear/get_issue_by_id">@@ -97,6 +101,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `issueId` (string, required): Issue ID - Specify the record ID of the issue to fetch. (example: "90fbc706-18cd-42c9-ae66-6bd344cc8977").+</Accordion><Accordion title="linear/get_issue_by_issue_identifier">@@ -104,6 +109,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `externalId` (string, required): External ID - Specify the human-readable Issue identifier of the issue to fetch. (example: "ABC-1").+</Accordion><Accordion title="linear/search_issue">@@ -131,6 +137,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token```Available fields: `title`, `number`, `project`, `createdAt`Available operators: `$stringExactlyMatches`, `$stringDoesNotExactlyMatch`, `$stringIsIn`, `$stringIsNotIn`, `$stringStartsWith`, `$stringDoesNotStartWith`, `$stringEndsWith`, `$stringDoesNotEndWith`, `$stringContains`, `$stringDoesNotContain`, `$stringGreaterThan`, `$stringLessThan`, `$numberGreaterThanOrEqualTo`, `$numberLessThanOrEqualTo`, `$numberGreaterThan`, `$numberLessThan`, `$dateTimeAfter`, `$dateTimeBefore`+</Accordion><Accordion title="linear/delete_issue">@@ -138,6 +145,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `issueId` (string, required): Issue ID - Specify the record ID of the issue to delete. (example: "90fbc706-18cd-42c9-ae66-6bd344cc8977").+</Accordion><Accordion title="linear/archive_issue">@@ -145,6 +153,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `issueId` (string, required): Issue ID - Specify the record ID of the issue to archive. (example: "90fbc706-18cd-42c9-ae66-6bd344cc8977").+</Accordion><Accordion title="linear/create_sub_issue">@@ -161,6 +170,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"lead": "linear_user_id"}```+</Accordion><Accordion title="linear/create_project">@@ -183,6 +193,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"description": ""}```+</Accordion><Accordion title="linear/update_project">@@ -199,6 +210,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"description": ""}```+</Accordion><Accordion title="linear/get_project_by_id">@@ -206,6 +218,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `projectId` (string, required): Project ID - Specify the Project ID of the project to fetch. (example: "a6634484-6061-4ac7-9739-7dc5e52c796b").+</Accordion><Accordion title="linear/delete_project">@@ -213,6 +226,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `projectId` (string, required): Project ID - Specify the Project ID of the project to delete. (example: "a6634484-6061-4ac7-9739-7dc5e52c796b").+</Accordion><Accordion title="linear/search_teams">@@ -238,6 +252,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token}```Available fields: `id`, `name`+</Accordion></AccordionGroup>@@ -401,37 +416,44 @@ crew.kickoff()### Common Issues**Permission Errors**+- Ensure your Linear account has necessary permissions for the target workspace- Verify that the OAuth connection includes required scopes for Linear API- Check if you have create/edit permissions for issues and projects in the workspace**Invalid IDs and References**+- Double-check team IDs, issue IDs, and project IDs for correct UUID format- Ensure referenced entities (teams, projects, cycles) exist and are accessible- Verify that issue identifiers follow the correct format (e.g., "ABC-1")**Team and Project Association Issues**+- Use LINEAR_SEARCH_TEAMS to get valid team IDs before creating issues or projects- Ensure teams exist and are active in your workspace- Verify that team IDs are properly formatted as UUIDs**Issue Status and Priority Problems**+- Check that status IDs reference valid workflow states for the team- Ensure priority values are within the valid range for your Linear configuration- Verify that custom fields and labels exist before referencing them**Date and Time Format Issues**+- Use ISO 8601 format for due dates and timestamps- Ensure time zones are handled correctly for due date calculations- Verify that date values are valid and in the future for due dates**Search and Filter Issues**+- Ensure search queries are properly formatted and not empty- Use valid field names in filter formulas: `title`, `number`, `project`, `createdAt`- Test simple filters before building complex multi-condition queries- Verify that operator types match the data types of the fields being filtered**Sub-issue Creation Problems**+- Ensure parent issue IDs are valid and accessible- Verify that the team ID for sub-issues matches or is compatible with the parent issue's team- Check that parent issues are not already archived or deleted@@ -439,5 +461,6 @@ crew.kickoff()### Getting Help<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with Linear integration setup or troubleshooting.+ Contact our support team for assistance with Linear integration setup or+ troubleshooting.</Card>diff --git a/docs/en/enterprise/integrations/microsoft_excel.mdx b/docs/en/enterprise/integrations/microsoft_excel.mdxindex 7e4df1743..233131c1c 100644--- a/docs/en/enterprise/integrations/microsoft_excel.mdx+++ b/docs/en/enterprise/integrations/microsoft_excel.mdx@@ -13,7 +13,7 @@ Enable your agents to create and manage Excel workbooks, worksheets, tables, andBefore using the Microsoft Excel integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A Microsoft 365 account with Excel and OneDrive/SharePoint access- Connected your Microsoft account through the [Integrations page](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Before using the Microsoft Excel integration, ensure you have:### 1. Connect Your Microsoft Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **Microsoft Excel** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for files and Excel workbook access@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -68,6 +70,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token}]```+</Accordion><Accordion title="microsoft_excel/get_workbooks">@@ -79,6 +82,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `expand` (string, optional): Expand related resources inline- `top` (integer, optional): Number of items to return. Minimum: 1, Maximum: 999- `orderby` (string, optional): Order results by specified properties+</Accordion><Accordion title="microsoft_excel/get_worksheets">@@ -91,6 +95,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `expand` (string, optional): Expand related resources inline- `top` (integer, optional): Number of items to return. Minimum: 1, Maximum: 999- `orderby` (string, optional): Order results by specified properties+</Accordion><Accordion title="microsoft_excel/create_worksheet">@@ -99,6 +104,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `file_id` (string, required): The ID of the Excel file- `name` (string, required): Name of the new worksheet+</Accordion><Accordion title="microsoft_excel/get_range_data">@@ -108,6 +114,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `file_id` (string, required): The ID of the Excel file- `worksheet_name` (string, required): Name of the worksheet- `range` (string, required): Range address (e.g., 'A1:C10')+</Accordion><Accordion title="microsoft_excel/update_range_data">@@ -125,6 +132,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token["Jane", 25, "Los Angeles"]]```+</Accordion><Accordion title="microsoft_excel/add_table">@@ -135,6 +143,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `worksheet_name` (string, required): Name of the worksheet- `range` (string, required): Range for the table (e.g., 'A1:D10')- `has_headers` (boolean, optional): Whether the first row contains headers. Default: true+</Accordion><Accordion title="microsoft_excel/get_tables">@@ -143,6 +152,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `file_id` (string, required): The ID of the Excel file- `worksheet_name` (string, required): Name of the worksheet+</Accordion><Accordion title="microsoft_excel/add_table_row">@@ -156,6 +166,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token```json["John Doe", 35, "Manager", "Sales"]```+</Accordion><Accordion title="microsoft_excel/create_chart">@@ -167,6 +178,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `chart_type` (string, required): Type of chart (e.g., 'ColumnClustered', 'Line', 'Pie')- `source_data` (string, required): Range of data for the chart (e.g., 'A1:B10')- `series_by` (string, optional): How to interpret the data ('Auto', 'Columns', or 'Rows'). Default: Auto+</Accordion><Accordion title="microsoft_excel/get_cell">@@ -177,6 +189,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `worksheet_name` (string, required): Name of the worksheet- `row` (integer, required): Row number (0-based)- `column` (integer, required): Column number (0-based)+</Accordion><Accordion title="microsoft_excel/get_used_range">@@ -185,6 +198,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `file_id` (string, required): The ID of the Excel file- `worksheet_name` (string, required): Name of the worksheet+</Accordion><Accordion title="microsoft_excel/list_charts">@@ -193,6 +207,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `file_id` (string, required): The ID of the Excel file- `worksheet_name` (string, required): Name of the worksheet+</Accordion><Accordion title="microsoft_excel/delete_worksheet">@@ -201,6 +216,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `file_id` (string, required): The ID of the Excel file- `worksheet_name` (string, required): Name of the worksheet to delete+</Accordion><Accordion title="microsoft_excel/delete_table">@@ -210,6 +226,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `file_id` (string, required): The ID of the Excel file- `worksheet_name` (string, required): Name of the worksheet- `table_name` (string, required): Name of the table to delete+</Accordion><Accordion title="microsoft_excel/list_names">@@ -217,6 +234,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `file_id` (string, required): The ID of the Excel file+</Accordion></AccordionGroup>@@ -421,36 +439,43 @@ crew.kickoff()### Common Issues**Permission Errors**+- Ensure your Microsoft account has appropriate permissions for Excel and OneDrive/SharePoint- Verify that the OAuth connection includes required scopes (Files.Read.All, Files.ReadWrite.All)- Check that you have access to the specific workbooks you're trying to modify**File ID and Path Issues**+- Verify that file IDs are correct and files exist in your OneDrive or SharePoint- Ensure file paths are properly formatted when creating new workbooks- Check that workbook files have the correct .xlsx extension**Worksheet and Range Issues**+- Verify that worksheet names exist in the specified workbook- Ensure range addresses are properly formatted (e.g., 'A1:C10')- Check that ranges don't exceed worksheet boundaries**Data Format Issues**+- Ensure data values are properly formatted for Excel (strings, numbers, integers)- Verify that 2D arrays for ranges have consistent row and column counts- Check that table data includes proper headers when has_headers is true**Chart Creation Issues**+- Verify that chart types are supported (ColumnClustered, Line, Pie, etc.)- Ensure source data ranges contain appropriate data for the chart type- Check that the source data range exists and contains data**Table Management Issues**+- Ensure table names are unique within worksheets- Verify that table ranges don't overlap with existing tables- Check that new row data matches the table's column structure**Cell and Range Operations**+- Verify that row and column indices are 0-based for cell operations- Ensure ranges contain data when using get_used_range- Check that named ranges exist before referencing them@@ -458,5 +483,6 @@ crew.kickoff()### Getting Help<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with Microsoft Excel integration setup or troubleshooting.+ Contact our support team for assistance with Microsoft Excel integration setup+ or troubleshooting.</Card>diff --git a/docs/en/enterprise/integrations/microsoft_onedrive.mdx b/docs/en/enterprise/integrations/microsoft_onedrive.mdxindex 3b8f29962..030ed22ed 100644--- a/docs/en/enterprise/integrations/microsoft_onedrive.mdx+++ b/docs/en/enterprise/integrations/microsoft_onedrive.mdx@@ -13,7 +13,7 @@ Enable your agents to upload, download, and manage files and folders in MicrosofBefore using the Microsoft OneDrive integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A Microsoft account with OneDrive access- Connected your Microsoft account through the [Integrations page](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Before using the Microsoft OneDrive integration, ensure you have:### 1. Connect Your Microsoft Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **Microsoft OneDrive** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for file access@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -59,6 +61,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `top` (integer, optional): Number of items to retrieve (max 1000). Default is `50`.- `orderby` (string, optional): Order by field (e.g., "name asc", "lastModifiedDateTime desc"). Default is "name asc".- `filter` (string, optional): OData filter expression.+</Accordion><Accordion title="microsoft_onedrive/get_file_info">@@ -66,6 +69,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `item_id` (string, required): The ID of the file or folder.+</Accordion><Accordion title="microsoft_onedrive/download_file">@@ -73,6 +77,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `item_id` (string, required): The ID of the file to download.+</Accordion><Accordion title="microsoft_onedrive/upload_file">@@ -81,6 +86,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `file_name` (string, required): Name of the file to upload.- `content` (string, required): Base64 encoded file content.+</Accordion><Accordion title="microsoft_onedrive/create_folder">@@ -88,6 +94,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `folder_name` (string, required): Name of the folder to create.+</Accordion><Accordion title="microsoft_onedrive/delete_item">@@ -95,6 +102,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `item_id` (string, required): The ID of the file or folder to delete.+</Accordion><Accordion title="microsoft_onedrive/copy_item">@@ -104,6 +112,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `item_id` (string, required): The ID of the file or folder to copy.- `parent_id` (string, optional): The ID of the destination folder (optional, defaults to root).- `new_name` (string, optional): New name for the copied item (optional).+</Accordion><Accordion title="microsoft_onedrive/move_item">@@ -113,6 +122,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `item_id` (string, required): The ID of the file or folder to move.- `parent_id` (string, required): The ID of the destination folder.- `new_name` (string, optional): New name for the item (optional).+</Accordion><Accordion title="microsoft_onedrive/search_files">@@ -121,6 +131,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `query` (string, required): Search query string.- `top` (integer, optional): Number of results to return (max 1000). Default is `50`.+</Accordion><Accordion title="microsoft_onedrive/share_item">@@ -130,6 +141,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `item_id` (string, required): The ID of the file or folder to share.- `type` (string, optional): Type of sharing link. Enum: `view`, `edit`, `embed`. Default is `view`.- `scope` (string, optional): Scope of the sharing link. Enum: `anonymous`, `organization`. Default is `anonymous`.+</Accordion><Accordion title="microsoft_onedrive/get_thumbnails">@@ -137,6 +149,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `item_id` (string, required): The ID of the file.+</Accordion></AccordionGroup>@@ -232,29 +245,35 @@ crew.kickoff()### Common Issues**Authentication Errors**+- Ensure your Microsoft account has the necessary permissions for file access (e.g., `Files.Read`, `Files.ReadWrite`).- Verify that the OAuth connection includes all required scopes.**File Upload Issues**+- Ensure `file_name` and `content` are provided for file uploads.- Content must be Base64 encoded for binary files.- Check that you have write permissions to OneDrive.**File/Folder ID Issues**+- Double-check item IDs for correctness when accessing specific files or folders.- Item IDs are returned by other operations like `list_files` or `search_files`.- Ensure the referenced items exist and are accessible.**Search and Filter Operations**+- Use appropriate search terms for `search_files` operations.- For `filter` parameters, use proper OData syntax.**File Operations (Copy/Move)**+- For `move_item`, ensure both `item_id` and `parent_id` are provided.- For `copy_item`, only `item_id` is required; `parent_id` defaults to root if not specified.- Verify that destination folders exist and are accessible.**Sharing Link Creation**+- Ensure the item exists before creating sharing links.- Choose appropriate `type` and `scope` based on your sharing requirements.- `anonymous` scope allows access without sign-in; `organization` requires organizational account.@@ -262,5 +281,6 @@ crew.kickoff()### Getting Help<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with Microsoft OneDrive integration setup or troubleshooting.+ Contact our support team for assistance with Microsoft OneDrive integration+ setup or troubleshooting.</Card>diff --git a/docs/en/enterprise/integrations/microsoft_outlook.mdx b/docs/en/enterprise/integrations/microsoft_outlook.mdxindex 0731f3c02..50a8a3085 100644--- a/docs/en/enterprise/integrations/microsoft_outlook.mdx+++ b/docs/en/enterprise/integrations/microsoft_outlook.mdx@@ -13,7 +13,7 @@ Enable your agents to access and manage Outlook emails, calendar events, and conBefore using the Microsoft Outlook integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A Microsoft account with Outlook access- Connected your Microsoft account through the [Integrations page](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Before using the Microsoft Outlook integration, ensure you have:### 1. Connect Your Microsoft Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **Microsoft Outlook** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for mail, calendar, and contact access@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -62,6 +64,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `orderby` (string, optional): Order by field (e.g., "receivedDateTime desc"). Default is "receivedDateTime desc".- `select` (string, optional): Select specific properties to return.- `expand` (string, optional): Expand related resources inline.+</Accordion><Accordion title="microsoft_outlook/send_email">@@ -77,6 +80,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `importance` (string, optional): Message importance level. Enum: `low`, `normal`, `high`. Default is `normal`.- `reply_to` (array, optional): Array of reply-to email addresses.- `save_to_sent_items` (boolean, optional): Whether to save the message to Sent Items folder. Default is `true`.+</Accordion><Accordion title="microsoft_outlook/get_calendar_events">@@ -87,6 +91,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `skip` (integer, optional): Number of events to skip. Default is `0`.- `filter` (string, optional): OData filter expression (e.g., "start/dateTime ge '2024-01-01T00:00:00Z'").- `orderby` (string, optional): Order by field (e.g., "start/dateTime asc"). Default is "start/dateTime asc".+</Accordion><Accordion title="microsoft_outlook/create_calendar_event">@@ -100,6 +105,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `timezone` (string, optional): Time zone (e.g., 'Pacific Standard Time'). Default is `UTC`.- `location` (string, optional): Event location.- `attendees` (array, optional): Array of attendee email addresses.+</Accordion><Accordion title="microsoft_outlook/get_contacts">@@ -110,6 +116,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `skip` (integer, optional): Number of contacts to skip. Default is `0`.- `filter` (string, optional): OData filter expression.- `orderby` (string, optional): Order by field (e.g., "displayName asc"). Default is "displayName asc".+</Accordion><Accordion title="microsoft_outlook/create_contact">@@ -124,6 +131,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `homePhones` (array, optional): Array of home phone numbers.- `jobTitle` (string, optional): Contact's job title.- `companyName` (string, optional): Contact's company name.+</Accordion></AccordionGroup>@@ -219,30 +227,36 @@ crew.kickoff()### Common Issues**Authentication Errors**+- Ensure your Microsoft account has the necessary permissions for mail, calendar, and contact access.- Required scopes include: `Mail.Read`, `Mail.Send`, `Calendars.Read`, `Calendars.ReadWrite`, `Contacts.Read`, `Contacts.ReadWrite`.- Verify that the OAuth connection includes all required scopes.**Email Sending Issues**+- Ensure `to_recipients`, `subject`, and `body` are provided for `send_email`.- Check that email addresses are properly formatted.- Verify that the account has `Mail.Send` permissions.**Calendar Event Creation**+- Ensure `subject`, `start_datetime`, and `end_datetime` are provided.- Use proper ISO 8601 format for datetime fields (e.g., '2024-01-20T10:00:00').- Verify timezone settings if events appear at incorrect times.**Contact Management**+- For `create_contact`, ensure `displayName` is provided as it's required.- When providing `emailAddresses`, use the proper object format with `address` and `name` properties.**Search and Filter Issues**+- Use proper OData syntax for `filter` parameters.- For date filters, use ISO 8601 format (e.g., "receivedDateTime ge '2024-01-01T00:00:00Z'").### Getting Help<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with Microsoft Outlook integration setup or troubleshooting.+ Contact our support team for assistance with Microsoft Outlook integration+ setup or troubleshooting.</Card>diff --git a/docs/en/enterprise/integrations/microsoft_sharepoint.mdx b/docs/en/enterprise/integrations/microsoft_sharepoint.mdxindex 77184fa6f..1ffa75c6c 100644--- a/docs/en/enterprise/integrations/microsoft_sharepoint.mdx+++ b/docs/en/enterprise/integrations/microsoft_sharepoint.mdx@@ -13,7 +13,7 @@ Enable your agents to access and manage SharePoint sites, lists, and document liBefore using the Microsoft SharePoint integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A Microsoft 365 account with SharePoint access- Connected your Microsoft account through the [Integrations page](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Before using the Microsoft SharePoint integration, ensure you have:### 1. Connect Your Microsoft Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **Microsoft SharePoint** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for SharePoint sites and content access@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -63,6 +65,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `top` (integer, optional): Number of items to return. Minimum: 1, Maximum: 999- `skip` (integer, optional): Number of items to skip. Minimum: 0- `orderby` (string, optional): Order results by specified properties (e.g., 'displayName desc')+</Accordion><Accordion title="microsoft_sharepoint/get_site">@@ -72,6 +75,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `site_id` (string, required): The ID of the SharePoint site- `select` (string, optional): Select specific properties to return (e.g., 'displayName,id,webUrl,drives')- `expand` (string, optional): Expand related resources inline (e.g., 'drives,lists')+</Accordion><Accordion title="microsoft_sharepoint/get_site_lists">@@ -79,6 +83,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `site_id` (string, required): The ID of the SharePoint site+</Accordion><Accordion title="microsoft_sharepoint/get_list">@@ -87,6 +92,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `site_id` (string, required): The ID of the SharePoint site- `list_id` (string, required): The ID of the list+</Accordion><Accordion title="microsoft_sharepoint/get_list_items">@@ -96,6 +102,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `site_id` (string, required): The ID of the SharePoint site- `list_id` (string, required): The ID of the list- `expand` (string, optional): Expand related data (e.g., 'fields')+</Accordion><Accordion title="microsoft_sharepoint/create_list_item">@@ -112,6 +119,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"Status": "Active"}```+</Accordion><Accordion title="microsoft_sharepoint/update_list_item">@@ -128,6 +136,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"Status": "Completed"}```+</Accordion><Accordion title="microsoft_sharepoint/delete_list_item">@@ -137,6 +146,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `site_id` (string, required): The ID of the SharePoint site- `list_id` (string, required): The ID of the list- `item_id` (string, required): The ID of the item to delete+</Accordion><Accordion title="microsoft_sharepoint/upload_file_to_library">@@ -146,6 +156,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `site_id` (string, required): The ID of the SharePoint site- `file_path` (string, required): The path where to upload the file (e.g., 'folder/filename.txt')- `content` (string, required): The file content to upload+</Accordion><Accordion title="microsoft_sharepoint/get_drive_items">@@ -153,6 +164,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `site_id` (string, required): The ID of the SharePoint site+</Accordion><Accordion title="microsoft_sharepoint/delete_drive_item">@@ -161,6 +173,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `site_id` (string, required): The ID of the SharePoint site- `item_id` (string, required): The ID of the file or folder to delete+</Accordion></AccordionGroup>@@ -363,36 +376,43 @@ crew.kickoff()### Common Issues**Permission Errors**+- Ensure your Microsoft account has appropriate permissions for SharePoint sites- Verify that the OAuth connection includes required scopes (Sites.Read.All, Sites.ReadWrite.All)- Check that you have access to the specific sites and lists you're trying to access**Site and List ID Issues**+- Verify that site IDs and list IDs are correct and properly formatted- Ensure that sites and lists exist and are accessible to your account- Use the get_sites and get_site_lists actions to discover valid IDs**Field and Schema Issues**+- Ensure field names match exactly with the SharePoint list schema- Verify that required fields are included when creating or updating list items- Check that field types and values are compatible with the list column definitions**File Upload Issues**+- Ensure file paths are properly formatted and don't contain invalid characters- Verify that you have write permissions to the target document library- Check that file content is properly encoded for upload**OData Query Issues**+- Use proper OData syntax for filter, select, expand, and orderby parameters- Verify that property names used in queries exist in the target resources- Test simple queries before building complex filter expressions**Pagination and Performance**+- Use top and skip parameters appropriately for large result sets- Implement proper pagination for lists with many items- Consider using select parameters to return only needed properties**Document Library Operations**+- Ensure you have proper permissions for document library operations- Verify that drive item IDs are correct when deleting files or folders- Check that file paths don't conflict with existing content@@ -400,5 +420,6 @@ crew.kickoff()### Getting Help<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with Microsoft SharePoint integration setup or troubleshooting.+ Contact our support team for assistance with Microsoft SharePoint integration+ setup or troubleshooting.</Card>diff --git a/docs/en/enterprise/integrations/microsoft_teams.mdx b/docs/en/enterprise/integrations/microsoft_teams.mdxindex e7f0db89b..f77d58ebd 100644--- a/docs/en/enterprise/integrations/microsoft_teams.mdx+++ b/docs/en/enterprise/integrations/microsoft_teams.mdx@@ -13,7 +13,7 @@ Enable your agents to access Teams data, send messages, create meetings, and manBefore using the Microsoft Teams integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A Microsoft account with Teams access- Connected your Microsoft account through the [Integrations page](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Before using the Microsoft Teams integration, ensure you have:### 1. Connect Your Microsoft Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **Microsoft Teams** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for Teams access@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -57,6 +59,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- No parameters required.+</Accordion><Accordion title="microsoft_teams/get_channels">@@ -64,6 +67,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `team_id` (string, required): The ID of the team.+</Accordion><Accordion title="microsoft_teams/send_message">@@ -74,6 +78,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `channel_id` (string, required): The ID of the channel.- `message` (string, required): The message content.- `content_type` (string, optional): Content type (html or text). Enum: `html`, `text`. Default is `text`.+</Accordion><Accordion title="microsoft_teams/get_messages">@@ -83,6 +88,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `team_id` (string, required): The ID of the team.- `channel_id` (string, required): The ID of the channel.- `top` (integer, optional): Number of messages to retrieve (max 50). Default is `20`.+</Accordion><Accordion title="microsoft_teams/create_meeting">@@ -92,6 +98,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `subject` (string, required): Meeting subject/title.- `startDateTime` (string, required): Meeting start time (ISO 8601 format with timezone).- `endDateTime` (string, required): Meeting end time (ISO 8601 format with timezone).+</Accordion><Accordion title="microsoft_teams/search_online_meetings_by_join_url">@@ -99,6 +106,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `join_web_url` (string, required): The join web URL of the meeting to search for.+</Accordion></AccordionGroup>@@ -194,35 +202,42 @@ crew.kickoff()### Common Issues**Authentication Errors**+- Ensure your Microsoft account has the necessary permissions for Teams access.- Required scopes include: `Team.ReadBasic.All`, `Channel.ReadBasic.All`, `ChannelMessage.Send`, `ChannelMessage.Read.All`, `OnlineMeetings.ReadWrite`, `OnlineMeetings.Read`.- Verify that the OAuth connection includes all required scopes.**Team and Channel Access**+- Ensure you are a member of the teams you're trying to access.- Double-check team IDs and channel IDs for correctness.- Team and channel IDs can be obtained using the `get_teams` and `get_channels` actions.**Message Sending Issues**+- Ensure `team_id`, `channel_id`, and `message` are provided for `send_message`.- Verify that you have permissions to send messages to the specified channel.- Choose appropriate `content_type` (text or html) based on your message format.**Meeting Creation**+- Ensure `subject`, `startDateTime`, and `endDateTime` are provided.- Use proper ISO 8601 format with timezone for datetime fields (e.g., '2024-01-20T10:00:00-08:00').- Verify that the meeting times are in the future.**Message Retrieval Limitations**+- The `get_messages` action can retrieve a maximum of 50 messages per request.- Messages are returned in reverse chronological order (newest first).**Meeting Search**+- For `search_online_meetings_by_join_url`, ensure the join URL is exact and properly formatted.- The URL should be the complete Teams meeting join URL.### Getting Help<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with Microsoft Teams integration setup or troubleshooting.+ Contact our support team for assistance with Microsoft Teams integration setup+ or troubleshooting.</Card>diff --git a/docs/en/enterprise/integrations/microsoft_word.mdx b/docs/en/enterprise/integrations/microsoft_word.mdxindex ed76a2efd..e83280e99 100644--- a/docs/en/enterprise/integrations/microsoft_word.mdx+++ b/docs/en/enterprise/integrations/microsoft_word.mdx@@ -13,7 +13,7 @@ Enable your agents to create, read, and manage Word documents and text files inBefore using the Microsoft Word integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A Microsoft account with Word and OneDrive/SharePoint access- Connected your Microsoft account through the [Integrations page](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Before using the Microsoft Word integration, ensure you have:### 1. Connect Your Microsoft Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **Microsoft Word** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for file access@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -61,6 +63,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `expand` (string, optional): Expand related resources inline.- `top` (integer, optional): Number of items to return (min 1, max 999).- `orderby` (string, optional): Order results by specified properties.+</Accordion><Accordion title="microsoft_word/create_text_document">@@ -69,6 +72,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `file_name` (string, required): Name of the text document (should end with .txt).- `content` (string, optional): Text content for the document. Default is "This is a new text document created via API."+</Accordion><Accordion title="microsoft_word/get_document_content">@@ -76,6 +80,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `file_id` (string, required): The ID of the document.+</Accordion><Accordion title="microsoft_word/get_document_properties">@@ -83,6 +88,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `file_id` (string, required): The ID of the document.+</Accordion><Accordion title="microsoft_word/delete_document">@@ -90,6 +96,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `file_id` (string, required): The ID of the document to delete.+</Accordion></AccordionGroup>@@ -185,24 +192,29 @@ crew.kickoff()### Common Issues**Authentication Errors**+- Ensure your Microsoft account has the necessary permissions for file access (e.g., `Files.Read.All`, `Files.ReadWrite.All`).- Verify that the OAuth connection includes all required scopes.**File Creation Issues**+- When creating text documents, ensure the `file_name` ends with `.txt` extension.- Verify that you have write permissions to the target location (OneDrive/SharePoint).**Document Access Issues**+- Double-check document IDs for correctness when accessing specific documents.- Ensure the referenced documents exist and are accessible.- Note that this integration works best with text files (.txt) for content operations.**Content Retrieval Limitations**+- The `get_document_content` action works best with text files (.txt).- For complex Word documents (.docx), consider using the document properties action to get metadata.### Getting Help<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with Microsoft Word integration setup or troubleshooting.+ Contact our support team for assistance with Microsoft Word integration setup+ or troubleshooting.</Card>diff --git a/docs/en/enterprise/integrations/notion.mdx b/docs/en/enterprise/integrations/notion.mdxindex 6d95805c6..c094da071 100644--- a/docs/en/enterprise/integrations/notion.mdx+++ b/docs/en/enterprise/integrations/notion.mdx@@ -13,7 +13,7 @@ Enable your agents to manage users and create comments through Notion. Access woBefore using the Notion integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A Notion account with appropriate workspace permissions- Connected your Notion account through the [Integrations page](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Before using the Notion integration, ensure you have:### 1. Connect Your Notion Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **Notion** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for user access and comment creation@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -58,6 +60,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `page_size` (integer, optional): Number of items returned in the response. Minimum: 1, Maximum: 100, Default: 100- `start_cursor` (string, optional): Cursor for pagination. Return results after this cursor.+</Accordion><Accordion title="notion/get_user">@@ -65,6 +68,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `user_id` (string, required): The ID of the user to retrieve.+</Accordion><Accordion title="notion/create_comment">@@ -96,6 +100,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token}]```+</Accordion></AccordionGroup>@@ -254,26 +259,31 @@ crew.kickoff()### Common Issues**Permission Errors**+- Ensure your Notion account has appropriate permissions to read user information- Verify that the OAuth connection includes required scopes for user access and comment creation- Check that you have permissions to comment on the target pages or discussions**User Access Issues**+- Ensure you have workspace admin permissions to list all users- Verify that user IDs are correct and users exist in the workspace- Check that the workspace allows API access to user information**Comment Creation Issues**+- Verify that page IDs or discussion IDs are correct and accessible- Ensure that rich text content follows Notion's API format specifications- Check that you have comment permissions on the target pages or discussions**API Rate Limits**+- Be mindful of Notion's API rate limits when making multiple requests- Implement appropriate delays between requests if needed- Consider pagination for large user lists**Parent Object Specification**+- Ensure parent object type is correctly specified (page_id or discussion_id)- Verify that the parent page or discussion exists and is accessible- Check that the parent object ID format is correct@@ -281,5 +291,6 @@ crew.kickoff()### Getting Help<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with Notion integration setup or troubleshooting.+ Contact our support team for assistance with Notion integration setup or+ troubleshooting.</Card>diff --git a/docs/en/enterprise/integrations/salesforce.mdx b/docs/en/enterprise/integrations/salesforce.mdxindex ba73f5db5..c729a3a7e 100644--- a/docs/en/enterprise/integrations/salesforce.mdx+++ b/docs/en/enterprise/integrations/salesforce.mdx@@ -13,7 +13,7 @@ Enable your agents to manage customer relationships, sales processes, and data tBefore using the Salesforce integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A Salesforce account with appropriate permissions- Connected your Salesforce account through the [Integrations page](https://app.crewai.com/integrations)@@ -21,7 +21,7 @@ Before using the Salesforce integration, ensure you have:### 1. Connect Your Salesforce Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **Salesforce** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for CRM and sales management@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -65,6 +67,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `Title` (string, optional): Title of the contact, such as CEO or Vice President- `Description` (string, optional): A description of the Contact- `additionalFields` (object, optional): Additional fields in JSON format for custom Contact fields+</Accordion><Accordion title="salesforce/create_record_lead">@@ -81,6 +84,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `Status` (string, optional): Lead Status - Use Connect Portal Workflow Settings to select Lead Status- `Description` (string, optional): A description of the Lead- `additionalFields` (object, optional): Additional fields in JSON format for custom Lead fields+</Accordion><Accordion title="salesforce/create_record_opportunity">@@ -96,6 +100,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `OwnerId` (string, optional): The Salesforce user assigned to work on this Opportunity- `NextStep` (string, optional): Description of next task in closing Opportunity- `additionalFields` (object, optional): Additional fields in JSON format for custom Opportunity fields+</Accordion><Accordion title="salesforce/create_record_task">@@ -114,6 +119,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `isReminderSet` (boolean, optional): Whether reminder is set- `reminderDateTime` (string, optional): Reminder Date/Time in ISO format- `additionalFields` (object, optional): Additional fields in JSON format for custom Task fields+</Accordion><Accordion title="salesforce/create_record_account">@@ -126,12 +132,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `Phone` (string, optional): Phone number- `Description` (string, optional): Account description- `additionalFields` (object, optional): Additional fields in JSON format for custom Account fields+</Accordion><Accordion title="salesforce/create_record_any">**Description:** Create a record of any object type in Salesforce.**Note:** This is a flexible tool for creating records of custom or unknown object types.+</Accordion></AccordionGroup>@@ -150,6 +158,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `Title` (string, optional): Title of the contact- `Description` (string, optional): A description of the Contact- `additionalFields` (object, optional): Additional fields in JSON format for custom Contact fields+</Accordion><Accordion title="salesforce/update_record_lead">@@ -167,6 +176,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `Status` (string, optional): Lead Status- `Description` (string, optional): A description of the Lead- `additionalFields` (object, optional): Additional fields in JSON format for custom Lead fields+</Accordion><Accordion title="salesforce/update_record_opportunity">@@ -183,6 +193,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `OwnerId` (string, optional): The Salesforce user assigned to work on this Opportunity- `NextStep` (string, optional): Description of next task in closing Opportunity- `additionalFields` (object, optional): Additional fields in JSON format for custom Opportunity fields+</Accordion><Accordion title="salesforce/update_record_task">@@ -201,6 +212,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `isReminderSet` (boolean, optional): Whether reminder is set- `reminderDateTime` (string, optional): Reminder Date/Time in ISO format- `additionalFields` (object, optional): Additional fields in JSON format for custom Task fields+</Accordion><Accordion title="salesforce/update_record_account">@@ -214,12 +226,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `Phone` (string, optional): Phone number- `Description` (string, optional): Account description- `additionalFields` (object, optional): Additional fields in JSON format for custom Account fields+</Accordion><Accordion title="salesforce/update_record_any">**Description:** Update a record of any object type in Salesforce.**Note:** This is a flexible tool for updating records of custom or unknown object types.+</Accordion></AccordionGroup>@@ -231,6 +245,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `recordId` (string, required): Record ID of the Contact+</Accordion><Accordion title="salesforce/get_record_by_id_lead">@@ -238,6 +253,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `recordId` (string, required): Record ID of the Lead+</Accordion><Accordion title="salesforce/get_record_by_id_opportunity">@@ -245,6 +261,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `recordId` (string, required): Record ID of the Opportunity+</Accordion><Accordion title="salesforce/get_record_by_id_task">@@ -252,6 +269,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `recordId` (string, required): Record ID of the Task+</Accordion><Accordion title="salesforce/get_record_by_id_account">@@ -259,6 +277,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `recordId` (string, required): Record ID of the Account+</Accordion><Accordion title="salesforce/get_record_by_id_any">@@ -267,6 +286,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `recordType` (string, required): Record Type (e.g., "CustomObject__c")- `recordId` (string, required): Record ID+</Accordion></AccordionGroup>@@ -282,6 +302,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `sortDirection` (string, optional): Sort direction - Options: ASC, DESC- `includeAllFields` (boolean, optional): Include all fields in results- `paginationParameters` (object, optional): Pagination settings with pageCursor+</Accordion><Accordion title="salesforce/search_records_lead">@@ -293,6 +314,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `sortDirection` (string, optional): Sort direction - Options: ASC, DESC- `includeAllFields` (boolean, optional): Include all fields in results- `paginationParameters` (object, optional): Pagination settings with pageCursor+</Accordion><Accordion title="salesforce/search_records_opportunity">@@ -304,6 +326,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `sortDirection` (string, optional): Sort direction - Options: ASC, DESC- `includeAllFields` (boolean, optional): Include all fields in results- `paginationParameters` (object, optional): Pagination settings with pageCursor+</Accordion><Accordion title="salesforce/search_records_task">@@ -315,6 +338,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `sortDirection` (string, optional): Sort direction - Options: ASC, DESC- `includeAllFields` (boolean, optional): Include all fields in results- `paginationParameters` (object, optional): Pagination settings with pageCursor+</Accordion><Accordion title="salesforce/search_records_account">@@ -326,6 +350,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `sortDirection` (string, optional): Sort direction - Options: ASC, DESC- `includeAllFields` (boolean, optional): Include all fields in results- `paginationParameters` (object, optional): Pagination settings with pageCursor+</Accordion><Accordion title="salesforce/search_records_any">@@ -336,6 +361,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `filterFormula` (string, optional): Filter search criteria- `includeAllFields` (boolean, optional): Include all fields in results- `paginationParameters` (object, optional): Pagination settings with pageCursor+</Accordion></AccordionGroup>@@ -348,6 +374,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `listViewId` (string, required): List View ID- `paginationParameters` (object, optional): Pagination settings with pageCursor+</Accordion><Accordion title="salesforce/get_record_by_view_id_lead">@@ -356,6 +383,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `listViewId` (string, required): List View ID- `paginationParameters` (object, optional): Pagination settings with pageCursor+</Accordion><Accordion title="salesforce/get_record_by_view_id_opportunity">@@ -364,6 +392,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `listViewId` (string, required): List View ID- `paginationParameters` (object, optional): Pagination settings with pageCursor+</Accordion><Accordion title="salesforce/get_record_by_view_id_task">@@ -372,6 +401,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `listViewId` (string, required): List View ID- `paginationParameters` (object, optional): Pagination settings with pageCursor+</Accordion><Accordion title="salesforce/get_record_by_view_id_account">@@ -380,6 +410,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `listViewId` (string, required): List View ID- `paginationParameters` (object, optional): Pagination settings with pageCursor+</Accordion><Accordion title="salesforce/get_record_by_view_id_any">@@ -389,6 +420,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `recordType` (string, required): Record Type- `listViewId` (string, required): List View ID- `paginationParameters` (object, optional): Pagination settings with pageCursor+</Accordion></AccordionGroup>@@ -409,6 +441,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `description` (string, optional): Field description- `helperText` (string, optional): Helper text shown on hover- `defaultFieldValue` (string, optional): Default field value+</Accordion><Accordion title="salesforce/create_custom_field_lead">@@ -425,6 +458,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `description` (string, optional): Field description- `helperText` (string, optional): Helper text shown on hover- `defaultFieldValue` (string, optional): Default field value+</Accordion><Accordion title="salesforce/create_custom_field_opportunity">@@ -441,6 +475,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `description` (string, optional): Field description- `helperText` (string, optional): Helper text shown on hover- `defaultFieldValue` (string, optional): Default field value+</Accordion><Accordion title="salesforce/create_custom_field_task">@@ -457,6 +492,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `description` (string, optional): Field description- `helperText` (string, optional): Helper text shown on hover- `defaultFieldValue` (string, optional): Default field value+</Accordion><Accordion title="salesforce/create_custom_field_account">@@ -473,12 +509,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `description` (string, optional): Field description- `helperText` (string, optional): Helper text shown on hover- `defaultFieldValue` (string, optional): Default field value+</Accordion><Accordion title="salesforce/create_custom_field_any">**Description:** Deploy custom fields for any object type.**Note:** This is a flexible tool for creating custom fields on custom or unknown object types.+</Accordion></AccordionGroup>@@ -490,6 +528,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `query` (string, required): SOQL Query (e.g., "SELECT Id, Name FROM Account WHERE Name = 'Example'")+</Accordion><Accordion title="salesforce/create_custom_object">@@ -500,6 +539,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `pluralLabel` (string, required): Plural Label (e.g., "Accounts")- `description` (string, optional): A description of the Custom Object- `recordName` (string, required): Record Name that appears in layouts and searches (e.g., "Account Name")+</Accordion><Accordion title="salesforce/describe_action_schema">@@ -510,6 +550,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `operation` (string, required): Operation Type (e.g., "CREATE_RECORD" or "UPDATE_RECORD")**Note:** Use this function first when working with custom objects to understand their schema before performing operations.+</Accordion></AccordionGroup>@@ -639,5 +680,6 @@ This comprehensive documentation covers all the Salesforce tools organized by fu### Getting Help<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with Salesforce integration setup or troubleshooting.+ Contact our support team for assistance with Salesforce integration setup or+ troubleshooting.</Card>diff --git a/docs/en/enterprise/integrations/shopify.mdx b/docs/en/enterprise/integrations/shopify.mdxindex 09d34d4f5..47e4cdf26 100644--- a/docs/en/enterprise/integrations/shopify.mdx+++ b/docs/en/enterprise/integrations/shopify.mdx@@ -13,7 +13,7 @@ Enable your agents to manage e-commerce operations through Shopify. Handle custoBefore using the Shopify integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A Shopify store with appropriate admin permissions- Connected your Shopify store through the [Integrations page](https://app.crewai.com/integrations)@@ -21,7 +21,7 @@ Before using the Shopify integration, ensure you have:### 1. Connect Your Shopify Store-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **Shopify** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for store and product management@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -64,6 +66,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `updatedAtMin` (string, optional): Only return customers updated after this date (ISO or Unix timestamp)- `updatedAtMax` (string, optional): Only return customers updated before this date (ISO or Unix timestamp)- `limit` (string, optional): Maximum number of customers to return (defaults to 250)+</Accordion><Accordion title="shopify/search_customers">@@ -72,6 +75,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `filterFormula` (object, optional): Advanced filter in disjunctive normal form with field-specific operators- `limit` (string, optional): Maximum number of customers to return (defaults to 250)+</Accordion><Accordion title="shopify/create_customer">@@ -93,6 +97,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `note` (string, optional): Customer note- `sendEmailInvite` (boolean, optional): Whether to send email invitation- `metafields` (object, optional): Additional metafields in JSON format+</Accordion><Accordion title="shopify/update_customer">@@ -115,6 +120,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `note` (string, optional): Customer note- `sendEmailInvite` (boolean, optional): Whether to send email invitation- `metafields` (object, optional): Additional metafields in JSON format+</Accordion></AccordionGroup>@@ -131,6 +137,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `updatedAtMin` (string, optional): Only return orders updated after this date (ISO or Unix timestamp)- `updatedAtMax` (string, optional): Only return orders updated before this date (ISO or Unix timestamp)- `limit` (string, optional): Maximum number of orders to return (defaults to 250)+</Accordion><Accordion title="shopify/create_order">@@ -144,6 +151,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `financialStatus` (string, optional): Financial status - Options: pending, authorized, partially_paid, paid, partially_refunded, refunded, voided- `inventoryBehaviour` (string, optional): Inventory behavior - Options: bypass, decrement_ignoring_policy, decrement_obeying_policy- `note` (string, optional): Order note+</Accordion><Accordion title="shopify/update_order">@@ -158,6 +166,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `financialStatus` (string, optional): Financial status - Options: pending, authorized, partially_paid, paid, partially_refunded, refunded, voided- `inventoryBehaviour` (string, optional): Inventory behavior - Options: bypass, decrement_ignoring_policy, decrement_obeying_policy- `note` (string, optional): Order note+</Accordion><Accordion title="shopify/get_abandoned_carts">@@ -170,6 +179,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `createdAtMin` (string, optional): Only return carts created after this date (ISO or Unix timestamp)- `createdAtMax` (string, optional): Only return carts created before this date (ISO or Unix timestamp)- `limit` (string, optional): Maximum number of carts to return (defaults to 250)+</Accordion></AccordionGroup>@@ -190,6 +200,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `updatedAtMin` (string, optional): Only return products updated after this date (ISO or Unix timestamp)- `updatedAtMax` (string, optional): Only return products updated before this date (ISO or Unix timestamp)- `limit` (string, optional): Maximum number of products to return (defaults to 250)+</Accordion><Accordion title="shopify/create_product">@@ -206,6 +217,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `imageUrl` (string, optional): Product image URL- `isPublished` (boolean, optional): Whether product is published- `publishToPointToSale` (boolean, optional): Whether to publish to point of sale+</Accordion><Accordion title="shopify/update_product">@@ -223,6 +235,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `imageUrl` (string, optional): Product image URL- `isPublished` (boolean, optional): Whether product is published- `publishToPointToSale` (boolean, optional): Whether to publish to point of sale+</Accordion></AccordionGroup>@@ -234,6 +247,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `productFilterFormula` (object, optional): Advanced filter in disjunctive normal form with support for fields like id, title, vendor, status, handle, tag, created_at, updated_at, published_at+</Accordion><Accordion title="shopify/create_product_graphql">@@ -247,6 +261,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `tags` (string, optional): Product tags as array or comma-separated list- `media` (object, optional): Media objects with alt text, content type, and source URL- `additionalFields` (object, optional): Additional product fields like status, requiresSellingPlan, giftCard+</Accordion><Accordion title="shopify/update_product_graphql">@@ -261,6 +276,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `tags` (string, optional): Product tags as array or comma-separated list- `media` (object, optional): Updated media objects with alt text, content type, and source URL- `additionalFields` (object, optional): Additional product fields like status, requiresSellingPlan, giftCard+</Accordion></AccordionGroup>@@ -389,5 +405,6 @@ crew.kickoff()### Getting Help<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with Shopify integration setup or troubleshooting.+ Contact our support team for assistance with Shopify integration setup or+ troubleshooting.</Card>diff --git a/docs/en/enterprise/integrations/slack.mdx b/docs/en/enterprise/integrations/slack.mdxindex 18c1a0c88..a997f4d94 100644--- a/docs/en/enterprise/integrations/slack.mdx+++ b/docs/en/enterprise/integrations/slack.mdx@@ -13,7 +13,7 @@ Enable your agents to manage team communication through Slack. Send messages, seBefore using the Slack integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A Slack workspace with appropriate permissions- Connected your Slack workspace through the [Integrations page](https://app.crewai.com/integrations)@@ -21,7 +21,7 @@ Before using the Slack integration, ensure you have:### 1. Connect Your Slack Workspace-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **Slack** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for team communication@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -59,6 +61,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- No parameters required - retrieves all channel members+</Accordion><Accordion title="slack/get_user_by_email">@@ -66,6 +69,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `email` (string, required): The email address of a user in the workspace+</Accordion><Accordion title="slack/get_users_by_name">@@ -76,6 +80,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `displayName` (string, required): User's display name to search for- `paginationParameters` (object, optional): Pagination settings- `pageCursor` (string, optional): Page cursor for pagination+</Accordion></AccordionGroup>@@ -87,6 +92,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- No parameters required - retrieves all accessible channels+</Accordion></AccordionGroup>@@ -103,6 +109,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `botIcon` (string, required): Bot icon - Can be either an image URL or an emoji (e.g., ":dog:")- `blocks` (object, optional): Slack Block Kit JSON for rich message formatting with attachments and interactive elements- `authenticatedUser` (boolean, optional): If true, message appears to come from your authenticated Slack user instead of the application (defaults to false)+</Accordion><Accordion title="slack/send_direct_message">@@ -115,6 +122,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `botIcon` (string, required): Bot icon - Can be either an image URL or an emoji (e.g., ":dog:")- `blocks` (object, optional): Slack Block Kit JSON for rich message formatting with attachments and interactive elements- `authenticatedUser` (boolean, optional): If true, message appears to come from your authenticated Slack user instead of the application (defaults to false)+</Accordion></AccordionGroup>@@ -132,6 +140,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `from:@john in:#general` - Search for messages from John in the #general channel- `has:link after:2023-01-01` - Search for messages with links after January 1, 2023- `in:@channel before:yesterday` - Search for messages in a specific channel before yesterday+</Accordion></AccordionGroup>@@ -140,6 +149,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_tokenSlack's Block Kit allows you to create rich, interactive messages. Here are some examples of how to use the `blocks` parameter:### Simple Text with Attachment+```json[{@@ -154,6 +164,7 @@ Slack's Block Kit allows you to create rich, interactive messages. Here are some```### Rich Formatting with Sections+```json[{@@ -311,5 +322,6 @@ crew.kickoff()## Contact Support<Card title="Need Help?" icon="headset" href="mailto:[email protected]">- Contact our support team for assistance with Slack integration setup or troubleshooting.+ Contact our support team for assistance with Slack integration setup or+ troubleshooting.</Card>diff --git a/docs/en/enterprise/integrations/stripe.mdx b/docs/en/enterprise/integrations/stripe.mdxindex 49590d98a..bf61c36fc 100644--- a/docs/en/enterprise/integrations/stripe.mdx+++ b/docs/en/enterprise/integrations/stripe.mdx@@ -13,7 +13,7 @@ Enable your agents to manage payments, subscriptions, and customer billing throuBefore using the Stripe integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A Stripe account with appropriate API permissions- Connected your Stripe account through the [Integrations page](https://app.crewai.com/integrations)@@ -21,7 +21,7 @@ Before using the Stripe integration, ensure you have:### 1. Connect Your Stripe Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **Stripe** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for payment processing@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -62,6 +64,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `name` (string, optional): Customer's full name- `description` (string, optional): Customer description for internal reference- `metadataCreateCustomer` (object, optional): Additional metadata as key-value pairs (e.g., `{"field1": 1, "field2": 2}`)+</Accordion><Accordion title="stripe/get_customer_by_id">@@ -69,6 +72,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `idGetCustomer` (string, required): The Stripe customer ID to retrieve+</Accordion><Accordion title="stripe/get_customers">@@ -79,6 +83,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `createdAfter` (string, optional): Filter customers created after this date (Unix timestamp)- `createdBefore` (string, optional): Filter customers created before this date (Unix timestamp)- `limitGetCustomers` (string, optional): Maximum number of customers to return (defaults to 10)+</Accordion><Accordion title="stripe/update_customer">@@ -90,6 +95,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `name` (string, optional): Updated customer name- `description` (string, optional): Updated customer description- `metadataUpdateCustomer` (object, optional): Updated metadata as key-value pairs+</Accordion></AccordionGroup>@@ -103,6 +109,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `customerIdCreateSubscription` (string, required): The customer ID for whom the subscription will be created- `plan` (string, required): The plan ID for the subscription - Use Connect Portal Workflow Settings to allow users to select a plan- `metadataCreateSubscription` (object, optional): Additional metadata for the subscription+</Accordion><Accordion title="stripe/get_subscriptions">@@ -112,6 +119,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `customerIdGetSubscriptions` (string, optional): Filter subscriptions by customer ID- `subscriptionStatus` (string, optional): Filter by subscription status - Options: incomplete, incomplete_expired, trialing, active, past_due, canceled, unpaid- `limitGetSubscriptions` (string, optional): Maximum number of subscriptions to return (defaults to 10)+</Accordion></AccordionGroup>@@ -125,6 +133,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `productName` (string, required): The product name- `description` (string, optional): Product description- `metadataProduct` (object, optional): Additional product metadata as key-value pairs+</Accordion><Accordion title="stripe/get_product_by_id">@@ -132,6 +141,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `productId` (string, required): The Stripe product ID to retrieve+</Accordion><Accordion title="stripe/get_products">@@ -141,6 +151,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `createdAfter` (string, optional): Filter products created after this date (Unix timestamp)- `createdBefore` (string, optional): Filter products created before this date (Unix timestamp)- `limitGetProducts` (string, optional): Maximum number of products to return (defaults to 10)+</Accordion></AccordionGroup>@@ -154,6 +165,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `balanceTransactionType` (string, optional): Filter by transaction type - Options: charge, refund, payment, payment_refund- `paginationParameters` (object, optional): Pagination settings- `pageCursor` (string, optional): Page cursor for pagination+</Accordion><Accordion title="stripe/get_plans">@@ -163,6 +175,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `isPlanActive` (boolean, optional): Filter by plan status - true for active plans, false for inactive plans- `paginationParameters` (object, optional): Pagination settings- `pageCursor` (string, optional): Page cursor for pagination+</Accordion></AccordionGroup>diff --git a/docs/en/enterprise/integrations/zendesk.mdx b/docs/en/enterprise/integrations/zendesk.mdxindex 41662c862..6537f3a95 100644--- a/docs/en/enterprise/integrations/zendesk.mdx+++ b/docs/en/enterprise/integrations/zendesk.mdx@@ -13,7 +13,7 @@ Enable your agents to manage customer support operations through Zendesk. CreateBefore using the Zendesk integration, ensure you have:-- A [CrewAI AOP](https://app.crewai.com) account with an active subscription+- A [CrewAI AMP](https://app.crewai.com) account with an active subscription- A Zendesk account with appropriate API permissions- Connected your Zendesk account through the [Integrations page](https://app.crewai.com/integrations)@@ -21,7 +21,7 @@ Before using the Zendesk integration, ensure you have:### 1. Connect Your Zendesk Account-1. Navigate to [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)+1. Navigate to [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)2. Find **Zendesk** in the Authentication Integrations section3. Click **Connect** and complete the OAuth flow4. Grant the necessary permissions for ticket and user management@@ -36,7 +36,9 @@ uv add crewai-tools### 3. Environment Variable Setup<Note>- To use integrations with `Agent(apps=[])`, you must set the `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise Token.+ To use integrations with `Agent(apps=[])`, you must set the+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` environment variable with your Enterprise+ Token.</Note>```bash@@ -70,6 +72,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `ticketTags` (string, optional): Array of tags to apply (e.g., `["enterprise", "other_tag"]`)- `ticketExternalId` (string, optional): External ID to link tickets to local records- `ticketCustomFields` (object, optional): Custom field values in JSON format+</Accordion><Accordion title="zendesk/update_ticket">@@ -88,6 +91,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `ticketTags` (string, optional): Updated tags array- `ticketExternalId` (string, optional): Updated external ID- `ticketCustomFields` (object, optional): Updated custom field values+</Accordion><Accordion title="zendesk/get_ticket_by_id">@@ -95,6 +99,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `ticketId` (string, required): The ticket ID to retrieve (e.g., "35436")+</Accordion><Accordion title="zendesk/add_comment_to_ticket">@@ -105,6 +110,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `commentBody` (string, required): Comment message (accepts plain text or HTML, e.g., "Thanks for your help!")- `isInternalNote` (boolean, optional): Set to true for internal notes instead of public replies (defaults to false)- `isPublic` (boolean, optional): True for public comments, false for internal notes+</Accordion><Accordion title="zendesk/search_tickets">@@ -126,6 +132,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `dueDate` (object, optional): Filter by due date with operator and value- `sort_by` (string, optional): Sort field - Options: created_at, updated_at, priority, status, ticket_type- `sort_order` (string, optional): Sort direction - Options: asc, desc+</Accordion></AccordionGroup>@@ -143,6 +150,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `externalId` (string, optional): Unique identifier from another system- `details` (string, optional): Additional user details- `notes` (string, optional): Internal notes about the user+</Accordion><Accordion title="zendesk/update_user">@@ -157,6 +165,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `externalId` (string, optional): Updated external ID- `details` (string, optional): Updated user details- `notes` (string, optional): Updated internal notes+</Accordion><Accordion title="zendesk/get_user_by_id">@@ -164,6 +173,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `userId` (string, required): The user ID to retrieve+</Accordion><Accordion title="zendesk/search_users">@@ -176,6 +186,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `externalId` (string, optional): Filter by external ID- `sort_by` (string, optional): Sort field - Options: created_at, updated_at- `sort_order` (string, optional): Sort direction - Options: asc, desc+</Accordion></AccordionGroup>@@ -188,6 +199,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**Parameters:**- `paginationParameters` (object, optional): Pagination settings- `pageCursor` (string, optional): Page cursor for pagination+</Accordion><Accordion title="zendesk/get_ticket_audits">@@ -197,6 +209,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `ticketId` (string, optional): Get audits for specific ticket (if empty, retrieves audits for all non-archived tickets, e.g., "1234")- `paginationParameters` (object, optional): Pagination settings- `pageCursor` (string, optional): Page cursor for pagination+</Accordion></AccordionGroup>diff --git a/docs/en/enterprise/introduction.mdx b/docs/en/enterprise/introduction.mdxindex 4320dd1a6..fa2eba891 100644--- a/docs/en/enterprise/introduction.mdx+++ b/docs/en/enterprise/introduction.mdx@@ -1,5 +1,5 @@----title: "CrewAI AOP"+title: "CrewAI AMP"description: "Deploy, monitor, and scale your AI agent workflows"icon: "globe"mode: "wide"@@ -7,13 +7,16 @@ mode: "wide"## Introduction-CrewAI AOP(Agent Operations Platform) provides a platform for deploying, monitoring, and scaling your crews and agents in a production environment.+CrewAI AMP(Agent Management Platform) provides a platform for deploying, monitoring, and scaling your crews and agents in a production environment.<Frame>- <img src="/images/enterprise/crewai-enterprise-dashboard.png" alt="CrewAI AOP Dashboard" />+ <img+ src="/images/enterprise/crewai-enterprise-dashboard.png"+ alt="CrewAI AMP Dashboard"+ /></Frame>-CrewAI AOP extends the power of the open-source framework with features designed for production deployments, collaboration, and scalability. Deploy your crews to a managed infrastructure and monitor their execution in real-time.+CrewAI AMP extends the power of the open-source framework with features designed for production deployments, collaboration, and scalability. Deploy your crews to a managed infrastructure and monitor their execution in real-time.## Key Features@@ -22,7 +25,8 @@ CrewAI AOP extends the power of the open-source framework with features designedDeploy your crews to a managed infrastructure with a few clicks</Card><Card title="API Access" icon="code">- Access your deployed crews via REST API for integration with existing systems+ Access your deployed crews via REST API for integration with existing+ systems</Card><Card title="Observability" icon="chart-line">Monitor your crews with detailed execution traces and logs@@ -57,11 +61,7 @@ CrewAI AOP extends the power of the open-source framework with features designed<Steps><Step title="Sign up for an account">Create your account at [app.crewai.com](https://app.crewai.com)- <Card- title="Sign Up"- icon="user"- href="https://app.crewai.com/signup"- >+ <Card title="Sign Up" icon="user" href="https://app.crewai.com/signup">Sign Up</Card></Step>diff --git a/docs/en/enterprise/resources/frequently-asked-questions.mdx b/docs/en/enterprise/resources/frequently-asked-questions.mdxindex c35a089a4..ba324b5bb 100644--- a/docs/en/enterprise/resources/frequently-asked-questions.mdx+++ b/docs/en/enterprise/resources/frequently-asked-questions.mdx@@ -1,6 +1,6 @@---title: FAQs-description: "Frequently asked questions about CrewAI AOP"+description: "Frequently asked questions about CrewAI AMP"icon: "circle-question"mode: "wide"---@@ -148,4 +148,5 @@ mode: "wide"<Accordion title="How can you control the maximum number of requests per minute that the entire crew can perform?">The `max_rpm` attribute sets the maximum number of requests per minute the crew can perform to avoid rate limits and will override individual agents' `max_rpm` settings if you set it.</Accordion>+</AccordionGroup>diff --git a/docs/en/installation.mdx b/docs/en/installation.mdxindex e5ff207e7..b13ecedfc 100644--- a/docs/en/installation.mdx+++ b/docs/en/installation.mdx@@ -6,6 +6,7 @@ mode: "wide"---## Video Tutorial+Watch this video tutorial for a step-by-step demonstration of the installation process:<iframe@@ -18,21 +19,25 @@ Watch this video tutorial for a step-by-step demonstration of the installation p></iframe>## Text Tutorial+<Note>**Python Version Requirements**- CrewAI requires `Python >=3.10 and <3.14`. Here's how to check your version:- ```bash- python3 --version- ```+CrewAI requires `Python >=3.10 and <3.14`. Here's how to check your version:++```bash+python3 --version+```++If you need to update Python, visit [python.org/downloads](https://python.org/downloads)- If you need to update Python, visit [python.org/downloads](https://python.org/downloads)</Note><Note>**OpenAI SDK Requirement**- CrewAI 0.175.0 requires `openai >= 1.13.3`. If you manage dependencies yourself, ensure your environment satisfies this constraint to avoid import/runtime issues.+CrewAI 0.175.0 requires `openai >= 1.13.3`. If you manage dependencies yourself, ensure your environment satisfies this constraint to avoid import/runtime issues.+</Note>CrewAI uses the `uv` as its dependency management and package handling tool. It simplifies project setup and execution, offering a seamless experience.@@ -95,6 +100,7 @@ If you haven't installed `uv` yet, follow **step 1** to quickly get it set up on```<Check>Installation successful! You're ready to create your first crew! 🎉</Check></Step>+</Steps># Creating a CrewAI Project@@ -128,6 +134,7 @@ We recommend using the `YAML` template scaffolding for a structured approach to├── agents.yaml└── tasks.yaml```+</Step><Step title="Customize Your Project">@@ -144,6 +151,7 @@ We recommend using the `YAML` template scaffolding for a structured approach to- Start by editing `agents.yaml` and `tasks.yaml` to define your crew's behavior.- Keep sensitive information like API keys in `.env`.+</Step><Step title="Run your Crew">@@ -167,13 +175,15 @@ We recommend using the `YAML` template scaffolding for a structured approach to<Note type="info">For teams and organizations, CrewAI offers enterprise deployment options that eliminate setup complexity:-### CrewAI AOP (SaaS)+### CrewAI AMP (SaaS)+- Zero installation required - just sign up for free at [app.crewai.com](https://app.crewai.com)- Automatic updates and maintenance- Managed infrastructure and scaling- Build Crews with no Code### CrewAI Factory (Self-hosted)+- Containerized deployment for your infrastructure- Supports any hyperscaler including on prem deployments- Integration with your existing security systems@@ -186,12 +196,9 @@ For teams and organizations, CrewAI offers enterprise deployment options that el## Next Steps<CardGroup cols={2}>- <Card- title="Build Your First Agent"- icon="code"- href="/en/quickstart"- >- Follow our quickstart guide to create your first CrewAI agent and get hands-on experience.+ <Card title="Build Your First Agent" icon="code" href="/en/quickstart">+ Follow our quickstart guide to create your first CrewAI agent and get+ hands-on experience.</Card><Cardtitle="Join the Community"diff --git a/docs/en/learn/llm-selection-guide.mdx b/docs/en/learn/llm-selection-guide.mdxindex a8119103b..c15f5fa5a 100644--- a/docs/en/learn/llm-selection-guide.mdx+++ b/docs/en/learn/llm-selection-guide.mdx@@ -1,7 +1,7 @@----title: 'Strategic LLM Selection Guide'-description: 'Strategic framework for choosing the right LLM for your CrewAI AI agents and writing effective task and agent definitions'-icon: 'brain-circuit'+title: "Strategic LLM Selection Guide"+description: "Strategic framework for choosing the right LLM for your CrewAI AI agents and writing effective task and agent definitions"+icon: "brain-circuit"mode: "wide"---@@ -10,23 +10,35 @@ mode: "wide"Rather than prescriptive model recommendations, we advocate for a **thinking framework** that helps you make informed decisions based on your specific use case, constraints, and requirements. The LLM landscape evolves rapidly, with new models emerging regularly and existing ones being updated frequently. What matters most is developing a systematic approach to evaluation that remains relevant regardless of which specific models are available.<Note>-This guide focuses on strategic thinking rather than specific model recommendations, as the LLM landscape evolves rapidly.+ This guide focuses on strategic thinking rather than specific model+ recommendations, as the LLM landscape evolves rapidly.</Note>## Quick Decision Framework<Steps><Step title="Analyze Your Tasks">- Begin by deeply understanding what your tasks actually require. Consider the cognitive complexity involved, the depth of reasoning needed, the format of expected outputs, and the amount of context the model will need to process. This foundational analysis will guide every subsequent decision.+ Begin by deeply understanding what your tasks actually require. Consider the+ cognitive complexity involved, the depth of reasoning needed, the format of+ expected outputs, and the amount of context the model will need to process.+ This foundational analysis will guide every subsequent decision.</Step><Step title="Map Model Capabilities">- Once you understand your requirements, map them to model strengths. Different model families excel at different types of work; some are optimized for reasoning and analysis, others for creativity and content generation, and others for speed and efficiency.+ Once you understand your requirements, map them to model strengths.+ Different model families excel at different types of work; some are+ optimized for reasoning and analysis, others for creativity and content+ generation, and others for speed and efficiency.</Step><Step title="Consider Constraints">- Factor in your real-world operational constraints including budget limitations, latency requirements, data privacy needs, and infrastructure capabilities. The theoretically best model may not be the practically best choice for your situation.+ Factor in your real-world operational constraints including budget+ limitations, latency requirements, data privacy needs, and infrastructure+ capabilities. The theoretically best model may not be the practically best+ choice for your situation.</Step><Step title="Test and Iterate">- Start with reliable, well-understood models and optimize based on actual performance in your specific use case. Real-world results often differ from theoretical benchmarks, so empirical testing is crucial.+ Start with reliable, well-understood models and optimize based on actual+ performance in your specific use case. Real-world results often differ from+ theoretical benchmarks, so empirical testing is crucial.</Step></Steps>@@ -43,6 +55,7 @@ The most critical step in LLM selection is understanding what your task actually- **Complex Tasks** require multi-step reasoning, strategic thinking, and the ability to handle ambiguous or incomplete information. These might involve analyzing multiple data sources, developing comprehensive strategies, or solving problems that require breaking down into smaller components. The model needs to maintain context across multiple reasoning steps and often must make inferences that aren't explicitly stated.- **Creative Tasks** demand a different type of cognitive capability focused on generating novel, engaging, and contextually appropriate content. This includes storytelling, marketing copy creation, and creative problem-solving. The model needs to understand nuance, tone, and audience while producing content that feels authentic and engaging rather than formulaic.+</Tab><Tab title="Output Requirements">@@ -51,6 +64,7 @@ The most critical step in LLM selection is understanding what your task actually- **Creative Content** outputs demand a balance of technical competence and creative flair. The model needs to understand audience, tone, and brand voice while producing content that engages readers and achieves specific communication goals. Quality here is often subjective and requires models that can adapt their writing style to different contexts and purposes.- **Technical Content** sits between structured data and creative content, requiring both precision and clarity. Documentation, code generation, and technical analysis need to be accurate and comprehensive while remaining accessible to the intended audience. The model must understand complex technical concepts and communicate them effectively.+</Tab><Tab title="Context Needs">@@ -59,6 +73,7 @@ The most critical step in LLM selection is understanding what your task actually- **Long Context** requirements emerge when working with substantial documents, extended conversations, or complex multi-part tasks. The model needs to maintain coherence across thousands of tokens while referencing earlier information accurately. This capability becomes crucial for document analysis, comprehensive research, and sophisticated dialogue systems.- **Very Long Context** scenarios push the boundaries of what's currently possible, involving massive document processing, extensive research synthesis, or complex multi-session interactions. These use cases require models specifically designed for extended context handling and often involve trade-offs between context length and processing speed.+</Tab></Tabs>@@ -73,6 +88,7 @@ Understanding model capabilities requires looking beyond marketing claims and beThe strength of reasoning models lies in their ability to maintain logical consistency across extended reasoning chains and to break down complex problems into manageable components. They're particularly valuable for strategic planning, complex analysis, and situations where the quality of reasoning matters more than speed of response.However, reasoning models often come with trade-offs in terms of speed and cost. They may also be less suitable for creative tasks or simple operations where their sophisticated reasoning capabilities aren't needed. Consider these models when your tasks involve genuine complexity that benefits from systematic, step-by-step analysis.+</Accordion><Accordion title="General Purpose Models" icon="microchip">@@ -81,6 +97,7 @@ Understanding model capabilities requires looking beyond marketing claims and beThe primary advantage of general purpose models is their reliability and predictability across different types of work. They handle most standard business tasks competently, from research and analysis to content creation and data processing. This makes them excellent choices for teams that need consistent performance across varied workflows.While general purpose models may not achieve the peak performance of specialized alternatives in specific domains, they offer operational simplicity and reduced complexity in model management. They're often the best starting point for new projects, allowing teams to understand their specific needs before potentially optimizing with more specialized models.+</Accordion><Accordion title="Fast & Efficient Models" icon="bolt">@@ -89,6 +106,7 @@ Understanding model capabilities requires looking beyond marketing claims and beThese models excel in scenarios involving routine operations, simple data processing, function calling, and high-volume tasks where the cognitive requirements are relatively straightforward. They're particularly valuable for applications that need to process many requests quickly or operate within tight budget constraints.The key consideration with efficient models is ensuring that their capabilities align with your task requirements. While they can handle many routine operations effectively, they may struggle with tasks requiring nuanced understanding, complex reasoning, or sophisticated content generation. They're best used for well-defined, routine operations where speed and cost matter more than sophistication.+</Accordion><Accordion title="Creative Models" icon="pen">@@ -97,6 +115,7 @@ Understanding model capabilities requires looking beyond marketing claims and beThe strength of creative models lies in their ability to adapt writing style to different audiences, maintain consistent voice and tone, and generate content that engages readers effectively. They often perform better on tasks involving storytelling, marketing copy, brand communications, and other content where creativity and engagement are primary goals.When selecting creative models, consider not just their ability to generate text, but their understanding of audience, context, and purpose. The best creative models can adapt their output to match specific brand voices, target different audience segments, and maintain consistency across extended content pieces.+</Accordion><Accordion title="Open Source Models" icon="code">@@ -105,6 +124,7 @@ Understanding model capabilities requires looking beyond marketing claims and beThe primary benefits of open source models include elimination of per-token costs, ability to fine-tune for specific use cases, complete data privacy, and independence from external API providers. They're particularly valuable for organizations with strict data privacy requirements, budget constraints, or specific customization needs.However, open source models require more technical expertise to deploy and maintain effectively. Teams need to consider infrastructure costs, model management complexity, and the ongoing effort required to keep models updated and optimized. The total cost of ownership may be higher than cloud-based alternatives when factoring in technical overhead.+</Accordion></AccordionGroup>@@ -113,7 +133,8 @@ Understanding model capabilities requires looking beyond marketing claims and be### a. Multi-Model Approach<Tip>-Use different models for different purposes within the same crew to optimize both performance and cost.+ Use different models for different purposes within the same crew to optimize+ both performance and cost.</Tip>The most sophisticated CrewAI implementations often employ multiple models strategically, assigning different models to different agents based on their specific roles and requirements. This approach allows teams to optimize for both performance and cost by using the most appropriate model for each type of work.@@ -177,6 +198,7 @@ The key to successful multi-model implementation is understanding how differentEffective manager LLMs require strong reasoning capabilities to make good delegation decisions, consistent performance to ensure predictable coordination, and excellent context management to track the state of multiple agents simultaneously. The model needs to understand the capabilities and limitations of different agents while optimizing task allocation for efficiency and quality.Cost considerations are particularly important for manager LLMs since they're involved in every operation. The model needs to provide sufficient capability for effective coordination while remaining cost-effective for frequent use. This often means finding models that offer good reasoning capabilities without the premium pricing of the most sophisticated options.+</Tab><Tab title="Function Calling LLM">@@ -185,6 +207,7 @@ The key to successful multi-model implementation is understanding how differentThe most important characteristics for function calling LLMs are precision and reliability rather than creativity or sophisticated reasoning. The model needs to consistently extract the correct parameters from natural language requests and handle tool responses appropriately. Speed is also important since tool usage often involves multiple round trips that can impact overall performance.Many teams find that specialized function calling models or general purpose models with strong tool support work better than creative or reasoning-focused models for this role. The key is ensuring that the model can reliably bridge the gap between natural language instructions and structured tool calls.+</Tab><Tab title="Agent-Specific Overrides">@@ -193,6 +216,7 @@ The key to successful multi-model implementation is understanding how differentConsider agent-specific overrides when an agent's role requires capabilities that differ substantially from other crew members. For example, a creative writing agent might benefit from a model optimized for content generation, while a data analysis agent might perform better with a reasoning-focused model.The challenge with agent-specific overrides is balancing optimization with operational complexity. Each additional model adds complexity to deployment, monitoring, and cost management. Teams should focus overrides on agents where the performance improvement justifies the additional complexity.+</Tab></Tabs>@@ -209,6 +233,7 @@ Effective task definition is often more important than model selection in determEffective task descriptions include relevant context and constraints that help the agent understand the broader purpose and any limitations they need to work within. They break complex work into focused steps that can be executed systematically, rather than presenting overwhelming, multi-faceted objectives that are difficult to approach systematically.Common mistakes include being too vague about objectives, failing to provide necessary context, setting unclear success criteria, or combining multiple unrelated tasks into a single description. The goal is to provide enough information for the agent to succeed while maintaining focus on a single, clear objective.+</Accordion><Accordion title="Expected Output Guidelines" icon="bullseye">@@ -217,6 +242,7 @@ Effective task definition is often more important than model selection in determThe best output guidelines provide concrete examples of quality indicators and define completion criteria clearly enough that both the agent and human reviewers can assess whether the task has been completed successfully. This reduces ambiguity and helps ensure consistent results across multiple task executions.Avoid generic output descriptions that could apply to any task, missing format specifications that leave agents guessing about structure, unclear quality standards that make evaluation difficult, or failing to provide examples or templates that help agents understand expectations.+</Accordion></AccordionGroup>@@ -229,6 +255,7 @@ Effective task definition is often more important than model selection in determImplementing sequential dependencies effectively requires using the context parameter to chain related tasks, building complexity gradually through task progression, and ensuring that each task produces outputs that serve as meaningful inputs for subsequent tasks. The goal is to maintain logical flow between dependent tasks while avoiding unnecessary bottlenecks.Sequential dependencies work best when there's a clear logical progression from one task to another and when the output of one task genuinely improves the quality or feasibility of subsequent tasks. However, they can create bottlenecks if not managed carefully, so it's important to identify which dependencies are truly necessary versus those that are merely convenient.+</Tab><Tab title="Parallel Execution">@@ -237,6 +264,7 @@ Effective task definition is often more important than model selection in determSuccessful parallel execution requires identifying tasks that can truly run independently, grouping related but separate work streams effectively, and planning for result integration when parallel tasks need to be combined into a final deliverable. The key is ensuring that parallel tasks don't create conflicts or redundancies that reduce overall quality.Consider parallel execution when you have multiple independent research streams, different types of analysis that don't depend on each other, or content creation tasks that can be developed simultaneously. However, be mindful of resource allocation and ensure that parallel execution doesn't overwhelm your available model capacity or budget.+</Tab></Tabs>@@ -245,7 +273,8 @@ Effective task definition is often more important than model selection in determ### a. Role-Driven LLM Selection<Warning>-Generic agent roles make it impossible to select the right LLM. Specific roles enable targeted model optimization.+ Generic agent roles make it impossible to select the right LLM. Specific roles+ enable targeted model optimization.</Warning>The specificity of your agent roles directly determines which LLM capabilities matter most for optimal performance. This creates a strategic opportunity to match precise model strengths with agent responsibilities.@@ -253,6 +282,7 @@ The specificity of your agent roles directly determines which LLM capabilities m**Generic vs. Specific Role Impact on LLM Choice:**When defining roles, think about the specific domain knowledge, working style, and decision-making frameworks that would be most valuable for the tasks the agent will handle. The more specific and contextual the role definition, the better the model can embody that role effectively.+```python# ✅ Specific role - clear LLM requirementsspecific_agent = Agent(@@ -273,7 +303,8 @@ specific_agent = Agent(### b. Backstory as Model Context Amplifier<Info>-Strategic backstories multiply your chosen LLM's effectiveness by providing domain-specific context that generic prompting cannot achieve.+ Strategic backstories multiply your chosen LLM's effectiveness by providing+ domain-specific context that generic prompting cannot achieve.</Info>A well-crafted backstory transforms your LLM choice from generic capability to specialized expertise. This is especially crucial for cost optimization - a well-contextualized efficient model can outperform a premium model without proper context.@@ -300,6 +331,7 @@ domain_expert = Agent(```**Backstory Elements That Enhance LLM Performance:**+- **Domain Experience**: "10+ years in enterprise SaaS sales"- **Specific Expertise**: "Specializes in technical due diligence for Series B+ rounds"- **Working Style**: "Prefers data-driven decisions with clear documentation"@@ -332,6 +364,7 @@ tech_writer = Agent(```**Alignment Checklist:**+- ✅ **Role Specificity**: Clear domain and responsibilities- ✅ **LLM Match**: Model strengths align with role requirements- ✅ **Backstory Depth**: Provides domain context the LLM can leverage@@ -353,6 +386,7 @@ Rather than repeating the strategic framework, here's a tactical checklist for i- Are any agents heavily tool-dependent?**Action**: Document current agent roles and identify optimization opportunities.+</Step><Step title="Implement Crew-Level Strategy" icon="users-gear">@@ -369,6 +403,7 @@ Rather than repeating the strategic framework, here's a tactical checklist for i```**Action**: Establish your crew's default LLM before optimizing individual agents.+</Step><Step title="Optimize High-Impact Agents" icon="star">@@ -390,16 +425,18 @@ Rather than repeating the strategic framework, here's a tactical checklist for i```**Action**: Upgrade 20% of your agents that handle 80% of the complexity.+</Step><Step title="Validate with Enterprise Testing" icon="test-tube">**Once you deploy your agents to production:**- - Use [CrewAI AOP platform](https://app.crewai.com) to A/B test your model selections+ - Use [CrewAI AMP platform](https://app.crewai.com) to A/B test your model selections- Run multiple iterations with real inputs to measure consistency and performance- Compare cost vs. performance across your optimized setup- Share results with your team for collaborative decision-making**Action**: Replace guesswork with data-driven validation using the testing platform.+</Step></Steps>@@ -412,6 +449,7 @@ Rather than repeating the strategic framework, here's a tactical checklist for iConsider reasoning models for business strategy development, complex data analysis that requires drawing insights from multiple sources, multi-step problem solving where each step depends on previous analysis, and strategic planning tasks that require considering multiple variables and their interactions.However, reasoning models often come with higher costs and slower response times, so they're best reserved for tasks where their sophisticated capabilities provide genuine value rather than being used for simple operations that don't require complex reasoning.+</Tab><Tab title="Creative Models">@@ -420,6 +458,7 @@ Rather than repeating the strategic framework, here's a tactical checklist for iUse creative models for blog post writing and article creation, marketing copy that needs to engage and persuade, creative storytelling and narrative development, and brand communications where voice and tone are crucial. These models often understand nuance and context better than general purpose alternatives.Creative models may be less suitable for technical or analytical tasks where precision and factual accuracy are more important than engagement and style. They're best used when the creative and communicative aspects of the output are primary success factors.+</Tab><Tab title="Efficient Models">@@ -428,6 +467,7 @@ Rather than repeating the strategic framework, here's a tactical checklist for iConsider efficient models for data processing and transformation tasks, simple formatting and organization operations, function calling and tool usage where precision matters more than sophistication, and high-volume operations where cost per operation is a significant factor.The key with efficient models is ensuring that their capabilities align with task requirements. They can handle many routine operations effectively but may struggle with tasks requiring nuanced understanding, complex reasoning, or sophisticated content generation.+</Tab><Tab title="Open Source Models">@@ -436,6 +476,7 @@ Rather than repeating the strategic framework, here's a tactical checklist for iConsider open source models for internal company tools where data privacy is paramount, privacy-sensitive applications that can't use external APIs, cost-optimized deployments where per-token pricing is prohibitive, and situations requiring custom model modifications or fine-tuning.However, open source models require more technical expertise to deploy and maintain effectively. Consider the total cost of ownership including infrastructure, technical overhead, and ongoing maintenance when evaluating open source options.+</Tab></Tabs>@@ -455,6 +496,7 @@ Rather than repeating the strategic framework, here's a tactical checklist for i# Processing agent gets efficient modelprocessor = Agent(role="Data Processor", llm=LLM(model="gpt-4o-mini"))```+</Accordion><Accordion title="Ignoring Crew-Level vs Agent-Level LLM Hierarchy" icon="shuffle">@@ -474,6 +516,7 @@ Rather than repeating the strategic framework, here's a tactical checklist for i# Agents inherit crew LLM unless specifically overriddenagent1 = Agent(llm=LLM(model="claude-3-5-sonnet")) # Override for specific needs```+</Accordion><Accordion title="Function Calling Model Mismatch" icon="screwdriver-wrench">@@ -492,6 +535,7 @@ Rather than repeating the strategic framework, here's a tactical checklist for illm=LLM(model="claude-3-5-sonnet") # Also strong with tools)```+</Accordion><Accordion title="Premature Optimization Without Testing" icon="gear">@@ -507,6 +551,7 @@ Rather than repeating the strategic framework, here's a tactical checklist for i# Test performance, then optimize specific agents as needed# Use Enterprise platform testing to validate improvements```+</Accordion><Accordion title="Overlooking Context and Memory Limitations" icon="brain">@@ -515,6 +560,7 @@ Rather than repeating the strategic framework, here's a tactical checklist for i**Real Example**: Using a short-context model for agents that need to maintain conversation history across multiple task iterations, or in crews with extensive agent-to-agent communication.**CrewAI Solution**: Match context capabilities to crew communication patterns.+</Accordion></AccordionGroup>@@ -522,26 +568,40 @@ Rather than repeating the strategic framework, here's a tactical checklist for i<Steps><Step title="Start Simple" icon="play">- Begin with reliable, general-purpose models that are well-understood and widely supported. This provides a stable foundation for understanding your specific requirements and performance expectations before optimizing for specialized needs.+ Begin with reliable, general-purpose models that are well-understood and+ widely supported. This provides a stable foundation for understanding your+ specific requirements and performance expectations before optimizing for+ specialized needs.</Step><Step title="Measure What Matters" icon="chart-line">- Develop metrics that align with your specific use case and business requirements rather than relying solely on general benchmarks. Focus on measuring outcomes that directly impact your success rather than theoretical performance indicators.+ Develop metrics that align with your specific use case and business+ requirements rather than relying solely on general benchmarks. Focus on+ measuring outcomes that directly impact your success rather than theoretical+ performance indicators.</Step><Step title="Iterate Based on Results" icon="arrows-rotate">- Make model changes based on observed performance in your specific context rather than theoretical considerations or general recommendations. Real-world performance often differs significantly from benchmark results or general reputation.+ Make model changes based on observed performance in your specific context+ rather than theoretical considerations or general recommendations.+ Real-world performance often differs significantly from benchmark results or+ general reputation.</Step><Step title="Consider Total Cost" icon="calculator">- Evaluate the complete cost of ownership including model costs, development time, maintenance overhead, and operational complexity. The cheapest model per token may not be the most cost-effective choice when considering all factors.+ Evaluate the complete cost of ownership including model costs, development+ time, maintenance overhead, and operational complexity. The cheapest model+ per token may not be the most cost-effective choice when considering all+ factors.</Step></Steps><Tip>-Focus on understanding your requirements first, then select models that best match those needs. The best LLM choice is the one that consistently delivers the results you need within your operational constraints.+ Focus on understanding your requirements first, then select models that best+ match those needs. The best LLM choice is the one that consistently delivers+ the results you need within your operational constraints.</Tip>### Enterprise-Grade Model Validation-For teams serious about optimizing their LLM selection, the **CrewAI AOP platform** provides sophisticated testing capabilities that go far beyond basic CLI testing. The platform enables comprehensive model evaluation that helps you make data-driven decisions about your LLM strategy.+For teams serious about optimizing their LLM selection, the **CrewAI AMP platform** provides sophisticated testing capabilities that go far beyond basic CLI testing. The platform enables comprehensive model evaluation that helps you make data-driven decisions about your LLM strategy.<Frame>@@ -562,7 +622,9 @@ For teams serious about optimizing their LLM selection, the **CrewAI AOP platforGo to [app.crewai.com](https://app.crewai.com) to get started!<Info>-The Enterprise platform transforms model selection from guesswork into a data-driven process, enabling you to validate the principles in this guide with your actual use cases and requirements.+ The Enterprise platform transforms model selection from guesswork into a+ data-driven process, enabling you to validate the principles in this guide+ with your actual use cases and requirements.</Info>## Key Principles Summary@@ -572,21 +634,27 @@ The Enterprise platform transforms model selection from guesswork into a data-drChoose models based on what the task actually requires, not theoretical capabilities or general reputation.</Card>- <Card title="Capability Matching" icon="puzzle-piece">- Align model strengths with agent roles and responsibilities for optimal performance.- </Card>+{" "}+<Card title="Capability Matching" icon="puzzle-piece">+ Align model strengths with agent roles and responsibilities for optimal+ performance.+</Card>- <Card title="Strategic Consistency" icon="link">- Maintain coherent model selection strategy across related components and workflows.- </Card>+{" "}+<Card title="Strategic Consistency" icon="link">+ Maintain coherent model selection strategy across related components and+ workflows.+</Card>- <Card title="Practical Testing" icon="flask">- Validate choices through real-world usage rather than benchmarks alone.- </Card>+{" "}+<Card title="Practical Testing" icon="flask">+ Validate choices through real-world usage rather than benchmarks alone.+</Card>- <Card title="Iterative Improvement" icon="arrow-up">- Start simple and optimize based on actual performance and needs.- </Card>+{" "}+<Card title="Iterative Improvement" icon="arrow-up">+ Start simple and optimize based on actual performance and needs.+</Card><Card title="Operational Balance" icon="scale-balanced">Balance performance requirements with cost and complexity constraints.@@ -594,13 +662,20 @@ The Enterprise platform transforms model selection from guesswork into a data-dr</CardGroup><Check>-Remember: The best LLM choice is the one that consistently delivers the results you need within your operational constraints. Focus on understanding your requirements first, then select models that best match those needs.+ Remember: The best LLM choice is the one that consistently delivers the+ results you need within your operational constraints. Focus on understanding+ your requirements first, then select models that best match those needs.</Check>## Current Model Landscape (June 2025)<Warning>-**Snapshot in Time**: The following model rankings represent current leaderboard standings as of June 2025, compiled from [LMSys Arena](https://arena.lmsys.org/), [Artificial Analysis](https://artificialanalysis.ai/), and other leading benchmarks. LLM performance, availability, and pricing change rapidly. Always conduct your own evaluations with your specific use cases and data.+ **Snapshot in Time**: The following model rankings represent current+ leaderboard standings as of June 2025, compiled from [LMSys+ Arena](https://arena.lmsys.org/), [Artificial+ Analysis](https://artificialanalysis.ai/), and other leading benchmarks. LLM+ performance, availability, and pricing change rapidly. Always conduct your own+ evaluations with your specific use cases and data.</Warning>### Leading Models by Category@@ -608,7 +683,10 @@ Remember: The best LLM choice is the one that consistently delivers the resultsThe tables below show a representative sample of current top-performing models across different categories, with guidance on their suitability for CrewAI agents:<Note>-These tables/metrics showcase selected leading models in each category and are not exhaustive. Many excellent models exist beyond those listed here. The goal is to illustrate the types of capabilities to look for rather than provide a complete catalog.+ These tables/metrics showcase selected leading models in each category and are+ not exhaustive. Many excellent models exist beyond those listed here. The goal+ is to illustrate the types of capabilities to look for rather than provide a+ complete catalog.</Note><Tabs>@@ -624,6 +702,7 @@ These tables/metrics showcase selected leading models in each category and are n| **Qwen3 235B (Reasoning)** | 62 | $2.63 | Moderate | Open-source alternative for reasoning tasks |These models excel at multi-step reasoning and are ideal for agents that need to develop strategies, coordinate other agents, or analyze complex information.+</Tab><Tab title="Coding & Technical">@@ -638,6 +717,7 @@ These tables/metrics showcase selected leading models in each category and are n| **Llama 3.1 405B** | Good | 81.1% | $3.50 | Function calling LLM for tool-heavy workflows |These models are optimized for code generation, debugging, and technical problem-solving, making them ideal for development-focused crews.+</Tab><Tab title="Speed & Efficiency">@@ -652,6 +732,7 @@ These tables/metrics showcase selected leading models in each category and are n| **Nova Micro** | High | 0.30s | $0.04 | Simple, fast task execution |These models prioritize speed and efficiency, perfect for agents handling routine operations or requiring quick responses. **Pro tip**: Pairing these models with fast inference providers like Groq can achieve even better performance, especially for open-source models like Llama.+</Tab><Tab title="Balanced Performance">@@ -666,6 +747,7 @@ These tables/metrics showcase selected leading models in each category and are n| **Qwen3 32B** | 44 | Good | $1.23 | Budget-friendly versatility |These models offer good performance across multiple dimensions, suitable for crews with diverse task requirements.+</Tab></Tabs>@@ -676,24 +758,28 @@ These tables/metrics showcase selected leading models in each category and are n**When performance is the priority**: Use top-tier models like **o3**, **Gemini 2.5 Pro**, or **Claude 4 Sonnet** for manager LLMs and critical agents. These models excel at complex reasoning and coordination but come with higher costs.**Strategy**: Implement a multi-model approach where premium models handle strategic thinking while efficient models handle routine operations.+</Accordion><Accordion title="Cost-Conscious Crews" icon="dollar-sign">**When budget is a primary constraint**: Focus on models like **DeepSeek R1**, **Llama 4 Scout**, or **Gemini 2.0 Flash**. These provide strong performance at significantly lower costs.**Strategy**: Use cost-effective models for most agents, reserving premium models only for the most critical decision-making roles.+</Accordion><Accordion title="Specialized Workflows" icon="screwdriver-wrench">**For specific domain expertise**: Choose models optimized for your primary use case. **Claude 4** series for coding, **Gemini 2.5 Pro** for research, **Llama 405B** for function calling.**Strategy**: Select models based on your crew's primary function, ensuring the core capability aligns with model strengths.+</Accordion><Accordion title="Enterprise & Privacy" icon="shield">**For data-sensitive operations**: Consider open-source models like **Llama 4** series, **DeepSeek V3**, or **Qwen3** that can be deployed locally while maintaining competitive performance.**Strategy**: Deploy open-source models on private infrastructure, accepting potential performance trade-offs for data control.+</Accordion></AccordionGroup>@@ -706,7 +792,10 @@ These tables/metrics showcase selected leading models in each category and are n- **Open Source Viability**: The gap between open-source and proprietary models continues to narrow, with models like Llama 4 Maverick and DeepSeek V3 offering competitive performance at attractive price points. Fast inference providers particularly shine with open-source models, often delivering better speed-to-cost ratios than proprietary alternatives.<Info>-**Testing is Essential**: Leaderboard rankings provide general guidance, but your specific use case, prompting style, and evaluation criteria may produce different results. Always test candidate models with your actual tasks and data before making final decisions.+ **Testing is Essential**: Leaderboard rankings provide general guidance, but+ your specific use case, prompting style, and evaluation criteria may produce+ different results. Always test candidate models with your actual tasks and+ data before making final decisions.</Info>### Practical Implementation Strategy@@ -716,13 +805,20 @@ These tables/metrics showcase selected leading models in each category and are nBegin with well-established models like **GPT-4.1**, **Claude 3.7 Sonnet**, or **Gemini 2.0 Flash** that offer good performance across multiple dimensions and have extensive real-world validation.</Step>- <Step title="Identify Specialized Needs">- Determine if your crew has specific requirements (coding, reasoning, speed) that would benefit from specialized models like **Claude 4 Sonnet** for development or **o3** for complex analysis. For speed-critical applications, consider fast inference providers like **Groq** alongside model selection.- </Step>-- <Step title="Implement Multi-Model Strategy">- Use different models for different agents based on their roles. High-capability models for managers and complex tasks, efficient models for routine operations.- </Step>+{" "}+<Step title="Identify Specialized Needs">+ Determine if your crew has specific requirements (coding, reasoning, speed)+ that would benefit from specialized models like **Claude 4 Sonnet** for+ development or **o3** for complex analysis. For speed-critical applications,+ consider fast inference providers like **Groq** alongside model selection.+</Step>++{" "}+<Step title="Implement Multi-Model Strategy">+ Use different models for different agents based on their roles.+ High-capability models for managers and complex tasks, efficient models for+ routine operations.+</Step><Step title="Monitor and Optimize">Track performance metrics relevant to your use case and be prepared to adjust model selections as new models are released or pricing changes.diff --git a/docs/en/mcp/dsl-integration.mdx b/docs/en/mcp/dsl-integration.mdxindex c0ffbcb91..d630055e7 100644--- a/docs/en/mcp/dsl-integration.mdx+++ b/docs/en/mcp/dsl-integration.mdx@@ -10,7 +10,9 @@ mode: "wide"CrewAI's MCP DSL (Domain Specific Language) integration provides the **simplest way** to connect your agents to MCP (Model Context Protocol) servers. Just add an `mcps` field to your agent and CrewAI handles all the complexity automatically.<Info>-This is the **recommended approach** for most MCP use cases. For advanced scenarios requiring manual connection management, see [MCPServerAdapter](/en/mcp/overview#advanced-mcpserveradapter).+ This is the **recommended approach** for most MCP use cases. For advanced+ scenarios requiring manual connection management, see+ [MCPServerAdapter](/en/mcp/overview#advanced-mcpserveradapter).</Info>## Basic Usage@@ -60,9 +62,9 @@ Use the `#` syntax to select specific tools from a server:"https://mcp.exa.ai/mcp?api_key=your_key#web_search_exa"```-### CrewAI AOP Marketplace+### CrewAI AMP Marketplace-Access tools from the CrewAI AOP marketplace:+Access tools from the CrewAI AMP marketplace:```python# Full service with all tools@@ -97,7 +99,7 @@ multi_source_agent = Agent("https://mcp.exa.ai/mcp?api_key=your_exa_key&profile=research","https://weather.api.com/mcp#get_current_conditions",- # CrewAI AOP marketplace+ # CrewAI AMP marketplace"crewai-amp:financial-insights","crewai-amp:academic-research#pubmed_search","crewai-amp:market-intelligence#competitor_analysis"@@ -319,6 +321,7 @@ agent = Agent(### Common Issues**No tools discovered:**+```python# Check your MCP server URL and authentication# Verify the server is running and accessible@@ -326,6 +329,7 @@ mcps=["https://mcp.example.com/mcp?api_key=valid_key"]```**Connection timeouts:**+```python# Server may be slow or overloaded# CrewAI will log warnings and continue with other servers@@ -333,6 +337,7 @@ mcps=["https://mcp.example.com/mcp?api_key=valid_key"]```**Authentication failures:**+```python# Verify API keys and credentials# Check server documentation for required parametersdiff --git a/docs/en/mcp/overview.mdx b/docs/en/mcp/overview.mdxindex 4171fa27a..63031982a 100644--- a/docs/en/mcp/overview.mdx+++ b/docs/en/mcp/overview.mdx@@ -1,6 +1,6 @@----title: 'MCP Servers as Tools in CrewAI'-description: 'Learn how to integrate MCP servers as tools in your CrewAI agents using the `crewai-tools` library.'+title: "MCP Servers as Tools in CrewAI"+description: "Learn how to integrate MCP servers as tools in your CrewAI agents using the `crewai-tools` library."icon: plugmode: "wide"---@@ -17,7 +17,7 @@ Use the `mcps` field directly on agents for seamless MCP tool integration. The D#### String-Based References (Quick Setup)-Perfect for remote HTTPS servers and CrewAI AOP marketplace:+Perfect for remote HTTPS servers and CrewAI AMP marketplace:```pythonfrom crewai import Agent@@ -29,7 +29,7 @@ agent = Agent(mcps=["https://mcp.exa.ai/mcp?api_key=your_key", # External MCP server"https://api.weather.com/mcp#get_forecast", # Specific tool from server- "crewai-amp:financial-data", # CrewAI AOP marketplace+ "crewai-amp:financial-data", # CrewAI AMP marketplace"crewai-amp:research-tools#pubmed_search" # Specific AMP tool])@@ -87,6 +87,7 @@ We currently support the following transport mechanisms:- **Streamable HTTPS**: for remote servers (flexible, potentially bi-directional communication over HTTPS, often utilizing SSE for server-to-client streams)## Video Tutorial+Watch this video tutorial for a comprehensive guide on MCP integration with CrewAI:<iframe@@ -203,7 +204,7 @@ mcps=[]```-#### CrewAI AOP Marketplace+#### CrewAI AMP Marketplace```pythonmcps=[@@ -373,6 +374,7 @@ Each transport type supports specific configuration options:### Common ParametersAll transport types support:+- **`tool_filter`**: Filter function to control which tools are available. Can be:- `None` (default): All tools are available- Static filter: Created with `create_static_tool_filter()` for allow/block lists@@ -423,6 +425,7 @@ agent = Agent(```All connection errors are handled gracefully:+- **Connection failures**: Logged as warnings, agent continues with available tools- **Timeout errors**: Connections timeout after 30 seconds (configurable)- **Authentication errors**: Logged clearly for debugging@@ -484,6 +487,7 @@ with MCPServerAdapter(server_params, connect_timeout=60) as mcp_tools:)# ... rest of your crew setup ...```+This general pattern shows how to integrate tools. For specific examples tailored to each transport, refer to the detailed guides below.## Filtering Tools@@ -570,6 +574,7 @@ When a crew class is decorated with `@CrewBase`, the adapter lifecycle is manage- If `mcp_server_params` is not defined, `get_mcp_tools()` simply returns an empty list, allowing the same code paths to run with or without MCP configured.This makes it safe to call `get_mcp_tools()` from multiple agent methods or selectively enable MCP per environment.+</Tip>### Connection Timeout Configuration@@ -636,7 +641,8 @@ class CrewWithCustomTimeout:href="/en/mcp/dsl-integration"color="#3B82F6">- **Recommended**: Use the simple `mcps=[]` field syntax for effortless MCP integration.+ **Recommended**: Use the simple `mcps=[]` field syntax for effortless MCP+ integration.</Card><Cardtitle="Stdio Transport"@@ -644,15 +650,12 @@ class CrewWithCustomTimeout:href="/en/mcp/stdio"color="#10B981">- Connect to local MCP servers via standard input/output. Ideal for scripts and local executables.+ Connect to local MCP servers via standard input/output. Ideal for scripts+ and local executables.</Card>- <Card- title="SSE Transport"- icon="wifi"- href="/en/mcp/sse"- color="#F59E0B"- >- Integrate with remote MCP servers using Server-Sent Events for real-time data streaming.+ <Card title="SSE Transport" icon="wifi" href="/en/mcp/sse" color="#F59E0B">+ Integrate with remote MCP servers using Server-Sent Events for real-time+ data streaming.</Card><Cardtitle="Streamable HTTP Transport"@@ -660,7 +663,8 @@ class CrewWithCustomTimeout:href="/en/mcp/streamable-http"color="#8B5CF6">- Utilize flexible Streamable HTTP for robust communication with remote MCP servers.+ Utilize flexible Streamable HTTP for robust communication with remote MCP+ servers.</Card><Cardtitle="Connecting to Multiple Servers"@@ -668,7 +672,8 @@ class CrewWithCustomTimeout:href="/en/mcp/multiple-servers"color="#EF4444">- Aggregate tools from several MCP servers simultaneously using a single adapter.+ Aggregate tools from several MCP servers simultaneously using a single+ adapter.</Card><Cardtitle="Security Considerations"@@ -676,27 +681,28 @@ class CrewWithCustomTimeout:href="/en/mcp/security"color="#DC2626">- Review important security best practices for MCP integration to keep your agents safe.+ Review important security best practices for MCP integration to keep your+ agents safe.</Card></CardGroup>Checkout this repository for full demos and examples of MCP integration with CrewAI! 👇<Card-title="GitHub Repository"-icon="github"-href="https://github.com/tonykipkemboi/crewai-mcp-demo"-target="_blank"+ title="GitHub Repository"+ icon="github"+ href="https://github.com/tonykipkemboi/crewai-mcp-demo"+ target="_blank">-CrewAI MCP Demo+ CrewAI MCP Demo</Card>## Staying Safe with MCP-<Warning>-Always ensure that you trust an MCP Server before using it.-</Warning>++<Warning>Always ensure that you trust an MCP Server before using it.</Warning>#### Security Warning: DNS Rebinding Attacks+SSE transports can be vulnerable to DNS rebinding attacks if not properly secured.To prevent this:@@ -709,6 +715,7 @@ Without these protections, attackers could use DNS rebinding to interact with loFor more details, see the [Anthropic's MCP Transport Security docs](https://modelcontextprotocol.io/docs/concepts/transports#security-considerations).### Limitations-* **Supported Primitives**: Currently, `MCPServerAdapter` primarily supports adapting MCP `tools`.-Other MCP primitives like `prompts` or `resources` are not directly integrated as CrewAI components through this adapter at this time.-* **Output Handling**: The adapter typically processes the primary text output from an MCP tool (e.g., `.content[0].text`). Complex or multi-modal outputs might require custom handling if not fitting this pattern.++- **Supported Primitives**: Currently, `MCPServerAdapter` primarily supports adapting MCP `tools`.+ Other MCP primitives like `prompts` or `resources` are not directly integrated as CrewAI components through this adapter at this time.+- **Output Handling**: The adapter typically processes the primary text output from an MCP tool (e.g., `.content[0].text`). Complex or multi-modal outputs might require custom handling if not fitting this pattern.diff --git a/docs/en/observability/tracing.mdx b/docs/en/observability/tracing.mdxindex d9af38685..5663e22ba 100644--- a/docs/en/observability/tracing.mdx+++ b/docs/en/observability/tracing.mdx@@ -1,6 +1,6 @@---title: CrewAI Tracing-description: Built-in tracing for CrewAI Crews and Flows with the CrewAI AOP platform+description: Built-in tracing for CrewAI Crews and Flows with the CrewAI AMP platformicon: magnifying-glass-chartmode: "wide"---@@ -9,7 +9,7 @@ mode: "wide"CrewAI provides built-in tracing capabilities that allow you to monitor and debug your Crews and Flows in real-time. This guide demonstrates how to enable tracing for both **Crews** and **Flows** using CrewAI's integrated observability platform.-> **What is CrewAI Tracing?** CrewAI's built-in tracing provides comprehensive observability for your AI agents, including agent decisions, task execution timelines, tool usage, and LLM calls - all accessible through the [CrewAI AOP platform](https://app.crewai.com).+> **What is CrewAI Tracing?** CrewAI's built-in tracing provides comprehensive observability for your AI agents, including agent decisions, task execution timelines, tool usage, and LLM calls - all accessible through the [CrewAI AMP platform](https://app.crewai.com).@@ -17,7 +17,7 @@ CrewAI provides built-in tracing capabilities that allow you to monitor and debuBefore you can use CrewAI tracing, you need:-1. **CrewAI AOP Account**: Sign up for a free account at [app.crewai.com](https://app.crewai.com)+1. **CrewAI AMP Account**: Sign up for a free account at [app.crewai.com](https://app.crewai.com)2. **CLI Authentication**: Use the CrewAI CLI to authenticate your local environment```bash@@ -26,9 +26,9 @@ crewai login## Setup Instructions-### Step 1: Create Your CrewAI AOP Account+### Step 1: Create Your CrewAI AMP Account-Visit [app.crewai.com](https://app.crewai.com) and create your free account. This will give you access to the CrewAI AOP platform where you can view traces, metrics, and manage your crews.+Visit [app.crewai.com](https://app.crewai.com) and create your free account. This will give you access to the CrewAI AMP platform where you can view traces, metrics, and manage your crews.### Step 2: Install CrewAI CLI and Authenticate@@ -38,16 +38,17 @@ If you haven't already, install CrewAI with the CLI tools:uv add crewai[tools]```-Then authenticate your CLI with your CrewAI AOP account:+Then authenticate your CLI with your CrewAI AMP account:```bashcrewai login```This command will:+1. Open your browser to the authentication page2. Prompt you to enter a device code-3. Authenticate your local environment with your CrewAI AOP account+3. Authenticate your local environment with your CrewAI AMP account4. Enable tracing capabilities for your local development### Step 3: Enable Tracing in Your Crew@@ -147,13 +148,12 @@ flow = ExampleFlow(tracing=True)result = flow.kickoff()```-### Step 5: View Traces in the CrewAI AOP Dashboard+### Step 5: View Traces in the CrewAI AMP Dashboard-After running the crew or flow, you can view the traces generated by your CrewAI application in the CrewAI AOP dashboard. You should see detailed steps of the agent interactions, tool usages, and LLM calls.+After running the crew or flow, you can view the traces generated by your CrewAI application in the CrewAI AMP dashboard. You should see detailed steps of the agent interactions, tool usages, and LLM calls.Just click on the link below to view the traces or head over to the traces tab in the dashboard [here](https://app.crewai.com/crewai_plus/trace_batches)-### Alternative: Environment Variable ConfigurationYou can also enable tracing globally by setting an environment variable:@@ -172,7 +172,7 @@ When this environment variable is set, all Crews and Flows will automatically ha## Viewing Your Traces-### Access the CrewAI AOP Dashboard+### Access the CrewAI AMP Dashboard1. Visit [app.crewai.com](https://app.crewai.com) and log in to your account2. Navigate to your project dashboard@@ -190,6 +190,7 @@ CrewAI tracing provides comprehensive visibility into:- **Error Tracking**: Detailed error information and stack traces### Trace Features+- **Execution Timeline**: Click through different stages of execution- **Detailed Logs**: Access comprehensive logs for debugging- **Performance Analytics**: Analyze execution patterns and optimize performancediff --git a/docs/en/quickstart.mdx b/docs/en/quickstart.mdxindex 86797b0ee..0ad5d2612 100644--- a/docs/en/quickstart.mdx+++ b/docs/en/quickstart.mdx@@ -58,6 +58,7 @@ Follow the steps below to get Crewing! 🚣♂️your ability to turn complex data into clear and concise reports, makingit easy for others to understand and act on the information you provide.```+</Step><Step title="Modify your `tasks.yaml` file">```yaml tasks.yaml@@ -81,6 +82,7 @@ Follow the steps below to get Crewing! 🚣♂️agent: reporting_analystoutput_file: report.md```+</Step><Step title="Modify your `crew.py` file">```python crew.py@@ -136,6 +138,7 @@ Follow the steps below to get Crewing! 🚣♂️verbose=True,)```+</Step><Step title="[Optional] Add before and after crew functions">```python crew.py@@ -160,6 +163,7 @@ Follow the steps below to get Crewing! 🚣♂️# ... remaining code```+</Step><Step title="Feel free to pass custom inputs to your crew">For example, you can pass the `topic` input to your crew to customize the research and reporting.@@ -178,6 +182,7 @@ Follow the steps below to get Crewing! 🚣♂️}LatestAiDevelopmentCrew().crew().kickoff(inputs=inputs)```+</Step><Step title="Set your environment variables">Before running your crew, make sure you have the following keys set as environment variables in your `.env` file:@@ -209,24 +214,24 @@ Follow the steps below to get Crewing! 🚣♂️</Step><Step title="Enterprise Alternative: Create in Crew Studio">- For CrewAI AOP users, you can create the same crew without writing code:+ For CrewAI AMP users, you can create the same crew without writing code:- 1. Log in to your CrewAI AOP account (create a free account at [app.crewai.com](https://app.crewai.com))- 2. Open Crew Studio- 3. Type what is the automation you're trying to build- 4. Create your tasks visually and connect them in sequence- 5. Configure your inputs and click "Download Code" or "Deploy"+1. Log in to your CrewAI AMP account (create a free account at [app.crewai.com](https://app.crewai.com))+2. Open Crew Studio+3. Type what is the automation you're trying to build+4. Create your tasks visually and connect them in sequence+5. Configure your inputs and click "Download Code" or "Deploy"- +- <Card title="Try CrewAI AOP" icon="rocket" href="https://app.crewai.com">- Start your free account at CrewAI AOP+ <Card title="Try CrewAI AMP" icon="rocket" href="https://app.crewai.com">+ Start your free account at CrewAI AMP</Card></Step><Step title="View your final report">You should see the output in the console and the `report.md` file should be created in the root of your project with the final report.- Here's an example of what the report should look like:+Here's an example of what the report should look like:<CodeGroup>```markdown output/report.md@@ -289,6 +294,7 @@ Follow the steps below to get Crewing! 🚣♂️## 8. ConclusionThe emergence of AI agents is undeniably reshaping the workplace landscape in 5. With their ability to automate tasks, enhance efficiency, and improve decision-making, AI agents are critical in driving operational success. Organizations must embrace and adapt to AI developments to thrive in an increasingly digital business environment.```+</CodeGroup></Step></Steps>@@ -297,6 +303,7 @@ Follow the steps below to get Crewing! 🚣♂️Congratulations!You have successfully set up your crew project and are ready to start building your own agentic workflows!+</Check>### Note on Consistency in Naming@@ -308,41 +315,45 @@ This naming consistency allows CrewAI to automatically link your configurations#### Example References<Tip>- Note how we use the same name for the agent in the `agents.yaml` (`email_summarizer`) file as the method name in the `crew.py` (`email_summarizer`) file.+ Note how we use the same name for the agent in the `agents.yaml`+ (`email_summarizer`) file as the method name in the `crew.py`+ (`email_summarizer`) file.</Tip>```yaml agents.yamlemail_summarizer:- role: >- Email Summarizer- goal: >- Summarize emails into a concise and clear summary- backstory: >- You will create a 5 bullet point summary of the report- llm: provider/model-id # Add your choice of model here+ role: >+ Email Summarizer+ goal: >+ Summarize emails into a concise and clear summary+ backstory: >+ You will create a 5 bullet point summary of the report+ llm: provider/model-id # Add your choice of model here```<Tip>- Note how we use the same name for the task in the `tasks.yaml` (`email_summarizer_task`) file as the method name in the `crew.py` (`email_summarizer_task`) file.+ Note how we use the same name for the task in the `tasks.yaml`+ (`email_summarizer_task`) file as the method name in the `crew.py`+ (`email_summarizer_task`) file.</Tip>```yaml tasks.yamlemail_summarizer_task:- description: >- Summarize the email into a 5 bullet point summary- expected_output: >- A 5 bullet point summary of the email- agent: email_summarizer- context:- - reporting_task- - research_task+ description: >+ Summarize the email into a 5 bullet point summary+ expected_output: >+ A 5 bullet point summary of the email+ agent: email_summarizer+ context:+ - reporting_task+ - research_task```## Deploying Your Crew-The easiest way to deploy your crew to production is through [CrewAI AOP](http://app.crewai.com).+The easiest way to deploy your crew to production is through [CrewAI AMP](http://app.crewai.com).-Watch this video tutorial for a step-by-step demonstration of deploying your crew to [CrewAI AOP](http://app.crewai.com) using the CLI.+Watch this video tutorial for a step-by-step demonstration of deploying your crew to [CrewAI AMP](http://app.crewai.com) using the CLI.<iframeclassName="w-full aspect-video rounded-xl"@@ -354,18 +365,16 @@ Watch this video tutorial for a step-by-step demonstration of deploying your cre></iframe><CardGroup cols={2}>- <Card- title="Deploy on Enterprise"- icon="rocket"- href="http://app.crewai.com"- >- Get started with CrewAI AOP and deploy your crew in a production environment with just a few clicks.+ <Card title="Deploy on Enterprise" icon="rocket" href="http://app.crewai.com">+ Get started with CrewAI AMP and deploy your crew in a production environment+ with just a few clicks.</Card><Cardtitle="Join the Community"icon="comments"href="https://community.crewai.com">- Join our open source community to discuss ideas, share your projects, and connect with other CrewAI developers.+ Join our open source community to discuss ideas, share your projects, and+ connect with other CrewAI developers.</Card></CardGroup>diff --git a/docs/enterprise-api.base.yaml b/docs/enterprise-api.base.yamlindex 7b434ae20..03ae18aa3 100644--- a/docs/enterprise-api.base.yaml+++ b/docs/enterprise-api.base.yaml@@ -1,12 +1,12 @@openapi: 3.0.3info:- title: CrewAI AOP API+ title: CrewAI AMP APIdescription: |- REST API for interacting with your deployed CrewAI crews on CrewAI AOP.+ REST API for interacting with your deployed CrewAI crews on CrewAI AMP.## Getting Started- 1. **Find your crew URL**: Get your unique crew URL from the CrewAI AOP dashboard+ 1. **Find your crew URL**: Get your unique crew URL from the CrewAI AMP dashboard2. **Copy examples**: Use the code examples from each endpoint page as templates3. **Replace placeholders**: Update URLs and tokens with your actual values4. **Test with your tools**: Use cURL, Postman, or your preferred API client@@ -18,7 +18,7 @@ info:- **Bearer Token**: Organization-level token for full crew operations- **User Bearer Token**: User-scoped token for individual access with limited permissions- You can find your bearer tokens in the Status tab of your crew's detail page in the CrewAI AOP dashboard.+ You can find your bearer tokens in the Status tab of your crew's detail page in the CrewAI AMP dashboard.## Reference Documentation@@ -43,7 +43,7 @@ info:url: https://crewai.comservers:- url: https://your-actual-crew-name.crewai.com- description: Replace with your actual deployed crew URL from the CrewAI AOP dashboard+ description: Replace with your actual deployed crew URL from the CrewAI AMP dashboard- url: https://my-travel-crew.crewai.comdescription: Example travel planning crew (replace with your URL)- url: https://content-creation-crew.crewai.com@@ -420,7 +420,7 @@ components:description: |**📋 Reference Documentation** - *The tokens shown in examples are placeholders for reference only.*- Use your actual Bearer Token or User Bearer Token from the CrewAI AOP dashboard for real API calls.+ Use your actual Bearer Token or User Bearer Token from the CrewAI AMP dashboard for real API calls.**Bearer Token**: Organization-level access for full crew operations**User Bearer Token**: User-scoped access with limited permissionsdiff --git a/docs/enterprise-api.en.yaml b/docs/enterprise-api.en.yamlindex 7b434ae20..03ae18aa3 100644--- a/docs/enterprise-api.en.yaml+++ b/docs/enterprise-api.en.yaml@@ -1,12 +1,12 @@openapi: 3.0.3info:- title: CrewAI AOP API+ title: CrewAI AMP APIdescription: |- REST API for interacting with your deployed CrewAI crews on CrewAI AOP.+ REST API for interacting with your deployed CrewAI crews on CrewAI AMP.## Getting Started- 1. **Find your crew URL**: Get your unique crew URL from the CrewAI AOP dashboard+ 1. **Find your crew URL**: Get your unique crew URL from the CrewAI AMP dashboard2. **Copy examples**: Use the code examples from each endpoint page as templates3. **Replace placeholders**: Update URLs and tokens with your actual values4. **Test with your tools**: Use cURL, Postman, or your preferred API client@@ -18,7 +18,7 @@ info:- **Bearer Token**: Organization-level token for full crew operations- **User Bearer Token**: User-scoped token for individual access with limited permissions- You can find your bearer tokens in the Status tab of your crew's detail page in the CrewAI AOP dashboard.+ You can find your bearer tokens in the Status tab of your crew's detail page in the CrewAI AMP dashboard.## Reference Documentation@@ -43,7 +43,7 @@ info:url: https://crewai.comservers:- url: https://your-actual-crew-name.crewai.com- description: Replace with your actual deployed crew URL from the CrewAI AOP dashboard+ description: Replace with your actual deployed crew URL from the CrewAI AMP dashboard- url: https://my-travel-crew.crewai.comdescription: Example travel planning crew (replace with your URL)- url: https://content-creation-crew.crewai.com@@ -420,7 +420,7 @@ components:description: |**📋 Reference Documentation** - *The tokens shown in examples are placeholders for reference only.*- Use your actual Bearer Token or User Bearer Token from the CrewAI AOP dashboard for real API calls.+ Use your actual Bearer Token or User Bearer Token from the CrewAI AMP dashboard for real API calls.**Bearer Token**: Organization-level access for full crew operations**User Bearer Token**: User-scoped access with limited permissionsdiff --git a/docs/enterprise-api.pt-BR.yaml b/docs/enterprise-api.pt-BR.yamlindex f58d29da2..831ab81e5 100644--- a/docs/enterprise-api.pt-BR.yaml+++ b/docs/enterprise-api.pt-BR.yaml@@ -1,12 +1,12 @@openapi: 3.0.3info:- title: CrewAI AOP API+ title: CrewAI AMP APIdescription: |- REST API para interagir com suas crews implantadas no CrewAI AOP.+ REST API para interagir com suas crews implantadas no CrewAI AMP.## Introdução- 1. **Encontre a URL da sua crew**: Obtenha sua URL única no painel do CrewAI AOP+ 1. **Encontre a URL da sua crew**: Obtenha sua URL única no painel do CrewAI AMP2. **Copie os exemplos**: Use os exemplos de cada endpoint como modelo3. **Substitua os placeholders**: Atualize URLs e tokens com seus valores reais4. **Teste com suas ferramentas**: Use cURL, Postman ou seu cliente preferido@@ -18,7 +18,7 @@ info:- **Bearer Token**: Token em nível de organização para operações completas- **User Bearer Token**: Token com escopo de usuário com permissões limitadas- Você encontra os tokens na aba Status da sua crew no painel do CrewAI AOP.+ Você encontra os tokens na aba Status da sua crew no painel do CrewAI AMP.## Documentação de Referência@@ -43,7 +43,7 @@ info:url: https://crewai.comservers:- url: https://your-actual-crew-name.crewai.com- description: Substitua pela URL real da sua crew no painel do CrewAI AOP+ description: Substitua pela URL real da sua crew no painel do CrewAI AMPsecurity:- BearerAuth: []paths:@@ -291,7 +291,7 @@ components:scheme: bearerdescription: |**📋 Referência** - *Os tokens mostrados são apenas exemplos.*- Use seus tokens reais do painel do CrewAI AOP.+ Use seus tokens reais do painel do CrewAI AMP.schemas:ExecutionRunning:diff --git a/docs/ko/api-reference/introduction.mdx b/docs/ko/api-reference/introduction.mdxindex ea24b63bd..967e06264 100644--- a/docs/ko/api-reference/introduction.mdx+++ b/docs/ko/api-reference/introduction.mdx@@ -1,6 +1,6 @@---title: "소개"-description: "CrewAI AOP REST API에 대한 완벽한 참고 자료"+description: "CrewAI AMP REST API에 대한 완벽한 참고 자료"icon: "code"mode: "wide"---@@ -13,7 +13,7 @@ CrewAI 엔터프라이즈 API 참고 자료에 오신 것을 환영합니다.<Steps><Step title="API 자격 증명 받기">- CrewAI AOP 대시보드에서 자신의 crew 상세 페이지로 이동하여 Status 탭에서 Bearer Token을 복사하세요.+ CrewAI AMP 대시보드에서 자신의 crew 상세 페이지로 이동하여 Status 탭에서 Bearer Token을 복사하세요.</Step><Step title="필수 입력값 확인하기">@@ -47,7 +47,7 @@ curl -H "Authorization: Bearer YOUR_CREW_TOKEN" \| **User Bearer Token** | 사용자 범위 접근 | 제한된 권한, 사용자별 작업에 적합 |<Tip>- 두 토큰 유형 모두 CrewAI AOP 대시보드의 crew 상세 페이지 Status 탭에서 확인할+ 두 토큰 유형 모두 CrewAI AMP 대시보드의 crew 상세 페이지 Status 탭에서 확인할수 있습니다.</Tip>@@ -84,7 +84,7 @@ API는 표준 HTTP 상태 코드를 사용합니다:## 인터랙티브 테스트<Info>- **왜 "전송" 버튼이 없나요?** 각 CrewAI AOP 사용자는 고유한 crew URL을+ **왜 "전송" 버튼이 없나요?** 각 CrewAI AMP 사용자는 고유한 crew URL을가지므로, 혼동을 피하기 위해 인터랙티브 플레이그라운드 대신 **참조 모드**를사용합니다. 이를 통해 비작동 전송 버튼 없이 요청이 어떻게 생겼는지 정확히보여줍니다.diff --git a/docs/ko/concepts/cli.mdx b/docs/ko/concepts/cli.mdxindex 7fa5733d1..90e6d8789 100644--- a/docs/ko/concepts/cli.mdx+++ b/docs/ko/concepts/cli.mdx@@ -5,7 +5,12 @@ icon: terminalmode: "wide"----<Warning>릴리즈 0.140.0부터 CrewAI AOP는 로그인 제공자 마이그레이션 프로세스를 시작했습니다. 이에 따라 CLI를 통한 인증 흐름이 업데이트되었습니다. Google을 통해 로그인하거나 2025년 7월 3일 이후에 계정을 생성한 사용자는 이전 버전의 `crewai` 라이브러리로는 로그인할 수 없습니다.</Warning>+<Warning>+ 릴리즈 0.140.0부터 CrewAI AOP는 로그인 제공자 마이그레이션 프로세스를+ 시작했습니다. 이에 따라 CLI를 통한 인증 흐름이 업데이트되었습니다. Google을+ 통해 로그인하거나 2025년 7월 3일 이후에 계정을 생성한 사용자는 이전 버전의+ `crewai` 라이브러리로는 로그인할 수 없습니다.+</Warning>## 개요@@ -41,6 +46,7 @@ crewai create [OPTIONS] TYPE NAME- `NAME`: crew 또는 flow의 이름예시:+```shell Terminalcrewai create crew my_new_crewcrewai create flow my_new_flow@@ -57,6 +63,7 @@ crewai version [OPTIONS]- `--tools`: (선택 사항) 설치된 CrewAI tools의 버전을 표시합니다.예시:+```shell Terminalcrewai versioncrewai version --tools@@ -74,6 +81,7 @@ crewai train [OPTIONS]- `-f, --filename TEXT`: 훈련에 사용할 커스텀 파일의 경로 (기본값: "trained_agents_data.pkl")예시:+```shell Terminalcrewai train -n 10 -f my_training_data.pkl```@@ -89,6 +97,7 @@ crewai replay [OPTIONS]- `-t, --task_id TEXT`: 이 task ID에서부터 crew를 다시 재생하며, 이후의 모든 task를 포함합니다.예시:+```shell Terminalcrewai replay -t task_123456```@@ -118,6 +127,7 @@ crewai reset-memories [OPTIONS]- `-a, --all`: 모든 메모리 초기화예시:+```shell Terminalcrewai reset-memories --long --shortcrewai reset-memories --all@@ -135,6 +145,7 @@ crewai test [OPTIONS]- `-m, --model TEXT`: Crew에서 테스트를 실행할 LLM 모델 (기본값: "gpt-4o-mini")예시:+```shell Terminalcrewai test -n 5 -m gpt-3.5-turbo```@@ -148,12 +159,14 @@ crewai run```<Note>-버전 0.103.0부터 `crewai run` 명령은 표준 crew와 flow 모두를 실행하는 데 사용할 수 있습니다. flow의 경우 pyproject.toml에서 유형을 자동으로 감지하여 적절한 명령을 실행합니다. 이제 crew와 flow 모두를 실행하는 권장 방법입니다.+ 버전 0.103.0부터 `crewai run` 명령은 표준 crew와 flow 모두를 실행하는 데+ 사용할 수 있습니다. flow의 경우 pyproject.toml에서 유형을 자동으로 감지하여+ 적절한 명령을 실행합니다. 이제 crew와 flow 모두를 실행하는 권장 방법입니다.</Note><Note>-이 명령들은 CrewAI 프로젝트가 설정된 디렉터리에서 실행해야 합니다.-일부 명령은 프로젝트 구조 내에서 추가 구성 또는 설정이 필요할 수 있습니다.+ 이 명령들은 CrewAI 프로젝트가 설정된 디렉터리에서 실행해야 합니다. 일부 명령은+ 프로젝트 구조 내에서 추가 구성 또는 설정이 필요할 수 있습니다.</Note>### 9. Chat@@ -165,6 +178,7 @@ crewai run```shell Terminalcrewai chat```+<Note>이 명령어들은 CrewAI 프로젝트의 루트 디렉터리에서 실행해야 합니다.</Note>@@ -182,28 +196,30 @@ def crew(self) -> Crew:chat_llm="gpt-4o", # LLM for chat orchestration)```+</Note>### 10. 배포-crew 또는 flow를 [CrewAI AOP](https://app.crewai.com)에 배포하세요.+crew 또는 flow를 [CrewAI AMP](https://app.crewai.com)에 배포하세요.- **인증**: CrewAI AOP에 배포하려면 인증이 필요합니다.- 아래 명령어로 로그인하거나 계정을 생성할 수 있습니다:- ```shell Terminal- crewai login- ```+ 아래 명령어로 로그인하거나 계정을 생성할 수 있습니다:++ ```shell Terminal+ crewai login+ ```- **배포 생성**: 인증이 완료되면, 로컬 프로젝트의 루트에서 crew 또는 flow에 대한 배포를 생성할 수 있습니다.- ```shell Terminal- crewai deploy create- ```- - 로컬 프로젝트 구성을 읽어옵니다.- - 로컬에서 확인된 환경 변수(`OPENAI_API_KEY`, `SERPER_API_KEY` 등)를 확인하도록 안내합니다. 이 변수들은 Enterprise 플랫폼에 배포할 때 안전하게 저장됩니다. 실행 전에 중요한 키가 로컬(예: `.env` 파일)에 올바르게 구성되어 있는지 확인하세요.+ ```shell Terminal+ crewai deploy create+ ```+ - 로컬 프로젝트 구성을 읽어옵니다.+ - 로컬에서 확인된 환경 변수(`OPENAI_API_KEY`, `SERPER_API_KEY` 등)를 확인하도록 안내합니다. 이 변수들은 Enterprise 플랫폼에 배포할 때 안전하게 저장됩니다. 실행 전에 중요한 키가 로컬(예: `.env` 파일)에 올바르게 구성되어 있는지 확인하세요.### 11. 조직 관리-CrewAI AOP 조직을 관리합니다.+CrewAI AMP 조직을 관리합니다.```shell Terminalcrewai org [COMMAND] [OPTIONS]@@ -212,65 +228,79 @@ crewai org [COMMAND] [OPTIONS]#### 명령어:- `list`: 사용자가 속한 모든 조직을 나열합니다.+```shell Terminalcrewai org list```- `current`: 현재 활성화된 조직을 표시합니다.+```shell Terminalcrewai org current```- `switch`: 특정 조직으로 전환합니다.+```shell Terminalcrewai org switch <organization_id>```<Note>-이러한 조직 관리 명령어를 사용하려면 CrewAI AOP에 인증되어 있어야 합니다.+ 이러한 조직 관리 명령어를 사용하려면 CrewAI AOP에 인증되어 있어야 합니다.</Note>- **배포 생성** (계속):- - 배포를 해당 원격 GitHub 저장소에 연결합니다 (일반적으로 자동으로 감지됩니다).++ - 배포를 해당 원격 GitHub 저장소에 연결합니다 (일반적으로 자동으로 감지됩니다).- **Crew 배포**: 인증이 완료되면 crew 또는 flow를 CrewAI AOP에 배포할 수 있습니다.- ```shell Terminal- crewai deploy push- ```- - CrewAI AOP 플랫폼에서 배포 프로세스를 시작합니다.- - 성공적으로 시작되면, Deployment created successfully! 메시지와 함께 Deployment Name 및 고유한 Deployment ID(UUID)가 출력됩니다.++ ```shell Terminal+ crewai deploy push+ ```++ - CrewAI AMP 플랫폼에서 배포 프로세스를 시작합니다.+ - 성공적으로 시작되면, Deployment created successfully! 메시지와 함께 Deployment Name 및 고유한 Deployment ID(UUID)가 출력됩니다.- **배포 상태**: 배포 상태를 확인하려면 다음을 사용합니다:- ```shell Terminal- crewai deploy status- ```- 이 명령은 가장 최근의 배포 시도에 대한 최신 배포 상태(예: `Building Images for Crew`, `Deploy Enqueued`, `Online`)를 가져옵니다.++ ```shell Terminal+ crewai deploy status+ ```++ 이 명령은 가장 최근의 배포 시도에 대한 최신 배포 상태(예: `Building Images for Crew`, `Deploy Enqueued`, `Online`)를 가져옵니다.- **배포 로그**: 배포 로그를 확인하려면 다음을 사용합니다:- ```shell Terminal- crewai deploy logs- ```- 이 명령은 배포 로그를 터미널로 스트리밍합니다.++ ```shell Terminal+ crewai deploy logs+ ```++ 이 명령은 배포 로그를 터미널로 스트리밍합니다.- **배포 목록**: 모든 배포를 나열하려면 다음을 사용합니다:- ```shell Terminal- crewai deploy list- ```- 이 명령은 모든 배포를 나열합니다.++ ```shell Terminal+ crewai deploy list+ ```++ 이 명령은 모든 배포를 나열합니다.- **배포 삭제**: 배포를 삭제하려면 다음을 사용합니다:- ```shell Terminal- crewai deploy remove- ```- 이 명령은 CrewAI AOP 플랫폼에서 배포를 삭제합니다.++ ```shell Terminal+ crewai deploy remove+ ```++ 이 명령은 CrewAI AMP 플랫폼에서 배포를 삭제합니다.- **도움말 명령어**: CLI에 대한 도움말을 보려면 다음을 사용합니다:- ```shell Terminal- crewai deploy --help- ```- 이 명령은 CrewAI Deploy CLI에 대한 도움말 메시지를 표시합니다.+ ```shell Terminal+ crewai deploy --help+ ```+ 이 명령은 CrewAI Deploy CLI에 대한 도움말 메시지를 표시합니다.-CLI를 사용하여 [CrewAI AOP](http://app.crewai.com)에 crew를 배포하는 단계별 시연은 아래 비디오 튜토리얼을 참조하십시오.+CLI를 사용하여 [CrewAI AMP](http://app.crewai.com)에 crew를 배포하는 단계별 시연은 아래 비디오 튜토리얼을 참조하십시오.<iframeclassName="w-full aspect-video rounded-xl"@@ -283,7 +313,7 @@ CLI를 사용하여 [CrewAI AOP](http://app.crewai.com)에 crew를 배포하는### 11. API 키-```crewai create crew``` 명령어를 실행하면, CLI에서 선택할 수 있는 LLM 제공업체 목록이 표시되고, 그 다음으로 선택한 제공업체에 대한 모델 선택이 이어집니다.+`crewai create crew` 명령어를 실행하면, CLI에서 선택할 수 있는 LLM 제공업체 목록이 표시되고, 그 다음으로 선택한 제공업체에 대한 모델 선택이 이어집니다.LLM 제공업체와 모델을 선택하면, API 키를 입력하라는 메시지가 표시됩니다.@@ -291,11 +321,11 @@ LLM 제공업체와 모델을 선택하면, API 키를 입력하라는 메시지다음은 CLI에서 제안하는 가장 인기 있는 LLM 공급자 목록입니다:-* OpenAI-* Groq-* Anthropic-* Google Gemini-* SambaNova+- OpenAI+- Groq+- Anthropic+- Google Gemini+- SambaNova공급자를 선택하면, CLI가 해당 공급자에서 사용 가능한 모델을 보여주고 API 키 입력을 요청합니다.@@ -307,7 +337,7 @@ LLM 제공업체와 모델을 선택하면, API 키를 입력하라는 메시지각 공급자의 Key 이름은 다음 링크에서 확인할 수 있습니다:-* [LiteLLM 공급자](https://docs.litellm.ai/docs/providers)+- [LiteLLM 공급자](https://docs.litellm.ai/docs/providers)### 12. 구성 관리@@ -320,23 +350,26 @@ crewai config [COMMAND] [OPTIONS]#### 명령어:- `list`: 모든 CLI 구성 매개변수 표시+```shell Terminalcrewai config list```- `set`: CLI 구성 매개변수 설정+```shell Terminalcrewai config set <key> <value>```- `reset`: 모든 CLI 구성 매개변수를 기본값으로 초기화+```shell Terminalcrewai config reset```#### 사용 가능한 구성 파라미터-- `enterprise_base_url`: CrewAI AOP 인스턴스의 기본 URL+- `enterprise_base_url`: CrewAI AMP 인스턴스의 기본 URL- `oauth2_provider`: 인증에 사용되는 OAuth2 공급자 (예: workos, okta, auth0)- `oauth2_audience`: OAuth2 audience 값으로, 일반적으로 대상 API 또는 리소스를 식별하는 데 사용됨- `oauth2_client_id`: 인증 요청 시 사용되는 공급자가 발급한 OAuth2 클라이언트 ID@@ -345,42 +378,49 @@ crewai config reset#### 예시현재 설정 표시:+```shell Terminalcrewai config list```예시 출력:-| 설정 | 값 | 설명 |-| :------------------- | :---------------------- | :------------------------------------------------------------------- |-| enterprise_base_url | https://app.crewai.com | CrewAI AOP 인스턴스의 기본 URL |-| org_name | Not set | 현재 활성화된 조직의 이름 |-| org_uuid | Not set | 현재 활성화된 조직의 UUID |-| oauth2_provider | workos | 인증에 사용되는 OAuth2 제공자 (예: workos, okta, auth0) |-| oauth2_audience | client_01YYY | 일반적으로 대상 API/리소스를 식별하는 데 사용되는 OAuth2 audience 값 |-| oauth2_client_id | client_01XXX | 제공자로부터 발급된 OAuth2 client ID (인증 요청 시 사용) |-| oauth2_domain | login.crewai.com | OAuth2 제공자의 도메인 (예: your-org.auth0.com) |+| 설정 | 값 | 설명 |+| :------------------ | :--------------------- | :------------------------------------------------------------------- |+| enterprise_base_url | https://app.crewai.com | CrewAI AMP 인스턴스의 기본 URL |+| org_name | Not set | 현재 활성화된 조직의 이름 |+| org_uuid | Not set | 현재 활성화된 조직의 UUID |+| oauth2_provider | workos | 인증에 사용되는 OAuth2 제공자 (예: workos, okta, auth0) |+| oauth2_audience | client_01YYY | 일반적으로 대상 API/리소스를 식별하는 데 사용되는 OAuth2 audience 값 |+| oauth2_client_id | client_01XXX | 제공자로부터 발급된 OAuth2 client ID (인증 요청 시 사용) |+| oauth2_domain | login.crewai.com | OAuth2 제공자의 도메인 (예: your-org.auth0.com) |엔터프라이즈 기본 URL 설정:+```shell Terminalcrewai config set enterprise_base_url https://my-enterprise.crewai.com```OAuth2 제공자 설정:+```shell Terminalcrewai config set oauth2_provider auth0```OAuth2 도메인 설정:+```shell Terminalcrewai config set oauth2_domain my-company.auth0.com```모든 설정을 기본값으로 재설정:+```shell Terminalcrewai config reset```<Note>-설정 값은 `~/.config/crewai/settings.json`에 저장됩니다. 조직 이름과 UUID와 같은 일부 설정 값은 읽기 전용이며 인증 및 조직 명령을 통해 관리됩니다. 도구 저장소 관련 설정은 숨겨져 있으며 사용자가 직접 설정할 수 없습니다.+ 설정 값은 `~/.config/crewai/settings.json`에 저장됩니다. 조직 이름과 UUID와+ 같은 일부 설정 값은 읽기 전용이며 인증 및 조직 명령을 통해 관리됩니다. 도구+ 저장소 관련 설정은 숨겨져 있으며 사용자가 직접 설정할 수 없습니다.</Note>diff --git a/docs/ko/enterprise/features/rbac.mdx b/docs/ko/enterprise/features/rbac.mdxindex c6af38187..5b76e086a 100644--- a/docs/ko/enterprise/features/rbac.mdx+++ b/docs/ko/enterprise/features/rbac.mdx@@ -10,7 +10,7 @@ mode: "wide"CrewAI AOP의 RBAC는 **조직 수준 역할**과 **자동화(Automation) 수준 가시성**을 결합하여 안전하고 확장 가능한 접근 제어를 제공합니다.<Frame>- <img src="/images/enterprise/users_and_roles.png" alt="CrewAI AOP RBAC 개요" />+ <img src="/images/enterprise/users_and_roles.png" alt="CrewAI AMP RBAC 개요" /></Frame>@@ -31,7 +31,8 @@ CrewAI AOP의 RBAC는 **조직 수준 역할**과 **자동화(Automation) 수준<b>Settings → Roles</b>로 이동합니다.</Step><Step title="역할 선택">- <b>Owner</b> 또는 <b>Member</b>를 사용하거나 <b>Create role</b>로 커스텀 역할을 만듭니다.+ <b>Owner</b> 또는 <b>Member</b>를 사용하거나 <b>Create role</b>로 커스텀+ 역할을 만듭니다.</Step><Step title="멤버에 할당">사용자들을 선택하여 역할을 지정합니다. 언제든 변경할 수 있습니다.@@ -40,9 +41,9 @@ CrewAI AOP의 RBAC는 **조직 수준 역할**과 **자동화(Automation) 수준### 구성 요약-| 영역 | 위치 | 옵션 |-|:---|:---|:---|-| 사용자 & 역할 | Settings → Roles | Owner, Member; 커스텀 역할 |+| 영역 | 위치 | 옵션 |+| :------------ | :--------------------------------- | :-------------------------------- |+| 사용자 & 역할 | Settings → Roles | Owner, Member; 커스텀 역할 || 자동화 가시성 | Automation → Settings → Visibility | Private; 사용자/역할 화이트리스트 |## 자동화 수준 접근 제어@@ -82,21 +83,26 @@ Private 모드에서는 화이트리스트에 포함된 사용자/역할만 다### Private 모드 접근 결과-| 동작 | Owner | 화이트리스트 사용자/역할 | 비포함 |-|:---|:---|:---|:---|-| 자동화 보기 | ✓ | ✓ | ✗ |-| 실행/API | ✓ | ✓ | ✗ |-| 로그/메트릭/설정 | ✓ | ✓ | ✗ |+| 동작 | Owner | 화이트리스트 사용자/역할 | 비포함 |+| :--------------- | :---- | :----------------------- | :----- |+| 자동화 보기 | ✓ | ✓ | ✗ |+| 실행/API | ✓ | ✓ | ✗ |+| 로그/메트릭/설정 | ✓ | ✓ | ✗ |<Tip>-Owner는 항상 접근 가능하며, Private 모드에서는 화이트리스트에 포함된 사용자/역할만 권한이 부여됩니다.+ Owner는 항상 접근 가능하며, Private 모드에서는 화이트리스트에 포함된+ 사용자/역할만 권한이 부여됩니다.</Tip><Frame>- <img src="/images/enterprise/visibility.png" alt="CrewAI AOP 가시성 설정" />+ <img src="/images/enterprise/visibility.png" alt="CrewAI AMP 가시성 설정" /></Frame>-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>RBAC 구성과 점검에 대한 지원이 필요하면 연락해 주세요.</Card>diff --git a/docs/ko/enterprise/features/tools-and-integrations.mdx b/docs/ko/enterprise/features/tools-and-integrations.mdxindex 3c9592fdf..e53a03b90 100644--- a/docs/ko/enterprise/features/tools-and-integrations.mdx+++ b/docs/ko/enterprise/features/tools-and-integrations.mdx@@ -9,221 +9,221 @@ mode: "wide"도구 & 통합은 서드파티 애플리케이션을 연결하고 에이전트가 런타임에 사용할 내부 도구를 관리하는 중앙 허브입니다.-<Frame>- -</Frame>+<Frame></Frame>## 살펴보기<Tabs><Tab title="통합" icon="plug">- ## 에이전트 앱 (통합)-- Gmail, Google Drive, HubSpot, Slack 등 OAuth 기반 서비스에 연결하여 에이전트 액션을 활성화하세요.+## 에이전트 앱 (통합)++Gmail, Google Drive, HubSpot, Slack 등 OAuth 기반 서비스에 연결하여 에이전트 액션을 활성화하세요.++{" "}+<Steps>+ <Step title="연결">+ 원하는 앱에서 <b>Connect</b>를 클릭하고 OAuth를 완료합니다.+ </Step>+ <Step title="구성">+ 필요에 따라 스코프, 트리거, 사용 가능한 액션을 조정합니다.+ </Step>+ <Step title="에이전트에서 사용">+ 연결된 서비스는 에이전트 도구로 사용 가능합니다.+ </Step>+</Steps>++{" "}+<Frame></Frame>++### 계정 연결하기++1. <Link href="https://app.crewai.com/crewai_plus/connectors">+ Integrations+ </Link>+ 로 이동+2. 원하는 서비스에서 <b>Connect</b> 클릭+3. OAuth 플로우 완료 및 스코프 승인+4. <Link href="https://app.crewai.com/crewai_plus/settings/integrations">+ 통합 설정+ </Link>+ 에서 Enterprise Token 복사++{" "}+<Frame>+ +</Frame>- <Steps>- <Step title="연결">- 원하는 앱에서 <b>Connect</b>를 클릭하고 OAuth를 완료합니다.- </Step>- <Step title="구성">- 필요에 따라 스코프, 트리거, 사용 가능한 액션을 조정합니다.- </Step>- <Step title="에이전트에서 사용">- 연결된 서비스는 에이전트 도구로 사용 가능합니다.- </Step>- </Steps>+### 통합 도구 설치- <Frame>- - </Frame>+로컬에서 통합을 사용하려면 최신 `crewai-tools` 패키지를 설치하세요.- ### 계정 연결하기+```bash+uv add crewai-tools+```- 1. <Link href="https://app.crewai.com/crewai_plus/connectors">Integrations</Link>로 이동- 2. 원하는 서비스에서 <b>Connect</b> 클릭- 3. OAuth 플로우 완료 및 스코프 승인- 4. <Link href="https://app.crewai.com/crewai_plus/settings/integrations">통합 설정</Link>에서 Enterprise Token 복사+### 환경 변수 설정- <Frame>- - </Frame>+{" "}+<Note>+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+</Note>- ### 통합 도구 설치+```bash+export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"+```- 로컬에서 통합을 사용하려면 최신 `crewai-tools` 패키지를 설치하세요.+또는 `.env` 파일에 추가하세요:- ```bash- uv add crewai-tools- ```+```+CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token+```- ### 환경 변수 설정+### 사용 예시- <Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.- </Note>+{" "}+<Tip>+ 새로운 간소화된 접근 방식을 사용하여 엔터프라이즈 앱을 통합하세요. Agent+ 구성에서 앱과 해당 액션을 직접 지정하기만 하면 됩니다.+</Tip>- ```bash- export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"- ```+```python+from crewai import Agent, Task, Crew- 또는 `.env` 파일에 추가하세요:+# Gmail 기능을 가진 에이전트 생성+email_agent = Agent(+ role="이메일 매니저",+ goal="이메일 커뮤니케이션 관리",+ backstory="이메일 관리에 특화된 AI 어시스턴트",+ apps=['gmail', 'gmail/send_email'] # 정식 이름 'gmail' 사용+)- ```- CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- ```+email_task = Task(+ description="프로젝트 업데이트에 대한 후속 이메일 작성 및 전송",+ agent=email_agent,+ expected_output="이메일 전송 성공 확인"+)- ### 사용 예시+crew = Crew(agents=[email_agent], tasks=[email_task])+crew.kickoff()+```- <Tip>- 새로운 간소화된 접근 방식을 사용하여 엔터프라이즈 앱을 통합하세요. Agent 구성에서 앱과 해당 액션을 직접 지정하기만 하면 됩니다.- </Tip>+### 도구 필터링- ```python- from crewai import Agent, Task, Crew+```python+from crewai import Agent, Task, Crew- # Gmail 기능을 가진 에이전트 생성- email_agent = Agent(- role="이메일 매니저",- goal="이메일 커뮤니케이션 관리",- backstory="이메일 관리에 특화된 AI 어시스턴트",- apps=['gmail', 'gmail/send_email'] # 정식 이름 'gmail' 사용- )+# 특정 Gmail 액션만 사용하는 에이전트 생성+gmail_agent = Agent(+ role="Gmail 매니저",+ goal="Gmail 커뮤니케이션 및 알림 관리",+ backstory="Gmail 커뮤니케이션 조율 AI 어시스턴트",+ apps=['gmail/fetch_emails'] # 정식 이름과 특정 액션 사용+)- email_task = Task(- description="프로젝트 업데이트에 대한 후속 이메일 작성 및 전송",- agent=email_agent,- expected_output="이메일 전송 성공 확인"- )+notification_task = Task(+ description="[email protected]에서 온 이메일 찾기",+ agent=gmail_agent,+ expected_output="[email protected]의 이메일을 찾았다는 확인"+)- crew = Crew(agents=[email_agent], tasks=[email_task])- crew.kickoff()- ```+crew = Crew(agents=[gmail_agent], tasks=[notification_task])+```- ### 도구 필터링+배포된 크루에서는 각 통합의 서비스 설정 페이지에서 사용 가능한 액션을 지정할 수 있습니다.- ```python- from crewai import Agent, Task, Crew+{" "}+<Frame>+ +</Frame>- # 특정 Gmail 액션만 사용하는 에이전트 생성- gmail_agent = Agent(- role="Gmail 매니저",- goal="Gmail 커뮤니케이션 및 알림 관리",- backstory="Gmail 커뮤니케이션 조율 AI 어시스턴트",- apps=['gmail/fetch_emails'] # 정식 이름과 특정 액션 사용- )+### 범위 지정 배포 (다중 사용자 조직)- notification_task = Task(- description="[email protected]에서 온 이메일 찾기",- agent=gmail_agent,- expected_output="[email protected]의 이메일을 찾았다는 확인"- )+각 통합을 특정 사용자로 범위 지정할 수 있습니다 (예: 특정 사용자의 Gmail 계정 사용).- crew = Crew(agents=[gmail_agent], tasks=[notification_task])- ```+{" "}+<Tip>팀/사용자별 데이터 접근을 분리해야 할 때 유용합니다.</Tip>- 배포된 크루에서는 각 통합의 서비스 설정 페이지에서 사용 가능한 액션을 지정할 수 있습니다.+`user_bearer_token`을 사용해 요청 사용자로 인증을 범위 지정합니다. 사용자가 로그인하지 않은 경우 연결된 통합을 사용하지 않으며, 그렇지 않으면 배포에 설정된 기본 토큰을 사용합니다.- <Frame>- - </Frame>+{" "}+<Frame></Frame>- ### 범위 지정 배포 (다중 사용자 조직)+{" "}+<div id="catalog"></div>+### 카탈로그- 각 통합을 특정 사용자로 범위 지정할 수 있습니다 (예: 특정 사용자의 Gmail 계정 사용).+#### 커뮤니케이션 & 협업- <Tip>- 팀/사용자별 데이터 접근을 분리해야 할 때 유용합니다.- </Tip>+- Gmail — 이메일 및 초안 관리+- Slack — 워크스페이스 알림 및 경보+- Microsoft — Office 365 및 Teams 통합- `user_bearer_token`을 사용해 요청 사용자로 인증을 범위 지정합니다. 사용자가 로그인하지 않은 경우 연결된 통합을 사용하지 않으며, 그렇지 않으면 배포에 설정된 기본 토큰을 사용합니다.+#### 프로젝트 관리- <Frame>- - </Frame>+- Jira — 이슈 추적 및 프로젝트 관리+- ClickUp — 작업 및 생산성 관리+- Asana — 팀 작업 조율+- Notion — 페이지 및 데이터베이스 관리+- Linear — 버그/프로젝트 추적+- GitHub — 리포지토리 및 이슈 관리- <div id="catalog"></div>- ### 카탈로그+#### CRM- #### 커뮤니케이션 & 협업- - Gmail — 이메일 및 초안 관리- - Slack — 워크스페이스 알림 및 경보- - Microsoft — Office 365 및 Teams 통합+- Salesforce — 계정 및 기회 관리+- HubSpot — 파이프라인/연락처 관리+- Zendesk — 고객 지원 티켓 관리- #### 프로젝트 관리- - Jira — 이슈 추적 및 프로젝트 관리- - ClickUp — 작업 및 생산성 관리- - Asana — 팀 작업 조율- - Notion — 페이지 및 데이터베이스 관리- - Linear — 버그/프로젝트 추적- - GitHub — 리포지토리 및 이슈 관리+#### 비즈니스 & 금융- #### CRM- - Salesforce — 계정 및 기회 관리- - HubSpot — 파이프라인/연락처 관리- - Zendesk — 고객 지원 티켓 관리+- Stripe — 결제 처리 및 고객 관리+- Shopify — 전자상거래 및 상품 관리- #### 비즈니스 & 금융- - Stripe — 결제 처리 및 고객 관리- - Shopify — 전자상거래 및 상품 관리+#### 생산성 & 스토리지- #### 생산성 & 스토리지- - Google Sheets — 스프레드시트 동기화- - Google Calendar — 일정/이벤트 관리- - Box — 파일 스토리지+- Google Sheets — 스프레드시트 동기화+- Google Calendar — 일정/이벤트 관리+- Box — 파일 스토리지- …더 많은 통합이 추가될 예정입니다!+…더 많은 통합이 추가될 예정입니다!</Tab><Tab title="내부 도구" icon="toolbox">- ## 내부 도구-- 로컬에서 도구를 만들고, CrewAI AOP 도구 저장소에 게시한 후, 에이전트에서 사용하세요.-- <Tip>- 아래 명령을 실행하기 전에 CrewAI AOP 계정에 로그인하세요:- ```bash- crewai login- ```- </Tip>-- <Frame>- - </Frame>-- <Steps>- <Step title="생성">- 로컬에서 새 도구 생성- ```bash- crewai tool create your-tool- ```- </Step>- <Step title="게시">- 도구 저장소에 게시- ```bash- crewai tool publish- ```- </Step>- <Step title="설치">- 도구 저장소에서 설치- ```bash- crewai tool install your-tool- ```- </Step>- </Steps>-- 관리:-- - 이름 및 설명- - 가시성 (비공개 / 공개)- - 필요한 환경 변수- - 버전 이력 및 다운로드- - 팀/역할 접근 권한-- <Frame>- - </Frame>+## 내부 도구++로컬에서 도구를 만들고, CrewAI AMP 도구 저장소에 게시한 후, 에이전트에서 사용하세요.++{" "}+<Tip>+ 아래 명령을 실행하기 전에 CrewAI AMP 계정에 로그인하세요: ```bash crewai login```+</Tip>++{" "}+<Frame></Frame>++{" "}+<Steps>+ <Step title="생성">+ 로컬에서 새 도구 생성 ```bash crewai tool create your-tool ```+ </Step>+ <Step title="게시">도구 저장소에 게시 ```bash crewai tool publish ```</Step>+ <Step title="설치">+ 도구 저장소에서 설치 ```bash crewai tool install your-tool ```+ </Step>+</Steps>++관리:++- 이름 및 설명+- 가시성 (비공개 / 공개)+- 필요한 환경 변수+- 버전 이력 및 다운로드+- 팀/역할 접근 권한++{" "}+<Frame></Frame></Tab></Tabs>@@ -231,10 +231,18 @@ mode: "wide"## 관련 문서<CardGroup cols={2}>- <Card title="도구 저장소" href="/ko/enterprise/guides/tool-repository" icon="toolbox">+ <Card+ title="도구 저장소"+ href="/ko/enterprise/guides/tool-repository"+ icon="toolbox"+ >크루 기능을 확장할 수 있도록 도구를 게시하고 설치하세요.</Card>- <Card title="Webhook 자동화" href="/ko/enterprise/guides/webhook-automation" icon="bolt">+ <Card+ title="Webhook 자동화"+ href="/ko/enterprise/guides/webhook-automation"+ icon="bolt"+ >워크플로를 자동화하고 외부 플랫폼/서비스와 통합하세요.</Card></CardGroup>diff --git a/docs/ko/enterprise/features/traces.mdx b/docs/ko/enterprise/features/traces.mdxindex 030eca0e0..819118e14 100644--- a/docs/ko/enterprise/features/traces.mdx+++ b/docs/ko/enterprise/features/traces.mdx@@ -20,15 +20,13 @@ CrewAI AOP의 Traces는 crew의 작동 과정을 처음 입력에서 최종 출- 실행 시간- 비용 추정치-<Frame>- -</Frame>+<Frame></Frame>## 트레이스(Traces) 접근하기<Steps><Step title="트레이스 탭으로 이동">- CrewAI AOP 대시보드에 들어가면, **트레이스**를 클릭하여 모든 실행 기록을 볼 수 있습니다.+ CrewAI AMP 대시보드에 들어가면, **트레이스**를 클릭하여 모든 실행 기록을 볼 수 있습니다.</Step><Step title="실행 선택하기">@@ -51,9 +49,7 @@ CrewAI AOP의 Traces는 crew의 작동 과정을 처음 입력에서 최종 출- **실행 시간**: crew 런의 전체 소요 시간- **예상 비용**: 토큰 사용량을 기반으로 한 대략적인 비용-<Frame>- -</Frame>+<Frame></Frame>### 2. Tasks & Agents@@ -64,33 +60,25 @@ CrewAI AOP의 Traces는 crew의 작동 과정을 처음 입력에서 최종 출- 상태 (완료/실패)- task의 개별 실행 시간-<Frame>- -</Frame>+<Frame></Frame>### 3. 최종 결과모든 작업이 완료된 후 crew가 생성한 최종 결과를 표시합니다.-<Frame>- -</Frame>+<Frame></Frame>### 4. 실행 타임라인각 작업이 시작되고 종료된 시점을 시각적으로 표현하여 병목 현상이나 병렬 실행 패턴을 파악하는 데 도움이 됩니다.-<Frame>- -</Frame>+<Frame></Frame>### 5. 상세 작업 보기타임라인이나 작업 목록에서 특정 작업을 클릭하면 다음을 볼 수 있습니다:-<Frame>- -</Frame>+<Frame></Frame>- **작업 키**: 작업의 고유 식별자- **작업 ID**: 시스템 내의 기술적 식별자@@ -120,6 +108,7 @@ CrewAI AOP의 Traces는 crew의 작동 과정을 처음 입력에서 최종 출<Frame></Frame>+</Step><Step title="성능 최적화">@@ -129,6 +118,7 @@ CrewAI AOP의 Traces는 crew의 작동 과정을 처음 입력에서 최종 출- 과도한 토큰 사용- 중복된 도구 작업- 불필요한 API 호출+</Step><Step title="비용 효율성 향상">@@ -138,9 +128,15 @@ CrewAI AOP의 Traces는 crew의 작동 과정을 처음 입력에서 최종 출- 프롬프트를 더 간결하게 다듬기- 자주 액세스하는 정보 캐싱- 중복 작업을 최소화하도록 작업 구조화하기+</Step></Steps>-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">- 트레이스 분석이나 기타 CrewAI 엔터프라이즈 기능에 대한 지원이 필요하시면 저희 지원팀에 문의하세요.+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>+ 트레이스 분석이나 기타 CrewAI 엔터프라이즈 기능에 대한 지원이 필요하시면 저희+ 지원팀에 문의하세요.</Card>diff --git a/docs/ko/enterprise/guides/automation-triggers.mdx b/docs/ko/enterprise/guides/automation-triggers.mdxindex 10f3d1655..cccda10a1 100644--- a/docs/ko/enterprise/guides/automation-triggers.mdx+++ b/docs/ko/enterprise/guides/automation-triggers.mdx@@ -1,11 +1,11 @@---title: "트리거 개요"-description: "CrewAI AOP 트리거의 동작 방식과 관리 방법, 그리고 통합별 플레이북을 한눈에 확인하세요"+description: "CrewAI AMP 트리거의 동작 방식과 관리 방법, 그리고 통합별 플레이북을 한눈에 확인하세요"icon: "bolt"mode: "wide"----CrewAI AOP 트리거는 팀이 이미 사용하고 있는 도구의 실시간 이벤트와 자동화를 연결합니다. 폴링이나 수동 실행 대신, 트리거는 새로운 이메일, 캘린더 업데이트, CRM 상태 변화 등을 감지하여 지정한 크루 또는 플로우를 즉시 실행합니다.+CrewAI AMP 트리거는 팀이 이미 사용하고 있는 도구의 실시간 이벤트와 자동화를 연결합니다. 폴링이나 수동 실행 대신, 트리거는 새로운 이메일, 캘린더 업데이트, CRM 상태 변화 등을 감지하여 지정한 크루 또는 플로우를 즉시 실행합니다.<iframeclassName="w-full aspect-video rounded-xl"@@ -25,37 +25,61 @@ CrewAI AOP 트리거는 팀이 이미 사용하고 있는 도구의 실시간<a href="/ko/enterprise/guides/gmail-trigger">새로운 이메일이나 스레드 업데이트에 맞춰 크루를 실행하세요.</a></Card>- <Card title="Google Calendar 트리거" icon="calendar-days">- <a href="/ko/enterprise/guides/google-calendar-trigger">캘린더 이벤트 생성, 수정, 취소에 대응하세요.</a>- </Card>-- <Card title="Google Drive 트리거" icon="folder-open">- <a href="/ko/enterprise/guides/google-drive-trigger">Drive 파일 업로드, 수정, 삭제를 감시하세요.</a>- </Card>-- <Card title="Outlook 트리거" icon="envelope-open">- <a href="/ko/enterprise/guides/outlook-trigger">Outlook의 새로운 메일이나 삭제된 이벤트에 대응하세요.</a>- </Card>-- <Card title="OneDrive 트리거" icon="cloud">- <a href="/ko/enterprise/guides/onedrive-trigger">OneDrive 파일 활동 및 공유 변경 사항을 감사하세요.</a>- </Card>-- <Card title="Microsoft Teams 트리거" icon="comments">- <a href="/ko/enterprise/guides/microsoft-teams-trigger">새로운 Teams 채팅이 생성될 때 워크플로우를 시작하세요.</a>- </Card>-- <Card title="HubSpot 트리거" icon="hubspot">- <a href="/ko/enterprise/guides/hubspot-trigger">HubSpot 워크플로우와 라이프사이클 이벤트에서 자동화를 실행하세요.</a>- </Card>-- <Card title="Salesforce 트리거" icon="salesforce">- <a href="/ko/enterprise/guides/salesforce-trigger">Salesforce 프로세스를 CrewAI 크루와 연결해 CRM 자동화를 구현하세요.</a>- </Card>-- <Card title="Slack 트리거" icon="slack">- <a href="/ko/enterprise/guides/slack-trigger">Slack 슬래시 명령으로 크루를 바로 실행하세요.</a>- </Card>+{" "}+<Card title="Google Calendar 트리거" icon="calendar-days">+ <a href="/ko/enterprise/guides/google-calendar-trigger">+ 캘린더 이벤트 생성, 수정, 취소에 대응하세요.+ </a>+</Card>++{" "}+<Card title="Google Drive 트리거" icon="folder-open">+ <a href="/ko/enterprise/guides/google-drive-trigger">+ Drive 파일 업로드, 수정, 삭제를 감시하세요.+ </a>+</Card>++{" "}+<Card title="Outlook 트리거" icon="envelope-open">+ <a href="/ko/enterprise/guides/outlook-trigger">+ Outlook의 새로운 메일이나 삭제된 이벤트에 대응하세요.+ </a>+</Card>++{" "}+<Card title="OneDrive 트리거" icon="cloud">+ <a href="/ko/enterprise/guides/onedrive-trigger">+ OneDrive 파일 활동 및 공유 변경 사항을 감사하세요.+ </a>+</Card>++{" "}+<Card title="Microsoft Teams 트리거" icon="comments">+ <a href="/ko/enterprise/guides/microsoft-teams-trigger">+ 새로운 Teams 채팅이 생성될 때 워크플로우를 시작하세요.+ </a>+</Card>++{" "}+<Card title="HubSpot 트리거" icon="hubspot">+ <a href="/ko/enterprise/guides/hubspot-trigger">+ HubSpot 워크플로우와 라이프사이클 이벤트에서 자동화를 실행하세요.+ </a>+</Card>++{" "}+<Card title="Salesforce 트리거" icon="salesforce">+ <a href="/ko/enterprise/guides/salesforce-trigger">+ Salesforce 프로세스를 CrewAI 크루와 연결해 CRM 자동화를 구현하세요.+ </a>+</Card>++{" "}+<Card title="Slack 트리거" icon="slack">+ <a href="/ko/enterprise/guides/slack-trigger">+ Slack 슬래시 명령으로 크루를 바로 실행하세요.+ </a>+</Card><Card title="Zapier 트리거" icon="bolt"><a href="/ko/enterprise/guides/zapier-trigger">CrewAI를 수천 개의 Zapier 지원 앱과 연동하세요.</a>@@ -77,7 +101,10 @@ CrewAI AOP 트리거는 팀이 이미 사용하고 있는 도구의 실시간2. **Triggers** 탭을 클릭하여 사용 가능한 통합을 확인합니다.<Frame>- <img src="/images/enterprise/list-available-triggers.png" alt="사용 가능한 트리거 목록" />+ <img+ src="/images/enterprise/list-available-triggers.png"+ alt="사용 가능한 트리거 목록"+ /></Frame>### 트리거 활성화/비활성화@@ -123,6 +150,7 @@ crewai triggers list```이 명령은 연결된 통합을 기반으로 사용 가능한 모든 트리거를 표시합니다:+- 통합 이름 및 연결 상태- 사용 가능한 트리거 유형- 트리거 이름 및 설명@@ -142,6 +170,7 @@ crewai triggers run microsoft_onedrive/file_changed```이 명령은:+- 로컬에서 크루를 실행합니다- 완전하고 실제적인 트리거 payload를 전달합니다- 프로덕션에서 크루가 호출되는 방식을 정확히 시뮬레이션합니다@@ -221,17 +250,20 @@ def delegate_to_crew(self, crewai_trigger_payload: dict = None):## 문제 해결**트리거가 실행되지 않나요?**+- 배포의 Triggers 탭에서 트리거가 활성화되어 있는지 확인하세요- Tools & Integrations에서 통합 연결 상태를 확인하세요- 필요한 모든 환경 변수가 올바르게 구성되어 있는지 확인하세요**실행 중 오류가 발생하나요?**+- 실행 로그에서 오류 세부 정보를 확인하세요- `crewai triggers run <트리거_이름>`을 사용하여 로컬에서 테스트하고 정확한 payload 구조를 확인하세요- 크루가 `crewai_trigger_payload` 매개변수를 처리할 수 있는지 확인하세요- 크루가 트리거 payload에 포함되지 않은 매개변수를 기대하지 않는지 확인하세요**개발 문제:**+- 배포하기 전에 항상 `crewai triggers run <trigger>`로 테스트하여 전체 payload를 확인하세요- `crewai run`은 트리거 호출을 시뮬레이션하지 않으므로 `crewai triggers run`을 대신 사용하세요- `crewai triggers list`를 사용하여 연결된 통합에 사용 가능한 트리거를 확인하세요diff --git a/docs/ko/enterprise/guides/azure-openai-setup.mdx b/docs/ko/enterprise/guides/azure-openai-setup.mdxindex e765c6a16..776c5363b 100644--- a/docs/ko/enterprise/guides/azure-openai-setup.mdx+++ b/docs/ko/enterprise/guides/azure-openai-setup.mdx@@ -19,8 +19,8 @@ mode: "wide"</Frame></Step>- <Step title="CrewAI AOP 연결 구성">- 4. 다른 탭에서 `CrewAI AOP > LLM Connections`를 엽니다. LLM Connection에 이름을 지정하고, 공급자로 Azure를 선택한 다음, Azure에서 선택한 것과 동일한 모델을 선택하세요.+ <Step title="CrewAI AMP 연결 구성">+ 4. 다른 탭에서 `CrewAI AMP > LLM Connections`를 엽니다. LLM Connection에 이름을 지정하고, 공급자로 Azure를 선택한 다음, Azure에서 선택한 것과 동일한 모델을 선택하세요.5. 같은 페이지에서 3단계에서 가져온 환경 변수를 추가하세요:- 하나는 `AZURE_DEPLOYMENT_TARGET_URL` (Target URI 사용)로 명명합니다. URL은 다음과 같이 표시됩니다: https://your-deployment.openai.azure.com/openai/deployments/gpt-4o/chat/completions?api-version=2024-08-01-preview- 다른 하나는 `AZURE_API_KEY` (Key 사용)로 명명합니다.@@ -28,7 +28,7 @@ mode: "wide"</Step><Step title="기본 구성 설정">- 7. `CrewAI AOP > Settings > Defaults > Crew Studio LLM Settings`에서 새 LLM Connection과 모델을 기본값으로 설정합니다.+ 7. `CrewAI AMP > Settings > Defaults > Crew Studio LLM Settings`에서 새 LLM Connection과 모델을 기본값으로 설정합니다.</Step><Step title="네트워크 액세스 구성">@@ -37,6 +37,7 @@ mode: "wide"- `Resource Management > Networking`으로 이동합니다.- `Allow access from all networks`가 활성화되어 있는지 확인하세요. 이 설정이 제한되어 있으면 CrewAI가 Azure OpenAI 엔드포인트에 접근하지 못할 수 있습니다.</Step>+</Steps>## 확인@@ -46,6 +47,7 @@ mode: "wide"## 문제 해결문제가 발생한 경우:+- Target URI 형식이 예상 패턴과 일치하는지 확인하세요- API 키가 올바르고 적절한 권한을 가지고 있는지 확인하세요- 네트워크 액세스가 CrewAI 연결을 허용하도록 구성되어 있는지 확인하세요diff --git a/docs/ko/enterprise/guides/build-crew.mdx b/docs/ko/enterprise/guides/build-crew.mdxindex f4bba24dc..85cb266b3 100644--- a/docs/ko/enterprise/guides/build-crew.mdx+++ b/docs/ko/enterprise/guides/build-crew.mdx@@ -7,7 +7,7 @@ mode: "wide"## 개요-[CrewAI AOP](https://app.crewai.com)는 프로덕션 환경에서 AI 에이전트를 **생성**, **배포** 및 **관리**하는 과정을 간소화합니다.+[CrewAI AMP](https://app.crewai.com)는 프로덕션 환경에서 AI 에이전트를 **생성**, **배포** 및 **관리**하는 과정을 간소화합니다.## 시작하기@@ -23,20 +23,22 @@ mode: "wide"### 설치 및 설정<Card title="표준 설치 따라하기" icon="wrench" href="/ko/installation">- CrewAI CLI를 설정하고 첫 번째 프로젝트를 생성하기 위해 표준 설치 가이드를 따라주세요.+ CrewAI CLI를 설정하고 첫 번째 프로젝트를 생성하기 위해 표준 설치 가이드를+ 따라주세요.</Card>### 크루 구성하기<Card title="빠른 시작 튜토리얼" icon="rocket" href="/ko/quickstart">- YAML 구성을 사용하여 첫 번째 에이전트 크루를 만드는 방법은 빠른 시작 가이드를 따라주세요.+ YAML 구성을 사용하여 첫 번째 에이전트 크루를 만드는 방법은 빠른 시작 가이드를+ 따라주세요.</Card>## 지원 및 리소스Enterprise 전용 지원 또는 문의가 필요하신 경우, [[email protected]](mailto:[email protected])으로 저희 전담 지원팀에 연락해 주시기 바랍니다.-<Card title="데모 예약" icon="calendar" href="mailto:[email protected]">- Enterprise 기능과 해당 기능이 귀사의 조직에 어떻게 도움이 될 수 있는지 알아보시려면 저희 팀과 상담 일정을 예약하세요.+ Enterprise 기능과 해당 기능이 귀사의 조직에 어떻게 도움이 될 수 있는지+ 알아보시려면 저희 팀과 상담 일정을 예약하세요.</Card>diff --git a/docs/ko/enterprise/guides/deploy-crew.mdx b/docs/ko/enterprise/guides/deploy-crew.mdxindex ecbab5d80..720e5e2f7 100644--- a/docs/ko/enterprise/guides/deploy-crew.mdx+++ b/docs/ko/enterprise/guides/deploy-crew.mdx@@ -6,14 +6,17 @@ mode: "wide"---<Note>-로컬에서 또는 Crew Studio를 통해 crew를 생성한 후, 다음 단계는 이를 CrewAI AOP 플랫폼에 배포하는 것입니다. 본 가이드에서는 다양한 배포 방법을 다루며, 여러분의 워크플로우에 가장 적합한 방식을 선택할 수 있도록 안내합니다.+ 로컬에서 또는 Crew Studio를 통해 crew를 생성한 후, 다음 단계는 이를 CrewAI AMP+ 플랫폼에 배포하는 것입니다. 본 가이드에서는 다양한 배포 방법을 다루며,+ 여러분의 워크플로우에 가장 적합한 방식을 선택할 수 있도록 안내합니다.</Note>## 사전 준비 사항<CardGroup cols={2}><Card title="배포 준비가 된 Crew" icon="users">- 작동 중인 crew가 로컬에서 빌드되었거나 Crew Studio를 통해 생성되어 있어야 합니다.+ 작동 중인 crew가 로컬에서 빌드되었거나 Crew Studio를 통해 생성되어 있어야+ 합니다.</Card><Card title="GitHub 저장소" icon="github">crew 코드가 GitHub 저장소에 있어야 합니다(GitHub 연동 방식의 경우).@@ -39,10 +42,10 @@ CLI는 로컬에서 개발된 crew를 Enterprise 플랫폼에 가장 빠르게</Step><Step title="Enterprise 플랫폼에 인증">- 먼저, CrewAI AOP 플랫폼에 CLI를 인증해야 합니다:+ 먼저, CrewAI AMP 플랫폼에 CLI를 인증해야 합니다:```bash- # 이미 CrewAI AOP 계정이 있거나 새로 생성하고 싶을 때:+ # 이미 CrewAI AMP 계정이 있거나 새로 생성하고 싶을 때:crewai login```@@ -124,19 +127,19 @@ crewai deploy remove <deployment_id>## 옵션 2: 웹 인터페이스를 통한 직접 배포-GitHub 계정을 연결하여 CrewAI AOP 웹 인터페이스를 통해 crews를 직접 배포할 수도 있습니다. 이 방법은 로컬 머신에서 CLI를 사용할 필요가 없습니다.+GitHub 계정을 연결하여 CrewAI AMP 웹 인터페이스를 통해 crews를 직접 배포할 수도 있습니다. 이 방법은 로컬 머신에서 CLI를 사용할 필요가 없습니다.<Steps><Step title="GitHub로 푸시하기">- crew를 GitHub 저장소에 푸시해야 합니다. 아직 crew를 만들지 않았다면, [이 튜토리얼](/ko/quickstart)을 따라할 수 있습니다.+crew를 GitHub 저장소에 푸시해야 합니다. 아직 crew를 만들지 않았다면, [이 튜토리얼](/ko/quickstart)을 따라할 수 있습니다.</Step><Step title="GitHub를 CrewAI AOP에 연결하기">- 1. [CrewAI AOP](https://app.crewai.com)에 로그인합니다.+ 1. [CrewAI AMP](https://app.crewai.com)에 로그인합니다.2. "Connect GitHub" 버튼을 클릭합니다.<Frame>@@ -190,7 +193,8 @@ GitHub 계정을 연결하여 CrewAI AOP 웹 인터페이스를 통해 crews를## ⚠️ 환경 변수 보안 요구사항<Warning>-**중요**: CrewAI AOP는 환경 변수 이름에 대한 보안 제한이 있으며, 이를 따르지 않을 경우 배포가 실패할 수 있습니다.+ **중요**: CrewAI AOP는 환경 변수 이름에 대한 보안 제한이 있으며, 이를 따르지+ 않을 경우 배포가 실패할 수 있습니다.</Warning>### 차단된 환경 변수 패턴@@ -198,12 +202,14 @@ GitHub 계정을 연결하여 CrewAI AOP 웹 인터페이스를 통해 crews를보안상의 이유로, 다음과 같은 환경 변수 명명 패턴은 **자동으로 필터링**되며 배포에 문제가 발생할 수 있습니다:**차단된 패턴:**+- `_TOKEN`으로 끝나는 변수 (예: `MY_API_TOKEN`)- `_PASSWORD`로 끝나는 변수 (예: `DB_PASSWORD`)- `_SECRET`로 끝나는 변수 (예: `API_SECRET`)- 특정 상황에서 `_KEY`로 끝나는 변수**특정 차단 변수:**+- `GITHUB_USER`, `GITHUB_TOKEN`- `AWS_REGION`, `AWS_DEFAULT_REGION`- 다양한 내부 CrewAI 시스템 변수@@ -211,6 +217,7 @@ GitHub 계정을 연결하여 CrewAI AOP 웹 인터페이스를 통해 crews를### 허용된 예외일부 변수는 차단된 패턴과 일치하더라도 명시적으로 허용됩니다:+- `AZURE_AD_TOKEN`- `AZURE_OPENAI_AD_TOKEN`- `ENTERPRISE_ACTION_TOKEN`@@ -240,7 +247,8 @@ API_CONFIG=secret1234. **변경 내용 문서화**: 팀을 위해 이름이 변경된 변수를 기록<Tip>-배포 실패 시, 환경 변수 에러 메시지가 난해하다면 먼저 변수 이름이 이 패턴을 따르는지 확인하세요.+ 배포 실패 시, 환경 변수 에러 메시지가 난해하다면 먼저 변수 이름이 이 패턴을+ 따르는지 확인하세요.</Tip>### 배포된 Crew와 상호작용하기@@ -248,6 +256,7 @@ API_CONFIG=secret123배포가 완료되면 다음을 통해 crew에 접근할 수 있습니다:1. **REST API**: 플랫폼에서 아래의 주요 경로가 포함된 고유한 HTTPS 엔드포인트를 생성합니다:+- `/inputs`: 필요한 입력 파라미터 목록- `/kickoff`: 제공된 입력값으로 실행 시작- `/status/{kickoff_id}`: 실행 상태 확인@@ -286,6 +295,11 @@ Enterprise 플랫폼은 또한 다음을 제공합니다:- **Custom Tools Repository**: 도구 생성, 공유 및 설치- **Crew Studio**: 코드를 작성하지 않고 채팅 인터페이스를 통해 crew 빌드-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">- Enterprise 플랫폼의 배포 문제 또는 문의 사항이 있으시면 지원팀에 연락해 주십시오.+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>+ Enterprise 플랫폼의 배포 문제 또는 문의 사항이 있으시면 지원팀에 연락해+ 주십시오.</Card>diff --git a/docs/ko/enterprise/guides/enable-crew-studio.mdx b/docs/ko/enterprise/guides/enable-crew-studio.mdxindex 222481e42..c6e2bc36e 100644--- a/docs/ko/enterprise/guides/enable-crew-studio.mdx+++ b/docs/ko/enterprise/guides/enable-crew-studio.mdx@@ -6,7 +6,8 @@ mode: "wide"---<Tip>-Crew Studio는 대화형 인터페이스를 통해 빠르게 Crew를 스캐폴딩하거나 구축할 수 있는 강력한 **노코드/로우코드** 도구입니다.+ Crew Studio는 대화형 인터페이스를 통해 빠르게 Crew를 스캐폴딩하거나 구축할 수+ 있는 강력한 **노코드/로우코드** 도구입니다.</Tip>## Crew Studio란?@@ -24,7 +25,7 @@ Crew Studio를 사용하면 다음과 같은 작업이 가능합니다:- 적절한 tool 선택- 필요한 입력값 구성- 커스터마이징을 위한 다운로드 가능한 코드 생성-- CrewAI AOP 플랫폼에 직접 배포+- CrewAI AMP 플랫폼에 직접 배포## 구성 단계@@ -32,7 +33,7 @@ Crew Studio를 사용하기 전에 LLM 연결을 구성해야 합니다:<Steps><Step title="LLM 연결 설정">- CrewAI AOP 대시보드의 **LLM Connections** 탭으로 이동하여 새 LLM 연결을 만듭니다.+ CrewAI AMP 대시보드의 **LLM Connections** 탭으로 이동하여 새 LLM 연결을 만듭니다.<Note>CrewAI에서 지원하는 원하는 LLM 공급자를 자유롭게 사용하실 수 있습니다.@@ -52,6 +53,7 @@ Crew Studio를 사용하기 전에 LLM 연결을 구성해야 합니다:<Frame></Frame>+</Step><Step title="연결 추가 확인">@@ -60,6 +62,7 @@ Crew Studio를 사용하기 전에 LLM 연결을 구성해야 합니다:<Frame></Frame>+</Step><Step title="LLM 기본값 구성">@@ -73,6 +76,7 @@ Crew Studio를 사용하기 전에 LLM 연결을 구성해야 합니다:<Frame></Frame>+</Step></Steps>@@ -82,7 +86,7 @@ LLM 연결과 기본 설정을 구성했다면 이제 Crew Studio 사용을 시<Steps><Step title="Studio 접속">- CrewAI AOP 대시보드에서 **Studio** 섹션으로 이동하세요.+ CrewAI AMP 대시보드에서 **Studio** 섹션으로 이동하세요.</Step><Step title="대화 시작">@@ -93,6 +97,7 @@ LLM 연결과 기본 설정을 구성했다면 이제 Crew Studio 사용을 시```Crew Assistant는 귀하의 요구 사항을 더 잘 이해하기 위해 추가 질문을 할 것입니다.+</Step><Step title="생성된 crew 검토">@@ -104,14 +109,16 @@ LLM 연결과 기본 설정을 구성했다면 이제 Crew Studio 사용을 시- 사용할 도구이 단계에서 구성 내용을 세부적으로 수정할 수 있습니다.+</Step><Step title="배포 또는 다운로드">구성에 만족하면 다음을 수행할 수 있습니다:- 생성된 코드를 다운로드하여 로컬에서 커스터마이징- - crew를 CrewAI AOP 플랫폼에 직접 배포+ - crew를 CrewAI AMP 플랫폼에 직접 배포- 구성을 수정하고 crew를 재생성+</Step><Step title="crew 테스트">@@ -120,7 +127,8 @@ LLM 연결과 기본 설정을 구성했다면 이제 Crew Studio 사용을 시</Steps><Tip>-최상의 결과를 얻으려면 crew가 달성해야 할 목표를 명확하고 상세하게 설명하세요. 원하는 입력값과 예상 결과를 설명에 포함시키는 것이 좋습니다.+ 최상의 결과를 얻으려면 crew가 달성해야 할 목표를 명확하고 상세하게 설명하세요.+ 원하는 입력값과 예상 결과를 설명에 포함시키는 것이 좋습니다.</Tip>## 예시 워크플로우@@ -134,33 +142,42 @@ LLM 연결과 기본 설정을 구성했다면 이제 Crew Studio 사용을 시```mdI need a crew that can analyze financial news and provide investment recommendations```- </Step>- <Step title="질문에 답하기">- crew assistant가 요구 사항을 구체화할 수 있도록 하는 추가 질문에 답변하세요.</Step>+{" "}+<Step title="질문에 답하기">+ crew assistant가 요구 사항을 구체화할 수 있도록 하는 추가 질문에 답변하세요.+</Step>+<Step title="계획 검토하기">생성된 crew 계획을 검토하세요. 여기에는 다음과 같은 항목이 포함될 수 있습니다:- 금융 뉴스를 수집하는 Research Agent- 데이터를 해석하는 Analysis Agent- 투자 조언을 제공하는 Recommendations Agent- </Step>- <Step title="승인 또는 수정">- 계획을 승인하거나 필요하다면 변경을 요청하세요.</Step>- <Step title="다운로드 또는 배포">- 사용자화를 위해 코드를 다운로드하거나 플랫폼에 직접 배포하세요.- </Step>+{" "}+<Step title="승인 또는 수정">+ 계획을 승인하거나 필요하다면 변경을 요청하세요.+</Step>++{" "}+<Step title="다운로드 또는 배포">+ 사용자화를 위해 코드를 다운로드하거나 플랫폼에 직접 배포하세요.+</Step><Step title="테스트 및 개선">샘플 입력으로 crew를 테스트하고 필요에 따라 개선하세요.</Step></Steps>-<Card title="도움이 필요하세요?" icon="headset" href="mailto:[email protected]">- Crew Studio 또는 기타 CrewAI AOP 기능 지원이 필요하다면 지원팀에 문의하세요.+<Card+ title="도움이 필요하세요?"+ icon="headset"+ href="mailto:[email protected]"+>+ Crew Studio 또는 기타 CrewAI AMP 기능 지원이 필요하다면 지원팀에 문의하세요.</Card>diff --git a/docs/ko/enterprise/guides/gmail-trigger.mdx b/docs/ko/enterprise/guides/gmail-trigger.mdxindex c0cc2b127..4277c5501 100644--- a/docs/ko/enterprise/guides/gmail-trigger.mdx+++ b/docs/ko/enterprise/guides/gmail-trigger.mdx@@ -10,17 +10,21 @@ mode: "wide"Use the Gmail Trigger to kick off your deployed crews when Gmail events happen in connected accounts, such as receiving a new email or messages matching a label/filter.<Tip>- Make sure Gmail is connected in Tools & Integrations and the trigger is enabled for your deployment.+ Make sure Gmail is connected in Tools & Integrations and the trigger is+ enabled for your deployment.</Tip>## Enabling the Gmail Trigger-1. Open your deployment in CrewAI AOP+1. Open your deployment in CrewAI AMP2. Go to the **Triggers** tab3. Locate **Gmail** and switch the toggle to enable<Frame>- <img src="/images/enterprise/trigger-selected.png" alt="Enable or disable triggers with toggle" />+ <img+ src="/images/enterprise/trigger-selected.png"+ alt="Enable or disable triggers with toggle"+ /></Frame>## Example: Process new emails@@ -68,7 +72,8 @@ crewai triggers run gmail/new_email_received`crewai triggers run` 명령은 완전한 Gmail payload로 크루를 실행하여 배포 전에 파싱 로직을 테스트할 수 있게 해줍니다.<Warning>- 개발 중에는 `crewai triggers run gmail/new_email_received`을 사용하세요 (`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를 받습니다.+ 개발 중에는 `crewai triggers run gmail/new_email_received`을 사용하세요+ (`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를 받습니다.</Warning>## Monitoring Executions@@ -76,7 +81,10 @@ crewai triggers run gmail/new_email_receivedTrack history and performance of triggered runs:<Frame>- <img src="/images/enterprise/list-executions.png" alt="List of executions triggered by automation" />+ <img+ src="/images/enterprise/list-executions.png"+ alt="List of executions triggered by automation"+ /></Frame>## Troubleshootingdiff --git a/docs/ko/enterprise/guides/google-calendar-trigger.mdx b/docs/ko/enterprise/guides/google-calendar-trigger.mdxindex 97a30b686..c6b250a49 100644--- a/docs/ko/enterprise/guides/google-calendar-trigger.mdx+++ b/docs/ko/enterprise/guides/google-calendar-trigger.mdx@@ -10,17 +10,21 @@ mode: "wide"Use the Google Calendar trigger to launch automations whenever calendar events change. Common use cases include briefing a team before a meeting, notifying stakeholders when a critical event is cancelled, or summarizing daily schedules.<Tip>- Make sure Google Calendar is connected in **Tools & Integrations** and enabled for the deployment you want to automate.+ Make sure Google Calendar is connected in **Tools & Integrations** and enabled+ for the deployment you want to automate.</Tip>## Enabling the Google Calendar Trigger-1. Open your deployment in CrewAI AOP+1. Open your deployment in CrewAI AMP2. Go to the **Triggers** tab3. Locate **Google Calendar** and switch the toggle to enable<Frame>- <img src="/images/enterprise/calendar-trigger.png" alt="Enable or disable triggers with toggle" />+ <img+ src="/images/enterprise/calendar-trigger.png"+ alt="Enable or disable triggers with toggle"+ /></Frame>## Example: Summarize meeting details@@ -54,7 +58,8 @@ crewai triggers run google_calendar/event_changed`crewai triggers run` 명령은 완전한 Calendar payload로 크루를 실행하여 배포 전에 파싱 로직을 테스트할 수 있게 해줍니다.<Warning>- 개발 중에는 `crewai triggers run google_calendar/event_changed`를 사용하세요 (`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를 받습니다.+ 개발 중에는 `crewai triggers run google_calendar/event_changed`를 사용하세요+ (`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를 받습니다.</Warning>## Monitoring Executions@@ -62,7 +67,10 @@ crewai triggers run google_calendar/event_changedThe **Executions** list in the deployment dashboard tracks every triggered run and surfaces payload metadata, output summaries, and errors.<Frame>- <img src="/images/enterprise/list-executions.png" alt="List of executions triggered by automation" />+ <img+ src="/images/enterprise/list-executions.png"+ alt="List of executions triggered by automation"+ /></Frame>## Troubleshootingdiff --git a/docs/ko/enterprise/guides/google-drive-trigger.mdx b/docs/ko/enterprise/guides/google-drive-trigger.mdxindex b3c512eed..9a05c7c4f 100644--- a/docs/ko/enterprise/guides/google-drive-trigger.mdx+++ b/docs/ko/enterprise/guides/google-drive-trigger.mdx@@ -10,17 +10,21 @@ mode: "wide"Trigger your automations when files are created, updated, or removed in Google Drive. Typical workflows include summarizing newly uploaded content, enforcing sharing policies, or notifying owners when critical files change.<Tip>- Connect Google Drive in **Tools & Integrations** and confirm the trigger is enabled for the automation you want to monitor.+ Connect Google Drive in **Tools & Integrations** and confirm the trigger is+ enabled for the automation you want to monitor.</Tip>## Enabling the Google Drive Trigger-1. Open your deployment in CrewAI AOP+1. Open your deployment in CrewAI AMP2. Go to the **Triggers** tab3. Locate **Google Drive** and switch the toggle to enable<Frame>- <img src="/images/enterprise/gdrive-trigger.png" alt="Enable or disable triggers with toggle" />+ <img+ src="/images/enterprise/gdrive-trigger.png"+ alt="Enable or disable triggers with toggle"+ /></Frame>## Example: Summarize file activity@@ -51,7 +55,8 @@ crewai triggers run google_drive/file_changed`crewai triggers run` 명령은 완전한 Drive payload로 크루를 실행하여 배포 전에 파싱 로직을 테스트할 수 있게 해줍니다.<Warning>- 개발 중에는 `crewai triggers run google_drive/file_changed`를 사용하세요 (`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를 받습니다.+ 개발 중에는 `crewai triggers run google_drive/file_changed`를 사용하세요+ (`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를 받습니다.</Warning>## Monitoring Executions@@ -59,7 +64,10 @@ crewai triggers run google_drive/file_changedTrack history and performance of triggered runs with the **Executions** list in the deployment dashboard.<Frame>- <img src="/images/enterprise/list-executions.png" alt="List of executions triggered by automation" />+ <img+ src="/images/enterprise/list-executions.png"+ alt="List of executions triggered by automation"+ /></Frame>## Troubleshootingdiff --git a/docs/ko/enterprise/guides/hubspot-trigger.mdx b/docs/ko/enterprise/guides/hubspot-trigger.mdxindex 4cb5cc979..a21c52f9d 100644--- a/docs/ko/enterprise/guides/hubspot-trigger.mdx+++ b/docs/ko/enterprise/guides/hubspot-trigger.mdx@@ -9,44 +9,53 @@ mode: "wide"## 사전 준비 사항-- CrewAI AOP 계정+- CrewAI AMP 계정- [HubSpot Workflows](https://knowledge.hubspot.com/workflows/create-workflows) 기능이 활성화된 HubSpot 계정## 설정 단계<Steps>- <Step title="HubSpot 계정을 CrewAI AOP와 연결하기">- - `CrewAI AOP 계정 > 트리거`에 로그인합니다.- - 사용 가능한 트리거 목록에서 `HubSpot`을 선택합니다.- - CrewAI AOP와 연결하고자 하는 HubSpot 계정을 선택합니다.- - 화면에 나타나는 안내에 따라 CrewAI AOP가 HubSpot 계정에 접근하도록 승인합니다.- - HubSpot이 CrewAI AOP와 성공적으로 연결되면 확인 메시지가 표시됩니다.- </Step>- <Step title="HubSpot 워크플로우 생성하기">- - `HubSpot 계정 > 자동화 > 워크플로우 > 새 워크플로우`에 로그인합니다.- - 필요에 맞는 워크플로우 유형을 선택합니다 (예: 처음부터 시작).- - 워크플로우 빌더에서 더하기(+) 아이콘을 클릭하여 새로운 작업을 추가합니다.- - `통합 앱 > CrewAI > Crew 시작하기`를 선택합니다.- - 시작할 Crew를 선택합니다.- - `저장`을 클릭하여 워크플로우에 작업을 추가합니다.- <Frame>- <img src="/images/enterprise/hubspot-workflow-1.png" alt="HubSpot Workflow 1" />- </Frame>- </Step>- <Step title="Crew 결과를 다른 작업과 함께 사용하기">- - Crew 시작 단계 이후, 더하기(+) 아이콘을 클릭하여 새로운 작업을 추가합니다.- - 예를 들어, 내부 이메일 알림을 전송하려면 `커뮤니케이션 > 내부 이메일 알림 전송`을 선택합니다.- - 본문 필드에서 `데이터 삽입`을 클릭하고, `다음에서 속성 또는 작업 결과 보기 > 작업 결과 > Crew 결과`를 선택하여 이메일에 Crew 데이터를 포함합니다.- <Frame>- <img src="/images/enterprise/hubspot-workflow-2.png" alt="HubSpot Workflow 2" />- </Frame>- - 필요에 따라 추가 작업을 구성합니다.- - 모든 워크플로우 단계를 검토하여 올바르게 설정되었는지 확인합니다.- - 워크플로우를 활성화합니다.- <Frame>- <img src="/images/enterprise/hubspot-workflow-3.png" alt="HubSpot Workflow 3" />- </Frame>- </Step>+ <Step title="HubSpot 계정을 CrewAI AOP와 연결하기">+ - `CrewAI AMP 계정 > 트리거`에 로그인합니다. - 사용 가능한 트리거 목록에서+ `HubSpot`을 선택합니다. - CrewAI AOP와 연결하고자 하는 HubSpot 계정을+ 선택합니다. - 화면에 나타나는 안내에 따라 CrewAI AOP가 HubSpot 계정에+ 접근하도록 승인합니다. - HubSpot이 CrewAI AOP와 성공적으로 연결되면 확인+ 메시지가 표시됩니다.+ </Step>+ <Step title="HubSpot 워크플로우 생성하기">+ - `HubSpot 계정 > 자동화 > 워크플로우 > 새 워크플로우`에 로그인합니다. -+ 필요에 맞는 워크플로우 유형을 선택합니다 (예: 처음부터 시작). - 워크플로우+ 빌더에서 더하기(+) 아이콘을 클릭하여 새로운 작업을 추가합니다. - `통합 앱 >+ CrewAI > Crew 시작하기`를 선택합니다. - 시작할 Crew를 선택합니다. - `저장`을+ 클릭하여 워크플로우에 작업을 추가합니다.+ <Frame>+ <img+ src="/images/enterprise/hubspot-workflow-1.png"+ alt="HubSpot Workflow 1"+ />+ </Frame>+ </Step>+ <Step title="Crew 결과를 다른 작업과 함께 사용하기">+ - Crew 시작 단계 이후, 더하기(+) 아이콘을 클릭하여 새로운 작업을 추가합니다.+ - 예를 들어, 내부 이메일 알림을 전송하려면 `커뮤니케이션 > 내부 이메일 알림+ 전송`을 선택합니다. - 본문 필드에서 `데이터 삽입`을 클릭하고, `다음에서 속성+ 또는 작업 결과 보기 > 작업 결과 > Crew 결과`를 선택하여 이메일에 Crew+ 데이터를 포함합니다.+ <Frame>+ <img+ src="/images/enterprise/hubspot-workflow-2.png"+ alt="HubSpot Workflow 2"+ />+ </Frame>+ - 필요에 따라 추가 작업을 구성합니다. - 모든 워크플로우 단계를+ 검토하여 올바르게 설정되었는지 확인합니다. - 워크플로우를 활성화합니다.+ <Frame>+ <img+ src="/images/enterprise/hubspot-workflow-3.png"+ alt="HubSpot Workflow 3"+ />+ </Frame>+ </Step></Steps>사용 가능한 작업과 사용자 지정 옵션에 대한 자세한 정보는 [HubSpot 워크플로우 문서](https://knowledge.hubspot.com/workflows/create-workflows)를 참고하세요.diff --git a/docs/ko/enterprise/guides/kickoff-crew.mdx b/docs/ko/enterprise/guides/kickoff-crew.mdxindex 936d5a9e4..fcea67412 100644--- a/docs/ko/enterprise/guides/kickoff-crew.mdx+++ b/docs/ko/enterprise/guides/kickoff-crew.mdx@@ -7,19 +7,17 @@ mode: "wide"## 개요-Crew를 CrewAI AOP 플랫폼에 배포한 후에는 웹 인터페이스 또는 API를 통해 실행을 시작할 수 있습니다. 이 가이드는 두 가지 접근 방식을 모두 다룹니다.+Crew를 CrewAI AMP 플랫폼에 배포한 후에는 웹 인터페이스 또는 API를 통해 실행을 시작할 수 있습니다. 이 가이드는 두 가지 접근 방식을 모두 다룹니다.## 방법 1: 웹 인터페이스 사용### 1단계: 배포된 Crew로 이동하기-1. [CrewAI AOP](https://app.crewai.com)에 로그인합니다.+1. [CrewAI AMP](https://app.crewai.com)에 로그인합니다.2. 프로젝트 목록에서 crew 이름을 클릭합니다.3. crew의 상세 페이지로 이동합니다.-<Frame>- -</Frame>+<Frame></Frame>### 2단계: 실행 시작@@ -31,9 +29,7 @@ crew의 상세 페이지에서 실행을 시작할 수 있는 두 가지 옵션2. JSON 에디터에서 crew에 필요한 입력 파라미터를 입력합니다.3. `Send Request` 버튼을 클릭합니다.-<Frame>- -</Frame>+<Frame></Frame>#### 옵션 B: 시각적 인터페이스 사용@@ -41,9 +37,7 @@ crew의 상세 페이지에서 실행을 시작할 수 있는 두 가지 옵션2. 양식 필드에 필요한 입력값을 입력합니다.3. `Run Crew` 버튼을 클릭합니다.-<Frame>- -</Frame>+<Frame></Frame>### 3단계: 실행 진행 상황 모니터링@@ -52,9 +46,7 @@ crew의 상세 페이지에서 실행을 시작할 수 있는 두 가지 옵션1. `kickoff_id`가 포함된 응답을 받게 됩니다. - **이 ID를 복사하세요**2. 이 ID는 실행을 추적하는 데 필수적입니다-<Frame>- -</Frame>+<Frame></Frame>### 4단계: 실행 상태 확인@@ -64,11 +56,10 @@ crew의 상세 페이지에서 실행을 시작할 수 있는 두 가지 옵션2. 지정된 필드에 `kickoff_id`를 붙여넣으세요3. "Get Status" 버튼을 클릭하세요-<Frame>- -</Frame>+<Frame></Frame>상태 응답에는 다음이 표시됩니다:+- 현재 실행 상태(`running`, `completed` 등)- 진행 중인 작업에 대한 세부 정보- 지금까지 생성된 모든 출력@@ -83,7 +74,7 @@ crew의 상세 페이지에서 실행을 시작할 수 있는 두 가지 옵션## 방법 2: API 사용-CrewAI AOP REST API를 사용하여 프로그래밍 방식으로 crews를 시작할 수도 있습니다.+CrewAI AMP REST API를 사용하여 프로그래밍 방식으로 crews를 시작할 수도 있습니다.### 인증@@ -122,7 +113,7 @@ curl -X GET \응답은 예를 들어 다음과 같이 필수 입력 파라미터 배열을 포함한 JSON 객체로 반환됩니다:```json-{"inputs":["topic","current_year"]}+{ "inputs": ["topic", "current_year"] }```이 예시에서는 해당 crew에서 두 개의 입력값인 `topic`과 `current_year`를 필요로 함을 보여줍니다.@@ -142,7 +133,7 @@ curl -X POST \응답에는 추적에 필요한 `kickoff_id`가 포함됩니다:```json-{"kickoff_id":"abcd1234-5678-90ef-ghij-klmnopqrstuv"}+{ "kickoff_id": "abcd1234-5678-90ef-ghij-klmnopqrstuv" }```### 3단계: 실행 상태 확인@@ -181,6 +172,11 @@ curl -X GET \2. "Traces" 탭에서 단계별 실행 세부 정보를 검토하세요3. 트레이스 세부 정보에서 LLM 응답과 도구 사용 내역을 확인하세요-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">- 실행 문제 또는 엔터프라이즈 플랫폼 관련 질문이 있으신 경우, 지원팀에 문의하세요.+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>+ 실행 문제 또는 엔터프라이즈 플랫폼 관련 질문이 있으신 경우, 지원팀에+ 문의하세요.</Card>diff --git a/docs/ko/enterprise/guides/microsoft-teams-trigger.mdx b/docs/ko/enterprise/guides/microsoft-teams-trigger.mdxindex 789cf711e..e1bd38a94 100644--- a/docs/ko/enterprise/guides/microsoft-teams-trigger.mdx+++ b/docs/ko/enterprise/guides/microsoft-teams-trigger.mdx@@ -10,17 +10,21 @@ mode: "wide"Use the Microsoft Teams trigger to start automations whenever a new chat is created. Common patterns include summarizing inbound requests, routing urgent messages to support teams, or creating follow-up tasks in other systems.<Tip>- Confirm Microsoft Teams is connected under **Tools & Integrations** and enabled in the **Triggers** tab for your deployment.+ Confirm Microsoft Teams is connected under **Tools & Integrations** and+ enabled in the **Triggers** tab for your deployment.</Tip>## Enabling the Microsoft Teams Trigger-1. Open your deployment in CrewAI AOP+1. Open your deployment in CrewAI AMP2. Go to the **Triggers** tab3. Locate **Microsoft Teams** and switch the toggle to enable<Frame caption="Microsoft Teams trigger connection">- <img src="/images/enterprise/msteams-trigger.png" alt="Enable or disable triggers with toggle" />+ <img+ src="/images/enterprise/msteams-trigger.png"+ alt="Enable or disable triggers with toggle"+ /></Frame>## Example: Summarize a new chat thread@@ -52,7 +56,9 @@ crewai triggers run microsoft_teams/teams_message_created`crewai triggers run` 명령은 완전한 Teams payload로 크루를 실행하여 배포 전에 파싱 로직을 테스트할 수 있게 해줍니다.<Warning>- 개발 중에는 `crewai triggers run microsoft_teams/teams_message_created`를 사용하세요 (`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를 받습니다.+ 개발 중에는 `crewai triggers run microsoft_teams/teams_message_created`를+ 사용하세요 (`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를+ 받습니다.</Warning>## Troubleshootingdiff --git a/docs/ko/enterprise/guides/onedrive-trigger.mdx b/docs/ko/enterprise/guides/onedrive-trigger.mdxindex e0bc1feb2..787696414 100644--- a/docs/ko/enterprise/guides/onedrive-trigger.mdx+++ b/docs/ko/enterprise/guides/onedrive-trigger.mdx@@ -10,17 +10,21 @@ mode: "wide"Start automations when files change inside OneDrive. You can generate audit summaries, notify security teams about external sharing, or update downstream line-of-business systems with new document metadata.<Tip>- Connect OneDrive in **Tools & Integrations** and toggle the trigger on for your deployment.+ Connect OneDrive in **Tools & Integrations** and toggle the trigger on for+ your deployment.</Tip>## Enabling the OneDrive Trigger-1. Open your deployment in CrewAI AOP+1. Open your deployment in CrewAI AMP2. Go to the **Triggers** tab3. Locate **OneDrive** and switch the toggle to enable<Frame caption="Microsoft OneDrive trigger connection">- <img src="/images/enterprise/onedrive-trigger.png" alt="Enable or disable triggers with toggle" />+ <img+ src="/images/enterprise/onedrive-trigger.png"+ alt="Enable or disable triggers with toggle"+ /></Frame>## Example: Audit file permissions@@ -51,7 +55,8 @@ crewai triggers run microsoft_onedrive/file_changed`crewai triggers run` 명령은 완전한 OneDrive payload로 크루를 실행하여 배포 전에 파싱 로직을 테스트할 수 있게 해줍니다.<Warning>- 개발 중에는 `crewai triggers run microsoft_onedrive/file_changed`를 사용하세요 (`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를 받습니다.+ 개발 중에는 `crewai triggers run microsoft_onedrive/file_changed`를 사용하세요+ (`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를 받습니다.</Warning>## Troubleshootingdiff --git a/docs/ko/enterprise/guides/outlook-trigger.mdx b/docs/ko/enterprise/guides/outlook-trigger.mdxindex 8f80628ed..bf5bf09a6 100644--- a/docs/ko/enterprise/guides/outlook-trigger.mdx+++ b/docs/ko/enterprise/guides/outlook-trigger.mdx@@ -10,17 +10,21 @@ mode: "wide"Automate responses when Outlook delivers a new message or when an event is removed from the calendar. Teams commonly route escalations, file tickets, or alert attendees of cancellations.<Tip>- Connect Outlook in **Tools & Integrations** and ensure the trigger is enabled for your deployment.+ Connect Outlook in **Tools & Integrations** and ensure the trigger is enabled+ for your deployment.</Tip>## Enabling the Outlook Trigger-1. Open your deployment in CrewAI AOP+1. Open your deployment in CrewAI AMP2. Go to the **Triggers** tab3. Locate **Outlook** and switch the toggle to enable<Frame caption="Microsoft Outlook trigger connection">- <img src="/images/enterprise/outlook-trigger.png" alt="Enable or disable triggers with toggle" />+ <img+ src="/images/enterprise/outlook-trigger.png"+ alt="Enable or disable triggers with toggle"+ /></Frame>## Example: Summarize a new email@@ -51,7 +55,9 @@ crewai triggers run microsoft_outlook/email_received`crewai triggers run` 명령은 완전한 Outlook payload로 크루를 실행하여 배포 전에 파싱 로직을 테스트할 수 있게 해줍니다.<Warning>- 개발 중에는 `crewai triggers run microsoft_outlook/email_received`를 사용하세요 (`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를 받습니다.+ 개발 중에는 `crewai triggers run microsoft_outlook/email_received`를+ 사용하세요 (`crewai run`이 아님). 배포 후에는 크루가 자동으로 트리거 payload를+ 받습니다.</Warning>## Troubleshootingdiff --git a/docs/ko/enterprise/guides/react-component-export.mdx b/docs/ko/enterprise/guides/react-component-export.mdxindex 704abdab2..3850ff3d2 100644--- a/docs/ko/enterprise/guides/react-component-export.mdx+++ b/docs/ko/enterprise/guides/react-component-export.mdx@@ -1,11 +1,11 @@---title: "React 컴포넌트 내보내기"-description: "CrewAI AOP React 컴포넌트를 애플리케이션에 내보내고 통합하는 방법을 알아보세요"+description: "CrewAI AMP React 컴포넌트를 애플리케이션에 내보내고 통합하는 방법을 알아보세요"icon: "react"mode: "wide"----이 가이드는 CrewAI AOP crew를 React 컴포넌트로 내보내고 이를 여러분의 애플리케이션에 통합하는 방법을 설명합니다.+이 가이드는 CrewAI AMP crew를 React 컴포넌트로 내보내고 이를 여러분의 애플리케이션에 통합하는 방법을 설명합니다.## React 컴포넌트 내보내기@@ -17,6 +17,7 @@ mode: "wide"<img src="/images/enterprise/export-react-component.png" alt="React 컴포넌트 내보내기" /></Frame></Step>+</Steps>## 리액트 환경 설정@@ -83,6 +84,7 @@ mode: "wide"```- 개발 서버가 시작되며, 기본 웹 브라우저가 자동으로 http://localhost:3000 을 열고 리액트 앱이 실행되는 것을 확인할 수 있습니다.</Step>+</Steps>## 커스터마이징@@ -90,10 +92,16 @@ mode: "wide"그런 다음 `CrewLead.jsx`를 커스터마이즈하여 색상, 제목 등을 추가할 수 있습니다.<Frame>- <img src="/images/enterprise/customise-react-component.png" alt="React 컴포넌트 커스터마이즈" />+ <img+ src="/images/enterprise/customise-react-component.png"+ alt="React 컴포넌트 커스터마이즈"+ /></Frame><Frame>- <img src="/images/enterprise/customise-react-component-2.png" alt="React 컴포넌트 커스터마이즈" />+ <img+ src="/images/enterprise/customise-react-component-2.png"+ alt="React 컴포넌트 커스터마이즈"+ /></Frame>## 다음 단계diff --git a/docs/ko/enterprise/guides/salesforce-trigger.mdx b/docs/ko/enterprise/guides/salesforce-trigger.mdxindex 7f50df05d..f2c7d7c0a 100644--- a/docs/ko/enterprise/guides/salesforce-trigger.mdx+++ b/docs/ko/enterprise/guides/salesforce-trigger.mdx@@ -31,7 +31,7 @@ Salesforce는 기업이 영업, 서비스, 마케팅 운영을 효율화할 수Salesforce 트리거를 설정하려면:-1. **지원팀 문의**: Salesforce 트리거 설정을 위해 CrewAI AOP 지원팀에 연락하세요.+1. **지원팀 문의**: Salesforce 트리거 설정을 위해 CrewAI AMP 지원팀에 연락하세요.2. **요구 사항 검토**: 필요한 Salesforce 권한과 API 액세스 권한이 있는지 확인하세요.3. **연결 구성**: 지원팀과 협력하여 CrewAI와 귀하의 Salesforce 인스턴스 간의 연결을 설정하세요.4. **트리거 테스트**: 트리거가 귀하의 특정 사용 사례에 맞게 올바르게 작동하는지 확인하세요.@@ -47,4 +47,4 @@ Salesforce 트리거를 설정하려면:## 다음 단계-자세한 설정 지침 및 고급 구성 옵션에 대해서는 CrewAI AOP 지원팀에 문의해 주시기 바랍니다. 지원팀은 귀하의 특정 Salesforce 환경과 비즈니스 요구에 맞는 맞춤형 안내를 제공해 드릴 수 있습니다.+자세한 설정 지침 및 고급 구성 옵션에 대해서는 CrewAI AMP 지원팀에 문의해 주시기 바랍니다. 지원팀은 귀하의 특정 Salesforce 환경과 비즈니스 요구에 맞는 맞춤형 안내를 제공해 드릴 수 있습니다.diff --git a/docs/ko/enterprise/guides/team-management.mdx b/docs/ko/enterprise/guides/team-management.mdxindex 70c5db634..2017d7d32 100644--- a/docs/ko/enterprise/guides/team-management.mdx+++ b/docs/ko/enterprise/guides/team-management.mdx@@ -1,40 +1,38 @@---title: "팀 관리"-description: "CrewAI AOP 조직에서 팀원을 초대하고 관리하는 방법을 알아보세요"+description: "CrewAI AMP 조직에서 팀원을 초대하고 관리하는 방법을 알아보세요"icon: "users"mode: "wide"----CrewAI AOP 계정의 관리자라면 새로운 팀원을 조직에 쉽게 초대할 수 있습니다. 이 안내서는 단계별로 프로세스를 안내합니다.+CrewAI AMP 계정의 관리자라면 새로운 팀원을 조직에 쉽게 초대할 수 있습니다. 이 안내서는 단계별로 프로세스를 안내합니다.## 팀 멤버 초대하기<Steps>- <Step title="설정 페이지 접속">- - CrewAI AOP 계정에 로그인합니다- - 대시보드 오른쪽 상단에 있는 기어 아이콘(⚙️)을 찾습니다- - 기어 아이콘을 클릭하여 **설정** 페이지에 접속합니다:- <Frame>- <img src="/images/enterprise/settings-page.png" alt="Settings Page" />- </Frame>- </Step>- <Step title="멤버 섹션으로 이동">- - 설정 페이지에서 `Members` 탭이 보입니다- - `Members` 탭을 클릭하여 **멤버** 페이지에 접속합니다:- <Frame>- <img src="/images/enterprise/members-tab.png" alt="Members Tab" />- </Frame>- </Step>- <Step title="새 멤버 초대">- - 멤버 섹션에서 현재 멤버 목록(본인 포함)을 확인할 수 있습니다- - `Email` 입력 필드를 찾습니다- - 초대하고자 하는 사람의 이메일 주소를 입력합니다- - `Invite` 버튼을 클릭하여 초대장을 보냅니다- </Step>- <Step title="필요에 따라 반복">- - 이 과정을 반복하여 여러 팀 멤버를 초대할 수 있습니다- - 초대한 각 멤버는 조직에 가입할 수 있는 이메일 초대장을 받게 됩니다- </Step>+ <Step title="설정 페이지 접속">+ - CrewAI AMP 계정에 로그인합니다 - 대시보드 오른쪽 상단에 있는 기어+ 아이콘(⚙️)을 찾습니다 - 기어 아이콘을 클릭하여 **설정** 페이지에 접속합니다:+ <Frame>+ <img src="/images/enterprise/settings-page.png" alt="Settings Page" />+ </Frame>+ </Step>+ <Step title="멤버 섹션으로 이동">+ - 설정 페이지에서 `Members` 탭이 보입니다 - `Members` 탭을 클릭하여 **멤버**+ 페이지에 접속합니다:+ <Frame>+ <img src="/images/enterprise/members-tab.png" alt="Members Tab" />+ </Frame>+ </Step>+ <Step title="새 멤버 초대">+ - 멤버 섹션에서 현재 멤버 목록(본인 포함)을 확인할 수 있습니다 - `Email`+ 입력 필드를 찾습니다 - 초대하고자 하는 사람의 이메일 주소를 입력합니다 -+ `Invite` 버튼을 클릭하여 초대장을 보냅니다+ </Step>+ <Step title="필요에 따라 반복">+ - 이 과정을 반복하여 여러 팀 멤버를 초대할 수 있습니다 - 초대한 각 멤버는+ 조직에 가입할 수 있는 이메일 초대장을 받게 됩니다+ </Step></Steps>## 역할 추가하기@@ -42,40 +40,42 @@ CrewAI AOP 계정의 관리자라면 새로운 팀원을 조직에 쉽게 초대플랫폼의 다양한 부분에 대한 접근 권한을 제어하기 위해 팀원들에게 역할을 추가할 수 있습니다.<Steps>- <Step title="설정 페이지 접근">- - CrewAI AOP 계정에 로그인하세요- - 대시보드 오른쪽 상단에서 기어 아이콘(⚙️)을 찾으세요- - 기어 아이콘을 클릭하여 **설정** 페이지에 접근하세요:- <Frame>- <img src="/images/enterprise/settings-page.png" alt="설정 페이지" />- </Frame>- </Step>- <Step title="멤버 섹션으로 이동">- - 설정 페이지에서 `Roles` 탭을 확인할 수 있습니다- - `Roles` 탭을 클릭하여 **Roles** 페이지로 이동하세요.- <Frame>- <img src="/images/enterprise/roles-tab.png" alt="Roles 탭" />- </Frame>- - 새로운 역할을 추가하려면 `Add Role` 버튼을 클릭하세요.- - 역할의 세부 정보와 권한을 입력한 후 `Create Role` 버튼을 클릭하여 역할을 생성하세요.- <Frame>- <img src="/images/enterprise/add-role-modal.png" alt="Add Role 모달" />- </Frame>- </Step>- <Step title="멤버에게 역할 추가하기">- - 멤버 섹션에서 현재 멤버(본인 포함) 목록을 확인할 수 있습니다- <Frame>- <img src="/images/enterprise/member-accepted-invitation.png" alt="멤버 초대 수락 완료" />- </Frame>- - 멤버가 초대를 수락하면 역할을 추가할 수 있습니다.- - 다시 `Roles` 탭으로 이동하세요- - 역할을 추가할 멤버로 이동한 후 `Role` 열에서 드롭다운을 클릭하세요- - 멤버에게 추가할 역할을 선택하세요- - `Update` 버튼을 클릭하여 역할을 저장하세요- <Frame>- <img src="/images/enterprise/assign-role.png" alt="멤버에 역할 추가" />- </Frame>- </Step>+ <Step title="설정 페이지 접근">+ - CrewAI AMP 계정에 로그인하세요 - 대시보드 오른쪽 상단에서 기어+ 아이콘(⚙️)을 찾으세요 - 기어 아이콘을 클릭하여 **설정** 페이지에 접근하세요:+ <Frame>+ <img src="/images/enterprise/settings-page.png" alt="설정 페이지" />+ </Frame>+ </Step>+ <Step title="멤버 섹션으로 이동">+ - 설정 페이지에서 `Roles` 탭을 확인할 수 있습니다 - `Roles` 탭을 클릭하여+ **Roles** 페이지로 이동하세요.+ <Frame>+ <img src="/images/enterprise/roles-tab.png" alt="Roles 탭" />+ </Frame>+ - 새로운 역할을 추가하려면 `Add Role` 버튼을 클릭하세요. - 역할의+ 세부 정보와 권한을 입력한 후 `Create Role` 버튼을 클릭하여 역할을+ 생성하세요.+ <Frame>+ <img src="/images/enterprise/add-role-modal.png" alt="Add Role 모달" />+ </Frame>+ </Step>+ <Step title="멤버에게 역할 추가하기">+ - 멤버 섹션에서 현재 멤버(본인 포함) 목록을 확인할 수 있습니다+ <Frame>+ <img+ src="/images/enterprise/member-accepted-invitation.png"+ alt="멤버 초대 수락 완료"+ />+ </Frame>+ - 멤버가 초대를 수락하면 역할을 추가할 수 있습니다. - 다시 `Roles`+ 탭으로 이동하세요 - 역할을 추가할 멤버로 이동한 후 `Role` 열에서 드롭다운을+ 클릭하세요 - 멤버에게 추가할 역할을 선택하세요 - `Update` 버튼을 클릭하여+ 역할을 저장하세요+ <Frame>+ <img src="/images/enterprise/assign-role.png" alt="멤버에 역할 추가" />+ </Frame>+ </Step></Steps>## 중요 참고 사항@@ -85,4 +85,4 @@ CrewAI AOP 계정의 관리자라면 새로운 팀원을 조직에 쉽게 초대- **초대 수락**: 초대된 멤버는 조직에 가입하기 위해 초대를 수락해야 합니다- **이메일 알림**: 팀 멤버에게 초대 이메일(스팸 폴더 포함)을 확인하도록 안내할 수 있습니다-이 단계들을 따르면 팀을 손쉽게 확장하고 CrewAI AOP 조직 내에서 더욱 효과적으로 협업할 수 있습니다.+이 단계들을 따르면 팀을 손쉽게 확장하고 CrewAI AMP 조직 내에서 더욱 효과적으로 협업할 수 있습니다.diff --git a/docs/ko/enterprise/guides/tool-repository.mdx b/docs/ko/enterprise/guides/tool-repository.mdxindex b75d3227c..5fd30818e 100644--- a/docs/ko/enterprise/guides/tool-repository.mdx+++ b/docs/ko/enterprise/guides/tool-repository.mdx@@ -20,11 +20,11 @@ Tool Repository는 CrewAI 도구를 위한 패키지 관리자입니다. 사용Tool Repository를 사용하기 전에 다음이 준비되어 있어야 합니다:-- [CrewAI AOP](https://app.crewai.com) 계정+- [CrewAI AMP](https://app.crewai.com) 계정- [CrewAI CLI](/ko/concepts/cli#cli) 설치됨- uv>=0.5.0 이 설치되어 있어야 합니다. [업그레이드 방법](https://docs.astral.sh/uv/getting-started/installation/#upgrading-uv)을 참고하세요.- [Git](https://git-scm.com) 설치 및 구성 완료-- CrewAI AOP 조직에서 도구를 게시하거나 설치할 수 있는 액세스 권한+- CrewAI AMP 조직에서 도구를 게시하거나 설치할 수 있는 액세스 권한## 도구 설치@@ -85,13 +85,13 @@ crewai tool publish도구를 삭제하려면:-1. [CrewAI AOP](https://app.crewai.com)로 이동합니다.+1. [CrewAI AMP](https://app.crewai.com)로 이동합니다.2. **Tools**로 이동합니다.3. 도구를 선택합니다.4. **Delete**를 클릭합니다.<Warning>-삭제는 영구적입니다. 삭제된 도구는 복구하거나 다시 설치할 수 없습니다.+ 삭제는 영구적입니다. 삭제된 도구는 복구하거나 다시 설치할 수 없습니다.</Warning>## 보안 점검@@ -100,8 +100,12 @@ crewai tool publish도구의 보안 점검 상태는 다음에서 확인할 수 있습니다:-`CrewAI AOP > Tools > Your Tool > Versions`+`CrewAI AMP > Tools > Your Tool > Versions`-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>API 통합 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의해 주세요.</Card>diff --git a/docs/ko/enterprise/guides/update-crew.mdx b/docs/ko/enterprise/guides/update-crew.mdxindex df4f458ff..f263a3091 100644--- a/docs/ko/enterprise/guides/update-crew.mdx+++ b/docs/ko/enterprise/guides/update-crew.mdx@@ -6,8 +6,9 @@ mode: "wide"---<Note>-CrewAI AOP에 crew를 배포한 후, 코드, 보안 설정 또는 구성을 업데이트해야 할 수 있습니다.-이 가이드는 이러한 일반적인 업데이트 작업을 수행하는 방법을 설명합니다.+ CrewAI AOP에 crew를 배포한 후, 코드, 보안 설정 또는 구성을 업데이트해야 할 수+ 있습니다. 이 가이드는 이러한 일반적인 업데이트 작업을 수행하는 방법을+ 설명합니다.</Note>## 왜 Crew를 업데이트해야 하나요?@@ -15,6 +16,7 @@ CrewAI AOP에 crew를 배포한 후, 코드, 보안 설정 또는 구성을 업CrewAI는 기본적으로 GitHub 업데이트를 자동으로 반영하지 않으므로, 배포 시 `Auto-update` 옵션을 선택하지 않았다면 수동으로 업데이트를 트리거해야 합니다.Crew 배포를 업데이트하고 싶은 이유는 여러 가지가 있을 수 있습니다:+- GitHub에 푸시한 최신 커밋으로 코드를 업데이트하고 싶은 경우- 보안상의 이유로 bearer 토큰을 재설정하고 싶은 경우- 환경 변수를 업데이트하고 싶은 경우@@ -23,12 +25,10 @@ Crew 배포를 업데이트하고 싶은 이유는 여러 가지가 있을 수GitHub 저장소에 새로운 커밋을 푸시한 후 배포를 업데이트하려면 다음 단계를 따르세요:-1. CrewAI AOP 플랫폼에서 자신의 crew로 이동하세요.+1. CrewAI AMP 플랫폼에서 자신의 crew로 이동하세요.2. crew 상세 페이지에서 `Re-deploy` 버튼을 클릭하세요.-<Frame>- -</Frame>+<Frame></Frame>이 작업을 수행하면 진행률 표시줄을 통해 추적할 수 있는 업데이트가 트리거됩니다. 시스템은 저장소에서 최신 코드를 가져와서 배포를 다시 빌드합니다.@@ -36,16 +36,15 @@ GitHub 저장소에 새로운 커밋을 푸시한 후 배포를 업데이트하현재 토큰이 유출되었을 가능성이 있다고 의심되는 경우 등, 새 베어러 토큰을 생성해야 한다면 다음 단계를 따르세요:-1. CrewAI AOP 플랫폼에서 해당 crew로 이동하세요.+1. CrewAI AMP 플랫폼에서 해당 crew로 이동하세요.2. `Bearer Token` 섹션을 찾으세요.3. 현재 토큰 옆에 있는 `Reset` 버튼을 클릭하세요.-<Frame>- -</Frame>+<Frame></Frame><Warning>-베어러 토큰을 재설정하면 이전 토큰은 즉시 사용할 수 없게 됩니다. 이전 토큰을 사용하고 있는 모든 애플리케이션이나 스크립트에서 토큰을 반드시 업데이트하세요.+ 베어러 토큰을 재설정하면 이전 토큰은 즉시 사용할 수 없게 됩니다. 이전 토큰을+ 사용하고 있는 모든 애플리케이션이나 스크립트에서 토큰을 반드시 업데이트하세요.</Warning>## 3. 환경 변수 업데이트하기@@ -54,22 +53,19 @@ crew의 환경 변수를 업데이트하려면 다음 단계를 따르세요:1. 먼저 crew 이름을 클릭하여 배포 페이지에 접속합니다.-<Frame>- -</Frame>+<Frame></Frame>2. `Environment Variables` 섹션을 찾습니다 (`Settings` 아이콘을 클릭해야 접근할 수 있습니다)3. 제공된 필드에서 기존 변수를 수정하거나 새 변수를 추가합니다4. 수정한 각 변수 옆의 `Update` 버튼을 클릭합니다-<Frame>- -</Frame>+<Frame></Frame>5. 마지막으로, 변경 사항을 적용하려면 페이지 하단의 `Update Deployment` 버튼을 클릭합니다<Note>-환경 변수를 업데이트하면 새로운 배포가 트리거되지만, 이는 환경 설정만 업데이트하며 코드 자체는 변경되지 않습니다.+ 환경 변수를 업데이트하면 새로운 배포가 트리거되지만, 이는 환경 설정만+ 업데이트하며 코드 자체는 변경되지 않습니다.</Note>## 업데이트 후@@ -81,9 +77,15 @@ crew의 환경 변수를 업데이트하려면 다음 단계를 따르세요:3. 완료되면 변경 사항이 예상대로 작동하는지 crew를 테스트합니다<Tip>-업데이트 후 문제가 발생하면 플랫폼에서 배포 로그를 확인하거나 지원팀에 문의하여 도움을 받을 수 있습니다.+ 업데이트 후 문제가 발생하면 플랫폼에서 배포 로그를 확인하거나 지원팀에+ 문의하여 도움을 받을 수 있습니다.</Tip>-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">- crew 업데이트나 배포 문제 해결에 대해 지원이 필요하시면 지원팀에 문의해 주세요.+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>+ crew 업데이트나 배포 문제 해결에 대해 지원이 필요하시면 지원팀에 문의해+ 주세요.</Card>diff --git a/docs/ko/enterprise/guides/webhook-automation.mdx b/docs/ko/enterprise/guides/webhook-automation.mdxindex 7264dfe75..7b3d55084 100644--- a/docs/ko/enterprise/guides/webhook-automation.mdx+++ b/docs/ko/enterprise/guides/webhook-automation.mdx@@ -1,6 +1,6 @@---title: "웹후크 자동화"-description: "ActivePieces, Zapier, Make.com과 같은 플랫폼을 사용하여 CrewAI AOP 워크플로우를 웹후크로 자동화하세요"+description: "ActivePieces, Zapier, Make.com과 같은 플랫폼을 사용하여 CrewAI AMP 워크플로우를 웹후크로 자동화하세요"icon: "webhook"mode: "wide"---@@ -11,7 +11,7 @@ CrewAI AOP를 사용하면 웹훅을 통해 워크플로우를 자동화할 수<Steps><Step title="Kickoff 인터페이스 접근">- - CrewAI AOP 대시보드로 이동하세요.+ - CrewAI AMP 대시보드로 이동하세요.- crew 실행을 시작할 때 사용하는 `/kickoff` 섹션을 찾으세요.<Frame><img src="/images/enterprise/kickoff-interface.png" alt="Kickoff 인터페이스" />@@ -44,7 +44,7 @@ CrewAI AOP를 사용하면 웹훅을 통해 워크플로우를 자동화할 수3. HTTP 액션 단계를 추가하세요.- 액션을 `Send HTTP request`로 설정하세요.- 메소드는 `POST`로 사용하세요.- - URL은 CrewAI AOP kickoff 엔드포인트로 설정하세요.+ - URL은 CrewAI AMP kickoff 엔드포인트로 설정하세요.- 필요한 헤더 추가 (예: `Bearer Token`)<Frame><img src="/images/enterprise/activepieces-headers.png" alt="ActivePieces 헤더" />@@ -76,6 +76,7 @@ CrewAI AOP를 사용하면 웹훅을 통해 워크플로우를 자동화할 수<img src="/images/enterprise/activepieces-email.png" alt="ActivePieces 이메일" /></Frame></Step>+</Steps>## Webhook 출력 예시@@ -121,4 +122,5 @@ CrewAI AOP를 사용하면 웹훅을 통해 워크플로우를 자동화할 수}```</Tab>+</Tabs>diff --git a/docs/ko/enterprise/guides/zapier-trigger.mdx b/docs/ko/enterprise/guides/zapier-trigger.mdxindex daa182455..5b939496c 100644--- a/docs/ko/enterprise/guides/zapier-trigger.mdx+++ b/docs/ko/enterprise/guides/zapier-trigger.mdx@@ -9,7 +9,7 @@ mode: "wide"## 사전 요구 사항-- CrewAI AOP 계정+- CrewAI AMP 계정- Zapier 계정- Slack 계정 (이 특정 예시에 해당)@@ -32,7 +32,7 @@ mode: "wide"- 아직 Slack 계정을 연결하지 않았다면 연결하세요.</Step>- <Step title="CrewAI AOP 액션 구성">+ <Step title="CrewAI AMP 액션 구성">- Zap에 새 액션 단계를 추가합니다.- CrewAI+를 액션 앱으로, Kickoff를 액션 이벤트로 선택합니다.@@ -41,8 +41,8 @@ mode: "wide"</Frame></Step>- <Step title="CrewAI AOP 계정 연결">- - CrewAI AOP 계정을 연결하세요.+ <Step title="CrewAI AMP 계정 연결">+ - CrewAI AMP 계정을 연결하세요.- 워크플로에 적합한 Crew를 선택하세요.<Frame>@@ -51,7 +51,7 @@ mode: "wide"- Slack 메시지의 데이터를 사용하여 Crew의 입력값을 구성하세요.</Step>- <Step title="CrewAI AOP 출력 포맷팅">+ <Step title="CrewAI AMP 출력 포맷팅">- CrewAI AOP에서 출력된 텍스트를 포맷팅하기 위해 추가 액션 단계를 추가합니다.- Zapier의 포매팅 도구를 사용하여 Markdown 출력을 HTML로 변환합니다.@@ -67,7 +67,7 @@ mode: "wide"- 포맷팅된 출력을 이메일로 전송하는 마지막 액션 단계를 추가합니다.- 원하는 이메일 서비스를 선택하세요 (예: Gmail, Outlook).- 수신자, 제목, 본문 등 이메일 상세 정보를 구성하세요.- - 포맷팅된 CrewAI AOP 출력을 이메일 본문에 삽입합니다.+ - 포맷팅된 CrewAI AMP 출력을 이메일 본문에 삽입합니다.<Frame><img src="/images/enterprise/zapier-7.png" alt="Zapier 7" />@@ -93,12 +93,13 @@ mode: "wide"<img src="/images/enterprise/zapier-9.png" alt="Zapier 12" /></Frame></Step>+</Steps>## 성공을 위한 팁-- CrewAI AOP 입력값이 Slack 메시지에서 올바르게 매핑되었는지 확인하세요.+- CrewAI AMP 입력값이 Slack 메시지에서 올바르게 매핑되었는지 확인하세요.- Zap을 활성화하기 전에 철저히 테스트하여 잠재적인 문제를 미리 파악하세요.- 워크플로우 내에서 발생할 수 있는 실패 상황을 관리하기 위해 오류 처리 단계를 추가하는 것을 고려하세요.-이 단계를 따르면 Slack 메시지로 트리거되는 자동화된 워크플로우와 CrewAI AOP 출력이 포함된 이메일 알림을 설정할 수 있습니다.+이 단계를 따르면 Slack 메시지로 트리거되는 자동화된 워크플로우와 CrewAI AMP 출력이 포함된 이메일 알림을 설정할 수 있습니다.diff --git a/docs/ko/enterprise/integrations/asana.mdx b/docs/ko/enterprise/integrations/asana.mdxindex 98669e114..ccdf815aa 100644--- a/docs/ko/enterprise/integrations/asana.mdx+++ b/docs/ko/enterprise/integrations/asana.mdx@@ -13,7 +13,7 @@ mode: "wide"Asana 연동을 사용하기 전에 다음을 확인하세요:-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- 적절한 권한이 있는 Asana 계정- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Asana 계정 연결@@ -21,7 +21,7 @@ Asana 연동을 사용하기 전에 다음을 확인하세요:### 1. Asana 계정 연결하기-1. [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.+1. [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.2. 인증 통합 섹션에서 **Asana**를 찾습니다.3. **Connect**를 클릭하고 OAuth 플로우를 완료합니다.4. 작업 및 프로젝트 관리를 위한 필요한 권한을 부여합니다.@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -58,6 +59,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `task` (string, 필수): 작업 ID - 댓글이 추가될 작업의 ID입니다. 댓글 작성자는 현재 인증된 사용자입니다.- `text` (string, 필수): 텍스트 (예: "This is a comment.").+</Accordion><Accordion title="asana/create_project">@@ -68,6 +70,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `workspace` (string, 필수): 워크스페이스 - Connect Portal Workflow 설정을 사용해 사용자가 프로젝트를 생성할 워크스페이스를 선택할 수 있도록 합니다. 공란인 경우 기본적으로 사용자의 첫 번째 워크스페이스가 선택됩니다.- `team` (string, 선택): 팀 - Connect Portal Workflow 설정을 사용해 사용자가 이 프로젝트를 공유할 팀을 선택할 수 있도록 합니다. 공란인 경우 기본적으로 사용자의 첫 번째 팀이 선택됩니다.- `notes` (string, 선택): 노트 (예: "These are things we need to purchase.").+</Accordion><Accordion title="asana/get_projects">@@ -76,6 +79,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `archived` (string, 선택): 보관됨 - 보관된 프로젝트를 보려면 "true", 활성 프로젝트만 보려면 "false", 보관됨과 활성 모두 보려면 "default"를 선택합니다.- 옵션: `default`, `true`, `false`+</Accordion><Accordion title="asana/get_project_by_id">@@ -83,6 +87,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `projectFilterId` (string, 필수): 프로젝트 ID.+</Accordion><Accordion title="asana/create_task">@@ -97,6 +102,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `dueAtDate` (string, 선택): 마감 시각 - 이 작업이 완료되어야 하는 날짜와 시간 (ISO 타임스탬프) 입니다. Due On과 함께 사용할 수 없습니다. (예: "2019-09-15T02:06:58.147Z").- `assignee` (string, 선택): 담당자 - 이 작업이 할당될 Asana 사용자의 ID입니다. Connect Portal Workflow 설정을 사용해 사용자가 담당자를 선택할 수 있도록 합니다.- `gid` (string, 선택): 외부 ID - 이 작업과 연결할 애플리케이션의 ID입니다. 이 ID를 사용하여 이후 작업 업데이트를 동기화할 수 있습니다.+</Accordion><Accordion title="asana/update_task">@@ -112,6 +118,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `dueAtDate` (string, 선택): 마감 시각 - 이 작업이 완료되어야 하는 날짜와 시간 (ISO 타임스탬프) 입니다. Due On과 함께 사용할 수 없습니다. (예: "2019-09-15T02:06:58.147Z").- `assignee` (string, 선택): 담당자 - 이 작업이 할당될 Asana 사용자의 ID입니다. Connect Portal Workflow 설정을 사용해 사용자가 담당자를 선택할 수 있도록 합니다.- `gid` (string, 선택): 외부 ID - 이 작업과 연결할 애플리케이션의 ID입니다. 이 ID를 사용하여 이후 작업 업데이트를 동기화할 수 있습니다.+</Accordion><Accordion title="asana/get_tasks">@@ -122,6 +129,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `project` (string, 선택): 프로젝트 - 작업을 필터링할 프로젝트의 ID입니다. Connect Portal Workflow 설정을 사용해 사용자가 프로젝트를 선택할 수 있도록 합니다.- `assignee` (string, 선택): 담당자 - 작업을 필터링할 담당자의 ID입니다. Connect Portal Workflow 설정을 사용해 사용자가 담당자를 선택할 수 있도록 합니다.- `completedSince` (string, 선택): 이후 완료됨 - 미완료이거나 해당 시간(ISO 또는 Unix 타임스탬프) 이후에 완료된 작업만 반환합니다. (예: "2014-04-25T16:15:47-04:00").+</Accordion><Accordion title="asana/get_tasks_by_id">@@ -129,6 +137,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `taskId` (string, 필수): 작업 ID.+</Accordion><Accordion title="asana/get_task_by_external_id">@@ -136,6 +145,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `gid` (string, 필수): 외부 ID - 이 작업이 애플리케이션과 연동(또는 동기화)된 ID입니다.+</Accordion><Accordion title="asana/add_task_to_section">@@ -146,6 +156,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `taskId` (string, 필수): 작업 ID - 작업의 ID입니다. (예: "1204619611402340").- `beforeTaskId` (string, 선택): 이전 작업 ID - 이 작업이 삽입될 섹션 내의 작업 ID입니다. 이후 작업 ID와 함께 사용할 수 없습니다. (예: "1204619611402340").- `afterTaskId` (string, 선택): 이후 작업 ID - 이 작업이 삽입될 섹션 내의 작업 ID입니다. 이전 작업 ID와 함께 사용할 수 없습니다. (예: "1204619611402340").+</Accordion><Accordion title="asana/get_teams">@@ -153,12 +164,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `workspace` (string, 필수): 워크스페이스 - 인증된 사용자가 볼 수 있는 이 워크스페이스 내의 팀을 반환합니다.+</Accordion><Accordion title="asana/get_workspaces">**설명:** Asana에서 워크스페이스 목록을 가져옵니다.**매개변수:** 필요 없음.+</Accordion></AccordionGroup>diff --git a/docs/ko/enterprise/integrations/box.mdx b/docs/ko/enterprise/integrations/box.mdxindex 9457468cc..4cdeed4a4 100644--- a/docs/ko/enterprise/integrations/box.mdx+++ b/docs/ko/enterprise/integrations/box.mdx@@ -13,7 +13,7 @@ mode: "wide"Box 통합을 사용하기 전에 다음을 확인하세요:-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- 적절한 권한이 있는 Box 계정- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Box 계정 연결@@ -21,7 +21,7 @@ Box 통합을 사용하기 전에 다음을 확인하세요:### 1. Box 계정 연결하기-1. [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.+1. [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.2. 인증 통합 섹션에서 **Box**를 찾습니다.3. **Connect**를 클릭하고 OAuth 흐름을 완료합니다.4. 파일 및 폴더 관리를 위한 필요한 권한을 부여합니다.@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -66,6 +67,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token}```- `file` (string, 필수): 파일 URL - 파일 크기는 50MB 미만이어야 합니다. (예시: "https://picsum.photos/200/300").+</Accordion><Accordion title="box/save_file_from_object">@@ -75,6 +77,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `file` (string, 필수): 파일 - 파일 데이터를 포함하는 파일 객체를 허용합니다. 파일 크기는 50MB 미만이어야 합니다.- `fileName` (string, 필수): 파일명 (예시: "qwerty.png").- `folder` (string, 선택): 폴더 - Connect Portal Workflow Settings를 사용하여 사용자가 파일의 폴더 목적지를 선택할 수 있도록 합니다. 비워두면 기본적으로 사용자의 루트 폴더에 저장됩니다.+</Accordion><Accordion title="box/get_file_by_id">@@ -82,6 +85,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `fileId` (string, 필수): 파일 ID - 파일을 나타내는 고유 식별자. (예시: "12345").+</Accordion><Accordion title="box/list_files">@@ -107,6 +111,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token]}```+</Accordion><Accordion title="box/create_folder">@@ -120,6 +125,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"id": "123456"}```+</Accordion><Accordion title="box/move_folder">@@ -134,6 +140,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"id": "123456"}```+</Accordion><Accordion title="box/get_folder_by_id">@@ -141,6 +148,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `folderId` (string, 필수): 폴더 ID - 폴더를 나타내는 고유 식별자. (예시: "0").+</Accordion><Accordion title="box/search_folders">@@ -166,6 +174,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token]}```+</Accordion><Accordion title="box/delete_folder">@@ -174,6 +183,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `folderId` (string, 필수): 폴더 ID - 폴더를 나타내는 고유 식별자. (예시: "0").- `recursive` (boolean, 선택): 재귀적 삭제 - 폴더가 비어 있지 않을 경우, 폴더와 그 모든 내용을 재귀적으로 삭제합니다.+</Accordion></AccordionGroup>diff --git a/docs/ko/enterprise/integrations/clickup.mdx b/docs/ko/enterprise/integrations/clickup.mdxindex 23ba4a895..0f66fe0de 100644--- a/docs/ko/enterprise/integrations/clickup.mdx+++ b/docs/ko/enterprise/integrations/clickup.mdx@@ -13,7 +13,7 @@ mode: "wide"ClickUp 통합을 사용하기 전에 다음을 준비해야 합니다:-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- 적절한 권한이 있는 ClickUp 계정- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 ClickUp 계정 연결@@ -21,7 +21,7 @@ ClickUp 통합을 사용하기 전에 다음을 준비해야 합니다:### 1. ClickUp 계정 연결하기-1. [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.+1. [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.2. 인증 통합 섹션에서 **ClickUp**을 찾습니다.3. **Connect**를 클릭하고 OAuth 과정을 완료합니다.4. 작업 및 프로젝트 관리에 필요한 권한을 부여합니다.@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -75,6 +76,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token}```사용 가능한 필드: `space_ids%5B%5D`, `project_ids%5B%5D`, `list_ids%5B%5D`, `statuses%5B%5D`, `include_closed`, `assignees%5B%5D`, `tags%5B%5D`, `due_date_gt`, `due_date_lt`, `date_created_gt`, `date_created_lt`, `date_updated_gt`, `date_updated_lt`+</Accordion><Accordion title="clickup/get_task_in_list">@@ -83,6 +85,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `listId` (string, 필수): 목록 - 작업을 가져올 목록을 선택합니다. 사용자가 ClickUp 목록을 선택할 수 있도록 Connect Portal 사용자 설정을 사용하세요.- `taskFilterFormula` (string, 선택): 지정된 필터와 일치하는 작업을 검색합니다. 예: name=task1.+</Accordion><Accordion title="clickup/create_task">@@ -96,6 +99,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `assignees` (string, 선택): 담당자 - 이 작업에 할당할 멤버(또는 멤버 ID 배열)를 선택합니다. 사용자가 ClickUp 멤버를 선택할 수 있도록 Connect Portal 사용자 설정을 사용하세요.- `dueDate` (string, 선택): 마감일 - 이 작업의 마감일을 지정합니다.- `additionalFields` (string, 선택): 추가 필드 - 이 작업에 포함할 추가 필드를 JSON으로 지정합니다.+</Accordion><Accordion title="clickup/update_task">@@ -110,6 +114,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `assignees` (string, 선택): 담당자 - 이 작업에 할당할 멤버(또는 멤버 ID 배열)를 선택합니다. 사용자가 ClickUp 멤버를 선택할 수 있도록 Connect Portal 사용자 설정을 사용하세요.- `dueDate` (string, 선택): 마감일 - 이 작업의 마감일을 지정합니다.- `additionalFields` (string, 선택): 추가 필드 - 이 작업에 포함할 추가 필드를 JSON으로 지정합니다.+</Accordion><Accordion title="clickup/delete_task">@@ -117,6 +122,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `taskId` (string, 필수): 작업 ID - 삭제할 작업의 ID입니다.+</Accordion><Accordion title="clickup/get_list">@@ -124,6 +130,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `spaceId` (string, 필수): 스페이스 ID - 목록이 포함된 스페이스의 ID입니다.+</Accordion><Accordion title="clickup/get_custom_fields_in_list">@@ -131,6 +138,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `listId` (string, 필수): 목록 ID - 사용자 정의 필드를 가져올 목록의 ID입니다.+</Accordion><Accordion title="clickup/get_all_fields_in_list">@@ -138,6 +146,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `listId` (string, 필수): 목록 ID - 모든 필드를 가져올 목록의 ID입니다.+</Accordion><Accordion title="clickup/get_space">@@ -145,6 +154,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `spaceId` (string, 선택): 스페이스 ID - 조회할 스페이스의 ID입니다.+</Accordion><Accordion title="clickup/get_folders">@@ -152,12 +162,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `spaceId` (string, 필수): 스페이스 ID - 폴더가 포함된 스페이스의 ID입니다.+</Accordion><Accordion title="clickup/get_member">**설명:** ClickUp에서 멤버 정보를 가져옵니다.**파라미터:** 필요 없음.+</Accordion></AccordionGroup>@@ -282,6 +294,11 @@ crew.kickoff()### 도움 받기-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">- ClickUp 연동 설정 또는 문제 해결에 대한 지원이 필요하신 경우 저희 지원팀에 문의하세요.+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>+ ClickUp 연동 설정 또는 문제 해결에 대한 지원이 필요하신 경우 저희 지원팀에+ 문의하세요.</Card>diff --git a/docs/ko/enterprise/integrations/github.mdx b/docs/ko/enterprise/integrations/github.mdxindex e89eb4bd2..b297a8ac1 100644--- a/docs/ko/enterprise/integrations/github.mdx+++ b/docs/ko/enterprise/integrations/github.mdx@@ -13,7 +13,7 @@ mode: "wide"GitHub 통합을 사용하기 전에 다음을 확인하세요:-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- 해당 리포지토리에 대한 적절한 권한이 있는 GitHub 계정- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 GitHub 계정 연결 완료@@ -21,7 +21,7 @@ GitHub 통합을 사용하기 전에 다음을 확인하세요:### 1. GitHub 계정 연결하기-1. [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.+1. [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.2. 인증 통합 섹션에서 **GitHub**을 찾습니다.3. **Connect**를 클릭하고 OAuth 흐름을 완료합니다.4. 리포지토리 및 이슈 관리를 위한 필수 권한을 부여합니다.@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -61,6 +62,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `title` (string, 필수): 이슈 제목 - 생성할 이슈의 제목을 지정합니다.- `body` (string, 선택): 이슈 본문 - 생성할 이슈의 본문 내용을 지정합니다.- `assignees` (string, 선택): 담당자 - 이 이슈의 담당자 GitHub 로그인을 문자열 배열로 지정합니다. (예시: `["octocat"]`).+</Accordion><Accordion title="github/update_issue">@@ -75,6 +77,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `assignees` (string, 선택): 담당자 - 이 이슈의 담당자 GitHub 로그인을 문자열 배열로 지정합니다. (예시: `["octocat"]`).- `state` (string, 선택): 상태 - 이슈의 변경된 상태를 지정합니다.- 옵션: `open`, `closed`+</Accordion><Accordion title="github/get_issue_by_number">@@ -84,6 +87,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `owner` (string, 필수): 소유자 - 이 이슈와 연관된 저장소의 계정 소유자 이름을 지정합니다. (예시: "abc").- `repo` (string, 필수): 저장소 - 이 이슈와 연관된 저장소 이름을 지정합니다.- `issue_number` (string, 필수): 이슈 번호 - 가져올 이슈의 번호를 지정합니다.+</Accordion><Accordion title="github/lock_issue">@@ -95,6 +99,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `issue_number` (string, 필수): 이슈 번호 - 잠글 이슈의 번호를 지정합니다.- `lock_reason` (string, 필수): 잠금 사유 - 이슈 또는 풀 리퀘스트 대화에 대한 잠금 이유를 지정합니다.- 옵션: `off-topic`, `too heated`, `resolved`, `spam`+</Accordion><Accordion title="github/search_issue">@@ -122,6 +127,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token}```사용 가능한 필드: `assignee`, `creator`, `mentioned`, `labels`+</Accordion><Accordion title="github/create_release">@@ -140,6 +146,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `discussion_category_name` (string, 선택): 토론 카테고리 이름 - 지정 시, 해당 카테고리의 토론이 생성되어 릴리스와 연결됩니다. 값은 저장소에 이미 존재하는 카테고리여야 합니다.- `generate_release_notes` (string, 선택): 릴리스 노트 - 지정한 이름과 본문을 사용하여 릴리스 노트를 자동으로 생성할지 여부를 지정합니다.- 옵션: `true`, `false`+</Accordion><Accordion title="github/update_release">@@ -159,6 +166,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `discussion_category_name` (string, 선택): 토론 카테고리 이름 - 지정 시, 해당 카테고리의 토론이 생성되어 릴리스와 연결됩니다. 값은 저장소에 이미 존재하는 카테고리여야 합니다.- `generate_release_notes` (string, 선택): 릴리스 노트 - 지정한 이름과 본문을 사용하여 릴리스 노트를 자동으로 생성할지 여부를 지정합니다.- 옵션: `true`, `false`+</Accordion><Accordion title="github/get_release_by_id">@@ -168,6 +176,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `owner` (string, 필수): 소유자 - 이 릴리스와 연관된 저장소의 계정 소유자 이름을 지정합니다. (예시: "abc").- `repo` (string, 필수): 저장소 - 이 릴리스와 연관된 저장소 이름을 지정합니다.- `id` (string, 필수): 릴리스 ID - 조회할 릴리스의 ID를 지정합니다.+</Accordion><Accordion title="github/get_release_by_tag_name">@@ -177,6 +186,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `owner` (string, 필수): 소유자 - 이 릴리스와 연관된 저장소의 계정 소유자 이름을 지정합니다. (예시: "abc").- `repo` (string, 필수): 저장소 - 이 릴리스와 연관된 저장소 이름을 지정합니다.- `tag_name` (string, 필수): 이름 - 가져올 릴리스의 태그를 지정합니다. (예시: "v1.0.0").+</Accordion><Accordion title="github/delete_release">@@ -186,6 +196,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `owner` (string, 필수): 소유자 - 이 릴리스와 연관된 저장소의 계정 소유자 이름을 지정합니다. (예시: "abc").- `repo` (string, 필수): 저장소 - 이 릴리스와 연관된 저장소 이름을 지정합니다.- `id` (string, 필수): 릴리스 ID - 삭제할 릴리스의 ID를 지정합니다.+</Accordion></AccordionGroup>@@ -312,6 +323,10 @@ crew.kickoff()### 도움 받기-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>GitHub 통합 설정 또는 문제 해결에 대해 지원팀에 문의하세요.</Card>diff --git a/docs/ko/enterprise/integrations/gmail.mdx b/docs/ko/enterprise/integrations/gmail.mdxindex 9e09db60b..54ed3f062 100644--- a/docs/ko/enterprise/integrations/gmail.mdx+++ b/docs/ko/enterprise/integrations/gmail.mdx@@ -13,7 +13,7 @@ mode: "wide"Gmail 통합을 사용하기 전에 다음을 확인하세요:-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- 적절한 권한이 있는 Gmail 계정- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Gmail 계정 연결@@ -21,7 +21,7 @@ Gmail 통합을 사용하기 전에 다음을 확인하세요:### 1. Gmail 계정 연결하기-1. [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.+1. [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.2. 인증 통합 섹션에서 **Gmail**을 찾습니다.3. **Connect**를 클릭하고 OAuth 흐름을 완료합니다.4. 이메일 및 연락처 관리를 위한 필요한 권한을 부여합니다.@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -73,6 +74,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"reply-to": "Sender Name <[email protected]>"}```+</Accordion><Accordion title="gmail/get_email_by_id">@@ -81,6 +83,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `userId` (string, 필수): 사용자 ID - 사용자의 이메일 주소를 지정합니다. (예: "[email protected]").- `messageId` (string, 필수): 메시지 ID - 조회할 메시지의 ID를 지정합니다.+</Accordion><Accordion title="gmail/fetch_emails">@@ -112,6 +115,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"pageCursor": "page_cursor_string"}```+</Accordion><Accordion title="gmail/delete_email">@@ -120,6 +124,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `userId` (string, 필수): 사용자 ID - 사용자의 이메일 주소를 지정합니다. (예: "[email protected]").- `messageId` (string, 필수): 메시지 ID - 휴지통으로 보낼 메시지의 ID를 지정합니다.+</Accordion><Accordion title="gmail/create_a_contact">@@ -140,6 +145,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token]}```+</Accordion><Accordion title="gmail/get_contact_by_resource_name">@@ -147,6 +153,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `resourceName` (string, 필수): 리소스 이름 - 조회할 연락처의 리소스 이름을 지정합니다.+</Accordion><Accordion title="gmail/search_for_contact">@@ -154,6 +161,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `searchTerm` (string, 필수): 검색어 - 이름, 닉네임, 이메일 주소, 전화번호 또는 조직 연락처 속성에서 유사하거나 정확히 일치하는 항목을 검색할 검색어를 지정합니다.+</Accordion><Accordion title="gmail/delete_contact">@@ -161,6 +169,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `resourceName` (string, 필수): 리소스 이름 - 삭제할 연락처의 리소스 이름을 지정합니다.+</Accordion><Accordion title="gmail/create_draft">@@ -184,6 +193,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"reply-to": "Sender Name <[email protected]>"}```+</Accordion></AccordionGroup>@@ -340,6 +350,11 @@ crew.kickoff()### 도움 받기-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">- Gmail 통합 설정 또는 문제 해결에 대한 지원이 필요하시다면 저희 지원팀에 문의해 주세요.+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>+ Gmail 통합 설정 또는 문제 해결에 대한 지원이 필요하시다면 저희 지원팀에 문의해+ 주세요.</Card>diff --git a/docs/ko/enterprise/integrations/google_calendar.mdx b/docs/ko/enterprise/integrations/google_calendar.mdxindex 514199796..80a6ab439 100644--- a/docs/ko/enterprise/integrations/google_calendar.mdx+++ b/docs/ko/enterprise/integrations/google_calendar.mdx@@ -13,7 +13,7 @@ mode: "wide"Google Calendar 통합을 사용하기 전에 다음을 준비해야 합니다:-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- Google Calendar에 접근 가능한 Google 계정- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Google 계정을 연결 완료@@ -21,7 +21,7 @@ Google Calendar 통합을 사용하기 전에 다음을 준비해야 합니다:### 1. Google 계정 연결하기-1. [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.+1. [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.2. 인증 통합 섹션에서 **Google Calendar**를 찾습니다.3. **Connect**를 클릭하고 OAuth 과정을 완료합니다.4. 캘린더 및 연락처 접근 권한을 허용합니다.@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -65,6 +66,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `eventDescription` (string, 선택): 이벤트 설명.- `eventId` (string, 선택): 이벤트 ID - 이 이벤트와 연결할 애플리케이션의 ID입니다. 이후 이 ID를 사용하여 이벤트를 동기화할 수 있습니다.- `includeMeetLink` (boolean, 선택): Google Meet 링크 포함 여부? - 이 이벤트에 대해 Google Meet 컨퍼런스 링크를 자동으로 생성합니다.+</Accordion><Accordion title="google_calendar/update_event">@@ -79,6 +81,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `attendees` (string, 선택): 참석자 - 이메일 주소 배열 또는 쉼표로 구분된 이메일 주소 허용.- `eventLocation` (string, 선택): 이벤트 위치.- `eventDescription` (string, 선택): 이벤트 설명.+</Accordion><Accordion title="google_calendar/view_events">@@ -88,6 +91,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `calendar` (string, 선택): 캘린더 - Connect Portal Workflow Settings를 사용하여 사용자가 이벤트를 추가할 캘린더를 선택할 수 있도록 합니다. 비워두면 사용자의 기본 캘린더로 기본 설정됩니다.- `after` (string, 선택): 이후 - 제공된 날짜 이후에 시작하는 이벤트를 필터링합니다 (밀리초 단위의 Unix 또는 ISO 타임스탬프). (예시: "2025-04-12T10:00:00Z 또는 1712908800000").- `before` (string, 선택): 이전 - 제공된 날짜 이전에 종료되는 이벤트를 필터링합니다 (밀리초 단위의 Unix 또는 ISO 타임스탬프). (예시: "2025-04-12T10:00:00Z 또는 1712908800000").+</Accordion><Accordion title="google_calendar/get_event_by_id">@@ -96,6 +100,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `eventId` (string, 필수): 이벤트 ID.- `calendar` (string, 선택): 캘린더 - Connect Portal Workflow Settings를 사용하여 사용자가 이벤트를 추가할 캘린더를 선택할 수 있도록 합니다. 비워두면 사용자의 기본 캘린더로 기본 설정됩니다.+</Accordion><Accordion title="google_calendar/delete_event">@@ -104,6 +109,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `eventId` (string, 필수): 이벤트 ID - 삭제할 캘린더 이벤트의 ID입니다.- `calendar` (string, 선택): 캘린더 - Connect Portal Workflow Settings를 사용하여 사용자가 이벤트를 추가할 캘린더를 선택할 수 있도록 합니다. 비워두면 사용자의 기본 캘린더로 기본 설정됩니다.+</Accordion><Accordion title="google_calendar/get_contacts">@@ -116,6 +122,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"pageCursor": "page_cursor_string"}```+</Accordion><Accordion title="google_calendar/search_contacts">@@ -123,6 +130,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `query` (string, 선택): 연락처를 검색할 검색 쿼리.+</Accordion><Accordion title="google_calendar/list_directory_people">@@ -135,6 +143,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"pageCursor": "page_cursor_string"}```+</Accordion><Accordion title="google_calendar/search_directory_people">@@ -148,6 +157,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"pageCursor": "page_cursor_string"}```+</Accordion><Accordion title="google_calendar/list_other_contacts">@@ -160,6 +170,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"pageCursor": "page_cursor_string"}```+</Accordion><Accordion title="google_calendar/search_other_contacts">@@ -167,6 +178,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `query` (string, 선택): 연락처를 검색할 검색 쿼리.+</Accordion><Accordion title="google_calendar/get_availability">@@ -187,6 +199,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token}]```+</Accordion></AccordionGroup>@@ -348,33 +361,43 @@ crew.kickoff()### 일반적인 문제**인증 오류**+- Google 계정에 캘린더 접근에 필요한 권한이 있는지 확인하세요- OAuth 연결에 Google Calendar API에 필요한 모든 범위가 포함되어 있는지 확인하세요- 캘린더 공유 설정이 필요한 접근 수준을 허용하는지 확인하세요**이벤트 생성 문제**+- 시간 형식이 올바른지(ISO8601 또는 Unix 타임스탬프) 확인하세요- 참석자 이메일 주소가 올바르게 형식화되어 있는지 확인하세요- 대상 캘린더가 존재하며 접근 가능한지 확인하세요- 올바른 시간대가 지정되어 있는지 확인하세요**가용성 및 시간 충돌**+- 가용성 확인 시 시간 범위에 올바른 ISO 형식을 사용하세요- 모든 작업에서 시간대가 일관성 있는지 확인하세요- 여러 캘린더를 확인할 때 캘린더 ID가 올바른지 확인하세요**연락처 및 사용자 검색**+- 검색 쿼리가 올바르게 형식화되어 있는지 확인하세요- 디렉터리 접근 권한이 부여되었는지 확인하세요- 연락처 정보가 최신이며 접근 가능한지 확인하세요**이벤트 업데이트 및 삭제**+- 이벤트 ID가 올바르며 이벤트가 존재하는지 확인하세요- 이벤트를 편집할 수 있는 권한이 있는지 확인하세요- 캘린더 소유권이 수정 작업을 허용하는지 확인하세요### 도움 받기-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">- Google Calendar 연동 설정 또는 문제 해결에 대한 지원이 필요하면 저희 지원팀에 문의하세요.+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>+ Google Calendar 연동 설정 또는 문제 해결에 대한 지원이 필요하면 저희 지원팀에+ 문의하세요.</Card>diff --git a/docs/ko/enterprise/integrations/google_contacts.mdx b/docs/ko/enterprise/integrations/google_contacts.mdxindex c9f54c741..5302784a8 100644--- a/docs/ko/enterprise/integrations/google_contacts.mdx+++ b/docs/ko/enterprise/integrations/google_contacts.mdx@@ -13,7 +13,7 @@ mode: "wide"Google Contacts 통합을 사용하기 전에 다음 사항을 확인하세요:-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- Google Contacts 액세스 권한이 있는 Google 계정- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Google 계정 연결@@ -21,7 +21,7 @@ Google Contacts 통합을 사용하기 전에 다음 사항을 확인하세요:### 1. Google 계정 연결-1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동+1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동2. 인증 통합 섹션에서 **Google Contacts** 찾기3. **연결**을 클릭하고 OAuth 플로우 완료4. 연락처 및 디렉토리 액세스에 필요한 권한 부여@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -61,6 +62,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `personFields` (string, 선택사항): 포함할 필드 (예: 'names,emailAddresses,phoneNumbers'). 기본값: names,emailAddresses,phoneNumbers- `requestSyncToken` (boolean, 선택사항): 응답에 동기화 토큰을 포함할지 여부. 기본값: false- `sortOrder` (string, 선택사항): 연결을 정렬할 순서. 옵션: LAST_MODIFIED_ASCENDING, LAST_MODIFIED_DESCENDING, FIRST_NAME_ASCENDING, LAST_NAME_ASCENDING+</Accordion><Accordion title="google_contacts/search_contacts">@@ -72,6 +74,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `pageSize` (integer, 선택사항): 반환할 결과 수. 최소: 1, 최대: 30- `pageToken` (string, 선택사항): 반환할 결과 페이지를 지정하는 토큰.- `sources` (array, 선택사항): 검색할 소스. 옵션: READ_SOURCE_TYPE_CONTACT, READ_SOURCE_TYPE_PROFILE. 기본값: READ_SOURCE_TYPE_CONTACT+</Accordion><Accordion title="google_contacts/list_directory_people">@@ -84,6 +87,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `readMask` (string, 선택사항): 읽을 필드 (예: 'names,emailAddresses')- `requestSyncToken` (boolean, 선택사항): 응답에 동기화 토큰을 포함할지 여부. 기본값: false- `mergeSources` (array, 선택사항): 디렉토리 사람 응답에 병합할 추가 데이터. 옵션: CONTACT+</Accordion><Accordion title="google_contacts/search_directory_people">@@ -94,6 +98,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `sources` (string, 필수): 디렉토리 소스 ('DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE' 사용)- `pageSize` (integer, 선택사항): 반환할 결과 수- `readMask` (string, 선택사항): 읽을 필드+</Accordion><Accordion title="google_contacts/list_other_contacts">@@ -104,6 +109,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `pageToken` (string, 선택사항): 반환할 결과 페이지를 지정하는 토큰.- `readMask` (string, 선택사항): 읽을 필드- `requestSyncToken` (boolean, 선택사항): 응답에 동기화 토큰을 포함할지 여부. 기본값: false+</Accordion><Accordion title="google_contacts/search_other_contacts">@@ -113,6 +119,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `query` (string, 필수): 검색 쿼리- `readMask` (string, 필수): 읽을 필드 (예: 'names,emailAddresses')- `pageSize` (integer, 선택사항): 결과 수+</Accordion><Accordion title="google_contacts/get_person">@@ -121,6 +128,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `resourceName` (string, 필수): 가져올 사람의 리소스 이름 (예: 'people/c123456789')- `personFields` (string, 선택사항): 포함할 필드 (예: 'names,emailAddresses,phoneNumbers'). 기본값: names,emailAddresses,phoneNumbers+</Accordion><Accordion title="google_contacts/create_contact">@@ -132,6 +140,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `phoneNumbers` (array, 선택사항): 전화번호들. 각 항목은 `value` (string, 전화번호)와 `type` (string, 'home', 'work', 'mobile', 'other', 기본값 'other')이 있는 객체.- `addresses` (array, 선택사항): 우편 주소들. 각 항목은 `formattedValue` (string, 형식화된 주소)와 `type` (string, 'home', 'work', 'other', 기본값 'other')이 있는 객체.- `organizations` (array, 선택사항): 조직/회사들. 각 항목은 `name` (string, 조직 이름), `title` (string, 직책), `type` (string, 'work', 'other', 기본값 'work')이 있는 객체.+</Accordion><Accordion title="google_contacts/update_contact">@@ -143,6 +152,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `names` (array, 선택사항): 사람의 이름들. 각 항목은 `givenName` (string), `familyName` (string), `displayName` (string)이 있는 객체.- `emailAddresses` (array, 선택사항): 이메일 주소들. 각 항목은 `value` (string, 이메일 주소)와 `type` (string, 'home', 'work', 'other')이 있는 객체.- `phoneNumbers` (array, 선택사항): 전화번호들. 각 항목은 `value` (string, 전화번호)와 `type` (string, 'home', 'work', 'mobile', 'other')이 있는 객체.+</Accordion><Accordion title="google_contacts/delete_contact">@@ -150,6 +160,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `resourceName` (string, 필수): 삭제할 사람의 리소스 이름 (예: 'people/c123456789').+</Accordion><Accordion title="google_contacts/batch_get_people">@@ -158,6 +169,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `resourceNames` (array, 필수): 가져올 사람들의 리소스 이름 (최대 200개 항목).- `personFields` (string, 선택사항): 포함할 필드 (예: 'names,emailAddresses,phoneNumbers'). 기본값: names,emailAddresses,phoneNumbers+</Accordion><Accordion title="google_contacts/list_contact_groups">@@ -167,6 +179,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `pageSize` (integer, 선택사항): 반환할 연락처 그룹 수. 최소: 1, 최대: 1000- `pageToken` (string, 선택사항): 반환할 결과 페이지를 지정하는 토큰.- `groupFields` (string, 선택사항): 포함할 필드 (예: 'name,memberCount,clientData'). 기본값: name,memberCount+</Accordion><Accordion title="google_contacts/get_contact_group">@@ -176,6 +189,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `resourceName` (string, 필수): 연락처 그룹의 리소스 이름 (예: 'contactGroups/myContactGroup').- `maxMembers` (integer, 선택사항): 포함할 최대 멤버 수. 최소: 0, 최대: 20000- `groupFields` (string, 선택사항): 포함할 필드 (예: 'name,memberCount,clientData'). 기본값: name,memberCount+</Accordion><Accordion title="google_contacts/create_contact_group">@@ -184,6 +198,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `name` (string, 필수): 연락처 그룹의 이름.- `clientData` (array, 선택사항): 클라이언트별 데이터. 각 항목은 `key` (string)와 `value` (string)가 있는 객체.+</Accordion></AccordionGroup>@@ -223,15 +238,22 @@ crew.kickoff()### 일반적인 문제**인증 오류**+- Google 계정이 연락처 및 디렉토리 액세스에 필요한 권한을 가지고 있는지 확인하세요.- OAuth 연결이 Google People API에 필요한 모든 범위를 포함하는지 확인하세요.**연락처 생성/업데이트 문제**+- 연락처 생성 시 `email`과 같은 필수 필드가 제공되는지 확인하세요.- 연락처를 업데이트하거나 삭제할 때 `resourceName`이 올바른지 확인하세요.### 도움 받기-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">- Google Contacts 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의하세요.+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>+ Google Contacts 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에+ 문의하세요.</Card>diff --git a/docs/ko/enterprise/integrations/google_docs.mdx b/docs/ko/enterprise/integrations/google_docs.mdxindex 33c749b65..c749be03b 100644--- a/docs/ko/enterprise/integrations/google_docs.mdx+++ b/docs/ko/enterprise/integrations/google_docs.mdx@@ -13,7 +13,7 @@ mode: "wide"Google Docs 통합을 사용하기 전에 다음 사항을 확인하세요:-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- Google Docs 액세스 권한이 있는 Google 계정- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Google 계정 연결@@ -21,7 +21,7 @@ Google Docs 통합을 사용하기 전에 다음 사항을 확인하세요:### 1. Google 계정 연결-1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동+1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동2. 인증 통합 섹션에서 **Google Docs** 찾기3. **연결**을 클릭하고 OAuth 플로우 완료4. 문서 액세스에 필요한 권한 부여@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -57,6 +58,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `title` (string, 선택사항): 새 문서의 제목.+</Accordion><Accordion title="google_docs/get_document">@@ -66,6 +68,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `documentId` (string, 필수): 검색할 문서의 ID.- `includeTabsContent` (boolean, 선택사항): 탭 내용을 포함할지 여부. 기본값: false- `suggestionsViewMode` (string, 선택사항): 문서에 적용할 제안 보기 모드. 옵션: DEFAULT_FOR_CURRENT_ACCESS, PREVIEW_SUGGESTIONS_ACCEPTED, PREVIEW_WITHOUT_SUGGESTIONS. 기본값: DEFAULT_FOR_CURRENT_ACCESS+</Accordion><Accordion title="google_docs/batch_update">@@ -75,6 +78,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `documentId` (string, 필수): 업데이트할 문서의 ID.- `requests` (array, 필수): 문서에 적용할 업데이트 목록. 각 항목은 요청을 나타내는 객체.- `writeControl` (object, 선택사항): 쓰기 요청이 실행되는 방식을 제어합니다. `requiredRevisionId` (string)와 `targetRevisionId` (string)를 포함.+</Accordion><Accordion title="google_docs/insert_text">@@ -84,6 +88,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `documentId` (string, 필수): 업데이트할 문서의 ID.- `text` (string, 필수): 삽입할 텍스트.- `index` (integer, 선택사항): 텍스트를 삽입할 0 기반 인덱스. 기본값: 1+</Accordion><Accordion title="google_docs/replace_text">@@ -94,6 +99,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `containsText` (string, 필수): 찾아서 교체할 텍스트.- `replaceText` (string, 필수): 교체할 텍스트.- `matchCase` (boolean, 선택사항): 검색이 대소문자를 구분할지 여부. 기본값: false+</Accordion><Accordion title="google_docs/delete_content_range">@@ -103,6 +109,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `documentId` (string, 필수): 업데이트할 문서의 ID.- `startIndex` (integer, 필수): 삭제할 범위의 시작 인덱스.- `endIndex` (integer, 필수): 삭제할 범위의 끝 인덱스.+</Accordion><Accordion title="google_docs/insert_page_break">@@ -111,6 +118,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `documentId` (string, 필수): 업데이트할 문서의 ID.- `index` (integer, 선택사항): 페이지 나누기를 삽입할 0 기반 인덱스. 기본값: 1+</Accordion><Accordion title="google_docs/create_named_range">@@ -121,6 +129,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `name` (string, 필수): 명명된 범위의 이름.- `startIndex` (integer, 필수): 범위의 시작 인덱스.- `endIndex` (integer, 필수): 범위의 끝 인덱스.+</Accordion></AccordionGroup>@@ -160,15 +169,22 @@ crew.kickoff()### 일반적인 문제**인증 오류**+- Google 계정이 Google Docs 액세스에 필요한 권한을 가지고 있는지 확인하세요.- OAuth 연결이 필요한 모든 범위(`https://www.googleapis.com/auth/documents`)를 포함하는지 확인하세요.**문서 ID 문제**+- 문서 ID가 올바른지 다시 확인하세요.- 문서가 존재하고 계정에서 액세스할 수 있는지 확인하세요.### 도움 받기-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">- Google Docs 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의하세요.+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>+ Google Docs 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에+ 문의하세요.</Card>diff --git a/docs/ko/enterprise/integrations/google_drive.mdx b/docs/ko/enterprise/integrations/google_drive.mdxindex 9a5b3d490..39ba7f0c1 100644--- a/docs/ko/enterprise/integrations/google_drive.mdx+++ b/docs/ko/enterprise/integrations/google_drive.mdx@@ -13,7 +13,7 @@ mode: "wide"Google Drive 통합을 사용하기 전에 다음 사항을 확인하세요:-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- Google Drive 액세스 권한이 있는 Google 계정- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Google 계정 연결@@ -21,7 +21,7 @@ Google Drive 통합을 사용하기 전에 다음 사항을 확인하세요:### 1. Google 계정 연결-1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.+1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.2. 인증 통합 섹션에서 **Google Drive**를 찾습니다.3. **연결**을 클릭하고 OAuth 과정을 완료합니다.4. 파일 및 폴더 관리에 필요한 권한을 부여합니다.@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -57,6 +58,11 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token### 도움 받기-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">- Google Drive 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의하세요.+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>+ Google Drive 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에+ 문의하세요.</Card>diff --git a/docs/ko/enterprise/integrations/google_sheets.mdx b/docs/ko/enterprise/integrations/google_sheets.mdxindex 8bd710bdf..de0b09168 100644--- a/docs/ko/enterprise/integrations/google_sheets.mdx+++ b/docs/ko/enterprise/integrations/google_sheets.mdx@@ -13,7 +13,7 @@ mode: "wide"Google Sheets 통합을 사용하기 전에 다음을 확인하세요:-- 활성 구독이 되어 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 되어 있는 [CrewAI AMP](https://app.crewai.com) 계정- Google Sheets에 액세스할 수 있는 Google 계정- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Google 계정 연결- 데이터 작업을 위한 올바른 열 헤더가 있는 스프레드시트@@ -22,7 +22,7 @@ Google Sheets 통합을 사용하기 전에 다음을 확인하세요:### 1. Google 계정 연결하기-1. [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.+1. [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.2. 인증 통합 섹션에서 **Google Sheets**를 찾습니다.3. **Connect**를 클릭하고 OAuth 흐름을 완료합니다.4. 스프레드시트 접근에 필요한 권한을 허용합니다.@@ -37,7 +37,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -59,6 +60,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `spreadsheetId` (string, 필수): 스프레드시트 - Connect Portal Workflow Settings를 사용하여 사용자가 스프레드시트를 선택할 수 있도록 합니다. 선택한 스프레드시트의 첫 번째 워크시트를 기본값으로 사용합니다.- `limit` (string, 선택): 행 제한 - 반환할 최대 행 수를 제한합니다.+</Accordion><Accordion title="google_sheets/append_values">@@ -76,6 +78,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"columnName4": "columnValue4"}```+</Accordion><Accordion title="google_sheets/update_values">@@ -112,6 +115,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"columnName4": "newValue4"}```+</Accordion></AccordionGroup>@@ -273,38 +277,49 @@ crew.kickoff()### 일반적인 문제**권한 오류**+- Google 계정이 대상 스프레드시트에 대해 편집 권한이 있는지 확인하세요- OAuth 연결에 Google Sheets API에 필요한 scope가 포함되어 있는지 검증하세요- 스프레드시트가 인증된 계정과 공유되어 있는지 확인하세요**스프레드시트 구조 문제**+- 행을 생성하거나 업데이트하기 전에 워크시트에 올바른 열 헤더가 있는지 확인하세요- `additionalFields`의 열 이름이 실제 열 헤더와 일치하는지 검증하세요- 지정된 워크시트가 스프레드시트에 존재하는지 확인하세요**데이터 유형 및 형식 문제**+- 데이터 값이 각 열에 대해 예상되는 형식과 일치하는지 확인하세요- 날짜 열에는 올바른 날짜 형식(ISO 형식 권장)을 사용하세요- 숫자 열에 입력되는 값이 적절한 형식인지 검증하세요**필터 수식 문제**+- 필터 수식이 부정 정규형(disjunctive normal form)의 올바른 JSON 구조를 따르는지 확인하세요- 실제 열 헤더와 일치하는 유효한 필드명을 사용하세요- 복잡한 다중 조건 쿼리를 작성하기 전에 간단한 필터로 테스트하세요- 연산자 유형이 열의 데이터 유형과 일치하는지 검증하세요**행 제한 및 성능**+- `GOOGLE_SHEETS_GET_ROW`를 사용할 때 행 제한에 유의하세요- 대용량 데이터셋의 경우 페이지네이션을 고려하세요- 처리되는 데이터의 양을 줄이기 위해 구체적인 필터를 사용하세요**업데이트 작업**+- 필터 조건이 업데이트하려는 행을 정확하게 식별하는지 확인하세요- 대규모 업데이트 전에 작은 데이터셋으로 필터 조건을 테스트하세요- 모든 필수 필드가 업데이트 작업에 포함되어 있는지 검증하세요### 도움 받기-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">- Google Sheets 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 저희 지원팀으로 문의해 주세요.+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>+ Google Sheets 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 저희+ 지원팀으로 문의해 주세요.</Card>diff --git a/docs/ko/enterprise/integrations/google_slides.mdx b/docs/ko/enterprise/integrations/google_slides.mdxindex 12df6bc7b..2c6a3b10c 100644--- a/docs/ko/enterprise/integrations/google_slides.mdx+++ b/docs/ko/enterprise/integrations/google_slides.mdx@@ -13,7 +13,7 @@ mode: "wide"Google Slides 통합을 사용하기 전에 다음 사항을 확인하세요:-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- Google Slides 액세스 권한이 있는 Google 계정- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Google 계정 연결@@ -21,7 +21,7 @@ Google Slides 통합을 사용하기 전에 다음 사항을 확인하세요:### 1. Google 계정 연결-1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동+1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동2. 인증 통합 섹션에서 **Google Slides** 찾기3. **연결**을 클릭하고 OAuth 플로우 완료4. 프레젠테이션, 스프레드시트 및 드라이브 액세스에 필요한 권한 부여@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -57,6 +58,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `title` (string, 필수): 프레젠테이션의 제목.+</Accordion><Accordion title="google_slides/get_presentation">@@ -65,6 +67,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `presentationId` (string, 필수): 검색할 프레젠테이션의 ID.- `fields` (string, 선택사항): 응답에 포함할 필드. 성능 향상을 위해 필요한 데이터만 반환하는 데 사용.+</Accordion><Accordion title="google_slides/batch_update_presentation">@@ -74,6 +77,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `presentationId` (string, 필수): 업데이트할 프레젠테이션의 ID.- `requests` (array, 필수): 프레젠테이션에 적용할 업데이트 목록. 각 항목은 요청을 나타내는 객체.- `writeControl` (object, 선택사항): 쓰기 요청이 실행되는 방식을 제어합니다. `requiredRevisionId` (string)를 포함.+</Accordion><Accordion title="google_slides/get_page">@@ -82,6 +86,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `presentationId` (string, 필수): 프레젠테이션의 ID.- `pageObjectId` (string, 필수): 검색할 페이지의 ID.+</Accordion><Accordion title="google_slides/get_thumbnail">@@ -90,6 +95,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `presentationId` (string, 필수): 프레젠테이션의 ID.- `pageObjectId` (string, 필수): 썸네일 생성을 위한 페이지의 ID.+</Accordion><Accordion title="google_slides/import_data_from_sheet">@@ -99,6 +105,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `presentationId` (string, 필수): 프레젠테이션의 ID.- `sheetId` (string, 필수): 가져올 Google 시트의 ID.- `dataRange` (string, 필수): 시트에서 가져올 데이터 범위.+</Accordion><Accordion title="google_slides/upload_file_to_drive">@@ -107,6 +114,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `file` (string, 필수): 업로드할 파일 데이터.- `presentationId` (string, 필수): 업로드된 파일을 연결할 프레젠테이션의 ID.+</Accordion><Accordion title="google_slides/link_file_to_presentation">@@ -115,6 +123,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `presentationId` (string, 필수): 프레젠테이션의 ID.- `fileId` (string, 필수): 연결할 파일의 ID.+</Accordion><Accordion title="google_slides/get_all_presentations">@@ -123,6 +132,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `pageSize` (integer, 선택사항): 페이지당 반환할 프레젠테이션 수.- `pageToken` (string, 선택사항): 페이지네이션을 위한 토큰.+</Accordion><Accordion title="google_slides/delete_presentation">@@ -130,6 +140,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `presentationId` (string, 필수): 삭제할 프레젠테이션의 ID.+</Accordion></AccordionGroup>@@ -169,15 +180,22 @@ crew.kickoff()### 일반적인 문제**인증 오류**+- Google 계정이 Google Slides 및 Google Drive 액세스에 필요한 권한을 가지고 있는지 확인하세요.- OAuth 연결이 필요한 모든 범위를 포함하는지 확인하세요.**프레젠테이션/페이지 ID 문제**+- 프레젠테이션 ID와 페이지 객체 ID가 올바른지 다시 확인하세요.- 프레젠테이션이나 페이지가 존재하고 액세스할 수 있는지 확인하세요.### 도움 받기-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">- Google Slides 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의하세요.+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>+ Google Slides 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에+ 문의하세요.</Card>diff --git a/docs/ko/enterprise/integrations/hubspot.mdx b/docs/ko/enterprise/integrations/hubspot.mdxindex 1b816bb6e..5c3330b3e 100644--- a/docs/ko/enterprise/integrations/hubspot.mdx+++ b/docs/ko/enterprise/integrations/hubspot.mdx@@ -13,7 +13,7 @@ mode: "wide"HubSpot 통합을 사용하기 전에 다음을 확인하세요.-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- 적절한 권한이 있는 HubSpot 계정- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 HubSpot 계정이 연결되어 있음@@ -21,7 +21,7 @@ HubSpot 통합을 사용하기 전에 다음을 확인하세요.### 1. HubSpot 계정 연결하기-1. [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.+1. [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.2. 인증 통합 섹션에서 **HubSpot**을 찾습니다.3. **Connect**를 클릭하고 OAuth 플로우를 완료합니다.4. 회사 및 연락처 관리를 위한 필요한 권한을 부여합니다.@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -115,6 +116,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `web_technologies` (string, 선택): 사용한 웹 기술. 미리 정의된 값 중 하나여야 합니다.- `website` (string, 선택): 웹사이트 URL.- `founded_year` (string, 선택): 설립 연도.+</Accordion><Accordion title="hubspot/create_contact">@@ -214,6 +216,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `hs_whatsapp_phone_number` (string, 선택): WhatsApp 전화번호.- `work_email` (string, 선택): 업무용 이메일.- `hs_googleplusid` (string, 선택): googleplus ID.+</Accordion><Accordion title="hubspot/create_deal">@@ -229,6 +232,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `dealtype` (string, 선택): 거래 유형. 사용 가능한 값: `newbusiness`, `existingbusiness`.- `description` (string, 선택): 거래 설명.- `hs_priority` (string, 선택): 거래 우선순위. 사용 가능한 값: `low`, `medium`, `high`.+</Accordion><Accordion title="hubspot/create_record_engagements">@@ -246,6 +250,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `hs_meeting_body` (string, 선택): 미팅 설명. (`MEETING`에서 사용)- `hs_meeting_start_time` (string, 선택): 미팅 시작 시간. (`MEETING`에서 사용)- `hs_meeting_end_time` (string, 선택): 미팅 종료 시간. (`MEETING`에서 사용)+</Accordion><Accordion title="hubspot/update_company">@@ -263,6 +268,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `numberofemployees` (number, 선택): 직원 수.- `annualrevenue` (number, 선택): 연간 매출.- `description` (string, 선택): 설명.+</Accordion><Accordion title="hubspot/create_record_any">@@ -271,6 +277,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `recordType` (string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.- 추가 파라미터는 커스텀 오브젝트의 스키마에 따라 다릅니다.+</Accordion><Accordion title="hubspot/update_contact">@@ -285,6 +292,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `company` (string, 선택): 회사명.- `jobtitle` (string, 선택): 직책.- `lifecyclestage` (string, 선택): 라이프사이클 단계.+</Accordion><Accordion title="hubspot/update_deal">@@ -298,6 +306,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `pipeline` (string, 선택): 거래가 속한 파이프라인.- `closedate` (string, 선택): 예상 마감일.- `dealtype` (string, 선택): 거래 유형.+</Accordion><Accordion title="hubspot/update_record_engagements">@@ -309,6 +318,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `hs_task_subject` (string, 선택): 작업 제목.- `hs_task_body` (string, 선택): 작업 노트.- `hs_task_status` (string, 선택): 작업 상태.+</Accordion><Accordion title="hubspot/update_record_any">@@ -318,6 +328,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `recordId` (string, 필수): 업데이트할 레코드의 ID.- `recordType` (string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.- 추가 파라미터는 커스텀 오브젝트의 스키마에 따라 다릅니다.+</Accordion><Accordion title="hubspot/list_companies">@@ -325,6 +336,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `paginationParameters` (object, 선택): 다음 페이지를 가져오려면 `pageCursor`를 사용하세요.+</Accordion><Accordion title="hubspot/list_contacts">@@ -332,6 +344,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `paginationParameters` (object, 선택): 다음 페이지를 가져오려면 `pageCursor`를 사용하세요.+</Accordion><Accordion title="hubspot/list_deals">@@ -339,6 +352,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `paginationParameters` (object, 선택): 다음 페이지를 가져오려면 `pageCursor`를 사용하세요.+</Accordion><Accordion title="hubspot/get_records_engagements">@@ -347,6 +361,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `objectName` (string, 필수): 가져올 참여 유형(예: "notes").- `paginationParameters` (object, 선택): 다음 페이지를 가져오려면 `pageCursor`를 사용하세요.+</Accordion><Accordion title="hubspot/get_records_any">@@ -355,6 +370,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `recordType` (string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.- `paginationParameters` (object, 선택): 다음 페이지를 가져오려면 `pageCursor`를 사용하세요.+</Accordion><Accordion title="hubspot/get_company">@@ -362,6 +378,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `recordId` (string, 필수): 가져올 회사의 ID.+</Accordion><Accordion title="hubspot/get_contact">@@ -369,6 +386,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `recordId` (string, 필수): 가져올 연락처의 ID.+</Accordion><Accordion title="hubspot/get_deal">@@ -376,6 +394,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `recordId` (string, 필수): 가져올 거래의 ID.+</Accordion><Accordion title="hubspot/get_record_by_id_engagements">@@ -383,6 +402,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `recordId` (string, 필수): 가져올 참여의 ID.+</Accordion><Accordion title="hubspot/get_record_by_id_any">@@ -391,6 +411,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `recordType` (string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.- `recordId` (string, 필수): 가져올 레코드의 ID.+</Accordion><Accordion title="hubspot/search_companies">@@ -399,6 +420,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `filterFormula` (object, 선택): 분리 정규형(OR of ANDs) 필터.- `paginationParameters` (object, 선택): 다음 페이지를 가져오려면 `pageCursor`를 사용하세요.+</Accordion><Accordion title="hubspot/search_contacts">@@ -407,6 +429,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `filterFormula` (object, 선택): 분리 정규형(OR of ANDs) 필터.- `paginationParameters` (object, 선택): 다음 페이지를 가져오려면 `pageCursor`를 사용하세요.+</Accordion><Accordion title="hubspot/search_deals">@@ -415,6 +438,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `filterFormula` (object, 선택): 분리 정규형(OR of ANDs) 필터.- `paginationParameters` (object, 선택): 다음 페이지를 가져오려면 `pageCursor`를 사용하세요.+</Accordion><Accordion title="hubspot/search_records_engagements">@@ -423,6 +447,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `engagementFilterFormula` (object, 선택): 참여 필터.- `paginationParameters` (object, 선택): 다음 페이지를 가져오려면 `pageCursor`를 사용하세요.+</Accordion><Accordion title="hubspot/search_records_any">@@ -432,6 +457,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `recordType` (string, 필수): 검색할 오브젝트 타입 ID.- `filterFormula` (string, 선택): 적용할 필터 수식.- `paginationParameters` (object, 선택): 다음 페이지를 가져오려면 `pageCursor`를 사용하세요.+</Accordion><Accordion title="hubspot/delete_record_companies">@@ -439,6 +465,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `recordId` (string, 필수): 삭제할 회사의 ID.+</Accordion><Accordion title="hubspot/delete_record_contacts">@@ -446,6 +473,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `recordId` (string, 필수): 삭제할 연락처의 ID.+</Accordion><Accordion title="hubspot/delete_record_deals">@@ -453,6 +481,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `recordId` (string, 필수): 삭제할 거래의 ID.+</Accordion><Accordion title="hubspot/delete_record_engagements">@@ -460,6 +489,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `recordId` (string, 필수): 삭제할 참여의 ID.+</Accordion><Accordion title="hubspot/delete_record_any">@@ -468,6 +498,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `recordType` (string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.- `recordId` (string, 필수): 삭제할 레코드의 ID.+</Accordion><Accordion title="hubspot/get_contacts_by_list_id">@@ -476,6 +507,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `listId` (string, 필수): 연락처를 가져올 리스트의 ID.- `paginationParameters` (object, 선택): 이후 페이지를 위해 `pageCursor` 사용.+</Accordion><Accordion title="hubspot/describe_action_schema">@@ -484,6 +516,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `recordType` (string, 필수): 오브젝트 타입 ID(예: 'companies').- `operation` (string, 필수): 작업 유형(예: 'CREATE_RECORD').+</Accordion></AccordionGroup>@@ -577,6 +610,10 @@ crew.kickoff()### 도움 받기-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>HubSpot 연동 설정 또는 문제 해결에 도움이 필요하시면 지원팀에 문의해 주세요.</Card>diff --git a/docs/ko/enterprise/integrations/jira.mdx b/docs/ko/enterprise/integrations/jira.mdxindex 85050d10a..dc25b63e0 100644--- a/docs/ko/enterprise/integrations/jira.mdx+++ b/docs/ko/enterprise/integrations/jira.mdx@@ -13,7 +13,7 @@ mode: "wide"Jira 통합을 사용하기 전에 다음을 준비하세요:-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- 적절한 프로젝트 권한이 있는 Jira 계정- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Jira 계정 연결@@ -21,7 +21,7 @@ Jira 통합을 사용하기 전에 다음을 준비하세요:### 1. Jira 계정 연결하기-1. [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.+1. [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.2. **Jira**를 인증 통합 섹션에서 찾습니다.3. **Connect**를 클릭하고 OAuth 절차를 완료합니다.4. 이슈 및 프로젝트 관리를 위한 필요한 권한을 부여합니다.@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -70,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"customfield_10001": "value"}```+</Accordion><Accordion title="jira/update_issue">@@ -85,6 +87,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- 옵션: `description`, `descriptionJSON`- `description` (string, 선택): 설명 - 이슈에 대한 자세한 설명입니다. 이 필드는 'descriptionType'이 'description'일 때만 나타납니다.- `additionalFields` (string, 선택): 추가 필드 - 포함해야 하는 다른 필드를 JSON 형식으로 지정하세요.+</Accordion><Accordion title="jira/get_issue_by_key">@@ -92,6 +95,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `issueKey` (string, 필수): 이슈 키 (예시: "TEST-1234").+</Accordion><Accordion title="jira/filter_issues">@@ -118,6 +122,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token```사용 가능한 연산자: `$stringExactlyMatches`, `$stringDoesNotExactlyMatch`, `$stringIsIn`, `$stringIsNotIn`, `$stringContains`, `$stringDoesNotContain`, `$stringGreaterThan`, `$stringLessThan`- `limit` (string, 선택): 결과 제한 - 반환되는 최대 이슈 수를 제한합니다. 입력하지 않으면 기본값은 10입니다.+</Accordion><Accordion title="jira/search_by_jql">@@ -131,12 +136,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"pageCursor": "cursor_string"}```+</Accordion><Accordion title="jira/update_issue_any">**설명:** Jira에서 임의의 이슈를 업데이트합니다. 이 기능의 속성 스키마를 얻으려면 DESCRIBE_ACTION_SCHEMA를 사용하세요.**파라미터:** 특정 파라미터 없음 - 예상 스키마를 먼저 확인하려면 JIRA_DESCRIBE_ACTION_SCHEMA를 사용하세요.+</Accordion><Accordion title="jira/describe_action_schema">@@ -146,6 +153,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `issueTypeId` (string, 필수): 이슈 유형 ID.- `projectKey` (string, 필수): 프로젝트 키.- `operation` (string, 필수): 작업 유형 값(예: CREATE_ISSUE 또는 UPDATE_ISSUE).+</Accordion><Accordion title="jira/get_projects">@@ -158,6 +166,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"pageCursor": "cursor_string"}```+</Accordion><Accordion title="jira/get_issue_types_by_project">@@ -165,12 +174,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `project` (string, 필수): 프로젝트 키.+</Accordion><Accordion title="jira/get_issue_types">**설명:** Jira에서 모든 이슈 유형을 조회합니다.**파라미터:** 필요 없음.+</Accordion><Accordion title="jira/get_issue_status_by_project">@@ -178,6 +189,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `project` (string, 필수): 프로젝트 키.+</Accordion><Accordion title="jira/get_all_assignees_by_project">@@ -185,6 +197,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `project` (string, 필수): 프로젝트 키.+</Accordion></AccordionGroup>@@ -347,37 +360,48 @@ crew.kickoff()### 일반적인 문제**권한 오류**+- Jira 계정이 대상 프로젝트에 필요한 권한을 가지고 있는지 확인하세요- OAuth 연결에 Jira API에 필요한 범위가 포함되어 있는지 확인하세요- 지정된 프로젝트에서 이슈 생성/편집 권한이 있는지 확인하세요**잘못된 프로젝트 또는 이슈 키**+- 프로젝트 키와 이슈 키가 올바른 형식(예: "PROJ-123")인지 다시 확인하세요- 프로젝트가 존재하며 계정으로 접근 가능한지 확인하세요- 이슈 키가 실제로 존재하는 이슈를 참조하는지 확인하세요**이슈 유형 및 상태 관련 문제**+- 프로젝트에 대한 유효한 이슈 유형을 얻으려면 JIRA_GET_ISSUE_TYPES_BY_PROJECT를 사용하세요- 유효한 상태를 얻으려면 JIRA_GET_ISSUE_STATUS_BY_PROJECT를 사용하세요- 이슈 유형과 상태가 대상 프로젝트에 제공되는지 확인하세요**JQL 쿼리 문제**+- API 호출에 사용하기 전에 Jira의 이슈 검색에서 JQL 쿼리를 테스트하세요- JQL에 사용된 필드명이 정확하게 철자되어 있고, Jira 인스턴스에 존재하는지 확인하세요- 복잡한 쿼리에는 올바른 JQL 문법을 사용하세요**커스텀 필드 및 스키마 문제**+- 복잡한 이슈 유형에 대해 올바른 스키마를 얻으려면 JIRA_DESCRIBE_ACTION_SCHEMA를 사용하세요- 커스텀 필드 ID가 정확한지 확인하세요 (예: "customfield_10001")- 커스텀 필드가 대상 프로젝트와 이슈 유형에서 사용 가능한지 확인하세요**필터 공식 문제**+- 필터 공식이 올바른 JSON 구조(불리언 합의 정규형)를 따르는지 확인하세요- Jira 구성에 존재하는 유효한 필드명을 사용하세요- 복잡한 다중 조건 쿼리를 만들기 전에 간단한 필터를 테스트하세요### 도움 받기-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">- Jira 연동 설정 또는 문제 해결에 대한 지원이 필요하시면 저희 지원팀에 문의하십시오.+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>+ Jira 연동 설정 또는 문제 해결에 대한 지원이 필요하시면 저희 지원팀에+ 문의하십시오.</Card>diff --git a/docs/ko/enterprise/integrations/linear.mdx b/docs/ko/enterprise/integrations/linear.mdxindex 34eae324a..a728d3858 100644--- a/docs/ko/enterprise/integrations/linear.mdx+++ b/docs/ko/enterprise/integrations/linear.mdx@@ -13,7 +13,7 @@ mode: "wide"Linear 통합을 사용하기 전에 다음을 확인하세요:-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- 적절한 워크스페이스 권한이 있는 Linear 계정- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)에서 Linear 계정 연결@@ -21,7 +21,7 @@ Linear 통합을 사용하기 전에 다음을 확인하세요:### 1. Linear 계정 연결하기-1. [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.+1. [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.2. 인증 통합( Authentication Integrations ) 섹션에서 **Linear**를 찾습니다.3. **Connect**를 클릭하고 OAuth 절차를 완료합니다.4. 이슈 및 프로젝트 관리를 위한 필수 권한을 부여합니다.@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -70,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"labelIds": ["a70bdf0f-530a-4887-857d-46151b52b47c"]}```+</Accordion><Accordion title="linear/update_issue">@@ -90,6 +92,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"labelIds": ["a70bdf0f-530a-4887-857d-46151b52b47c"]}```+</Accordion><Accordion title="linear/get_issue_by_id">@@ -97,6 +100,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `issueId` (string, 필수): 이슈 ID - 가져올 이슈의 레코드 ID를 지정합니다. (예: "90fbc706-18cd-42c9-ae66-6bd344cc8977").+</Accordion><Accordion title="linear/get_issue_by_issue_identifier">@@ -104,6 +108,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `externalId` (string, 필수): 외부 ID - 가져올 이슈의 사람이 읽을 수 있는 이슈 식별자를 지정합니다. (예: "ABC-1").+</Accordion><Accordion title="linear/search_issue">@@ -131,6 +136,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token```사용 가능한 필드: `title`, `number`, `project`, `createdAt`사용 가능한 연산자: `$stringExactlyMatches`, `$stringDoesNotExactlyMatch`, `$stringIsIn`, `$stringIsNotIn`, `$stringStartsWith`, `$stringDoesNotStartWith`, `$stringEndsWith`, `$stringDoesNotEndWith`, `$stringContains`, `$stringDoesNotContain`, `$stringGreaterThan`, `$stringLessThan`, `$numberGreaterThanOrEqualTo`, `$numberLessThanOrEqualTo`, `$numberGreaterThan`, `$numberLessThan`, `$dateTimeAfter`, `$dateTimeBefore`+</Accordion><Accordion title="linear/delete_issue">@@ -138,6 +144,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `issueId` (string, 필수): 이슈 ID - 삭제할 이슈의 레코드 ID를 지정합니다. (예: "90fbc706-18cd-42c9-ae66-6bd344cc8977").+</Accordion><Accordion title="linear/archive_issue">@@ -145,6 +152,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `issueId` (string, 필수): 이슈 ID - 아카이브할 이슈의 레코드 ID를 지정합니다. (예: "90fbc706-18cd-42c9-ae66-6bd344cc8977").+</Accordion><Accordion title="linear/create_sub_issue">@@ -161,6 +169,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"lead": "linear_user_id"}```+</Accordion><Accordion title="linear/create_project">@@ -183,6 +192,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"description": ""}```+</Accordion><Accordion title="linear/update_project">@@ -199,6 +209,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token"description": ""}```+</Accordion><Accordion title="linear/get_project_by_id">@@ -206,6 +217,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `projectId` (string, 필수): 프로젝트 ID - 가져올 프로젝트의 프로젝트 ID를 지정합니다. (예: "a6634484-6061-4ac7-9739-7dc5e52c796b").+</Accordion><Accordion title="linear/delete_project">@@ -213,6 +225,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `projectId` (string, 필수): 프로젝트 ID - 삭제할 프로젝트의 프로젝트 ID를 지정합니다. (예: "a6634484-6061-4ac7-9739-7dc5e52c796b").+</Accordion><Accordion title="linear/search_teams">@@ -238,6 +251,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token}```사용 가능한 필드: `id`, `name`+</Accordion></AccordionGroup>@@ -400,43 +414,54 @@ crew.kickoff()### 일반적인 문제**권한 오류**+- Linear 계정이 대상 워크스페이스에 필요한 권한을 가지고 있는지 확인하세요- OAuth 연결에 Linear API에 필요한 스코프가 포함되어 있는지 확인하세요- 워크스페이스에서 이슈 및 프로젝트를 생성/편집할 권한이 있는지 확인하세요**잘못된 ID 및 참조**+- 팀 ID, 이슈 ID, 프로젝트 ID가 올바른 UUID 형식인지 다시 한번 확인하세요- 참조된 엔티티(팀, 프로젝트, 사이클)가 존재하며 접근 가능한지 확인하세요- 이슈 식별자가 올바른 형식(예: "ABC-1")을 따르는지 검증하세요**팀 및 프로젝트 연관 문제**+- 이슈나 프로젝트를 생성하기 전에 LINEAR_SEARCH_TEAMS를 사용하여 유효한 팀 ID를 조회하세요- 워크스페이스 내에 팀이 존재하고 활성화되어 있는지 확인하세요- 팀 ID가 올바르게 UUID 형식으로 구성되어 있는지 검증하세요**이슈 상태 및 우선순위 문제**+- 상태 ID가 팀의 유효한 워크플로우 상태를 참조하는지 확인하세요- 우선순위 값이 Linear 구성에서 허용된 범위 내에 있는지 확인하세요- 참조하기 전에 사용자 지정 필드와 라벨이 존재하는지 검증하세요**날짜 및 시간 형식 문제**+- 마감일 및 타임스탬프에 ISO 8601 형식을 사용하세요- 마감일 계산 시 타임존을 올바로 처리하는지 확인하세요- 마감일의 날짜 값이 유효하며 미래인지 검증하세요**검색 및 필터 문제**+- 검색 쿼리가 올바르게 형식화되어 있으며 비어 있지 않은지 확인하세요- 필터 공식에서 유효한 필드 이름을 사용하세요: `title`, `number`, `project`, `createdAt`- 복잡한 다중 조건 쿼리를 만들기 전에 단순한 필터를 먼저 테스트해 보세요- 연산자 타입이 필터링 대상 필드의 데이터 타입과 일치하는지 확인하세요**서브이슈 생성 문제**+- 상위 이슈 ID가 유효하고 접근 가능한지 확인하세요- 서브이슈의 팀 ID가 상위 이슈 팀과 일치하거나 호환되는지 검증하세요- 상위 이슈가 이미 보관/삭제되지 않았는지 확인하세요### 도움 받기-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>Linear 연동 설정 또는 문제 해결에 대해 지원팀에 문의하세요.</Card>diff --git a/docs/ko/enterprise/integrations/microsoft_excel.mdx b/docs/ko/enterprise/integrations/microsoft_excel.mdxindex 37c375d2f..41707ef66 100644--- a/docs/ko/enterprise/integrations/microsoft_excel.mdx+++ b/docs/ko/enterprise/integrations/microsoft_excel.mdx@@ -13,7 +13,7 @@ mode: "wide"Microsoft Excel 통합을 사용하기 전에 다음 사항을 확인하세요:-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- Excel 및 OneDrive/SharePoint 액세스 권한이 있는 Microsoft 365 계정- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Microsoft 계정 연결@@ -21,7 +21,7 @@ Microsoft Excel 통합을 사용하기 전에 다음 사항을 확인하세요:### 1. Microsoft 계정 연결-1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동+1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동2. 인증 통합 섹션에서 **Microsoft Excel** 찾기3. **연결**을 클릭하고 OAuth 플로우 완료4. 파일 및 Excel 통합 문서 액세스에 필요한 권한 부여@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -58,6 +59,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `file_path` (string, 필수): 통합 문서를 만들 경로 (예: 'MyWorkbook.xlsx')- `worksheets` (array, 선택사항): 만들 초기 워크시트들. 각 항목은 `name` (string, 워크시트 이름)이 있는 객체.+</Accordion><Accordion title="microsoft_excel/get_workbooks">@@ -69,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `expand` (string, 선택사항): 관련 리소스를 인라인으로 확장.- `top` (integer, 선택사항): 반환할 항목 수 (최소 1, 최대 999).- `orderby` (string, 선택사항): 지정된 속성으로 결과 정렬.+</Accordion><Accordion title="microsoft_excel/get_worksheets">@@ -81,6 +84,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `expand` (string, 선택사항): 관련 리소스를 인라인으로 확장.- `top` (integer, 선택사항): 반환할 항목 수 (최소 1, 최대 999).- `orderby` (string, 선택사항): 지정된 속성으로 결과 정렬.+</Accordion><Accordion title="microsoft_excel/create_worksheet">@@ -89,6 +93,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `file_id` (string, 필수): Excel 파일의 ID.- `name` (string, 필수): 새 워크시트의 이름.+</Accordion><Accordion title="microsoft_excel/get_range_data">@@ -98,6 +103,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `file_id` (string, 필수): Excel 파일의 ID.- `worksheet_name` (string, 필수): 워크시트의 이름.- `range` (string, 필수): 범위 주소 (예: 'A1:C10').+</Accordion><Accordion title="microsoft_excel/update_range_data">@@ -108,6 +114,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `worksheet_name` (string, 필수): 워크시트의 이름.- `range` (string, 필수): 범위 주소 (예: 'A1:C10').- `values` (array, 필수): 범위에 설정할 값들의 2D 배열. 각 내부 배열은 행을 나타내며, 요소는 string, number 또는 integer일 수 있음.+</Accordion><Accordion title="microsoft_excel/add_table">@@ -118,6 +125,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `worksheet_name` (string, 필수): 워크시트의 이름.- `range` (string, 필수): 테이블의 범위 (예: 'A1:D10').- `has_headers` (boolean, 선택사항): 첫 번째 행이 헤더를 포함하는지 여부. 기본값: true.+</Accordion><Accordion title="microsoft_excel/get_tables">@@ -126,6 +134,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `file_id` (string, 필수): Excel 파일의 ID.- `worksheet_name` (string, 필수): 워크시트의 이름.+</Accordion><Accordion title="microsoft_excel/add_table_row">@@ -136,6 +145,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `worksheet_name` (string, 필수): 워크시트의 이름.- `table_name` (string, 필수): 테이블의 이름.- `values` (array, 필수): 새 행의 값들 배열. 요소는 string, number 또는 integer일 수 있음.+</Accordion><Accordion title="microsoft_excel/create_chart">@@ -147,6 +157,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `chart_type` (string, 필수): 차트 유형 (예: 'ColumnClustered', 'Line', 'Pie').- `source_data` (string, 필수): 차트의 데이터 범위 (예: 'A1:B10').- `series_by` (string, 선택사항): 데이터 해석 방법 ('Auto', 'Columns' 또는 'Rows'). 기본값: 'Auto'.+</Accordion><Accordion title="microsoft_excel/get_cell">@@ -157,6 +168,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `worksheet_name` (string, 필수): 워크시트의 이름.- `row` (integer, 필수): 행 번호 (0 기반).- `column` (integer, 필수): 열 번호 (0 기반).+</Accordion><Accordion title="microsoft_excel/get_used_range">@@ -165,6 +177,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `file_id` (string, 필수): Excel 파일의 ID.- `worksheet_name` (string, 필수): 워크시트의 이름.+</Accordion><Accordion title="microsoft_excel/list_charts">@@ -173,6 +186,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `file_id` (string, 필수): Excel 파일의 ID.- `worksheet_name` (string, 필수): 워크시트의 이름.+</Accordion><Accordion title="microsoft_excel/delete_worksheet">@@ -181,6 +195,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `file_id` (string, 필수): Excel 파일의 ID.- `worksheet_name` (string, 필수): 삭제할 워크시트의 이름.+</Accordion><Accordion title="microsoft_excel/delete_table">@@ -190,6 +205,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `file_id` (string, 필수): Excel 파일의 ID.- `worksheet_name` (string, 필수): 워크시트의 이름.- `table_name` (string, 필수): 삭제할 테이블의 이름.+</Accordion><Accordion title="microsoft_excel/list_names">@@ -197,6 +213,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `file_id` (string, 필수): Excel 파일의 ID.+</Accordion></AccordionGroup>@@ -236,15 +253,22 @@ crew.kickoff()### 일반적인 문제**인증 오류**+- Microsoft 계정이 파일 액세스에 필요한 권한을 가지고 있는지 확인하세요 (예: `Files.Read.All`, `Files.ReadWrite.All`).- OAuth 연결이 필요한 모든 범위를 포함하는지 확인하세요.**파일 생성 문제**+- 통합 문서를 만들 때 `file_path`가 `.xlsx` 확장자로 끝나는지 확인하세요.- 대상 위치(OneDrive/SharePoint)에 쓰기 권한이 있는지 확인하세요.### 도움 받기-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">- Microsoft Excel 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의하세요.+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>+ Microsoft Excel 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에+ 문의하세요.</Card>diff --git a/docs/ko/enterprise/integrations/microsoft_onedrive.mdx b/docs/ko/enterprise/integrations/microsoft_onedrive.mdxindex 4c49c73bb..4d8bc2273 100644--- a/docs/ko/enterprise/integrations/microsoft_onedrive.mdx+++ b/docs/ko/enterprise/integrations/microsoft_onedrive.mdx@@ -13,7 +13,7 @@ mode: "wide"Microsoft OneDrive 통합을 사용하기 전에 다음 사항을 확인하세요:-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- OneDrive 액세스 권한이 있는 Microsoft 계정- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Microsoft 계정 연결@@ -21,7 +21,7 @@ Microsoft OneDrive 통합을 사용하기 전에 다음 사항을 확인하세### 1. Microsoft 계정 연결-1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동+1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동2. 인증 통합 섹션에서 **Microsoft OneDrive** 찾기3. **연결**을 클릭하고 OAuth 플로우 완료4. 파일 액세스에 필요한 권한 부여@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -59,6 +60,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `top` (integer, 선택사항): 검색할 항목 수 (최대 1000). 기본값: 50.- `orderby` (string, 선택사항): 필드별 정렬 (예: "name asc", "lastModifiedDateTime desc"). 기본값: "name asc".- `filter` (string, 선택사항): OData 필터 표현식.+</Accordion><Accordion title="microsoft_onedrive/get_file_info">@@ -66,6 +68,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `item_id` (string, 필수): 파일 또는 폴더의 ID.+</Accordion><Accordion title="microsoft_onedrive/download_file">@@ -73,6 +76,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `item_id` (string, 필수): 다운로드할 파일의 ID.+</Accordion><Accordion title="microsoft_onedrive/upload_file">@@ -81,6 +85,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `file_name` (string, 필수): 업로드할 파일의 이름.- `content` (string, 필수): Base64로 인코딩된 파일 내용.+</Accordion><Accordion title="microsoft_onedrive/create_folder">@@ -88,6 +93,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `folder_name` (string, 필수): 만들 폴더의 이름.+</Accordion><Accordion title="microsoft_onedrive/delete_item">@@ -95,6 +101,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `item_id` (string, 필수): 삭제할 파일 또는 폴더의 ID.+</Accordion><Accordion title="microsoft_onedrive/copy_item">@@ -104,6 +111,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `item_id` (string, 필수): 복사할 파일 또는 폴더의 ID.- `parent_id` (string, 선택사항): 대상 폴더의 ID (선택사항, 기본값은 루트).- `new_name` (string, 선택사항): 복사된 항목의 새 이름 (선택사항).+</Accordion><Accordion title="microsoft_onedrive/move_item">@@ -113,6 +121,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `item_id` (string, 필수): 이동할 파일 또는 폴더의 ID.- `parent_id` (string, 필수): 대상 폴더의 ID.- `new_name` (string, 선택사항): 항목의 새 이름 (선택사항).+</Accordion><Accordion title="microsoft_onedrive/search_files">@@ -121,6 +130,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `query` (string, 필수): 검색 쿼리 문자열.- `top` (integer, 선택사항): 반환할 결과 수 (최대 1000). 기본값: 50.+</Accordion><Accordion title="microsoft_onedrive/share_item">@@ -130,6 +140,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `item_id` (string, 필수): 공유할 파일 또는 폴더의 ID.- `type` (string, 선택사항): 공유 링크 유형. 옵션: view, edit, embed. 기본값: view.- `scope` (string, 선택사항): 공유 링크 범위. 옵션: anonymous, organization. 기본값: anonymous.+</Accordion><Accordion title="microsoft_onedrive/get_thumbnails">@@ -137,6 +148,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `item_id` (string, 필수): 파일의 ID.+</Accordion></AccordionGroup>@@ -176,15 +188,22 @@ crew.kickoff()### 일반적인 문제**인증 오류**+- Microsoft 계정이 파일 액세스에 필요한 권한을 가지고 있는지 확인하세요 (예: `Files.Read`, `Files.ReadWrite`).- OAuth 연결이 필요한 모든 범위를 포함하는지 확인하세요.**파일 업로드 문제**+- 파일 업로드 시 `file_name`과 `content`가 제공되는지 확인하세요.- 바이너리 파일의 경우 내용이 Base64로 인코딩되어야 합니다.### 도움 받기-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">- Microsoft OneDrive 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의하세요.+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>+ Microsoft OneDrive 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에+ 문의하세요.</Card>diff --git a/docs/ko/enterprise/integrations/microsoft_outlook.mdx b/docs/ko/enterprise/integrations/microsoft_outlook.mdxindex 355072f75..661b55ceb 100644--- a/docs/ko/enterprise/integrations/microsoft_outlook.mdx+++ b/docs/ko/enterprise/integrations/microsoft_outlook.mdx@@ -13,7 +13,7 @@ mode: "wide"Microsoft Outlook 통합을 사용하기 전에 다음 사항을 확인하세요:-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- Outlook 액세스 권한이 있는 Microsoft 계정- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Microsoft 계정 연결@@ -21,7 +21,7 @@ Microsoft Outlook 통합을 사용하기 전에 다음 사항을 확인하세요### 1. Microsoft 계정 연결-1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동+1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동2. 인증 통합 섹션에서 **Microsoft Outlook** 찾기3. **연결**을 클릭하고 OAuth 플로우 완료4. 이메일, 캘린더 및 연락처 액세스에 필요한 권한 부여@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -62,6 +63,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `orderby` (string, 선택사항): 필드별 정렬 (예: "receivedDateTime desc"). 기본값: "receivedDateTime desc".- `select` (string, 선택사항): 반환할 특정 속성 선택.- `expand` (string, 선택사항): 관련 리소스를 인라인으로 확장.+</Accordion><Accordion title="microsoft_outlook/send_email">@@ -77,6 +79,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `importance` (string, 선택사항): 메시지 중요도 수준. 옵션: low, normal, high. 기본값: normal.- `reply_to` (array, 선택사항): 회신용 이메일 주소 배열.- `save_to_sent_items` (boolean, 선택사항): 보낸 편지함 폴더에 메시지를 저장할지 여부. 기본값: true.+</Accordion><Accordion title="microsoft_outlook/get_calendar_events">@@ -87,6 +90,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `skip` (integer, 선택사항): 건너뛸 이벤트 수. 기본값: 0.- `filter` (string, 선택사항): OData 필터 표현식 (예: "start/dateTime ge '2024-01-01T00:00:00Z'").- `orderby` (string, 선택사항): 필드별 정렬 (예: "start/dateTime asc"). 기본값: "start/dateTime asc".+</Accordion><Accordion title="microsoft_outlook/create_calendar_event">@@ -100,6 +104,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `timezone` (string, 선택사항): 시간대 (예: 'Pacific Standard Time'). 기본값: UTC.- `location` (string, 선택사항): 이벤트 위치.- `attendees` (array, 선택사항): 참석자의 이메일 주소 배열.+</Accordion><Accordion title="microsoft_outlook/get_contacts">@@ -110,6 +115,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `skip` (integer, 선택사항): 건너뛸 연락처 수. 기본값: 0.- `filter` (string, 선택사항): OData 필터 표현식.- `orderby` (string, 선택사항): 필드별 정렬 (예: "displayName asc"). 기본값: "displayName asc".+</Accordion><Accordion title="microsoft_outlook/create_contact">@@ -124,6 +130,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `homePhones` (array, 선택사항): 집 전화번호 배열.- `jobTitle` (string, 선택사항): 연락처의 직책.- `companyName` (string, 선택사항): 연락처의 회사 이름.+</Accordion></AccordionGroup>@@ -163,15 +170,22 @@ crew.kickoff()### 일반적인 문제**인증 오류**+- Microsoft 계정이 이메일, 캘린더 및 연락처 액세스에 필요한 권한을 가지고 있는지 확인하세요.- 필요한 범위: `Mail.Read`, `Mail.Send`, `Calendars.Read`, `Calendars.ReadWrite`, `Contacts.Read`, `Contacts.ReadWrite`.**이메일 보내기 문제**+- `send_email`에 `to_recipients`, `subject`, `body`가 제공되는지 확인하세요.- 이메일 주소가 올바르게 형식화되어 있는지 확인하세요.### 도움 받기-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">- Microsoft Outlook 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의하세요.+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>+ Microsoft Outlook 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에+ 문의하세요.</Card>diff --git a/docs/ko/enterprise/integrations/microsoft_sharepoint.mdx b/docs/ko/enterprise/integrations/microsoft_sharepoint.mdxindex f9e57a56e..e7de84c41 100644--- a/docs/ko/enterprise/integrations/microsoft_sharepoint.mdx+++ b/docs/ko/enterprise/integrations/microsoft_sharepoint.mdx@@ -13,7 +13,7 @@ mode: "wide"Microsoft SharePoint 통합을 사용하기 전에 다음 사항을 확인하세요:-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- SharePoint 액세스 권한이 있는 Microsoft 계정- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Microsoft 계정 연결@@ -21,7 +21,7 @@ Microsoft SharePoint 통합을 사용하기 전에 다음 사항을 확인하세### 1. Microsoft 계정 연결-1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동+1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동2. 인증 통합 섹션에서 **Microsoft SharePoint** 찾기3. **연결**을 클릭하고 OAuth 플로우 완료4. SharePoint 사이트 및 파일 액세스에 필요한 권한 부여@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -63,6 +64,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `top` (integer, 선택사항): 반환할 항목 수 (최소 1, 최대 999).- `skip` (integer, 선택사항): 건너뛸 항목 수 (최소 0).- `orderby` (string, 선택사항): 지정된 속성으로 결과 정렬 (예: 'displayName desc').+</Accordion><Accordion title="microsoft_sharepoint/get_site">@@ -72,6 +74,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `site_id` (string, 필수): SharePoint 사이트의 ID.- `select` (string, 선택사항): 반환할 특정 속성 선택 (예: 'displayName,id,webUrl,drives').- `expand` (string, 선택사항): 관련 리소스를 인라인으로 확장 (예: 'drives,lists').+</Accordion><Accordion title="microsoft_sharepoint/get_site_lists">@@ -79,6 +82,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `site_id` (string, 필수): SharePoint 사이트의 ID.+</Accordion><Accordion title="microsoft_sharepoint/get_list">@@ -87,6 +91,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `site_id` (string, 필수): SharePoint 사이트의 ID.- `list_id` (string, 필수): 목록의 ID.+</Accordion><Accordion title="microsoft_sharepoint/get_list_items">@@ -96,6 +101,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `site_id` (string, 필수): SharePoint 사이트의 ID.- `list_id` (string, 필수): 목록의 ID.- `expand` (string, 선택사항): 관련 데이터 확장 (예: 'fields').+</Accordion><Accordion title="microsoft_sharepoint/create_list_item">@@ -105,6 +111,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `site_id` (string, 필수): SharePoint 사이트의 ID.- `list_id` (string, 필수): 목록의 ID.- `fields` (object, 필수): 새 항목의 필드 값.+</Accordion><Accordion title="microsoft_sharepoint/update_list_item">@@ -115,6 +122,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `list_id` (string, 필수): 목록의 ID.- `item_id` (string, 필수): 업데이트할 항목의 ID.- `fields` (object, 필수): 업데이트할 필드 값.+</Accordion><Accordion title="microsoft_sharepoint/delete_list_item">@@ -124,6 +132,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `site_id` (string, 필수): SharePoint 사이트의 ID.- `list_id` (string, 필수): 목록의 ID.- `item_id` (string, 필수): 삭제할 항목의 ID.+</Accordion><Accordion title="microsoft_sharepoint/upload_file_to_library">@@ -133,6 +142,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `site_id` (string, 필수): SharePoint 사이트의 ID.- `file_path` (string, 필수): 파일을 업로드할 경로 (예: 'folder/fileName.txt').- `content` (string, 필수): 업로드할 파일의 내용.+</Accordion><Accordion title="microsoft_sharepoint/get_drive_items">@@ -140,6 +150,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `site_id` (string, 필수): SharePoint 사이트의 ID.+</Accordion><Accordion title="microsoft_sharepoint/delete_drive_item">@@ -148,6 +159,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `site_id` (string, 필수): SharePoint 사이트의 ID.- `item_id` (string, 필수): 삭제할 파일 또는 폴더의 ID.+</Accordion></AccordionGroup>@@ -187,15 +199,22 @@ crew.kickoff()### 일반적인 문제**인증 오류**+- Microsoft 계정이 SharePoint 액세스에 필요한 권한을 가지고 있는지 확인하세요 (예: `Sites.Read.All`, `Sites.ReadWrite.All`).- OAuth 연결이 필요한 모든 범위를 포함하는지 확인하세요.**사이트/목록/항목 ID 문제**+- 사이트, 목록, 항목 ID가 올바른지 다시 확인하세요.- 참조된 리소스가 존재하고 액세스할 수 있는지 확인하세요.### 도움 받기-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">- Microsoft SharePoint 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의하세요.+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>+ Microsoft SharePoint 통합 설정 또는 문제 해결에 대한 지원이 필요하시면+ 지원팀에 문의하세요.</Card>diff --git a/docs/ko/enterprise/integrations/microsoft_teams.mdx b/docs/ko/enterprise/integrations/microsoft_teams.mdxindex 68a8b45bf..338bd94be 100644--- a/docs/ko/enterprise/integrations/microsoft_teams.mdx+++ b/docs/ko/enterprise/integrations/microsoft_teams.mdx@@ -13,7 +13,7 @@ mode: "wide"Microsoft Teams 통합을 사용하기 전에 다음 사항을 확인하세요:-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- Teams 액세스 권한이 있는 Microsoft 계정- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Microsoft 계정 연결@@ -21,7 +21,7 @@ Microsoft Teams 통합을 사용하기 전에 다음 사항을 확인하세요:### 1. Microsoft 계정 연결-1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동+1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동2. 인증 통합 섹션에서 **Microsoft Teams** 찾기3. **연결**을 클릭하고 OAuth 플로우 완료4. Teams 액세스에 필요한 권한 부여@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -57,6 +58,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- 매개변수가 필요하지 않습니다.+</Accordion><Accordion title="microsoft_teams/get_channels">@@ -64,6 +66,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `team_id` (string, 필수): 팀의 ID.+</Accordion><Accordion title="microsoft_teams/send_message">@@ -74,6 +77,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `channel_id` (string, 필수): 채널의 ID.- `message` (string, 필수): 메시지 내용.- `content_type` (string, 선택사항): 콘텐츠 유형 (html 또는 text). 옵션: html, text. 기본값: text.+</Accordion><Accordion title="microsoft_teams/get_messages">@@ -83,6 +87,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `team_id` (string, 필수): 팀의 ID.- `channel_id` (string, 필수): 채널의 ID.- `top` (integer, 선택사항): 검색할 메시지 수 (최대 50). 기본값: 20.+</Accordion><Accordion title="microsoft_teams/create_meeting">@@ -92,6 +97,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `subject` (string, 필수): 회의 제목/제목.- `startDateTime` (string, 필수): 회의 시작 시간 (시간대가 포함된 ISO 8601 형식).- `endDateTime` (string, 필수): 회의 종료 시간 (시간대가 포함된 ISO 8601 형식).+</Accordion><Accordion title="microsoft_teams/search_online_meetings_by_join_url">@@ -99,6 +105,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `join_web_url` (string, 필수): 검색할 회의의 웹 참가 URL.+</Accordion></AccordionGroup>@@ -138,15 +145,22 @@ crew.kickoff()### 일반적인 문제**인증 오류**+- Microsoft 계정이 Teams 액세스에 필요한 권한을 가지고 있는지 확인하세요.- 필요한 범위: `Team.ReadBasic.All`, `Channel.ReadBasic.All`, `ChannelMessage.Send`, `ChannelMessage.Read.All`, `OnlineMeetings.ReadWrite`, `OnlineMeetings.Read`.**팀 및 채널 액세스**+- 액세스하려는 팀의 멤버인지 확인하세요.- 팀 및 채널 ID가 올바른지 다시 확인하세요.### 도움 받기-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">- Microsoft Teams 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의하세요.+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>+ Microsoft Teams 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에+ 문의하세요.</Card>diff --git a/docs/ko/enterprise/integrations/microsoft_word.mdx b/docs/ko/enterprise/integrations/microsoft_word.mdxindex c13f486fb..8f718501b 100644--- a/docs/ko/enterprise/integrations/microsoft_word.mdx+++ b/docs/ko/enterprise/integrations/microsoft_word.mdx@@ -13,7 +13,7 @@ mode: "wide"Microsoft Word 통합을 사용하기 전에 다음 사항을 확인하세요:-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- Word 및 OneDrive/SharePoint 액세스 권한이 있는 Microsoft 계정- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Microsoft 계정 연결@@ -21,7 +21,7 @@ Microsoft Word 통합을 사용하기 전에 다음 사항을 확인하세요:### 1. Microsoft 계정 연결-1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동+1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동2. 인증 통합 섹션에서 **Microsoft Word** 찾기3. **연결**을 클릭하고 OAuth 플로우 완료4. 파일 액세스에 필요한 권한 부여@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -61,6 +62,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `expand` (string, 선택사항): 관련 리소스를 인라인으로 확장.- `top` (integer, 선택사항): 반환할 항목 수 (최소 1, 최대 999).- `orderby` (string, 선택사항): 지정된 속성으로 결과 정렬.+</Accordion><Accordion title="microsoft_word/create_text_document">@@ -69,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `file_name` (string, 필수): 텍스트 문서의 이름 (.txt로 끝나야 함).- `content` (string, 선택사항): 문서의 텍스트 내용. 기본값: "API를 통해 생성된 새 텍스트 문서입니다."+</Accordion><Accordion title="microsoft_word/get_document_content">@@ -76,6 +79,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `file_id` (string, 필수): 문서의 ID.+</Accordion><Accordion title="microsoft_word/get_document_properties">@@ -83,6 +87,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `file_id` (string, 필수): 문서의 ID.+</Accordion><Accordion title="microsoft_word/delete_document">@@ -90,6 +95,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `file_id` (string, 필수): 삭제할 문서의 ID.+</Accordion></AccordionGroup>@@ -129,15 +135,22 @@ crew.kickoff()### 일반적인 문제**인증 오류**+- Microsoft 계정이 파일 액세스에 필요한 권한을 가지고 있는지 확인하세요 (예: `Files.Read.All`, `Files.ReadWrite.All`).- OAuth 연결이 필요한 모든 범위를 포함하는지 확인하세요.**파일 생성 문제**+- 텍스트 문서를 만들 때 `file_name`이 `.txt` 확장자로 끝나는지 확인하세요.- 대상 위치(OneDrive/SharePoint)에 쓰기 권한이 있는지 확인하세요.### 도움 받기-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">- Microsoft Word 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에 문의하세요.+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>+ Microsoft Word 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 지원팀에+ 문의하세요.</Card>diff --git a/docs/ko/enterprise/integrations/notion.mdx b/docs/ko/enterprise/integrations/notion.mdxindex 66dcda50f..7015789da 100644--- a/docs/ko/enterprise/integrations/notion.mdx+++ b/docs/ko/enterprise/integrations/notion.mdx@@ -13,7 +13,7 @@ mode: "wide"Notion 통합을 사용하기 전에 다음을 확인하세요:-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- 적절한 워크스페이스 권한이 있는 Notion 계정- [통합 페이지](https://app.crewai.com/crewai_plus/connectors)를 통해 Notion 계정을 연결함@@ -21,7 +21,7 @@ Notion 통합을 사용하기 전에 다음을 확인하세요:### 1. Notion 계정 연결하기-1. [CrewAI AOP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.+1. [CrewAI AMP Integrations](https://app.crewai.com/crewai_plus/connectors)로 이동합니다.2. 인증 통합(Auhtentication Integrations) 섹션에서 **Notion**을(를) 찾습니다.3. **Connect**를 클릭하고 OAuth 플로우를 완료합니다.4. 페이지 및 데이터베이스 관리를 위한 필요한 권한을 부여합니다.@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -107,6 +108,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token}}```+</Accordion><Accordion title="notion/update_page">@@ -141,6 +143,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token}}```+</Accordion><Accordion title="notion/get_page_by_id">@@ -148,6 +151,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `pageId` (string, 필수): 페이지 ID - 가져올 페이지의 ID를 지정합니다. (예: "59833787-2cf9-4fdf-8782-e53db20768a5").+</Accordion><Accordion title="notion/archive_page">@@ -155,6 +159,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `pageId` (string, 필수): 페이지 ID - 보관할 페이지의 ID를 지정합니다. (예: "59833787-2cf9-4fdf-8782-e53db20768a5").+</Accordion><Accordion title="notion/search_pages">@@ -180,6 +185,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token}```사용 가능한 필드: `query`, `filter.value`, `direction`, `page_size`+</Accordion><Accordion title="notion/get_page_content">@@ -187,6 +193,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `blockId` (string, 필수): 페이지 ID - 해당 블록이나 페이지의 모든 자식 블록을 순서대로 가져오기 위해 Block 또는 Page ID를 지정합니다. (예: "59833787-2cf9-4fdf-8782-e53db20768a5").+</Accordion><Accordion title="notion/update_block">@@ -274,6 +281,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token}}```+</Accordion><Accordion title="notion/get_block_by_id">@@ -281,6 +289,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `blockId` (string, 필수): 블록 ID - 가져올 블록의 ID를 지정합니다. (예: "9bc30ad4-9373-46a5-84ab-0a7845ee52e6").+</Accordion><Accordion title="notion/delete_block">@@ -288,6 +297,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `blockId` (string, 필수): 블록 ID - 삭제할 블록의 ID를 지정합니다. (예: "9bc30ad4-9373-46a5-84ab-0a7845ee52e6").+</Accordion></AccordionGroup>@@ -452,47 +462,59 @@ crew.kickoff()### 일반적인 문제**권한 오류**+- Notion 계정이 대상 워크스페이스에 대한 편집 권한이 있는지 확인하세요- OAuth 연결에 Notion API에 필요한 범위가 포함되어 있는지 확인하세요- 페이지와 데이터베이스가 인증된 통합에 공유되어 있는지 확인하세요**잘못된 페이지 및 블록 ID**+- 페이지 ID 및 블록 ID가 올바른 UUID 형식인지 다시 확인하세요- 참조되는 페이지와 블록이 존재하고 접근 가능한지 확인하세요- 새 페이지를 생성할 때 상위 페이지 또는 데이터베이스 ID가 유효한지 검증하세요**속성 스키마 문제**+- 데이터베이스에 페이지를 생성할 때 페이지 속성이 데이터베이스 스키마와 일치하는지 확인하세요- 대상 데이터베이스에 대해 속성 이름과 타입이 올바른지 확인하세요- 페이지를 생성하거나 업데이트할 때 필수 속성이 포함되어 있는지 확인하세요**콘텐츠 블록 구조**+- 블록 콘텐츠가 Notion의 리치 텍스트 형식 사양을 따르는지 확인하세요- 중첩된 블록 구조가 올바르게 포맷되어 있는지 확인하세요- 미디어 URL이 접근 가능하며 올바른 형식인지 확인하세요**검색 및 필터 문제**+- 검색 쿼리가 올바르게 포맷되어 있고 비어 있지 않은지 확인하세요- 필터 공식에서 유효한 필드명을 사용하세요: `query`, `filter.value`, `direction`, `page_size`- 복잡한 필터 조건을 만들기 전에 간단한 검색을 테스트하세요**상위-하위 관계**+- 하위 페이지를 생성하기 전에 상위 페이지 또는 데이터베이스가 존재하는지 확인하세요- 상위 컨테이너에 대한 적절한 권한이 있는지 확인하세요- 데이터베이스 스키마가 설정하려는 속성을 허용하는지 확인하세요**리치 텍스트 및 미디어 콘텐츠**+- 외부 이미지, PDF, 북마크의 URL이 접근 가능한지 확인하세요- 리치 텍스트 포매팅이 Notion의 API 사양을 따르는지 확인하세요- 코드 블록의 언어 타입이 Notion에서 지원되는지 확인하세요**아카이브 및 삭제 작업**+- 아카이브(복구 가능)와 삭제(영구적)의 차이를 이해하세요- 대상 콘텐츠를 아카이브 또는 삭제할 수 있는 권한이 있는지 확인하세요- 여러 페이지 또는 블록에 영향을 줄 수 있는 대량 작업은 신중히 진행하세요### 도움 받기-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>Notion 연동 설정 또는 문제 해결에 대해 지원팀에 문의해 주세요.</Card>diff --git a/docs/ko/enterprise/integrations/salesforce.mdx b/docs/ko/enterprise/integrations/salesforce.mdxindex bf1c1dc16..51675dff6 100644--- a/docs/ko/enterprise/integrations/salesforce.mdx+++ b/docs/ko/enterprise/integrations/salesforce.mdx@@ -13,7 +13,7 @@ mode: "wide"Salesforce 통합을 사용하기 전에 다음을 확인하세요:-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- 적절한 권한이 있는 Salesforce 계정- [통합 페이지](https://app.crewai.com/integrations)를 통해 Salesforce 계정 연결@@ -21,7 +21,7 @@ Salesforce 통합을 사용하기 전에 다음을 확인하세요:### 1. Salesforce 계정 연결-1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.+1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.2. 인증 통합 섹션에서 **Salesforce**를 찾습니다.3. **연결**을 클릭하고 OAuth 과정을 완료합니다.4. CRM 및 영업 관리에 필요한 권한을 부여합니다.@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -65,6 +66,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `Title` (string, 선택): 담당자의 직함(예: CEO 또는 Vice President 등)- `Description` (string, 선택): Contact에 대한 설명- `additionalFields` (object, 선택): 사용자 정의 Contact 필드를 위한 JSON 형식의 추가 필드+</Accordion><Accordion title="salesforce/create_record_lead">@@ -81,6 +83,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `Status` (string, 선택): 리드 상태 - 리드 상태를 선택하려면 Connect Portal Workflow 설정을 사용하세요- `Description` (string, 선택): Lead에 대한 설명- `additionalFields` (object, 선택): 사용자 정의 Lead 필드를 위한 JSON 형식의 추가 필드+</Accordion><Accordion title="salesforce/create_record_opportunity">@@ -96,6 +99,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `OwnerId` (string, 선택): 이 Opportunity를 담당하는 Salesforce 사용자- `NextStep` (string, 선택): Opportunity 마감을 위한 다음 작업의 설명- `additionalFields` (object, 선택): 사용자 정의 Opportunity 필드를 위한 JSON 형식의 추가 필드+</Accordion><Accordion title="salesforce/create_record_task">@@ -114,6 +118,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `isReminderSet` (boolean, 선택): 알림 설정 여부- `reminderDateTime` (string, 선택): 알림 날짜/시간(ISO 형식)- `additionalFields` (object, 선택): 사용자 정의 Task 필드를 위한 JSON 형식의 추가 필드+</Accordion><Accordion title="salesforce/create_record_account">@@ -126,12 +131,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `Phone` (string, 선택): 전화번호- `Description` (string, 선택): Account 설명- `additionalFields` (object, 선택): 사용자 정의 Account 필드를 위한 JSON 형식의 추가 필드+</Accordion><Accordion title="salesforce/create_record_any">**설명:** Salesforce에서 모든 오브젝트 유형의 레코드를 생성합니다.**참고:** 이 기능은 사용자 정의 또는 알려지지 않은 오브젝트 유형의 레코드를 생성할 때 유연하게 사용할 수 있습니다.+</Accordion></AccordionGroup>@@ -150,6 +157,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `Title` (string, 선택): 연락처의 직함- `Description` (string, 선택): 연락처에 대한 설명- `additionalFields` (object, 선택): 커스텀 연락처 필드를 위한 JSON 형식의 추가 필드+</Accordion><Accordion title="salesforce/update_record_lead">@@ -167,6 +175,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `Status` (string, 선택): 리드 상태- `Description` (string, 선택): 리드에 대한 설명- `additionalFields` (object, 선택): 커스텀 리드 필드를 위한 JSON 형식의 추가 필드+</Accordion><Accordion title="salesforce/update_record_opportunity">@@ -183,6 +192,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `OwnerId` (string, 선택): 이 기회를 담당하는 Salesforce 사용자- `NextStep` (string, 선택): 기회 마감을 위한 다음 작업의 설명- `additionalFields` (object, 선택): 커스텀 기회 필드를 위한 JSON 형식의 추가 필드+</Accordion><Accordion title="salesforce/update_record_task">@@ -201,6 +211,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `isReminderSet` (boolean, 선택): 알림 설정 여부- `reminderDateTime` (string, 선택): 알림 날짜/시간 (ISO 형식)- `additionalFields` (object, 선택): 커스텀 작업 필드를 위한 JSON 형식의 추가 필드+</Accordion><Accordion title="salesforce/update_record_account">@@ -214,12 +225,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `Phone` (string, 선택): 전화번호- `Description` (string, 선택): 계정 설명- `additionalFields` (object, 선택): 커스텀 계정 필드를 위한 JSON 형식의 추가 필드+</Accordion><Accordion title="salesforce/update_record_any">**설명:** Salesforce에서 어떤 객체 유형이든 레코드를 업데이트합니다.**참고:** 이는 커스텀 또는 미확인 객체 유형의 레코드 업데이트를 위한 유연한 도구입니다.+</Accordion></AccordionGroup>@@ -231,6 +244,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `recordId` (string, 필수): Contact의 레코드 ID+</Accordion><Accordion title="salesforce/get_record_by_id_lead">@@ -238,6 +252,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `recordId` (string, 필수): Lead의 레코드 ID+</Accordion><Accordion title="salesforce/get_record_by_id_opportunity">@@ -245,6 +260,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `recordId` (string, 필수): Opportunity의 레코드 ID+</Accordion><Accordion title="salesforce/get_record_by_id_task">@@ -252,6 +268,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `recordId` (string, 필수): Task의 레코드 ID+</Accordion><Accordion title="salesforce/get_record_by_id_account">@@ -259,6 +276,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `recordId` (string, 필수): Account의 레코드 ID+</Accordion><Accordion title="salesforce/get_record_by_id_any">@@ -267,6 +285,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `recordType` (string, 필수): 레코드 유형 (예: "CustomObject__c")- `recordId` (string, 필수): 레코드 ID+</Accordion></AccordionGroup>@@ -282,6 +301,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `sortDirection` (string, 선택): 정렬 방향 - 옵션: ASC, DESC- `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함- `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정+</Accordion><Accordion title="salesforce/search_records_lead">@@ -293,6 +313,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `sortDirection` (string, 선택): 정렬 방향 - 옵션: ASC, DESC- `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함- `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정+</Accordion><Accordion title="salesforce/search_records_opportunity">@@ -304,6 +325,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `sortDirection` (string, 선택): 정렬 방향 - 옵션: ASC, DESC- `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함- `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정+</Accordion><Accordion title="salesforce/search_records_task">@@ -315,6 +337,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `sortDirection` (string, 선택): 정렬 방향 - 옵션: ASC, DESC- `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함- `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정+</Accordion><Accordion title="salesforce/search_records_account">@@ -326,6 +349,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `sortDirection` (string, 선택): 정렬 방향 - 옵션: ASC, DESC- `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함- `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정+</Accordion><Accordion title="salesforce/search_records_any">@@ -336,6 +360,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `filterFormula` (string, 선택): 필터 검색 조건- `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함- `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정+</Accordion></AccordionGroup>@@ -348,6 +373,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `listViewId` (string, 필수): 리스트 뷰 ID- `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정+</Accordion><Accordion title="salesforce/get_record_by_view_id_lead">@@ -356,6 +382,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `listViewId` (string, 필수): 리스트 뷰 ID- `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정+</Accordion><Accordion title="salesforce/get_record_by_view_id_opportunity">@@ -364,6 +391,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `listViewId` (string, 필수): 리스트 뷰 ID- `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정+</Accordion><Accordion title="salesforce/get_record_by_view_id_task">@@ -372,6 +400,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `listViewId` (string, 필수): 리스트 뷰 ID- `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정+</Accordion><Accordion title="salesforce/get_record_by_view_id_account">@@ -380,6 +409,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `listViewId` (string, 필수): 리스트 뷰 ID- `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정+</Accordion><Accordion title="salesforce/get_record_by_view_id_any">@@ -389,6 +419,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `recordType` (string, 필수): 레코드 유형- `listViewId` (string, 필수): 리스트 뷰 ID- `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정+</Accordion></AccordionGroup>@@ -409,6 +440,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `description` (string, 선택): 필드 설명- `helperText` (string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트- `defaultFieldValue` (string, 선택): 필드의 기본값+</Accordion><Accordion title="salesforce/create_custom_field_lead">@@ -425,6 +457,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `description` (string, 선택): 필드 설명- `helperText` (string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트- `defaultFieldValue` (string, 선택): 필드의 기본값+</Accordion><Accordion title="salesforce/create_custom_field_opportunity">@@ -441,6 +474,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `description` (string, 선택): 필드 설명- `helperText` (string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트- `defaultFieldValue` (string, 선택): 필드의 기본값+</Accordion><Accordion title="salesforce/create_custom_field_task">@@ -457,6 +491,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `description` (string, 선택): 필드 설명- `helperText` (string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트- `defaultFieldValue` (string, 선택): 필드의 기본값+</Accordion><Accordion title="salesforce/create_custom_field_account">@@ -473,12 +508,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `description` (string, 선택): 필드 설명- `helperText` (string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트- `defaultFieldValue` (string, 선택): 필드의 기본값+</Accordion><Accordion title="salesforce/create_custom_field_any">**설명:** 모든 오브젝트 타입에 대한 커스텀 필드를 배포합니다.**참고:** 커스텀 또는 미지의 오브젝트 타입에 커스텀 필드를 생성할 수 있는 유연한 도구입니다.+</Accordion></AccordionGroup>@@ -490,6 +527,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `query` (string, 필수): SOQL 쿼리 (예: "SELECT Id, Name FROM Account WHERE Name = 'Example'")+</Accordion><Accordion title="salesforce/create_custom_object">@@ -500,6 +538,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `pluralLabel` (string, 필수): 복수형 라벨 (예: "Accounts")- `description` (string, 선택): 커스텀 오브젝트에 대한 설명- `recordName` (string, 필수): 레이아웃과 검색에 표시되는 레코드 이름 (예: "Account Name")+</Accordion><Accordion title="salesforce/describe_action_schema">@@ -510,6 +549,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `operation` (string, 필수): 작업 타입 (예: "CREATE_RECORD" 또는 "UPDATE_RECORD")**참고:** 커스텀 오브젝트 작업 시, 해당 스키마를 이해하기 위해 제일 먼저 이 기능을 사용하세요.+</Accordion></AccordionGroup>@@ -637,6 +677,10 @@ crew.kickoff()### 도움 받기-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>Salesforce 통합 설정 또는 문제 해결에 대해 지원팀에 문의하세요.</Card>diff --git a/docs/ko/enterprise/integrations/shopify.mdx b/docs/ko/enterprise/integrations/shopify.mdxindex 86f3d2abe..3b6a3a8df 100644--- a/docs/ko/enterprise/integrations/shopify.mdx+++ b/docs/ko/enterprise/integrations/shopify.mdx@@ -13,7 +13,7 @@ mode: "wide"Shopify 연동을 사용하기 전에 다음을 확인하세요:-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- 적절한 관리자 권한이 있는 Shopify 스토어- [통합 페이지](https://app.crewai.com/integrations)를 통해 Shopify 스토어 연결@@ -21,7 +21,7 @@ Shopify 연동을 사용하기 전에 다음을 확인하세요:### 1. Shopify 스토어 연결-1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.+1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.2. 인증 통합 섹션에서 **Shopify**를 찾습니다.3. **연결**을 클릭하고 OAuth 과정을 완료합니다.4. 스토어 및 제품 관리에 필요한 권한을 부여합니다.@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -64,6 +65,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `updatedAtMin` (string, 선택): 이 날짜 이후에 업데이트된 고객만 반환 (ISO 또는 Unix 타임스탬프)- `updatedAtMax` (string, 선택): 이 날짜 이전에 업데이트된 고객만 반환 (ISO 또는 Unix 타임스탬프)- `limit` (string, 선택): 반환할 최대 고객 수 (기본값 250)+</Accordion><Accordion title="shopify/search_customers">@@ -72,6 +74,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `filterFormula` (object, 선택): 필드별 연산자가 포함된 불리언 합정규형의 고급 필터- `limit` (string, 선택): 반환할 최대 고객 수 (기본값 250)+</Accordion><Accordion title="shopify/create_customer">@@ -93,6 +96,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `note` (string, 선택): 고객 메모- `sendEmailInvite` (boolean, 선택): 이메일 초대장 전송 여부- `metafields` (object, 선택): 추가 메타필드(JSON 형식)+</Accordion><Accordion title="shopify/update_customer">@@ -115,6 +119,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `note` (string, 선택): 고객 메모- `sendEmailInvite` (boolean, 선택): 이메일 초대장 전송 여부- `metafields` (object, 선택): 추가 메타필드(JSON 형식)+</Accordion></AccordionGroup>@@ -131,6 +136,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `updatedAtMin` (string, optional): 이 날짜 이후에 업데이트된 주문만 반환 (ISO 또는 Unix 타임스탬프)- `updatedAtMax` (string, optional): 이 날짜 이전에 업데이트된 주문만 반환 (ISO 또는 Unix 타임스탬프)- `limit` (string, optional): 반환할 주문의 최대 개수 (기본값: 250)+</Accordion><Accordion title="shopify/create_order">@@ -144,6 +150,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `financialStatus` (string, optional): 결제 상태 - 옵션: pending, authorized, partially_paid, paid, partially_refunded, refunded, voided- `inventoryBehaviour` (string, optional): 인벤토리 동작 - 옵션: bypass, decrement_ignoring_policy, decrement_obeying_policy- `note` (string, optional): 주문 메모+</Accordion><Accordion title="shopify/update_order">@@ -158,6 +165,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `financialStatus` (string, optional): 결제 상태 - 옵션: pending, authorized, partially_paid, paid, partially_refunded, refunded, voided- `inventoryBehaviour` (string, optional): 인벤토리 동작 - 옵션: bypass, decrement_ignoring_policy, decrement_obeying_policy- `note` (string, optional): 주문 메모+</Accordion><Accordion title="shopify/get_abandoned_carts">@@ -170,6 +178,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `createdAtMin` (string, optional): 이 날짜 이후에 생성된 장바구니만 반환 (ISO 또는 Unix 타임스탬프)- `createdAtMax` (string, optional): 이 날짜 이전에 생성된 장바구니만 반환 (ISO 또는 Unix 타임스탬프)- `limit` (string, optional): 반환할 장바구니의 최대 개수 (기본값: 250)+</Accordion></AccordionGroup>@@ -190,6 +199,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `updatedAtMin` (string, optional): 해당 날짜(ISO 혹은 Unix 타임스탬프) 이후에 수정된 제품만 반환- `updatedAtMax` (string, optional): 해당 날짜(ISO 혹은 Unix 타임스탬프) 이전에 수정된 제품만 반환- `limit` (string, optional): 반환할 최대 제품 수 (기본값: 250)+</Accordion><Accordion title="shopify/create_product">@@ -206,6 +216,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `imageUrl` (string, optional): 제품 이미지 URL- `isPublished` (boolean, optional): 제품 공개 여부- `publishToPointToSale` (boolean, optional): 포인트 오브 세일(Point of Sale)에 공개 여부+</Accordion><Accordion title="shopify/update_product">@@ -223,6 +234,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `imageUrl` (string, optional): 제품 이미지 URL- `isPublished` (boolean, optional): 제품 공개 여부- `publishToPointToSale` (boolean, optional): 포인트 오브 세일(Point of Sale)에 공개 여부+</Accordion></AccordionGroup>@@ -234,6 +246,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `productFilterFormula` (object, 선택): id, title, vendor, status, handle, tag, created_at, updated_at, published_at와 같은 필드를 지원하는 불리언 정규합형(DNF) 기반의 고급 필터+</Accordion><Accordion title="shopify/create_product_graphql">@@ -247,6 +260,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `tags` (string, 선택): 배열 또는 쉼표로 구분된 리스트 형태의 제품 태그- `media` (object, 선택): 대체 텍스트, 콘텐츠 유형 및 소스 URL을 가진 미디어 객체- `additionalFields` (object, 선택): status, requiresSellingPlan, giftCard와 같은 추가 제품 필드+</Accordion><Accordion title="shopify/update_product_graphql">@@ -261,6 +275,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `tags` (string, 선택): 배열 또는 쉼표로 구분된 리스트 형태의 제품 태그- `media` (object, 선택): 대체 텍스트, 콘텐츠 유형 및 소스 URL을 포함한 업데이트된 미디어 객체- `additionalFields` (object, 선택): status, requiresSellingPlan, giftCard와 같은 추가 제품 필드+</Accordion></AccordionGroup>@@ -387,6 +402,11 @@ crew.kickoff()### 도움 받기-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">- Shopify 연동 설정 또는 문제 해결에 관한 지원이 필요하시면 고객 지원팀에 문의해 주세요.+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>+ Shopify 연동 설정 또는 문제 해결에 관한 지원이 필요하시면 고객 지원팀에 문의해+ 주세요.</Card>diff --git a/docs/ko/enterprise/integrations/slack.mdx b/docs/ko/enterprise/integrations/slack.mdxindex 13132e481..6e38d009f 100644--- a/docs/ko/enterprise/integrations/slack.mdx+++ b/docs/ko/enterprise/integrations/slack.mdx@@ -13,7 +13,7 @@ mode: "wide"Slack 통합을 사용하기 전에 다음을 확인하십시오:-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- 적절한 권한이 있는 Slack 워크스페이스- [통합 페이지](https://app.crewai.com/integrations)를 통해 Slack 워크스페이스를 연결함@@ -21,7 +21,7 @@ Slack 통합을 사용하기 전에 다음을 확인하십시오:### 1. Slack 워크스페이스 연결-1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.+1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.2. 인증 통합 섹션에서 **Slack**을 찾습니다.3. **연결**을 클릭하고 OAuth 과정을 완료합니다.4. 팀 커뮤니케이션에 필요한 권한을 부여합니다.@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -59,6 +60,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- 파라미터 없음 - 모든 채널 멤버를 조회합니다+</Accordion><Accordion title="slack/get_user_by_email">@@ -66,6 +68,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `email` (string, 필수): 워크스페이스 내 사용자의 이메일 주소+</Accordion><Accordion title="slack/get_users_by_name">@@ -76,6 +79,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `displayName` (string, 필수): 검색할 사용자의 표시 이름- `paginationParameters` (object, 선택): 페이지네이션 설정- `pageCursor` (string, 선택): 페이지네이션을 위한 페이지 커서+</Accordion></AccordionGroup>@@ -87,6 +91,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- 파라미터가 필요하지 않습니다 - 접근 가능한 모든 채널을 조회합니다+</Accordion></AccordionGroup>@@ -103,6 +108,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `botIcon` (string, 필수): 봇 아이콘 - 이미지 URL 또는 이모지(e.g., ":dog:") 모두 가능합니다.- `blocks` (object, 선택): 첨부파일 및 인터랙티브 요소 등이 포함된 풍부한 메시지 포맷팅을 위한 Slack Block Kit JSON- `authenticatedUser` (boolean, 선택): true이면 메시지가 애플리케이션이 아니라 인증된 Slack 사용자로부터 보낸 것처럼 표시됩니다(기본값은 false)+</Accordion><Accordion title="slack/send_direct_message">@@ -115,6 +121,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `botIcon` (string, 필수): 봇 아이콘 - 이미지 URL 또는 이모지(e.g., ":dog:") 모두 가능합니다.- `blocks` (object, 선택): 첨부파일 및 인터랙티브 요소 등이 포함된 풍부한 메시지 포맷팅을 위한 Slack Block Kit JSON- `authenticatedUser` (boolean, 선택): true이면 메시지가 애플리케이션이 아니라 인증된 Slack 사용자로부터 보낸 것처럼 표시됩니다(기본값은 false)+</Accordion></AccordionGroup>@@ -132,6 +139,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `from:@john in:#general` - #general 채널에서 John이 보낸 메시지 검색- `has:link after:2023-01-01` - 2023년 1월 1일 이후에 링크가 포함된 메시지 검색- `in:@channel before:yesterday` - 특정 채널에서 어제 이전에 작성된 메시지 검색+</Accordion></AccordionGroup>@@ -140,6 +148,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_tokenSlack의 Block Kit을 사용하면 풍부하고 상호작용이 가능한 메시지를 생성할 수 있습니다. 다음은 `blocks` 매개변수를 사용하는 방법에 대한 몇 가지 예시입니다:### 첨부 파일이 있는 간단한 텍스트+```json[{@@ -154,6 +163,7 @@ Slack의 Block Kit을 사용하면 풍부하고 상호작용이 가능한 메시```### 섹션을 활용한 리치 포매팅+```json[{@@ -298,6 +308,10 @@ crew.kickoff()## 지원 문의-<Card title="도움이 필요하신가요?" icon="headset" href="mailto:[email protected]">+<Card+ title="도움이 필요하신가요?"+ icon="headset"+ href="mailto:[email protected]"+>Slack 연동 설정 또는 문제 해결에 대해 지원팀에 문의하세요.</Card>diff --git a/docs/ko/enterprise/integrations/stripe.mdx b/docs/ko/enterprise/integrations/stripe.mdxindex 45ce8ec63..c343fe61a 100644--- a/docs/ko/enterprise/integrations/stripe.mdx+++ b/docs/ko/enterprise/integrations/stripe.mdx@@ -13,7 +13,7 @@ mode: "wide"Stripe 통합을 사용하기 전에 다음 사항을 확인하세요:-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- 적절한 API 권한이 있는 Stripe 계정- [통합 페이지](https://app.crewai.com/integrations)를 통해 Stripe 계정 연결@@ -21,7 +21,7 @@ Stripe 통합을 사용하기 전에 다음 사항을 확인하세요:### 1. Stripe 계정 연결-1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.+1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.2. 인증 통합 섹션에서 **Stripe**를 찾습니다.3. **연결**을 클릭하고 OAuth 과정을 완료합니다.4. 결제 처리에 필요한 권한을 부여합니다.@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -62,6 +63,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `name` (string, 선택): 고객의 전체 이름- `description` (string, 선택): 내부 참조용 고객 설명- `metadataCreateCustomer` (object, 선택): 추가 메타데이터를 key-value 쌍으로 입력 (예: `{"field1": 1, "field2": 2}`)+</Accordion><Accordion title="stripe/get_customer_by_id">@@ -69,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `idGetCustomer` (string, 필수): 조회할 Stripe 고객 ID+</Accordion><Accordion title="stripe/get_customers">@@ -79,6 +82,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `createdAfter` (string, 선택): 이 날짜 이후 생성된 고객 필터링 (유닉스 타임스탬프)- `createdBefore` (string, 선택): 이 날짜 이전 생성된 고객 필터링 (유닉스 타임스탬프)- `limitGetCustomers` (string, 선택): 반환할 최대 고객 수 (기본값 10)+</Accordion><Accordion title="stripe/update_customer">@@ -90,6 +94,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `name` (string, 선택): 업데이트할 고객 이름- `description` (string, 선택): 업데이트할 고객 설명- `metadataUpdateCustomer` (object, 선택): 업데이트할 메타데이터를 key-value 쌍으로 입력+</Accordion></AccordionGroup>@@ -103,6 +108,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `customerIdCreateSubscription` (string, 필수): 구독이 생성될 고객 ID- `plan` (string, 필수): 구독을 위한 플랜 ID - 사용자가 플랜을 선택할 수 있도록 Connect Portal Workflow Settings를 사용하세요- `metadataCreateSubscription` (object, 선택): 구독에 대한 추가 메타데이터+</Accordion><Accordion title="stripe/get_subscriptions">@@ -112,6 +118,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `customerIdGetSubscriptions` (string, 선택): 고객 ID로 구독을 필터링- `subscriptionStatus` (string, 선택): 구독 상태별 필터링 - 옵션: incomplete, incomplete_expired, trialing, active, past_due, canceled, unpaid- `limitGetSubscriptions` (string, 선택): 반환할 구독의 최대 개수(기본값은 10)+</Accordion></AccordionGroup>@@ -125,6 +132,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `productName` (string, 필수): 제품 이름- `description` (string, 선택): 제품 설명- `metadataProduct` (object, 선택): 키-값 쌍으로 구성된 추가 제품 메타데이터+</Accordion><Accordion title="stripe/get_product_by_id">@@ -132,6 +140,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `productId` (string, 필수): 조회할 Stripe 제품 ID+</Accordion><Accordion title="stripe/get_products">@@ -141,6 +150,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `createdAfter` (string, 선택): 이 날짜 이후 생성된 제품만 필터링 (Unix 타임스탬프)- `createdBefore` (string, 선택): 이 날짜 이전 생성된 제품만 필터링 (Unix 타임스탬프)- `limitGetProducts` (string, 선택): 반환할 최대 제품 수 (기본값 10)+</Accordion></AccordionGroup>@@ -154,6 +164,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `balanceTransactionType` (string, 선택 사항): 거래 유형별 필터 - 옵션: charge, refund, payment, payment_refund- `paginationParameters` (object, 선택 사항): 페이지네이션 설정- `pageCursor` (string, 선택 사항): 페이지네이션을 위한 페이지 커서+</Accordion><Accordion title="stripe/get_plans">@@ -163,6 +174,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `isPlanActive` (boolean, 선택 사항): 플랜 상태별 필터 - true는 활성 플랜, false는 비활성 플랜- `paginationParameters` (object, 선택 사항): 페이지네이션 설정- `pageCursor` (string, 선택 사항): 페이지네이션을 위한 페이지 커서+</Accordion></AccordionGroup>diff --git a/docs/ko/enterprise/integrations/zendesk.mdx b/docs/ko/enterprise/integrations/zendesk.mdxindex b2266afcf..dfa9018ff 100644--- a/docs/ko/enterprise/integrations/zendesk.mdx+++ b/docs/ko/enterprise/integrations/zendesk.mdx@@ -13,7 +13,7 @@ mode: "wide"Zendesk 통합을 사용하기 전에 다음을 확인하세요.-- 활성 구독이 있는 [CrewAI AOP](https://app.crewai.com) 계정+- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정- 적절한 API 권한이 있는 Zendesk 계정- [통합 페이지](https://app.crewai.com/integrations)를 통해 Zendesk 계정 연결@@ -21,7 +21,7 @@ Zendesk 통합을 사용하기 전에 다음을 확인하세요.### 1. Zendesk 계정 연결-1. [CrewAI AOP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.+1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/connectors)으로 이동합니다.2. 인증 통합 섹션에서 **Zendesk**를 찾습니다.3. **연결**을 클릭하고 OAuth 과정을 완료합니다.4. 티켓 및 사용자 관리에 필요한 권한을 부여합니다.@@ -36,7 +36,8 @@ uv add crewai-tools### 3. 환경 변수 설정<Note>- `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로 `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.+ `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로+ `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.</Note>```bash@@ -70,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `ticketTags` (string, 선택): 적용할 태그 배열 (예: `["enterprise", "other_tag"]`)- `ticketExternalId` (string, 선택): 티켓을 로컬 레코드와 연결할 외부 ID- `ticketCustomFields` (object, 선택): JSON 형식의 사용자 정의 필드 값+</Accordion><Accordion title="zendesk/update_ticket">@@ -88,6 +90,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `ticketTags` (string, 선택): 업데이트된 태그 배열- `ticketExternalId` (string, 선택): 업데이트된 외부 ID- `ticketCustomFields` (object, 선택): 업데이트된 사용자 정의 필드 값+</Accordion><Accordion title="zendesk/get_ticket_by_id">@@ -95,6 +98,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `ticketId` (string, 필수): 조회할 티켓의 ID (예: "35436")+</Accordion><Accordion title="zendesk/add_comment_to_ticket">@@ -105,6 +109,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `commentBody` (string, 필수): 댓글 메시지 (일반 텍스트 또는 HTML 지원, 예: "도움을 주셔서 감사합니다!")- `isInternalNote` (boolean, 선택): 공개 답글 대신 내부 노트로 설정하려면 true (기본값: false)- `isPublic` (boolean, 선택): 공개 댓글이면 true, 내부 노트이면 false+</Accordion><Accordion title="zendesk/search_tickets">@@ -126,6 +131,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `dueDate` (object, 선택): 마감일로 필터링 (연산자와 값)- `sort_by` (string, 선택): 정렬 필드 - 옵션: created_at, updated_at, priority, status, ticket_type- `sort_order` (string, 선택): 정렬 방향 - 옵션: asc, desc+</Accordion></AccordionGroup>@@ -143,6 +149,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `externalId` (string, 선택): 다른 시스템의 고유 식별자- `details` (string, 선택): 추가 사용자 정보- `notes` (string, 선택): 사용자에 대한 내부 메모+</Accordion><Accordion title="zendesk/update_user">@@ -157,6 +164,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `externalId` (string, 선택): 업데이트된 외부 ID- `details` (string, 선택): 업데이트된 사용자 상세 정보- `notes` (string, 선택): 업데이트된 내부 메모+</Accordion><Accordion title="zendesk/get_user_by_id">@@ -164,6 +172,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**매개변수:**- `userId` (string, 필수): 조회할 사용자 ID+</Accordion><Accordion title="zendesk/search_users">@@ -176,6 +185,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `externalId` (string, 선택): 외부 ID로 필터링- `sort_by` (string, 선택): 정렬 필드 - 옵션: created_at, updated_at- `sort_order` (string, 선택): 정렬 방향 - 옵션: asc, desc+</Accordion></AccordionGroup>@@ -188,6 +198,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token**파라미터:**- `paginationParameters` (object, 선택 사항): 페이지네이션 설정- `pageCursor` (string, 선택 사항): 페이지네이션을 위한 페이지 커서+</Accordion><Accordion title="zendesk/get_ticket_audits">@@ -197,6 +208,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token- `ticketId` (string, 선택 사항): 특정 티켓의 감사를 조회합니다(비워두면 모든 비보관된 티켓의 감사를 조회, 예: "1234")- `paginationParameters` (object, 선택 사항): 페이지네이션 설정- `pageCursor` (string, 선택 사항): 페이지네이션을 위한 페이지 커서+</Accordion></AccordionGroup>diff --git a/docs/ko/enterprise/introduction.mdx b/docs/ko/enterprise/introduction.mdxindex bfd95e9f9..f8be4ce60 100644--- a/docs/ko/enterprise/introduction.mdx+++ b/docs/ko/enterprise/introduction.mdx@@ -7,10 +7,13 @@ mode: "wide"## 소개-CrewAI AOP(Agent Operation Platform)는 프로덕션 환경에서 crew와 agent를 배포, 모니터링, 확장할 수 있는 플랫폼을 제공합니다.+CrewAI AMP(Agent Management Platform)는 프로덕션 환경에서 crew와 agent를 배포, 모니터링, 확장할 수 있는 플랫폼을 제공합니다.<Frame>- <img src="/images/enterprise/crewai-enterprise-dashboard.png" alt="CrewAI AOP Dashboard" />+ <img+ src="/images/enterprise/crewai-enterprise-dashboard.png"+ alt="CrewAI AMP Dashboard"+ /></Frame>CrewAI AOP는 오픈 소스 프레임워크의 강력함에 프로덕션 배포, 협업, 확장성을 위한 기능을 더했습니다. crew를 관리형 인프라에 배포하고, 실행을 실시간으로 모니터링하세요.@@ -57,11 +60,7 @@ CrewAI AOP는 오픈 소스 프레임워크의 강력함에 프로덕션 배포,<Steps><Step title="계정 가입하기">[app.crewai.com](https://app.crewai.com)에서 계정을 생성하세요- <Card- title="가입하기"- icon="user"- href="https://app.crewai.com/signup"- >+ <Card title="가입하기" icon="user" href="https://app.crewai.com/signup">가입하기</Card></Step>diff --git a/docs/ko/installation.mdx b/docs/ko/installation.mdxindex cc0fdcd51..bdc04ea39 100644--- a/docs/ko/installation.mdx+++ b/docs/ko/installation.mdx@@ -6,6 +6,7 @@ mode: "wide"---## 비디오 튜토리얼+설치 과정을 단계별로 시연하는 비디오 튜토리얼을 시청하세요:<iframe@@ -18,15 +19,18 @@ mode: "wide"></iframe>## 텍스트 튜토리얼+<Note>**Python 버전 요구 사항**- CrewAI는 `Python >=3.10 및 <3.14`가 필요합니다. 버전을 확인하는 방법은 다음과 같습니다:- ```bash- python3 --version- ```+CrewAI는 `Python >=3.10 및 <3.14`가 필요합니다. 버전을 확인하는 방법은 다음과 같습니다:++```bash+python3 --version+```++Python을 업데이트해야 하는 경우, [python.org/downloads](https://python.org/downloads)를 방문하세요.- Python을 업데이트해야 하는 경우, [python.org/downloads](https://python.org/downloads)를 방문하세요.</Note>CrewAI는 의존성 관리와 패키지 처리를 위해 `uv`를 사용합니다. 프로젝트 설정과 실행을 간소화하여 원활한 경험을 제공합니다.@@ -89,6 +93,7 @@ CrewAI는 의존성 관리와 패키지 처리를 위해 `uv`를 사용합니다```<Check>설치가 완료되었습니다! 이제 첫 번째 crew를 만들 준비가 되었습니다! 🎉</Check></Step>+</Steps># CrewAI 프로젝트 생성하기@@ -122,6 +127,7 @@ CrewAI는 의존성 관리와 패키지 처리를 위해 `uv`를 사용합니다├── agents.yaml└── tasks.yaml```+</Step><Step title="프로젝트 커스터마이즈">@@ -138,6 +144,7 @@ CrewAI는 의존성 관리와 패키지 처리를 위해 `uv`를 사용합니다- `agents.yaml` 및 `tasks.yaml`을 편집하여 crew의 동작을 정의하는 것부터 시작하세요.- API 키와 같은 민감한 정보는 `.env` 파일에 보관하세요.+</Step><Step title="Crew 실행하기">@@ -161,13 +168,15 @@ CrewAI는 의존성 관리와 패키지 처리를 위해 `uv`를 사용합니다<Note type="info">팀과 조직을 위해, CrewAI는 설치 복잡성을 없애는 엔터프라이즈 배포 옵션을 제공합니다:-### CrewAI AOP (SaaS)+### CrewAI AMP (SaaS)+- 설치가 전혀 필요하지 않습니다 - [app.crewai.com](https://app.crewai.com)에서 무료로 가입하세요- 자동 업데이트 및 유지 보수- 관리형 인프라 및 확장성 지원- 코딩 없이 Crew 생성### CrewAI Factory (자가 호스팅)+- 귀하의 인프라를 위한 컨테이너화된 배포- 온프레미스 배포를 포함하여 모든 하이퍼스케일러 지원- 기존 보안 시스템과의 통합@@ -180,12 +189,9 @@ CrewAI는 의존성 관리와 패키지 처리를 위해 `uv`를 사용합니다## 다음 단계<CardGroup cols={2}>- <Card- title="첫 번째 Agent 만들기"- icon="code"- href="/ko/quickstart"- >- 빠른 시작 가이드를 따라 CrewAI 에이전트를 처음 만들어보고 직접 경험해 보세요.+ <Card title="첫 번째 Agent 만들기" icon="code" href="/ko/quickstart">+ 빠른 시작 가이드를 따라 CrewAI 에이전트를 처음 만들어보고 직접 경험해+ 보세요.</Card><Cardtitle="커뮤니티 참여하기"diff --git a/docs/ko/learn/llm-selection-guide.mdx b/docs/ko/learn/llm-selection-guide.mdxindex 26e01b02f..e66994ac3 100644--- a/docs/ko/learn/llm-selection-guide.mdx+++ b/docs/ko/learn/llm-selection-guide.mdx@@ -1,7 +1,7 @@----title: '전략적 LLM 선택 가이드'-description: 'CrewAI AI 에이전트를 위한 적합한 LLM 선택 및 효과적인 작업과 에이전트 정의 작성에 대한 전략적 프레임워크'-icon: 'brain-circuit'+title: "전략적 LLM 선택 가이드"+description: "CrewAI AI 에이전트를 위한 적합한 LLM 선택 및 효과적인 작업과 에이전트 정의 작성에 대한 전략적 프레임워크"+icon: "brain-circuit"mode: "wide"---@@ -10,23 +10,33 @@ mode: "wide"처방적인 모델 추천보다는, **사고 프레임워크**를 제안하여 특정 사용 사례, 제약 조건, 요구 사항에 따라 정보에 입각한 결정을 내릴 수 있도록 돕고자 합니다. LLM 환경은 빠르게 변화하고 있으며, 새로운 모델이 정기적으로 등장하고 기존 모델도 자주 업데이트되고 있습니다. 가장 중요한 것은 어떤 특정 모델이 제공되는지와 상관없이 평가를 위한 체계적인 접근법을 개발하는 것입니다.<Note>-이 가이드는 LLM 환경이 빠르게 변화하고 있기 때문에 특정 모델 추천보다는 전략적 사고에 초점을 맞추고 있습니다.+ 이 가이드는 LLM 환경이 빠르게 변화하고 있기 때문에 특정 모델 추천보다는 전략적+ 사고에 초점을 맞추고 있습니다.</Note>## 빠른 결정 프레임워크<Steps><Step title="작업 분석">- 먼저, 작업이 실제로 무엇을 요구하는지 깊이 이해하세요. 필요한 인지 복잡성, 요구되는 추론의 깊이, 기대되는 출력 형식, 모델이 처리해야 할 맥락의 양을 고려합니다. 이러한 기본 분석이 이후의 모든 결정을 안내할 것입니다.+ 먼저, 작업이 실제로 무엇을 요구하는지 깊이 이해하세요. 필요한 인지 복잡성,+ 요구되는 추론의 깊이, 기대되는 출력 형식, 모델이 처리해야 할 맥락의 양을+ 고려합니다. 이러한 기본 분석이 이후의 모든 결정을 안내할 것입니다.</Step><Step title="모델 역량 매핑">- 요구 사항을 이해한 후, 이를 모델의 강점에 매핑하세요. 서로 다른 모델 계열은 작업 유형에 따라 특화되어 있습니다. 일부는 추론 및 분석에 최적화되어 있고, 일부는 창의성이나 콘텐츠 생성, 또 다른 일부는 속도와 효율성에 최적화되어 있습니다.+ 요구 사항을 이해한 후, 이를 모델의 강점에 매핑하세요. 서로 다른 모델 계열은+ 작업 유형에 따라 특화되어 있습니다. 일부는 추론 및 분석에 최적화되어 있고,+ 일부는 창의성이나 콘텐츠 생성, 또 다른 일부는 속도와 효율성에 최적화되어+ 있습니다.</Step><Step title="제약 조건 고려">- 예산 제한, 지연 시간 요구사항, 데이터 프라이버시 필요성, 인프라 역량 등 실제 운영상의 제약 조건을 반영하세요. 이론적으로 가장 좋은 모델이 실제로는 최선의 선택이 아닐 수 있습니다.+ 예산 제한, 지연 시간 요구사항, 데이터 프라이버시 필요성, 인프라 역량 등 실제+ 운영상의 제약 조건을 반영하세요. 이론적으로 가장 좋은 모델이 실제로는 최선의+ 선택이 아닐 수 있습니다.</Step><Step title="테스트 및 반복">- 신뢰할 수 있고 잘 이해된 모델로 시작하여, 특정 사용 사례에서 실제 성능을 바탕으로 최적화하세요. 실제 결과는 이론적 벤치마크와 다를 수 있으므로, 경험적 테스트가 매우 중요합니다.+ 신뢰할 수 있고 잘 이해된 모델로 시작하여, 특정 사용 사례에서 실제 성능을+ 바탕으로 최적화하세요. 실제 결과는 이론적 벤치마크와 다를 수 있으므로,+ 경험적 테스트가 매우 중요합니다.</Step></Steps>@@ -43,6 +53,7 @@ LLM을 선택할 때 가장 중요한 단계는 실제로 여러분의 작업이- **Complex Tasks**는 다단계 추론, 전략적 사고, 모호하거나 불완전한 정보를 처리하는 능력을 필요로 합니다. 여러 데이터 소스를 분석하거나, 포괄적 전략을 개발하거나, 더 작은 구성 요소로 분해해야 하는 문제 해결 작업 등이 이에 해당합니다. 모델은 여러 추론 단계를 거치는 동안 맥락을 유지해야 하며, 명시적으로 언급되지 않은 내용을 추론해야 할 때가 많습니다.- **Creative Tasks**는 새롭고, 흥미로우며, 맥락에 적합한 콘텐츠를 생성하는 데 중점을 둔 새로운 인지적 능력을 요구합니다. 여기에는 스토리텔링, 마케팅 카피 작성, 창의적 문제 해결이 포함됩니다. 모델은 뉘앙스, 톤, 대상 청중을 이해하고, 공식적이지 않고 진정성 있고 흥미로운 콘텐츠를 제작해야 합니다.+</Tab><Tab title="Output Requirements">@@ -51,6 +62,7 @@ LLM을 선택할 때 가장 중요한 단계는 실제로 여러분의 작업이- **Creative Content** 출력은 기술적 역량과 창의적 감각의 균형을 필요로 합니다. 모델은 대상 청중, 톤, 브랜드 보이스를 이해하고, 독자의 관심을 끌며 특정 커뮤니케이션 목표를 달성하는 콘텐츠를 제작할 수 있어야 합니다. 이 영역의 품질은 주관적인 경우가 많으며, 다양한 맥락과 목적에 맞게 글쓰기 스타일을 조정할 수 있는 모델이 필요합니다.- **Technical Content**는 구조화된 데이터와 창의적 콘텐츠의 중간에 위치하며, 정확성과 명확성을 모두 필요로 합니다. 문서화, 코드 생성, 기술 분석 등은 정밀하면서도 포괄적으로 작성되어야 하며, 대상이 되는 청중에게 효과적으로 전달되어야 합니다. 모델은 복잡한 기술 개념을 이해하고 이를 명확하게 설명할 수 있어야 합니다.+</Tab><Tab title="Context Needs">@@ -59,6 +71,7 @@ LLM을 선택할 때 가장 중요한 단계는 실제로 여러분의 작업이- **Long Context** 요구 사항은 방대한 문서 작업, 장기간 대화, 복잡한 다중 파트 작업을 처리할 때 발생합니다. 모델은 수천 토큰에 걸쳐 일관성을 유지해야 하며, 앞선 정보를 정확히 참조할 수 있어야 합니다. 이는 문서 분석, 포괄적 연구, 정교한 대화 시스템에 매우 중요한 기능입니다.- **Very Long Context** 시나리오는 현재 가능한 한계를 뛰어넘는 경우로, 대규모 문서 처리, 광범위한 연구 종합, 복잡한 다중 세션 상호작용 등이 있습니다. 이러한 활용 사례는 확장된 컨텍스트 처리를 위해 특별히 설계된 모델이 필요하며, 종종 컨텍스트 길이와 처리 속도 간의 절충이 발생합니다.+</Tab></Tabs>@@ -73,6 +86,7 @@ LLM을 선택할 때 가장 중요한 단계는 실제로 여러분의 작업이Reasoning 모델의 강점은 확장된 reasoning 체인에서 논리적 일관성을 유지하고, 복잡한 문제를 관리 가능한 구성 요소로 나눌 수 있다는 점에 있습니다. 전략적 계획, 복잡한 분석, 그리고 응답 속도보다 reasoning의 질이 더 중요한 상황에서 특히 가치가 있습니다.하지만 reasoning 모델은 속도와 비용 면에서 트레이드오프가 따르는 경우가 많습니다. 또한 그들의 고도화된 reasoning 역량이 필요 없는 창의적인 작업이나 간단한 작업에는 덜 적합할 수 있습니다. 체계적이고 단계적인 분석이 요구되는 진정한 복잡성이 관련된 작업에서 이러한 모델을 고려하십시오.+</Accordion><Accordion title="General Purpose Models" icon="microchip">@@ -81,6 +95,7 @@ LLM을 선택할 때 가장 중요한 단계는 실제로 여러분의 작업이General purpose 모델의 주요 장점은 다양한 유형의 작업에서 예측 가능한 신뢰성과 일관성입니다. 조사, 분석, 콘텐츠 제작, 데이터 처리 등 대부분의 표준 비즈니스 작업을 충분히 처리할 수 있습니다. 이로 인해 다양한 워크플로우 전반에서 일관된 성능이 필요한 팀에 매우 적합한 선택이 됩니다.General purpose 모델은 특정 도메인에서 특화된 대안들이 보여주는 최고 성능에는 미치지 않을 수 있지만, 운영의 단순성과 모델 관리의 복잡성 감소라는 이점이 있습니다. 신규 프로젝트의 시작점으로 가장 좋은 선택인 경우가 많으며, 팀이 구체적인 필요를 이해하고 나서 특화 모델로 최적화할 수 있습니다.+</Accordion><Accordion title="Fast & Efficient Models" icon="bolt">@@ -89,6 +104,7 @@ LLM을 선택할 때 가장 중요한 단계는 실제로 여러분의 작업이이러한 모델은 일상적인 운영, 간단한 데이터 처리, 함수 호출, 대용량 작업 등 인지적 요구가 비교적 단순한 시나리오에서 뛰어납니다. 많은 요청을 신속하게 처리해야 하거나 예산 제약 내에서 운영되어야 하는 애플리케이션에 특히 유용합니다.효율적인 모델에서 가장 중요한 고려사항은 그들의 역량이 귀하의 작업 요구와 일치하는지 확인하는 것입니다. 많은 일상적 작업은 효과적으로 처리할 수 있지만, Nuanced한 이해, 복잡한 reasoning, 혹은 고도화된 콘텐츠 생성이 필요한 작업에는 어려움을 겪을 수 있습니다. 정교함보다 속도와 비용이 더 중요한 명확하고 일상적인 작업에 가장 적합합니다.+</Accordion><Accordion title="Creative Models" icon="pen">@@ -97,6 +113,7 @@ LLM을 선택할 때 가장 중요한 단계는 실제로 여러분의 작업이Creative 모델의 강점은 다양한 대상에 맞춰 글쓰기 스타일을 조정하고, 일관된 목소리와 톤을 유지하며, 독자를 효과적으로 사로잡는 콘텐츠를 생성할 수 있다는 점입니다. 스토리텔링, 마케팅 카피, 브랜드 커뮤니케이션 등 창의성과 몰입이 주요 목적이 되는 콘텐츠 작업에서 더 우수한 성과를 보입니다.Creative 모델을 선택할 때는 단순한 텍스트 생성 능력뿐 아니라, 대상, 맥락, 목적에 대한 이해력도 함께 고려해야 합니다. 최상의 creative 모델은 특정 브랜드 목소리에 맞게 출력 내용을 조정하고, 다양한 대상 그룹을 타깃팅하며, 긴 콘텐츠에서도 일관성을 유지할 수 있습니다.+</Accordion><Accordion title="Open Source Models" icon="code">@@ -105,6 +122,7 @@ LLM을 선택할 때 가장 중요한 단계는 실제로 여러분의 작업이Open source 모델의 주요 이점으로는 토큰당 비용의 제거, 특정 용도에 맞춘 파인튜닝 가능성, 완전한 데이터 프라이버시, 외부 API 제공자에 대한 의존성 해소가 있습니다. 특히 엄격한 데이터 프라이버시 요구사항, 예산 제약, 특정 맞춤화 필요가 있는 조직에 매우 유용합니다.그러나 open source 모델은 효과적으로 배포 및 유지관리하기 위해 더 많은 기술 전문성이 필요합니다. 팀에서는 인프라 비용, 모델 관리 복잡성, 지속적인 모델 업데이트 및 최적화를 위한 지속적인 노력을 고려해야 합니다. 기술적 오버헤드를 감안하면 전체 소유 비용이 클라우드 기반 대안보다 높을 수 있습니다.+</Accordion></AccordionGroup>@@ -113,7 +131,8 @@ LLM을 선택할 때 가장 중요한 단계는 실제로 여러분의 작업이### a. 멀티-모델 접근 방식<Tip>-동일 crew 내에서 다양한 목적에 맞는 서로 다른 모델을 사용해 성능과 비용을 모두 최적화할 수 있습니다.+ 동일 crew 내에서 다양한 목적에 맞는 서로 다른 모델을 사용해 성능과 비용을 모두+ 최적화할 수 있습니다.</Tip>가장 정교하게 구현된 CrewAI의 경우, 여러 개의 모델을 전략적으로 활용하여 각 agent의 역할과 요구 사항에 맞는 모델을 지정합니다. 이 접근 방식은 각 작업 유형에 가장 적합한 모델을 사용함으로써 성능과 비용을 모두 최적화할 수 있게 해줍니다.@@ -177,6 +196,7 @@ crew = Crew(효과적인 Manager LLM은 올바른 위임 결정을 내리기 위한 강력한 추론 능력, 예측 가능한 조정을 보장하는 일관된 성능, 여러 에이전트의 상태를 동시에 추적하기 위한 탁월한 컨텍스트 관리가 필요합니다. 이 모델은 다양한 에이전트의 역량과 한계를 이해하고, 효율성과 품질을 최적화하기 위해 작업 할당을 최적화해야 합니다.Manager LLM은 모든 작업에 관여하기 때문에 비용 고려가 특히 중요합니다. 모델은 효과적인 조정을 위한 충분한 역량을 제공하면서도, 잦은 사용에도 비용 효율적이어야 합니다. 이는 종종 가장 정교한 모델의 높은 가격 없이도 충분한 추론 능력을 제공하는 모델을 찾는 것을 의미합니다.+</Tab><Tab title="Function Calling LLM">@@ -185,6 +205,7 @@ crew = Crew(Function calling LLM에서 가장 중요한 특성은 창의성이나 정교한 추론력보다는 정확성과 신뢰성입니다. 모델은 자연어 요청에서 올바른 파라미터를 일관되게 추출하고, 도구 응답을 적절히 처리해야 합니다. 도구 사용은 여러 번의 왕복 작업이 수반될 수 있으므로 속도도 중요합니다.많은 팀들은, 창의적이거나 추론에 특화된 모델보다는, 특화된 function calling 모델이나 도구 지원이 강력한 범용 모델이 이 역할에 더 적합하다는 것을 발견합니다. 핵심은 모델이 자연어 지침과 구조화된 도구 호출 간의 간극을 신뢰성 있게 연결할 수 있도록 하는 것입니다.+</Tab><Tab title="Agent-Specific Overrides">@@ -193,6 +214,7 @@ crew = Crew(에이전트별 재정의를 고려해야 하는 경우는 에이전트의 역할이 다른 crew 구성원과 본질적으로 다른 역량을 요구할 때입니다. 예를 들어, 창의적 글쓰기에 특화된 에이전트는 콘텐츠 생성에 최적화된 모델이 도움이 될 수 있고, 데이터 분석 에이전트는 추론에 중점을 둔 모델로 더 나은 성과를 거둘 수 있습니다.에이전트별 재정의를 적용할 때의 과제는 최적화와 운영 복잡도 간의 균형을 유지하는 것입니다. 모델이 하나 추가될 때마다 배포, 모니터링, 비용 관리의 복잡성이 늘어납니다. 따라서 팀은 성능 향상 효과가 추가 복잡성을 정당화할 수 있는 에이전트에만 재정의를 집중해야 합니다.+</Tab></Tabs>@@ -209,6 +231,7 @@ CrewAI 출력의 품질을 결정하는 데 있어 모델 선택보다 효과적효과적인 작업 설명은 에이전트가 더 넓은 목적과 그들이 반드시 지켜야 할 제한사항을 이해할 수 있도록 관련 맥락 및 제약 조건을 포함합니다. 복잡한 작업을 체계적으로 실행할 수 있는 집중된 단계로 분할하여, 여러 측면이 뒤섞이고 접근하기 어려운 압도적인 목표로 제시하지 않습니다.일반적인 실수로는 목표가 너무 모호하다거나, 필요한 맥락을 제공하지 않는다거나, 성공 기준이 불분명하다거나, 관련 없는 여러 작업을 하나의 설명으로 결합하는 경우가 있습니다. 목표는 단일의 명확한 목적에 집중하며, 에이전트가 성공할 수 있을 정도로 충분한 정보를 제공하는 것입니다.+</Accordion><Accordion title="예상 산출물 가이드라인" icon="bullseye">@@ -217,6 +240,7 @@ CrewAI 출력의 품질을 결정하는 데 있어 모델 선택보다 효과적최고의 산출물 가이드라인은 품질 지표에 대한 구체적인 예시를 제공하고, 완료 기준을 에이전트와 인간 평가자 모두가 작업의 성공적 완료 여부를 평가할 수 있을 만큼 명확하게 정의합니다. 이는 모호함을 줄이고 여러 작업 실행 간 일관된 결과를 보장하는 데 도움이 됩니다.어떤 작업에나 적용할 수 있을 정도로 일반적인 산출물 설명, 에이전트가 구조를 추측해야 하는 형식 명세 누락, 평가가 어려운 불분명한 품질 기준, 에이전트가 기대치를 이해하도록 도와주는 예시 또는 템플릿 미제공 등은 피해야 합니다.+</Accordion></AccordionGroup>@@ -229,6 +253,7 @@ CrewAI 출력의 품질을 결정하는 데 있어 모델 선택보다 효과적순차적 의존성을 효과적으로 구현하기 위해서는 context 파라미터를 사용하여 관련 작업을 연쇄시키고, 작업의 진행을 통해 점진적으로 복잡성을 구축하며, 각 작업이 다음 작업에 의미 있는 입력값이 될 수 있는 산출물을 생성하도록 해야 합니다. 목표는 의존된 작업 간의 논리적 흐름을 유지하면서 불필요한 병목을 피하는 것입니다.순차적 의존성은 한 작업에서 다른 작업으로 명확한 논리적 진행이 있고, 한 작업의 산출물이 다음 작업의 품질이나 실행 가능성을 실제로 향상시킬 때 가장 효과적입니다. 그러나 적절히 관리되지 않을 경우 병목 현상이 발생할 수 있으니, 반드시 진정으로 필요한 의존성과 단순히 편의상 설정된 의존성을 구분해야 합니다.+</Tab><Tab title="병렬 실행">@@ -237,6 +262,7 @@ CrewAI 출력의 품질을 결정하는 데 있어 모델 선택보다 효과적성공적인 병렬 실행을 위해서는 실제로 독립적으로 수행이 가능한 작업을 식별하고, 관련되지만 분리된 작업 스트림을 효과적으로 그룹화하며, 병렬로 진행된 작업을 최종 결과물로 통합해야 할 때 결과 통합을 계획해야 합니다. 핵심은 병렬 작업이 전체 품질을 저하하는 충돌이나 중복을 만들지 않도록 하는 것입니다.여러 개의 독립적인 연구 스트림이나 서로 의존하지 않는 다양한 분석, 동시에 개발이 가능한 콘텐츠 생성 작업이 있을 때 병렬 실행을 고려하십시오. 다만, 자원 할당에 주의하고, 병렬 실행이 모델의 가용 용량이나 예산을 초과하지 않도록 해야 합니다.+</Tab></Tabs>@@ -245,7 +271,8 @@ CrewAI 출력의 품질을 결정하는 데 있어 모델 선택보다 효과적### a. 역할 기반 LLM 선택<Warning>-일반적인 에이전트 역할은 올바른 LLM을 선택할 수 없게 만듭니다. 구체적인 역할은 목표에 맞춘 모델 최적화를 가능하게 합니다.+ 일반적인 에이전트 역할은 올바른 LLM을 선택할 수 없게 만듭니다. 구체적인 역할은+ 목표에 맞춘 모델 최적화를 가능하게 합니다.</Warning>에이전트 역할의 구체성은 최적의 성능을 위해 어떤 LLM의 능력이 가장 중요한지를 직접적으로 결정합니다. 이는 에이전트의 책임에 정확히 맞는 모델 강점을 연결할 수 있는 전략적 기회를 만듭니다.@@ -253,6 +280,7 @@ CrewAI 출력의 품질을 결정하는 데 있어 모델 선택보다 효과적**일반 역할 vs. 구체적 역할이 LLM 선택에 미치는 영향:**역할을 정의할 때 에이전트가 다룰 작업에 가장 가치 있는 특정 도메인 지식, 작업 방식, 의사결정 프레임워크를 고려하세요. 역할 정의가 더 구체적이고 상황에 맞을수록 모델이 그 역할을 효과적으로 구현할 수 있습니다.+```python# ✅ 특정 역할 - 명확한 LLM 요구specific_agent = Agent(@@ -273,7 +301,9 @@ specific_agent = Agent(### b. 모델 컨텍스트 증폭기로서의 백스토리<Info>-전략적으로 구성된 백스토리는 도메인 특화 컨텍스트를 제공하여 일반적인 프롬프트로는 달성할 수 없는 수준으로 선택한 LLM의 효율성을 획기적으로 높여줍니다.+ 전략적으로 구성된 백스토리는 도메인 특화 컨텍스트를 제공하여 일반적인+ 프롬프트로는 달성할 수 없는 수준으로 선택한 LLM의 효율성을 획기적으로+ 높여줍니다.</Info>잘 설계된 백스토리는 LLM을 단순한 범용 모델에서 전문적인 전문가로 탈바꿈시켜 줍니다. 이는 비용 최적화 관점에서 특히 중요합니다. 효율적인 모델이라도 컨텍스트가 잘 구축되면, 적절한 컨텍스트 없이 고가의 모델보다 더 뛰어난 성능을 발휘할 수 있습니다.@@ -300,6 +330,7 @@ domain_expert = Agent(```**LLM 성능을 높여주는 백스토리 요소:**+- **도메인 경험**: "10년 이상의 엔터프라이즈 SaaS 영업 경력"- **특정 전문성**: "시리즈 B+ 라운드의 기술 실사 전문"- **업무 스타일**: "명확한 문서화와 데이터 기반 의사결정을 선호"@@ -332,6 +363,7 @@ tech_writer = Agent(```**정렬 체크리스트:**+- ✅ **역할 특이성**: 명확한 도메인과 책임- ✅ **LLM 적합도**: 모델의 강점이 역할 요구사항과 일치- ✅ **백스토리 깊이**: LLM이 활용할 수 있는 도메인 맥락 제공@@ -353,6 +385,7 @@ tech_writer = Agent(- 도구에 크게 의존하는 agent가 있습니까?**Action**: 현재 agent 역할을 문서화하고 최적화 기회를 식별하세요.+</Step><Step title="Crew 수준 전략 구현" icon="users-gear">@@ -369,6 +402,7 @@ tech_writer = Agent(```**Action**: 개별 agent 최적화 전에 crew의 기본 LLM을 설정하세요.+</Step><Step title="고임팩트 agent 최적화" icon="star">@@ -390,16 +424,18 @@ tech_writer = Agent(```**Action**: 복잡도의 80%를 처리하는 agent 20%를 업그레이드하세요.+</Step><Step title="엔터프라이즈 테스트로 검증" icon="test-tube">**agent를 프로덕션에 배포한 후:**- - [CrewAI AOP platform](https://app.crewai.com)을 활용하여 모델 선택을 A/B 테스트하세요+ - [CrewAI AMP platform](https://app.crewai.com)을 활용하여 모델 선택을 A/B 테스트하세요- 실제 입력으로 여러 번 반복 테스트하여 일관성과 성능을 측정하세요- 최적화된 셋업 전반의 비용과 성능을 비교하세요- 팀과 결과를 공유하여 협업 의사결정을 지원하세요**Action**: 테스트 플랫폼을 활용해 추측이 아닌 데이터 기반 검증을 실행하세요.+</Step></Steps>@@ -412,6 +448,7 @@ tech_writer = Agent(예를 들어, 비즈니스 전략 개발, 여러 출처에서 인사이트를 도출해야 하는 복잡한 데이터 분석, 각 단계가 이전 분석을 기반으로 해야 하는 다단계 문제 해결, 다양한 변수 및 이들의 상호작용을 고려해야 하는 전략적 계획 수립 업무에 reasoning 모델을 고려해 보세요.그러나 reasoning 모델은 일반적으로 더 높은 비용과 느린 응답 시간을 수반하므로, 복잡한 사고가 필요한 작업에서 실질적인 가치를 제공할 때에만 사용하는 것이 좋으며, 복잡한 reasoning이 필요하지 않은 단순한 작업에는 권장되지 않습니다.+</Tab><Tab title="Creative Models">@@ -420,6 +457,7 @@ tech_writer = Agent(creative 모델은 블로그 포스트 작성 및 기사 생성, 독자를 끌어들이고 설득해야 하는 마케팅 카피, 창의적인 스토리텔링 및 내러티브 개발, 목소리와 톤이 중요한 브랜드 커뮤니케이션 등에 적합합니다. 이 모델은 일반 목적 모델보다 뉘앙스와 맥락을 더 잘 이해할 수 있습니다.creative 모델은 정밀성과 사실적 정확성이 스타일이나 참여도보다 더 중요한 기술적 또는 분석적 작업에는 덜 적합할 수 있습니다. 결과물의 창의적·의사소통적 측면이 성공의 주요 요인일 때 사용하는 것이 가장 좋습니다.+</Tab><Tab title="Efficient Models">@@ -428,6 +466,7 @@ tech_writer = Agent(efficient 모델은 데이터 처리 및 변환 작업, 단순한 서식 지정 및 정리 작업, 정밀성이 중요하고 복잡함보다는 정확성이 필요한 함수 호출 및 도구 사용, 1회 작업당 비용이 중대한 고볼륨 작업에 적합합니다.efficient 모델에서는 해당 모델의 역량이 작업 요구 사항과 일치하는지 확인하는 것이 핵심입니다. 다양한 반복 작업을 효과적으로 처리할 수 있지만, 뉘앙스 이해, 복잡한 reasoning, 고도화된 콘텐츠 생성이 필요한 작업에서는 한계가 있을 수 있습니다.+</Tab><Tab title="Open Source Models">@@ -436,6 +475,7 @@ tech_writer = Agent(예를 들어, 데이터 프라이버시가 최우선인 사내 도구, 외부 API를 사용할 수 없는 프라이버시 민감형 애플리케이션, 토큰 단위 가격이 부담스러운 비용 최적화 배포, 모델 수정 또는 파인튜닝이 필요한 상황에서 open source 모델을 고려해 보세요.단, open source 모델은 효과적으로 배포하고 유지하기 위해 더 많은 기술 전문성이 요구됩니다. 인프라, 기술적 오버헤드, 지속적인 유지보수를 포함한 전체 소유 비용을 종합적으로 평가해야 합니다.+</Tab></Tabs>@@ -455,6 +495,7 @@ tech_writer = Agent(# 처리 agent는 효율적인 모델 사용processor = Agent(role="Data Processor", llm=LLM(model="gpt-4o-mini"))```+</Accordion><Accordion title="Crew 수준과 Agent 수준 LLM 계층 혼동" icon="shuffle">@@ -474,6 +515,7 @@ tech_writer = Agent(# agent는 특별히 지정하지 않으면 crew LLM을 상속받음agent1 = Agent(llm=LLM(model="claude-3-5-sonnet")) # 특정 요구에 따라 오버라이드```+</Accordion><Accordion title="함수 호출 모델 미스매치" icon="screwdriver-wrench">@@ -492,6 +534,7 @@ tech_writer = Agent(llm=LLM(model="claude-3-5-sonnet") # 도구 사용에 강점)```+</Accordion><Accordion title="테스트 없는 조기 최적화" icon="gear">@@ -507,6 +550,7 @@ tech_writer = Agent(# 성능을 테스트하고, 필요에 따라 특정 agent만 최적화# Enterprise 플랫폼 테스트를 통해 개선 사항 검증```+</Accordion><Accordion title="컨텍스트·메모리 한계 간과" icon="brain">@@ -515,6 +559,7 @@ tech_writer = Agent(**실제 예시**: 여러 차례 반복되는 업무나 agent 간 활발한 소통이 필요한 crew에 대화 내역을 오래 유지해야 하는데, 짧은 컨텍스트 모델을 사용한 경우.**CrewAI 솔루션**: crew의 소통 패턴에 맞춰 컨텍스트 처리 능력을 갖춘 모델을 선택.+</Accordion></AccordionGroup>@@ -522,26 +567,36 @@ tech_writer = Agent(<Steps><Step title="간단하게 시작하기" icon="play">- 신뢰할 수 있고, 잘 알려져 있으며, 널리 지원되는 범용 모델로 시작하세요. 이것은 최적화된 특수한 필요에 집중하기 전에 귀하의 특정 요구사항과 성능 기대치를 이해할 수 있는 안정적인 기초를 제공합니다.+ 신뢰할 수 있고, 잘 알려져 있으며, 널리 지원되는 범용 모델로 시작하세요.+ 이것은 최적화된 특수한 필요에 집중하기 전에 귀하의 특정 요구사항과 성능+ 기대치를 이해할 수 있는 안정적인 기초를 제공합니다.</Step><Step title="중요한 것 측정하기" icon="chart-line">- 일반적인 벤치마크에만 의존하지 말고, 귀하의 특정 사용 사례와 비즈니스 요구에 부합하는 지표를 개발하세요. 이론적 성능 지표가 아니라 성공에 직접적으로 영향을 미치는 결과 측정에 집중하세요.+ 일반적인 벤치마크에만 의존하지 말고, 귀하의 특정 사용 사례와 비즈니스 요구에+ 부합하는 지표를 개발하세요. 이론적 성능 지표가 아니라 성공에 직접적으로+ 영향을 미치는 결과 측정에 집중하세요.</Step><Step title="결과에 기반한 반복" icon="arrows-rotate">- 이론적 고려사항이나 일반적인 권장사항이 아니라, 귀하의 특정 상황에서 관찰된 성능에 따라 모델을 변경하세요. 실제 성능은 벤치마크 결과나 일반적인 평판과는 크게 다를 수 있습니다.+ 이론적 고려사항이나 일반적인 권장사항이 아니라, 귀하의 특정 상황에서 관찰된+ 성능에 따라 모델을 변경하세요. 실제 성능은 벤치마크 결과나 일반적인 평판과는+ 크게 다를 수 있습니다.</Step><Step title="총 비용 고려하기" icon="calculator">- 모델 비용, 개발 시간, 유지 보수 오버헤드, 운영 복잡성 등 소유에 드는 전체 비용을 평가하세요. 토큰당 가장 저렴한 모델이 모든 요소를 고려했을 때 반드시 가장 비용 효율적이지는 않을 수 있습니다.+ 모델 비용, 개발 시간, 유지 보수 오버헤드, 운영 복잡성 등 소유에 드는 전체+ 비용을 평가하세요. 토큰당 가장 저렴한 모델이 모든 요소를 고려했을 때 반드시+ 가장 비용 효율적이지는 않을 수 있습니다.</Step></Steps><Tip>-먼저 귀하의 요구사항을 이해하는 데 집중한 후, 그 요구와 가장 잘 맞는 모델을 선택하세요. 최상의 LLM 선택은 운영상의 제약 조건 내에서 꾸준히 원하는 결과를 제공하는 것입니다.+ 먼저 귀하의 요구사항을 이해하는 데 집중한 후, 그 요구와 가장 잘 맞는 모델을+ 선택하세요. 최상의 LLM 선택은 운영상의 제약 조건 내에서 꾸준히 원하는 결과를+ 제공하는 것입니다.</Tip>### 엔터프라이즈급 모델 검증-LLM 선택을 최적화하고자 하는 팀을 위해 **CrewAI AOP 플랫폼**은 기본적인 CLI 테스트를 훨씬 능가하는 정교한 테스트 기능을 제공합니다. 이 플랫폼은 데이터 기반의 LLM 전략 의사결정을 지원하는 종합적인 모델 평가를 가능하게 합니다.+LLM 선택을 최적화하고자 하는 팀을 위해 **CrewAI AMP 플랫폼**은 기본적인 CLI 테스트를 훨씬 능가하는 정교한 테스트 기능을 제공합니다. 이 플랫폼은 데이터 기반의 LLM 전략 의사결정을 지원하는 종합적인 모델 평가를 가능하게 합니다.<Frame>@@ -562,7 +617,9 @@ LLM 선택을 최적화하고자 하는 팀을 위해 **CrewAI AOP 플랫폼**지금 [app.crewai.com](https://app.crewai.com)에서 시작하세요!<Info>-Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터 기반 프로세스로 혁신하여, 본 가이드의 원칙을 실제 사용 사례와 요구 사항에 맞게 검증할 수 있도록 해줍니다.+ Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터 기반 프로세스로+ 혁신하여, 본 가이드의 원칙을 실제 사용 사례와 요구 사항에 맞게 검증할 수+ 있도록 해줍니다.</Info>## 주요 원칙 요약@@ -572,21 +629,25 @@ Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터이론적 능력이나 일반적인 평판이 아니라, 작업에 실제로 필요한 것에 따라 모델을 선택하세요.</Card>- <Card title="능력 일치" icon="puzzle-piece">- 최적의 성능을 위해 모델의 강점을 agent의 역할 및 책임과 일치시키세요.- </Card>+{" "}+<Card title="능력 일치" icon="puzzle-piece">+ 최적의 성능을 위해 모델의 강점을 agent의 역할 및 책임과 일치시키세요.+</Card>- <Card title="전략적 일관성" icon="link">- 관련 구성 요소와 워크플로 전반에 걸쳐 일관된 모델 선택 전략을 유지하세요.- </Card>+{" "}+<Card title="전략적 일관성" icon="link">+ 관련 구성 요소와 워크플로 전반에 걸쳐 일관된 모델 선택 전략을 유지하세요.+</Card>- <Card title="실용적 테스트" icon="flask">- 벤치마크에만 의존하지 말고 실제 사용을 통해 선택을 검증하세요.- </Card>+{" "}+<Card title="실용적 테스트" icon="flask">+ 벤치마크에만 의존하지 말고 실제 사용을 통해 선택을 검증하세요.+</Card>- <Card title="반복적 개선" icon="arrow-up">- 단순하게 시작하고 실제 성능과 필요에 따라 최적화하세요.- </Card>+{" "}+<Card title="반복적 개선" icon="arrow-up">+ 단순하게 시작하고 실제 성능과 필요에 따라 최적화하세요.+</Card><Card title="운영적 균형" icon="scale-balanced">성능 요구사항과 비용 및 복잡성 제약을 균형 있게 맞추세요.@@ -594,13 +655,19 @@ Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터</CardGroup><Check>-기억하세요: 최고의 LLM 선택이란 운영상의 제약 내에서 일관되게 필요한 결과를 제공하는 모델입니다. 먼저 요구사항을 정확히 이해하는 데 집중한 후, 그에 가장 잘 맞는 모델을 선택하세요.+ 기억하세요: 최고의 LLM 선택이란 운영상의 제약 내에서 일관되게 필요한 결과를+ 제공하는 모델입니다. 먼저 요구사항을 정확히 이해하는 데 집중한 후, 그에 가장+ 잘 맞는 모델을 선택하세요.</Check>## 현재 모델 현황 (2025년 6월)<Warning>-**특정 시점의 스냅샷**: 아래 모델 순위는 2025년 6월 기준으로, [LMSys Arena](https://arena.lmsys.org/), [Artificial Analysis](https://artificialanalysis.ai/) 및 기타 주요 벤치마크에서 집계된 최신 리더보드 결과입니다. LLM의 성능, 가용성, 가격은 빠르게 변동됩니다. 항상 귀하의 특정 사용 사례와 데이터로 직접 평가를 진행하시기 바랍니다.+ **특정 시점의 스냅샷**: 아래 모델 순위는 2025년 6월 기준으로, [LMSys+ Arena](https://arena.lmsys.org/), [Artificial+ Analysis](https://artificialanalysis.ai/) 및 기타 주요 벤치마크에서 집계된+ 최신 리더보드 결과입니다. LLM의 성능, 가용성, 가격은 빠르게 변동됩니다. 항상+ 귀하의 특정 사용 사례와 데이터로 직접 평가를 진행하시기 바랍니다.</Warning>### 카테고리별 주요 모델@@ -608,7 +675,10 @@ Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터아래 표는 다양한 카테고리에서 현재 최고의 성능을 보이는 대표적인 모델들을 보여주며, CrewAI 에이전트에 적합한 모델 선택에 대한 가이드를 제공합니다:<Note>-이 표와 지표는 각 카테고리에서 선별된 주요 모델을 보여주기 위한 것으로, 전체를 포괄하지 않습니다. 여기 소개되지 않은 훌륭한 모델들도 많이 존재합니다. 이 표의 목적은 완전한 목록을 제공하는 것이 아니라, 어떤 능력을 갖춘 모델을 찾아야 하는지 예시를 제시하는 것입니다.+ 이 표와 지표는 각 카테고리에서 선별된 주요 모델을 보여주기 위한 것으로, 전체를+ 포괄하지 않습니다. 여기 소개되지 않은 훌륭한 모델들도 많이 존재합니다. 이 표의+ 목적은 완전한 목록을 제공하는 것이 아니라, 어떤 능력을 갖춘 모델을 찾아야+ 하는지 예시를 제시하는 것입니다.</Note><Tabs>@@ -624,6 +694,7 @@ Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터| **Qwen3 235B (Reasoning)** | 62 | $2.63 | 보통 | reasoning 작업을 위한 오픈소스 대안 |이 모델들은 다단계 reasoning에 뛰어나며, 전략을 개발하거나 다른 에이전트를 조정하거나 복잡한 정보를 분석해야 하는 에이전트에 이상적입니다.+</Tab><Tab title="Coding & Technical">@@ -638,6 +709,7 @@ Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터| **Llama 3.1 405B** | 좋음 | 81.1% | $3.50 | 도구 사용이 많은 워크플로우를 위한 function calling LLM |이 모델들은 코드 생성, 디버깅, 기술 문제 해결에 최적화되어 있어, 개발 중심 팀에 적합합니다.+</Tab><Tab title="Speed & Efficiency">@@ -652,6 +724,7 @@ Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터| **Nova Micro** | 높음 | 0.30s | $0.04 | 단순·빠른 작업 처리 |이 모델들은 속도와 효율을 우선시하며, 일상적 운영 또는 신속한 응답이 필요한 에이전트에게 최적입니다. **팁**: 이러한 모델을 Groq와 같은 빠른 추론 제공자와 함께 사용하면 더욱 우수한 성능을 낼 수 있습니다. 특히 Llama와 같은 오픈소스 모델에 적합합니다.+</Tab><Tab title="Balanced Performance">@@ -666,6 +739,7 @@ Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터| **Qwen3 32B** | 44 | 좋음 | $1.23 | 예산 친화적 다재다능성 |이 모델들은 다양한 측면에서 우수한 성능을 제공하며, 여러 작업이 혼합된 팀에 적합합니다.+</Tab></Tabs>@@ -676,24 +750,28 @@ Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터**퍼포먼스가 우선 순위일 때**: 매니저 LLM 또는 중요한 에이전트 역할에는 **o3**, **Gemini 2.5 Pro**, **Claude 4 Sonnet**과 같은 최상위 모델을 사용하세요. 이 모델들은 복잡한 reasoning 및 coordination에 탁월하지만 비용이 더 높습니다.**전략**: 프리미엄 모델이 전략적 사고를 담당하고, 효율적인 모델이 일상적 operation을 처리하는 멀티 모델 접근법을 구현하세요.+</Accordion><Accordion title="Cost-Conscious Crews" icon="dollar-sign">**예산이 주요 제약일 때**: **DeepSeek R1**, **Llama 4 Scout**, **Gemini 2.0 Flash**와 같은 모델에 집중하세요. 이 모델들은 훨씬 낮은 비용으로 강력한 퍼포먼스를 제공합니다.**전략**: 대부분의 에이전트에는 비용 효율이 높은 모델을 사용하고, 가장 중요한 decision-making 역할에만 프리미엄 모델을 남겨두세요.+</Accordion><Accordion title="Specialized Workflows" icon="screwdriver-wrench">**특정 도메인 전문성이 필요할 때**: 주된 사용 사례에 최적화된 모델을 선택하세요. 코딩에는 **Claude 4** 시리즈, 리서치에는 **Gemini 2.5 Pro**, function calling에는 **Llama 405B**를 사용하세요.**전략**: crew의 주요 기능에 따라 모델을 선택해, 핵심 역량이 모델의 강점과 일치하도록 하세요.+</Accordion><Accordion title="Enterprise & Privacy" icon="shield">**데이터 민감한 operation의 경우**: 로컬에서 배포 가능하면서 경쟁력 있는 퍼포먼스를 유지하는 오픈 소스 모델인 **Llama 4** 시리즈, **DeepSeek V3**, **Qwen3** 등을 고려하세요.**전략**: 사설 인프라에 오픈 소스 모델을 배포하여, 데이터 제어를 위해 필요한 퍼포먼스 손실을 감수하세요.+</Accordion></AccordionGroup>@@ -706,7 +784,10 @@ Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터- **오픈 소스의 실효성**: 오픈 소스와 독점 모델 간의 격차가 계속 좁혀지고 있으며, Llama 4 Maverick 및 DeepSeek V3와 같은 모델이 매력적인 가격대에서 경쟁력 있는 성능을 제공합니다. 특히 빠른 추론을 제공하는 업체들은 오픈 소스 모델과 함께 탁월한 속도-비용 비율을 제공하는 경우가 많아 독점 모델보다 우위에 서기도 합니다.<Info>-**테스트는 필수입니다**: 리더보드 순위는 일반적인 가이드라인을 제공하지만, 귀하의 특정 사용 사례, 프롬프트 스타일, 평가 기준에 따라 결과가 달라질 수 있습니다. 최종 결정을 내리기 전에 반드시 실제 작업과 데이터로 후보 모델을 테스트해 보세요.+ **테스트는 필수입니다**: 리더보드 순위는 일반적인 가이드라인을 제공하지만,+ 귀하의 특정 사용 사례, 프롬프트 스타일, 평가 기준에 따라 결과가 달라질 수+ 있습니다. 최종 결정을 내리기 전에 반드시 실제 작업과 데이터로 후보 모델을+ 테스트해 보세요.</Info>### 실질적인 구현 전략@@ -716,13 +797,19 @@ Enterprise 플랫폼은 모델 선택을 단순한 추측이 아닌 데이터여러 차원에서 우수한 성능을 제공하며 실제 환경에서 광범위하게 검증된 **GPT-4.1**, **Claude 3.7 Sonnet**, **Gemini 2.0 Flash**와 같은 잘 알려진 모델부터 시작하십시오.</Step>- <Step title="특화된 요구 사항 식별">- crew에 코드 작성, reasoning, 속도 등 특정 요구가 있는지 확인하고, 이러한 요구에 부합하는 **Claude 4 Sonnet**(개발용) 또는 **o3**(복잡한 분석용)과 같은 특화 모델을 고려하십시오. 속도가 중요한 애플리케이션의 경우, 모델 선택과 더불어 **Groq**와 같은 빠른 추론 제공자를 고려할 수 있습니다.- </Step>-- <Step title="다중 모델 전략 구현">- 각 에이전트의 역할에 따라 다양한 모델을 사용하세요. 관리자와 복잡한 작업에는 고성능 모델을, 일상적 운영에는 효율적인 모델을 적용합니다.- </Step>+{" "}+<Step title="특화된 요구 사항 식별">+ crew에 코드 작성, reasoning, 속도 등 특정 요구가 있는지 확인하고, 이러한+ 요구에 부합하는 **Claude 4 Sonnet**(개발용) 또는 **o3**(복잡한 분석용)과 같은+ 특화 모델을 고려하십시오. 속도가 중요한 애플리케이션의 경우, 모델 선택과+ 더불어 **Groq**와 같은 빠른 추론 제공자를 고려할 수 있습니다.+</Step>++{" "}+<Step title="다중 모델 전략 구현">+ 각 에이전트의 역할에 따라 다양한 모델을 사용하세요. 관리자와 복잡한 작업에는+ 고성능 모델을, 일상적 운영에는 효율적인 모델을 적용합니다.+</Step><Step title="모니터링 및 최적화">사용 사례와 관련된 성능 지표를 추적하고, 새로운 모델이 출시되거나 가격이 변동될 때 모델 선택을 조정할 준비를 하십시오.diff --git a/docs/ko/mcp/dsl-integration.mdx b/docs/ko/mcp/dsl-integration.mdxindex d7da0d788..56bb63911 100644--- a/docs/ko/mcp/dsl-integration.mdx+++ b/docs/ko/mcp/dsl-integration.mdx@@ -10,7 +10,9 @@ mode: "wide"CrewAI의 MCP DSL(Domain Specific Language) 통합은 에이전트를 MCP(Model Context Protocol) 서버에 연결하는 **가장 간단한 방법**을 제공합니다. 에이전트에 `mcps` 필드만 추가하면 CrewAI가 모든 복잡성을 자동으로 처리합니다.<Info>-이는 대부분의 MCP 사용 사례에 **권장되는 접근 방식**입니다. 수동 연결 관리가 필요한 고급 시나리오의 경우 [MCPServerAdapter](/ko/mcp/overview#advanced-mcpserveradapter)를 참조하세요.+ 이는 대부분의 MCP 사용 사례에 **권장되는 접근 방식**입니다. 수동 연결 관리가+ 필요한 고급 시나리오의 경우+ [MCPServerAdapter](/ko/mcp/overview#advanced-mcpserveradapter)를 참조하세요.</Info>## 기본 사용법@@ -60,9 +62,9 @@ agent = Agent("https://mcp.exa.ai/mcp?api_key=your_key#web_search_exa"```-### CrewAI AOP 마켓플레이스+### CrewAI AMP 마켓플레이스-CrewAI AOP 마켓플레이스의 도구에 액세스하세요:+CrewAI AMP 마켓플레이스의 도구에 액세스하세요:```python# 모든 도구가 포함된 전체 서비스@@ -97,7 +99,7 @@ multi_source_agent = Agent("https://mcp.exa.ai/mcp?api_key=your_exa_key&profile=research","https://weather.api.com/mcp#get_current_conditions",- # CrewAI AOP 마켓플레이스+ # CrewAI AMP 마켓플레이스"crewai-amp:financial-insights","crewai-amp:academic-research#pubmed_search","crewai-amp:market-intelligence#competitor_analysis"diff --git a/docs/ko/mcp/overview.mdx b/docs/ko/mcp/overview.mdxindex c3b290840..23b58ded9 100644--- a/docs/ko/mcp/overview.mdx+++ b/docs/ko/mcp/overview.mdx@@ -1,6 +1,6 @@----title: 'CrewAI에서 MCP 서버를 도구로 활용하기'-description: '`crewai-tools` 라이브러리를 사용하여 MCP 서버를 CrewAI agent에 도구로 통합하는 방법을 알아봅니다.'+title: "CrewAI에서 MCP 서버를 도구로 활용하기"+description: "`crewai-tools` 라이브러리를 사용하여 MCP 서버를 CrewAI agent에 도구로 통합하는 방법을 알아봅니다."icon: plugmode: "wide"---@@ -25,7 +25,7 @@ agent = Agent(mcps=["https://mcp.exa.ai/mcp?api_key=your_key", # 외부 MCP 서버"https://api.weather.com/mcp#get_forecast", # 서버의 특정 도구- "crewai-amp:financial-data", # CrewAI AOP 마켓플레이스+ "crewai-amp:financial-data", # CrewAI AMP 마켓플레이스"crewai-amp:research-tools#pubmed_search" # 특정 AMP 도구])@@ -43,6 +43,7 @@ agent = Agent(- **Streamable HTTP**: 원격 서버용 (유연하며 잠재적으로 양방향 통신이 가능, 주로 SSE를 활용한 서버-클라이언트 스트림 제공, HTTP 기반)## 비디오 튜토리얼+CrewAI와 MCP 통합에 대한 종합적인 안내를 위해 이 비디오 튜토리얼을 시청하세요:<iframe@@ -120,6 +121,7 @@ with MCPServerAdapter(server_params, connect_timeout=60) as mcp_tools:)# ... 나머지 crew 설정 ...```+이 일반적인 패턴은 도구를 통합하는 방법을 보여줍니다. 각 transport에 맞춘 구체적인 예시는 아래의 상세 가이드를 참고하세요.## 필터링 도구@@ -206,6 +208,7 @@ class CrewWithMCP:- `mcp_server_params`를 지정하지 않으면 `get_mcp_tools()`는 빈 리스트를 반환하여 MCP 설정 여부와 상관없이 동일한 코드 경로를 사용할 수 있습니다.따라서 여러 에이전트에서 `get_mcp_tools()`를 호출하거나 환경에 따라 MCP 사용을 토글하더라도 안전하게 동작합니다.+</Tip>### 연결 타임아웃 구성@@ -266,21 +269,13 @@ class CrewWithCustomTimeout:## MCP 통합 탐색<CardGroup cols={2}>- <Card- title="Stdio 전송"- icon="server"- href="/ko/mcp/stdio"- color="#3B82F6"- >- 표준 입력/출력을 통해 로컬 MCP 서버에 연결합니다. 스크립트와 로컬 실행 파일에 이상적입니다.+ <Card title="Stdio 전송" icon="server" href="/ko/mcp/stdio" color="#3B82F6">+ 표준 입력/출력을 통해 로컬 MCP 서버에 연결합니다. 스크립트와 로컬 실행+ 파일에 이상적입니다.</Card>- <Card- title="SSE 전송"- icon="wifi"- href="/ko/mcp/sse"- color="#10B981"- >- 실시간 데이터 스트리밍을 위해 Server-Sent Events를 사용하여 원격 MCP 서버와 통합합니다.+ <Card title="SSE 전송" icon="wifi" href="/ko/mcp/sse" color="#10B981">+ 실시간 데이터 스트리밍을 위해 Server-Sent Events를 사용하여 원격 MCP 서버와+ 통합합니다.</Card><Cardtitle="스트림 가능한 HTTP 전송"@@ -288,7 +283,8 @@ class CrewWithCustomTimeout:href="/ko/mcp/streamable-http"color="#F59E0B">- 유연한 스트림 가능한 HTTP를 활용하여 원격 MCP 서버와 안정적으로 통신할 수 있습니다.+ 유연한 스트림 가능한 HTTP를 활용하여 원격 MCP 서버와 안정적으로 통신할 수+ 있습니다.</Card><Cardtitle="다중 서버 연결"@@ -304,27 +300,30 @@ class CrewWithCustomTimeout:href="/ko/mcp/security"color="#EF4444">- 에이전트를 안전하게 보호하기 위한 MCP 통합의 중요한 보안 모범 사례를 검토하세요.+ 에이전트를 안전하게 보호하기 위한 MCP 통합의 중요한 보안 모범 사례를+ 검토하세요.</Card></CardGroup>CrewAI와의 MCP 통합에 대한 전체 데모와 예제를 보려면 이 저장소를 확인하세요! 👇<Card-title="GitHub 저장소"-icon="github"-href="https://github.com/tonykipkemboi/crewai-mcp-demo"-target="_blank"+ title="GitHub 저장소"+ icon="github"+ href="https://github.com/tonykipkemboi/crewai-mcp-demo"+ target="_blank">-CrewAI MCP 데모+ CrewAI MCP 데모</Card>## MCP와 함께 안전하게 사용하기+<Warning>-항상 MCP 서버를 사용하기 전에 해당 서버를 신뢰할 수 있는지 확인하세요.+ 항상 MCP 서버를 사용하기 전에 해당 서버를 신뢰할 수 있는지 확인하세요.</Warning>#### 보안 경고: DNS 리바인딩 공격+SSE 전송은 적절하게 보안되지 않은 경우 DNS 리바인딩 공격에 취약할 수 있습니다.이를 방지하려면 다음을 수행하세요:@@ -337,5 +336,6 @@ SSE 전송은 적절하게 보안되지 않은 경우 DNS 리바인딩 공격에자세한 내용은 [Anthropic의 MCP 전송 보안 문서](https://modelcontextprotocol.io/docs/concepts/transports#security-considerations)를 참고하세요.### 제한 사항-* **지원되는 프리미티브**: 현재 `MCPServerAdapter`는 주로 MCP `tools`를 어댑팅하는 기능을 지원합니다. 다른 MCP 프리미티브(예: `prompts` 또는 `resources`)는 현재 이 어댑터를 통해 CrewAI 컴포넌트로 직접 통합되어 있지 않습니다.-* **출력 처리**: 어댑터는 일반적으로 MCP tool의 주요 텍스트 출력(예: `.content[0].text`)을 처리합니다. 복잡하거나 멀티모달 출력의 경우 이 패턴에 맞지 않으면 별도의 커스텀 처리가 필요할 수 있습니다.++- **지원되는 프리미티브**: 현재 `MCPServerAdapter`는 주로 MCP `tools`를 어댑팅하는 기능을 지원합니다. 다른 MCP 프리미티브(예: `prompts` 또는 `resources`)는 현재 이 어댑터를 통해 CrewAI 컴포넌트로 직접 통합되어 있지 않습니다.+- **출력 처리**: 어댑터는 일반적으로 MCP tool의 주요 텍스트 출력(예: `.content[0].text`)을 처리합니다. 복잡하거나 멀티모달 출력의 경우 이 패턴에 맞지 않으면 별도의 커스텀 처리가 필요할 수 있습니다.diff --git a/docs/ko/observability/tracing.mdx b/docs/ko/observability/tracing.mdxindex 5551523b5..1691f01ae 100644--- a/docs/ko/observability/tracing.mdx+++ b/docs/ko/observability/tracing.mdx@@ -1,6 +1,6 @@---title: CrewAI Tracing-description: CrewAI AOP 플랫폼을 사용한 CrewAI Crews 및 Flows의 내장 추적+description: CrewAI AMP 플랫폼을 사용한 CrewAI Crews 및 Flows의 내장 추적icon: magnifying-glass-chartmode: "wide"---@@ -9,7 +9,7 @@ mode: "wide"CrewAI는 Crews와 Flows를 실시간으로 모니터링하고 디버깅할 수 있는 내장 추적 기능을 제공합니다. 이 가이드는 CrewAI의 통합 관측 가능성 플랫폼을 사용하여 **Crews**와 **Flows** 모두에 대한 추적을 활성화하는 방법을 보여줍니다.-> **CrewAI Tracing이란?** CrewAI의 내장 추적은 agent 결정, 작업 실행 타임라인, 도구 사용, LLM 호출을 포함한 AI agent에 대한 포괄적인 관측 가능성을 제공하며, 모두 [CrewAI AOP 플랫폼](https://app.crewai.com)을 통해 액세스할 수 있습니다.+> **CrewAI Tracing이란?** CrewAI의 내장 추적은 agent 결정, 작업 실행 타임라인, 도구 사용, LLM 호출을 포함한 AI agent에 대한 포괄적인 관측 가능성을 제공하며, 모두 [CrewAI AMP 플랫폼](https://app.crewai.com)을 통해 액세스할 수 있습니다.@@ -17,7 +17,7 @@ CrewAI는 Crews와 Flows를 실시간으로 모니터링하고 디버깅할 수CrewAI 추적을 사용하기 전에 다음이 필요합니다:-1. **CrewAI AOP 계정**: [app.crewai.com](https://app.crewai.com)에서 무료 계정에 가입하세요+1. **CrewAI AMP 계정**: [app.crewai.com](https://app.crewai.com)에서 무료 계정에 가입하세요2. **CLI 인증**: CrewAI CLI를 사용하여 로컬 환경을 인증하세요```bash@@ -26,9 +26,9 @@ crewai login## 설정 지침-### 1단계: CrewAI AOP 계정 생성+### 1단계: CrewAI AMP 계정 생성-[app.crewai.com](https://app.crewai.com)을 방문하여 무료 계정을 만드세요. 이를 통해 추적, 메트릭을 보고 crews를 관리할 수 있는 CrewAI AOP 플랫폼에 액세스할 수 있습니다.+[app.crewai.com](https://app.crewai.com)을 방문하여 무료 계정을 만드세요. 이를 통해 추적, 메트릭을 보고 crews를 관리할 수 있는 CrewAI AMP 플랫폼에 액세스할 수 있습니다.### 2단계: CrewAI CLI 설치 및 인증@@ -38,16 +38,17 @@ crewai loginuv add crewai[tools]```-그런 다음 CrewAI AOP 계정으로 CLI를 인증하세요:+그런 다음 CrewAI AMP 계정으로 CLI를 인증하세요:```bashcrewai login```이 명령은 다음을 수행합니다:+1. 브라우저에서 인증 페이지를 엽니다2. 장치 코드를 입력하라는 메시지를 표시합니다-3. CrewAI AOP 계정으로 로컬 환경을 인증합니다+3. CrewAI AMP 계정으로 로컬 환경을 인증합니다4. 로컬 개발을 위한 추적 기능을 활성화합니다### 3단계: Crew에서 추적 활성화@@ -147,13 +148,12 @@ flow = ExampleFlow(tracing=True)result = flow.kickoff()```-### 5단계: CrewAI AOP 대시보드에서 추적 보기+### 5단계: CrewAI AMP 대시보드에서 추적 보기-crew 또는 flow를 실행한 후 CrewAI AOP 대시보드에서 CrewAI 애플리케이션이 생성한 추적을 볼 수 있습니다. agent 상호 작용, 도구 사용 및 LLM 호출의 세부 단계를 볼 수 있습니다.+crew 또는 flow를 실행한 후 CrewAI AMP 대시보드에서 CrewAI 애플리케이션이 생성한 추적을 볼 수 있습니다. agent 상호 작용, 도구 사용 및 LLM 호출의 세부 단계를 볼 수 있습니다.아래 링크를 클릭하여 추적을 보거나 대시보드의 추적 탭으로 이동하세요 [여기](https://app.crewai.com/crewai_plus/trace_batches)-### 대안: 환경 변수 구성환경 변수를 설정하여 전역적으로 추적을 활성화할 수도 있습니다:@@ -172,7 +172,7 @@ CREWAI_TRACING_ENABLED=true## 추적 보기-### CrewAI AOP 대시보드 액세스+### CrewAI AMP 대시보드 액세스1. [app.crewai.com](https://app.crewai.com)을 방문하여 계정에 로그인하세요2. 프로젝트 대시보드로 이동하세요@@ -190,6 +190,7 @@ CrewAI 추적은 다음에 대한 포괄적인 가시성을 제공합니다:- **오류 추적**: 세부 오류 정보 및 스택 추적### 추적 기능+- **실행 타임라인**: 실행의 다양한 단계를 클릭하여 확인하세요- **세부 로그**: 디버깅을 위한 포괄적인 로그에 액세스하세요- **성능 분석**: 실행 패턴을 분석하고 성능을 최적화하세요diff --git a/docs/ko/quickstart.mdx b/docs/ko/quickstart.mdxindex 1a69baffb..cdfbf6608 100644--- a/docs/ko/quickstart.mdx+++ b/docs/ko/quickstart.mdx@@ -58,6 +58,7 @@ mode: "wide"your ability to turn complex data into clear and concise reports, makingit easy for others to understand and act on the information you provide.```+</Step><Step title="`tasks.yaml` 파일 수정하기">```yaml tasks.yaml@@ -81,6 +82,7 @@ mode: "wide"agent: reporting_analystoutput_file: report.md```+</Step><Step title="`crew.py` 파일 수정하기">```python crew.py@@ -136,6 +138,7 @@ mode: "wide"verbose=True,)```+</Step><Step title="[선택 사항] crew 실행 전/후 함수 추가">```python crew.py@@ -160,6 +163,7 @@ mode: "wide"# ... remaining code```+</Step><Step title="crew에 커스텀 입력값 전달하기">예를 들어, crew에 `topic` 입력값을 넘겨 연구 및 보고서 출력을 맞춤화할 수 있습니다.@@ -178,6 +182,7 @@ mode: "wide"}LatestAiDevelopmentCrew().crew().kickoff(inputs=inputs)```+</Step><Step title="환경 변수 설정">crew를 실행하기 전에 `.env` 파일에 아래 키가 환경 변수로 설정되어 있는지 확인하세요:@@ -209,24 +214,24 @@ mode: "wide"</Step><Step title="엔터프라이즈 대안: Crew Studio에서 생성">- CrewAI AOP 사용자는 코드를 작성하지 않고도 동일한 crew를 생성할 수 있습니다:+ CrewAI AMP 사용자는 코드를 작성하지 않고도 동일한 crew를 생성할 수 있습니다:- 1. CrewAI AOP 계정에 로그인하세요([app.crewai.com](https://app.crewai.com)에서 무료 계정 만들기)- 2. Crew Studio 열기- 3. 구현하려는 자동화 내용을 입력하세요- 4. 미션을 시각적으로 생성하고 순차적으로 연결하세요- 5. 입력값을 구성하고 "Download Code" 또는 "Deploy"를 클릭하세요+1. CrewAI AMP 계정에 로그인하세요([app.crewai.com](https://app.crewai.com)에서 무료 계정 만들기)+2. Crew Studio 열기+3. 구현하려는 자동화 내용을 입력하세요+4. 미션을 시각적으로 생성하고 순차적으로 연결하세요+5. 입력값을 구성하고 "Download Code" 또는 "Deploy"를 클릭하세요- +- <Card title="CrewAI AOP 체험하기" icon="rocket" href="https://app.crewai.com">+ <Card title="CrewAI AMP 체험하기" icon="rocket" href="https://app.crewai.com">CrewAI AOP에서 무료 계정을 시작하세요</Card></Step><Step title="최종 보고서 확인하기">콘솔에서 출력 결과를 확인할 수 있으며 프로젝트 루트에 `report.md` 파일로 최종 보고서가 생성됩니다.- 보고서 예시는 다음과 같습니다:+보고서 예시는 다음과 같습니다:<CodeGroup>```markdown output/report.md@@ -289,6 +294,7 @@ mode: "wide"## 8. ConclusionThe emergence of AI agents is undeniably reshaping the workplace landscape in 5. With their ability to automate tasks, enhance efficiency, and improve decision-making, AI agents are critical in driving operational success. Organizations must embrace and adapt to AI developments to thrive in an increasingly digital business environment.```+</CodeGroup></Step></Steps>@@ -297,6 +303,7 @@ mode: "wide"축하합니다!crew 프로젝트 설정이 완료되었으며, 이제 자신만의 agentic workflow 구축을 바로 시작하실 수 있습니다!+</Check>### 명명 일관성에 대한 참고@@ -308,41 +315,44 @@ YAML 파일(`agents.yaml` 및 `tasks.yaml`)에서 사용하는 이름은 Python#### 예시 참조<Tip>- `agents.yaml` (`email_summarizer`) 파일에서 에이전트 이름과 `crew.py` (`email_summarizer`) 파일에서 메서드 이름이 동일하게 사용되는 점에 주목하세요.+ `agents.yaml` (`email_summarizer`) 파일에서 에이전트 이름과 `crew.py`+ (`email_summarizer`) 파일에서 메서드 이름이 동일하게 사용되는 점에 주목하세요.</Tip>```yaml agents.yamlemail_summarizer:- role: >- Email Summarizer- goal: >- Summarize emails into a concise and clear summary- backstory: >- You will create a 5 bullet point summary of the report- llm: provider/model-id # Add your choice of model here+ role: >+ Email Summarizer+ goal: >+ Summarize emails into a concise and clear summary+ backstory: >+ You will create a 5 bullet point summary of the report+ llm: provider/model-id # Add your choice of model here```<Tip>- `tasks.yaml` (`email_summarizer_task`) 파일에서 태스크 이름과 `crew.py` (`email_summarizer_task`) 파일에서 메서드 이름이 동일하게 사용되는 점에 주목하세요.+ `tasks.yaml` (`email_summarizer_task`) 파일에서 태스크 이름과 `crew.py`+ (`email_summarizer_task`) 파일에서 메서드 이름이 동일하게 사용되는 점에+ 주목하세요.</Tip>```yaml tasks.yamlemail_summarizer_task:- description: >- Summarize the email into a 5 bullet point summary- expected_output: >- A 5 bullet point summary of the email- agent: email_summarizer- context:- - reporting_task- - research_task+ description: >+ Summarize the email into a 5 bullet point summary+ expected_output: >+ A 5 bullet point summary of the email+ agent: email_summarizer+ context:+ - reporting_task+ - research_task```## Crew 배포하기-production 환경에 crew를 배포하는 가장 쉬운 방법은 [CrewAI AOP](http://app.crewai.com)를 통해서입니다.+production 환경에 crew를 배포하는 가장 쉬운 방법은 [CrewAI AMP](http://app.crewai.com)를 통해서입니다.-CLI를 사용하여 [CrewAI AOP](http://app.crewai.com)에 crew를 배포하는 단계별 시연은 이 영상 튜토리얼을 참고하세요.+CLI를 사용하여 [CrewAI AMP](http://app.crewai.com)에 crew를 배포하는 단계별 시연은 이 영상 튜토리얼을 참고하세요.<iframeclassName="w-full aspect-video rounded-xl"@@ -354,18 +364,16 @@ CLI를 사용하여 [CrewAI AOP](http://app.crewai.com)에 crew를 배포하는></iframe><CardGroup cols={2}>- <Card- title="Enterprise에 배포"- icon="rocket"- href="http://app.crewai.com"- >- CrewAI AOP로 시작하여 몇 번의 클릭만으로 production 환경에 crew를 배포하세요.+ <Card title="Enterprise에 배포" icon="rocket" href="http://app.crewai.com">+ CrewAI AOP로 시작하여 몇 번의 클릭만으로 production 환경에 crew를+ 배포하세요.</Card><Cardtitle="커뮤니티 참여하기"icon="comments"href="https://community.crewai.com">- 오픈 소스 커뮤니티에 참여하여 아이디어를 나누고, 프로젝트를 공유하며, 다른 CrewAI 개발자들과 소통하세요.+ 오픈 소스 커뮤니티에 참여하여 아이디어를 나누고, 프로젝트를 공유하며, 다른+ CrewAI 개발자들과 소통하세요.</Card></CardGroup>diff --git a/docs/pt-BR/api-reference/introduction.mdx b/docs/pt-BR/api-reference/introduction.mdxindex 2ddbe9720..e071e3b1b 100644--- a/docs/pt-BR/api-reference/introduction.mdx+++ b/docs/pt-BR/api-reference/introduction.mdx@@ -1,19 +1,19 @@---title: "Introdução"-description: "Referência completa para a API REST do CrewAI AOP"+description: "Referência completa para a API REST do CrewAI AMP"icon: "code"mode: "wide"----# CrewAI AOP API+# CrewAI AMP API-Bem-vindo à referência da API do CrewAI AOP. Esta API permite que você interaja programaticamente com seus crews implantados, possibilitando a integração com seus aplicativos, fluxos de trabalho e serviços.+Bem-vindo à referência da API do CrewAI AMP. Esta API permite que você interaja programaticamente com seus crews implantados, possibilitando a integração com seus aplicativos, fluxos de trabalho e serviços.## Início Rápido<Steps><Step title="Obtenha suas credenciais de API">- Navegue até a página de detalhes do seu crew no painel do CrewAI AOP e copie seu Bearer Token na aba Status.+ Navegue até a página de detalhes do seu crew no painel do CrewAI AMP e copie seu Bearer Token na aba Status.</Step><Step title="Descubra os Inputs Necessários">@@ -48,7 +48,7 @@ curl -H "Authorization: Bearer YOUR_CREW_TOKEN" \<Tip>Você pode encontrar ambos os tipos de token na aba Status da página de- detalhes do seu crew no painel do CrewAI AOP.+ detalhes do seu crew no painel do CrewAI AMP.</Tip>## URL Base@@ -84,7 +84,7 @@ A API utiliza códigos de status HTTP padrão:## Testes Interativos<Info>- **Por que não há botão "Enviar"?** Como cada usuário do CrewAI AOP possui sua+ **Por que não há botão "Enviar"?** Como cada usuário do CrewAI AMP possui suaprópria URL de crew, utilizamos o **modo referência** em vez de um playgroundinterativo para evitar confusão. Isso mostra exatamente como as requisiçõesdevem ser feitas, sem botões de envio não funcionais.diff --git a/docs/pt-BR/concepts/agents.mdx b/docs/pt-BR/concepts/agents.mdxindex f7cc71360..383d501c6 100644--- a/docs/pt-BR/concepts/agents.mdx+++ b/docs/pt-BR/concepts/agents.mdx@@ -8,6 +8,7 @@ mode: "wide"## Visão Geral de um AgenteNo framework CrewAI, um `Agent` é uma unidade autônoma que pode:+- Executar tarefas específicas- Tomar decisões com base em seu papel e objetivo- Utilizar ferramentas para alcançar objetivos@@ -16,15 +17,19 @@ No framework CrewAI, um `Agent` é uma unidade autônoma que pode:- Delegar tarefas, quando permitido<Tip>-Pense em um agente como um membro especializado da equipe com habilidades, competências e responsabilidades específicas. Por exemplo, um agente `Researcher` pode ser excelente em coletar e analisar informações, enquanto um agente `Writer` pode ser melhor na criação de conteúdo.+ Pense em um agente como um membro especializado da equipe com habilidades,+ competências e responsabilidades específicas. Por exemplo, um agente+ `Researcher` pode ser excelente em coletar e analisar informações, enquanto um+ agente `Writer` pode ser melhor na criação de conteúdo.</Tip><Note type="info" title="Aprimoramento Empresarial: Construtor Visual de Agentes">-O CrewAI AOP inclui um Construtor Visual de Agentes, que simplifica a criação e configuração de agentes sem escrever código. Projete seus agentes visualmente e teste-os em tempo real.+O CrewAI AMP inclui um Construtor Visual de Agentes, que simplifica a criação e configuração de agentes sem escrever código. Projete seus agentes visualmente e teste-os em tempo real.O Construtor Visual de Agentes permite:+- Configuração intuitiva de agentes com interfaces baseadas em formulários- Testes e validação em tempo real- Biblioteca de modelos com tipos de agentes pré-configurados@@ -33,36 +38,36 @@ O Construtor Visual de Agentes permite:## Atributos do Agente-| Atributo | Parâmetro | Tipo | Descrição |-| :-------------------------------------- | :----------------------- | :---------------------------- | :----------------------------------------------------------------------------------------------------------------- |-| **Role (Função)** | `role` | `str` | Define a função e a área de especialização do agente dentro da equipe. |-| **Goal (Objetivo)** | `goal` | `str` | O objetivo individual que guia a tomada de decisão do agente. |-| **Backstory (História de fundo)** | `backstory` | `str` | Fornece contexto e personalidade ao agente, enriquecendo as interações. |-| **LLM** _(opcional)_ | `llm` | `Union[str, LLM, Any]` | Modelo de linguagem que alimenta o agente. Padrão: modelo especificado em `OPENAI_MODEL_NAME` ou "gpt-4". |-| **Tools (Ferramentas)** _(opcional)_ | `tools` | `List[BaseTool]` | Capacidades ou funções disponíveis para o agente. Padrão: lista vazia. |-| **Function Calling LLM** _(opcional)_ | `function_calling_llm` | `Optional[Any]` | Modelo de linguagem usado para chamada de ferramentas, sobrescreve LLM principal se especificado. |-| **Max Iterations** _(opcional)_ | `max_iter` | `int` | Número máximo de iterações antes do agente fornecer sua melhor resposta. Padrão: 20. |-| **Max RPM** _(opcional)_ | `max_rpm` | `Optional[int]` | Quantidade máxima de requisições por minuto para evitar limites de taxa. |-| **Max Execution Time** _(opcional)_ | `max_execution_time` | `Optional[int]` | Tempo máximo (em segundos) de execução da tarefa. |-| **Verbose** _(opcional)_ | `verbose` | `bool` | Habilita logs detalhados de execução para depuração. Padrão: False. |-| **Allow Delegation** _(opcional)_ | `allow_delegation` | `bool` | Permite que o agente delegue tarefas para outros agentes. Padrão: False. |-| **Step Callback** _(opcional)_ | `step_callback` | `Optional[Any]` | Função chamada após cada passo do agente, sobrescreve callback da equipe. |-| **Cache** _(opcional)_ | `cache` | `bool` | Ativa cache para o uso de ferramentas. Padrão: True. |-| **System Template** _(opcional)_ | `system_template` | `Optional[str]` | Template personalizado de prompt de sistema para o agente. |-| **Prompt Template** _(opcional)_ | `prompt_template` | `Optional[str]` | Template de prompt personalizado para o agente. |-| **Response Template** _(opcional)_ | `response_template` | `Optional[str]` | Template de resposta personalizado para o agente. |-| **Allow Code Execution** _(opcional)_ | `allow_code_execution` | `Optional[bool]` | Ativa execução de código pelo agente. Padrão: False. |-| **Max Retry Limit** _(opcional)_ | `max_retry_limit` | `int` | Número máximo de tentativas (retries) em caso de erro. Padrão: 2. |-| **Respect Context Window** _(opcional)_ | `respect_context_window` | `bool` | Mantém as mensagens dentro do tamanho da janela de contexto, resumindo quando necessário. Padrão: True. |-| **Code Execution Mode** _(opcional)_ | `code_execution_mode` | `Literal["safe", "unsafe"]` | Modo de execução de código: 'safe' (usando Docker) ou 'unsafe' (direto). Padrão: 'safe'. |-| **Multimodal** _(opcional)_ | `multimodal` | `bool` | Se o agente suporta capacidades multimodais. Padrão: False. |-| **Inject Date** _(opcional)_ | `inject_date` | `bool` | Se deve injetar automaticamente a data atual nas tarefas. Padrão: False. |-| **Date Format** _(opcional)_ | `date_format` | `str` | Formato de data utilizado quando `inject_date` está ativo. Padrão: "%Y-%m-%d" (formato ISO). |-| **Reasoning** _(opcional)_ | `reasoning` | `bool` | Se o agente deve refletir e criar um plano antes de executar uma tarefa. Padrão: False. |-| **Max Reasoning Attempts** _(opcional)_ | `max_reasoning_attempts` | `Optional[int]` | Número máximo de tentativas de raciocínio antes de executar a tarefa. Se None, tentará até estar pronto. |-| **Embedder** _(opcional)_ | `embedder` | `Optional[Dict[str, Any]]` | Configuração do embedder utilizado pelo agente. |-| **Knowledge Sources** _(opcional)_ | `knowledge_sources` | `Optional[List[BaseKnowledgeSource]]` | Fontes de conhecimento disponíveis para o agente. |-| **Use System Prompt** _(opcional)_ | `use_system_prompt` | `Optional[bool]` | Se deve usar o system prompt (suporte para modelo o1). Padrão: True. |+| Atributo | Parâmetro | Tipo | Descrição |+| :-------------------------------------- | :----------------------- | :------------------------------------ | :-------------------------------------------------------------------------------------------------------- |+| **Role (Função)** | `role` | `str` | Define a função e a área de especialização do agente dentro da equipe. |+| **Goal (Objetivo)** | `goal` | `str` | O objetivo individual que guia a tomada de decisão do agente. |+| **Backstory (História de fundo)** | `backstory` | `str` | Fornece contexto e personalidade ao agente, enriquecendo as interações. |+| **LLM** _(opcional)_ | `llm` | `Union[str, LLM, Any]` | Modelo de linguagem que alimenta o agente. Padrão: modelo especificado em `OPENAI_MODEL_NAME` ou "gpt-4". |+| **Tools (Ferramentas)** _(opcional)_ | `tools` | `List[BaseTool]` | Capacidades ou funções disponíveis para o agente. Padrão: lista vazia. |+| **Function Calling LLM** _(opcional)_ | `function_calling_llm` | `Optional[Any]` | Modelo de linguagem usado para chamada de ferramentas, sobrescreve LLM principal se especificado. |+| **Max Iterations** _(opcional)_ | `max_iter` | `int` | Número máximo de iterações antes do agente fornecer sua melhor resposta. Padrão: 20. |+| **Max RPM** _(opcional)_ | `max_rpm` | `Optional[int]` | Quantidade máxima de requisições por minuto para evitar limites de taxa. |+| **Max Execution Time** _(opcional)_ | `max_execution_time` | `Optional[int]` | Tempo máximo (em segundos) de execução da tarefa. |+| **Verbose** _(opcional)_ | `verbose` | `bool` | Habilita logs detalhados de execução para depuração. Padrão: False. |+| **Allow Delegation** _(opcional)_ | `allow_delegation` | `bool` | Permite que o agente delegue tarefas para outros agentes. Padrão: False. |+| **Step Callback** _(opcional)_ | `step_callback` | `Optional[Any]` | Função chamada após cada passo do agente, sobrescreve callback da equipe. |+| **Cache** _(opcional)_ | `cache` | `bool` | Ativa cache para o uso de ferramentas. Padrão: True. |+| **System Template** _(opcional)_ | `system_template` | `Optional[str]` | Template personalizado de prompt de sistema para o agente. |+| **Prompt Template** _(opcional)_ | `prompt_template` | `Optional[str]` | Template de prompt personalizado para o agente. |+| **Response Template** _(opcional)_ | `response_template` | `Optional[str]` | Template de resposta personalizado para o agente. |+| **Allow Code Execution** _(opcional)_ | `allow_code_execution` | `Optional[bool]` | Ativa execução de código pelo agente. Padrão: False. |+| **Max Retry Limit** _(opcional)_ | `max_retry_limit` | `int` | Número máximo de tentativas (retries) em caso de erro. Padrão: 2. |+| **Respect Context Window** _(opcional)_ | `respect_context_window` | `bool` | Mantém as mensagens dentro do tamanho da janela de contexto, resumindo quando necessário. Padrão: True. |+| **Code Execution Mode** _(opcional)_ | `code_execution_mode` | `Literal["safe", "unsafe"]` | Modo de execução de código: 'safe' (usando Docker) ou 'unsafe' (direto). Padrão: 'safe'. |+| **Multimodal** _(opcional)_ | `multimodal` | `bool` | Se o agente suporta capacidades multimodais. Padrão: False. |+| **Inject Date** _(opcional)_ | `inject_date` | `bool` | Se deve injetar automaticamente a data atual nas tarefas. Padrão: False. |+| **Date Format** _(opcional)_ | `date_format` | `str` | Formato de data utilizado quando `inject_date` está ativo. Padrão: "%Y-%m-%d" (formato ISO). |+| **Reasoning** _(opcional)_ | `reasoning` | `bool` | Se o agente deve refletir e criar um plano antes de executar uma tarefa. Padrão: False. |+| **Max Reasoning Attempts** _(opcional)_ | `max_reasoning_attempts` | `Optional[int]` | Número máximo de tentativas de raciocínio antes de executar a tarefa. Se None, tentará até estar pronto. |+| **Embedder** _(opcional)_ | `embedder` | `Optional[Dict[str, Any]]` | Configuração do embedder utilizado pelo agente. |+| **Knowledge Sources** _(opcional)_ | `knowledge_sources` | `Optional[List[BaseKnowledgeSource]]` | Fontes de conhecimento disponíveis para o agente. |+| **Use System Prompt** _(opcional)_ | `use_system_prompt` | `Optional[bool]` | Se deve usar o system prompt (suporte para modelo o1). Padrão: True. |## Criando Agentes@@ -137,7 +142,8 @@ class LatestAiDevelopmentCrew():```<Note>-Os nomes utilizados em seus arquivos YAML (`agents.yaml`) devem ser iguais aos nomes dos métodos no seu código Python.+ Os nomes utilizados em seus arquivos YAML (`agents.yaml`) devem ser iguais aos+ nomes dos métodos no seu código Python.</Note>### Definição Direta em Código@@ -183,6 +189,7 @@ agent = Agent(Vamos detalhar algumas combinações de parâmetros-chave para casos de uso comuns:#### Agente de Pesquisa Básico+```python Coderesearch_agent = Agent(role="Analista de Pesquisa",@@ -194,6 +201,7 @@ research_agent = Agent(```#### Agente de Desenvolvimento de Código+```python Codedev_agent = Agent(role="Desenvolvedor Python Sênior",@@ -207,6 +215,7 @@ dev_agent = Agent(```#### Agente de Análise de Longa Duração+```python Codeanalysis_agent = Agent(role="Analista de Dados",@@ -220,6 +229,7 @@ analysis_agent = Agent(```#### Agente com Template Personalizado+```python Codecustom_agent = Agent(role="Atendente de Suporte ao Cliente",@@ -232,6 +242,7 @@ custom_agent = Agent(```#### Agente Ciente de Data, com Raciocínio+```python Codestrategic_agent = Agent(role="Analista de Mercado",@@ -246,6 +257,7 @@ strategic_agent = Agent(```#### Agente de Raciocínio+```python Codereasoning_agent = Agent(role="Planejador Estratégico",@@ -259,6 +271,7 @@ reasoning_agent = Agent(```#### Agente Multimodal+```python Codemultimodal_agent = Agent(role="Analista de Conteúdo Visual",@@ -272,52 +285,65 @@ multimodal_agent = Agent(### Detalhes dos Parâmetros#### Parâmetros Críticos+- `role`, `goal` e `backstory` são obrigatórios e definem o comportamento do agente- `llm` determina o modelo de linguagem utilizado (padrão: GPT-4 da OpenAI)#### Memória e Contexto+- `memory`: Ative para manter o histórico de conversas- `respect_context_window`: Evita problemas com limites de tokens- `knowledge_sources`: Adicione bases de conhecimento específicas do domínio#### Controle de Execução+- `max_iter`: Número máximo de tentativas antes da melhor resposta- `max_execution_time`: Tempo limite em segundos- `max_rpm`: Limite de requisições por minuto- `max_retry_limit`: Tentativas de correção em erros#### Execução de Código+- `allow_code_execution`: Deve ser True para permitir execução de código- `code_execution_mode`:- `"safe"`: Usa Docker (recomendado para produção)- `"unsafe"`: Execução direta (apenas em ambientes confiáveis)<Note>- Isso executa uma imagem Docker padrão. Se você deseja configurar a imagem Docker, veja a ferramenta Code Interpreter na seção de ferramentas.- Adicione a ferramenta de interpretação de código como um parâmetro em ferramentas no agente.+ Isso executa uma imagem Docker padrão. Se você deseja configurar a imagem+ Docker, veja a ferramenta Code Interpreter na seção de ferramentas. Adicione a+ ferramenta de interpretação de código como um parâmetro em ferramentas no+ agente.</Note>#### Funcionalidades Avançadas+- `multimodal`: Habilita capacidades multimodais para processar texto e conteúdo visual- `reasoning`: Permite que o agente reflita e crie planos antes de executar tarefas- `inject_date`: Injeta a data atual automaticamente nas descrições das tarefas#### Templates+- `system_template`: Define o comportamento central do agente- `prompt_template`: Estrutura o formato da entrada- `response_template`: Formata as respostas do agente<Note>-Ao usar templates personalizados, assegure-se de definir tanto `system_template` quanto `prompt_template`. O `response_template` é opcional, mas recomendado para formatação consistente de saída.+ Ao usar templates personalizados, assegure-se de definir tanto+ `system_template` quanto `prompt_template`. O `response_template` é opcional,+ mas recomendado para formatação consistente de saída.</Note><Note>-Ao usar templates personalizados, você pode usar variáveis como `{role}`, `{goal}` e `{backstory}` em seus templates. Elas serão automaticamente preenchidas durante a execução.+ Ao usar templates personalizados, você pode usar variáveis como `{role}`, `+ {goal}` e `{backstory}` em seus templates. Elas serão automaticamente+ preenchidas durante a execução.</Note>## Ferramentas do AgenteAgentes podem ser equipados com diversas ferramentas para ampliar suas capacidades. O CrewAI suporta ferramentas do:+- [CrewAI Toolkit](https://github.com/joaomdmoura/crewai-tools)- [LangChain Tools](https://python.langchain.com/docs/integrations/tools)@@ -356,7 +382,9 @@ analyst = Agent(```<Note>-Quando `memory` está ativo, o agente manterá o contexto ao longo de múltiplas interações, melhorando a capacidade de lidar com tarefas complexas, em múltiplos passos.+ Quando `memory` está ativo, o agente manterá o contexto ao longo de múltiplas+ interações, melhorando a capacidade de lidar com tarefas complexas, em+ múltiplos passos.</Note>## Gerenciamento da Janela de Contexto@@ -386,6 +414,7 @@ smart_agent = Agent(```**O que acontece quando os limites de contexto são excedidos:**+- ⚠️ **Mensagem de aviso**: `"Context length exceeded. Summarizing content to fit the model context window."`- 🔄 **Resumir automaticamente**: O CrewAI resume o histórico da conversa de forma inteligente- ✅ **Execução contínua**: A execução da tarefa prossegue normalmente com o contexto resumido@@ -407,6 +436,7 @@ strict_agent = Agent(```**O que acontece quando os limites de contexto são excedidos:**+- ❌ **Mensagem de erro**: `"Context length exceeded. Consider using smaller text or RAG tools from crewai_tools."`- 🛑 **Execução interrompida**: A execução da tarefa é parada imediatamente- 🔧 **Intervenção manual necessária**: Você precisará modificar sua abordagem@@ -414,6 +444,7 @@ strict_agent = Agent(### Como Escolher a Melhor Configuração#### Use `respect_context_window=True` (padrão) quando:+- **Processar documentos grandes** que podem ultrapassar os limites de contexto- **Conversas longas** onde certo grau de resumo é aceitável- **Tarefas de pesquisa** onde o contexto geral é mais importante que detalhes exatos@@ -432,6 +463,7 @@ document_processor = Agent(```#### Use `respect_context_window=False` quando:+- **Precisão é crítica** e perda de informação é inaceitável- **Tarefas jurídicas ou médicas** que requerem contexto completo- **Revisão de código** onde detalhes perdidos podem causar bugs@@ -454,6 +486,7 @@ precision_agent = Agent(Ao lidar com conjuntos de dados muito grandes, considere as seguintes estratégias:#### 1. Use Ferramentas RAG+```python Codefrom crewai_tools import RagTool@@ -471,6 +504,7 @@ rag_agent = Agent(```#### 2. Use Fontes de Conhecimento+```python Code# Use fontes de conhecimento ao invés de prompts grandesknowledge_agent = Agent(@@ -494,6 +528,7 @@ knowledge_agent = Agent(### Solucionando Problemas de Contexto**Se você receber erros de limite de contexto:**+```python Code# Solução rápida: Habilite manipulação automáticaagent.respect_context_window = True@@ -507,6 +542,7 @@ agent.tools = [RagTool()]```**Se o resumo automático perder informações importantes:**+```python Code# Desative o resumo automático e use RAGagent = Agent(@@ -520,28 +556,34 @@ agent = Agent(```<Note>-O recurso de gerenciamento da janela de contexto funciona automaticamente em segundo plano. Você não precisa chamar funções especiais – basta definir `respect_context_window` conforme deseja e o CrewAI cuida do resto!+ O recurso de gerenciamento da janela de contexto funciona automaticamente em+ segundo plano. Você não precisa chamar funções especiais – basta definir+ `respect_context_window` conforme deseja e o CrewAI cuida do resto!</Note>## Considerações e Boas Práticas Importantes### Segurança e Execução de Código+- Ao usar `allow_code_execution`, seja cauteloso com entradas do usuário e sempre as valide- Use `code_execution_mode: "safe"` (Docker) em ambientes de produção- Considere definir limites adequados de `max_execution_time` para evitar loops infinitos### Otimização de Performance+- Use `respect_context_window: true` para evitar problemas com limite de tokens- Ajuste `max_rpm` para evitar rate limiting- Ative `cache: true` para melhorar performance em tarefas repetitivas- Ajuste `max_iter` e `max_retry_limit` conforme a complexidade da tarefa### Gerenciamento de Memória e Contexto+- Considere `knowledge_sources` para informações específicas de domínio- Configure `embedder` ao usar modelos de embedding personalizados- Use templates personalizados (`system_template`, `prompt_template`, `response_template`) para controle fino do comportamento do agente### Funcionalidades Avançadas+- Ative `reasoning: true` para agentes que precisam planejar e refletir antes de tarefas complexas- Defina `max_reasoning_attempts` para controlar as iterações de planejamento (`None` para ilimitadas)- Use `inject_date: true` para dar consciência temporal a agentes em tarefas que dependem de datas@@ -549,6 +591,7 @@ O recurso de gerenciamento da janela de contexto funciona automaticamente em seg- Ative `multimodal: true` para agentes que precisam processar texto e imagem### Colaboração entre Agentes+- Ative `allow_delegation: true` quando agentes precisarem trabalhar juntos- Use `step_callback` para monitorar e registrar interações dos agentes- Considere usar LLMs diferentes para propósitos distintos:@@ -556,6 +599,7 @@ O recurso de gerenciamento da janela de contexto funciona automaticamente em seg- `function_calling_llm` para uso eficiente de ferramentas### Consciência de Data e Raciocínio+- Use `inject_date: true` para fornecer consciência temporal aos agentes em tarefas sensíveis ao tempo- Customize o formato de data com `date_format` usando códigos standards de datetime do Python- Códigos válidos incluem: %Y (ano), %m (mês), %d (dia), %B (nome completo do mês), etc.@@ -563,22 +607,26 @@ O recurso de gerenciamento da janela de contexto funciona automaticamente em seg- Ative `reasoning: true` para tarefas complexas que se beneficiam de planejamento e reflexão antecipados### Compatibilidade de Modelos+- Defina `use_system_prompt: false` para modelos antigos que não suportam mensagens de sistema- Certifique-se que o `llm` escolhido suporta as funcionalidades necessárias (como function calling)## Solução de Problemas Comuns1. **Limite de Taxa (Rate Limiting)**: Se atingir limites de API:+- Implemente o `max_rpm` adequado- Use cache para operações repetitivas- Considere agrupar requisições em lote2. **Erros de Janela de Contexto**: Se exceder limites de contexto:+- Habilite `respect_context_window`- Otimize seus prompts- Limpe periodicamente a memória do agente3. **Problemas de Execução de Código**: Se a execução de código falhar:+- Verifique se o Docker está instalado para o modo seguro- Cheque permissões de execução- Revise as configurações do sandbox de códigodiff --git a/docs/pt-BR/concepts/cli.mdx b/docs/pt-BR/concepts/cli.mdxindex 28a5338aa..1cce9ca03 100644--- a/docs/pt-BR/concepts/cli.mdx+++ b/docs/pt-BR/concepts/cli.mdx@@ -4,7 +4,14 @@ description: Aprenda a usar o CLI do CrewAI para interagir com o CrewAI.icon: terminalmode: "wide"----<Warning>A partir da versão 0.140.0, a plataforma CrewAI AOP iniciou um processo de migração de seu provedor de login. Como resultado, o fluxo de autenticação via CLI foi atualizado. Usuários que utlizam o Google para fazer login, ou que criaram conta após 3 de julho de 2025 não poderão fazer login com versões anteriores da biblioteca `crewai`.</Warning>++<Warning>+ A partir da versão 0.140.0, a plataforma CrewAI AMP iniciou um processo de+ migração de seu provedor de login. Como resultado, o fluxo de autenticação via+ CLI foi atualizado. Usuários que utlizam o Google para fazer login, ou que+ criaram conta após 3 de julho de 2025 não poderão fazer login com versões+ anteriores da biblioteca `crewai`.+</Warning>## Visão Geral@@ -40,6 +47,7 @@ crewai create [OPTIONS] TYPE NAME- `NAME`: Nome do crew ou flowExemplo:+```shell Terminalcrewai create crew my_new_crewcrewai create flow my_new_flow@@ -56,6 +64,7 @@ crewai version [OPTIONS]- `--tools`: (Opcional) Mostra a versão instalada das ferramentas do CrewAIExemplo:+```shell Terminalcrewai versioncrewai version --tools@@ -73,6 +82,7 @@ crewai train [OPTIONS]- `-f, --filename TEXT`: Caminho para um arquivo customizado para treinamento (padrão: "trained_agents_data.pkl")Exemplo:+```shell Terminalcrewai train -n 10 -f my_training_data.pkl```@@ -104,6 +114,7 @@ crewai replay [OPTIONS]- `-t, --task_id TEXT`: Reexecuta o crew a partir deste task ID, incluindo todas as tarefas subsequentesExemplo:+```shell Terminalcrewai replay -t task_123456```@@ -133,6 +144,7 @@ crewai reset-memories [OPTIONS]- `-a, --all`: Redefine TODAS as memóriasExemplo:+```shell Terminalcrewai reset-memories --long --shortcrewai reset-memories --all@@ -150,6 +162,7 @@ crewai test [OPTIONS]- `-m, --model TEXT`: Modelo LLM para executar os testes no Crew (padrão: "gpt-4o-mini")Exemplo:+```shell Terminalcrewai test -n 5 -m gpt-3.5-turbo```@@ -163,12 +176,17 @@ crewai run```<Note>-A partir da versão 0.103.0, o comando `crewai run` pode ser usado para executar tanto crews padrão quanto flows. Para flows, ele detecta automaticamente o tipo a partir do pyproject.toml e executa o comando apropriado. Este é agora o modo recomendado de executar tanto crews quanto flows.+ A partir da versão 0.103.0, o comando `crewai run` pode ser usado para+ executar tanto crews padrão quanto flows. Para flows, ele detecta+ automaticamente o tipo a partir do pyproject.toml e executa o comando+ apropriado. Este é agora o modo recomendado de executar tanto crews quanto+ flows.</Note><Note>-Certifique-se de executar estes comandos a partir do diretório onde seu projeto CrewAI está configurado.-Alguns comandos podem exigir configuração ou ajustes adicionais dentro da estrutura do seu projeto.+ Certifique-se de executar estes comandos a partir do diretório onde seu+ projeto CrewAI está configurado. Alguns comandos podem exigir configuração ou+ ajustes adicionais dentro da estrutura do seu projeto.</Note>### 9. Chat@@ -180,6 +198,7 @@ Depois de receber os resultados, você pode continuar interagindo com o assisten```shell Terminalcrewai chat```+<Note>Garanta que você execute estes comandos a partir do diretório raiz do seu projeto CrewAI.</Note>@@ -197,28 +216,30 @@ def crew(self) -> Crew:chat_llm="gpt-4o", # LLM para orquestração de chat)```+</Note>### 10. Deploy-Implemente o crew ou flow no [CrewAI AOP](https://app.crewai.com).+Implemente o crew ou flow no [CrewAI AMP](https://app.crewai.com).++- **Autenticação**: Você precisa estar autenticado para implementar no CrewAI AMP.+ Você pode fazer login ou criar uma conta com:-- **Autenticação**: Você precisa estar autenticado para implementar no CrewAI AOP.- Você pode fazer login ou criar uma conta com:- ```shell Terminal- crewai login- ```+ ```shell Terminal+ crewai login+ ```- **Criar um deployment**: Depois de autenticado, você pode criar um deployment para seu crew ou flow a partir da raiz do seu projeto local.- ```shell Terminal- crewai deploy create- ```- - Lê a configuração do seu projeto local.- - Solicita a confirmação das variáveis de ambiente (como `OPENAI_API_KEY`, `SERPER_API_KEY`) encontradas localmente. Elas serão armazenadas de forma segura junto ao deployment na plataforma Enterprise. Verifique se suas chaves sensíveis estão corretamente configuradas localmente (por exemplo, em um arquivo `.env`) antes de executar este comando.+ ```shell Terminal+ crewai deploy create+ ```+ - Lê a configuração do seu projeto local.+ - Solicita a confirmação das variáveis de ambiente (como `OPENAI_API_KEY`, `SERPER_API_KEY`) encontradas localmente. Elas serão armazenadas de forma segura junto ao deployment na plataforma Enterprise. Verifique se suas chaves sensíveis estão corretamente configuradas localmente (por exemplo, em um arquivo `.env`) antes de executar este comando.### 11. Gerenciamento de Organização-Gerencie suas organizações no CrewAI AOP.+Gerencie suas organizações no CrewAI AMP.```shell Terminalcrewai org [COMMAND] [OPTIONS]@@ -227,65 +248,80 @@ crewai org [COMMAND] [OPTIONS]#### Comandos:- `list`: Liste todas as organizações das quais você faz parte+```shell Terminalcrewai org list```- `current`: Exibe sua organização ativa atualmente+```shell Terminalcrewai org current```- `switch`: Mude para uma organização específica+```shell Terminalcrewai org switch <organization_id>```<Note>-Você deve estar autenticado no CrewAI AOP para usar estes comandos de gerenciamento de organização.+ Você deve estar autenticado no CrewAI AMP para usar estes comandos de+ gerenciamento de organização.</Note>- **Criar um deployment** (continuação):- - Vincula o deployment ao respectivo repositório remoto do GitHub (normalmente detectado automaticamente).-- **Implantar o Crew**: Depois de autenticado, você pode implantar seu crew ou flow no CrewAI AOP.- ```shell Terminal- crewai deploy push- ```- - Inicia o processo de deployment na plataforma CrewAI AOP.- - Após a iniciação bem-sucedida, será exibida a mensagem Deployment created successfully! juntamente com o Nome do Deployment e um Deployment ID (UUID) único.+ - Vincula o deployment ao respectivo repositório remoto do GitHub (normalmente detectado automaticamente).++- **Implantar o Crew**: Depois de autenticado, você pode implantar seu crew ou flow no CrewAI AMP.++ ```shell Terminal+ crewai deploy push+ ```++ - Inicia o processo de deployment na plataforma CrewAI AMP.+ - Após a iniciação bem-sucedida, será exibida a mensagem Deployment created successfully! juntamente com o Nome do Deployment e um Deployment ID (UUID) único.- **Status do Deployment**: Você pode verificar o status do seu deployment com:- ```shell Terminal- crewai deploy status- ```- Isso retorna o status mais recente do último deployment iniciado (por exemplo, `Building Images for Crew`, `Deploy Enqueued`, `Online`).++ ```shell Terminal+ crewai deploy status+ ```++ Isso retorna o status mais recente do último deployment iniciado (por exemplo, `Building Images for Crew`, `Deploy Enqueued`, `Online`).- **Logs do Deployment**: Você pode checar os logs do seu deployment com:- ```shell Terminal- crewai deploy logs- ```- Isso faz o streaming dos logs do deployment para seu terminal.++ ```shell Terminal+ crewai deploy logs+ ```++ Isso faz o streaming dos logs do deployment para seu terminal.- **Listar deployments**: Você pode listar todos os seus deployments com:- ```shell Terminal- crewai deploy list- ```- Isto lista todos os seus deployments.++ ```shell Terminal+ crewai deploy list+ ```++ Isto lista todos os seus deployments.- **Deletar um deployment**: Você pode deletar um deployment com:- ```shell Terminal- crewai deploy remove- ```- Isto exclui o deployment da plataforma CrewAI AOP.++ ```shell Terminal+ crewai deploy remove+ ```++ Isto exclui o deployment da plataforma CrewAI AMP.- **Comando de Ajuda**: Você pode obter ajuda sobre o CLI com:- ```shell Terminal- crewai deploy --help- ```- Isto exibe a mensagem de ajuda para o CLI CrewAI Deploy.+ ```shell Terminal+ crewai deploy --help+ ```+ Isto exibe a mensagem de ajuda para o CLI CrewAI Deploy.-Assista ao vídeo tutorial para uma demonstração passo-a-passo de implantação do seu crew no [CrewAI AOP](http://app.crewai.com) usando o CLI.+Assista ao vídeo tutorial para uma demonstração passo-a-passo de implantação do seu crew no [CrewAI AMP](http://app.crewai.com) usando o CLI.<iframeclassName="w-full aspect-video rounded-xl"@@ -298,7 +334,7 @@ Assista ao vídeo tutorial para uma demonstração passo-a-passo de implantaçã### 11. Chaves de API-Ao executar o comando ```crewai create crew```, o CLI primeiro mostrará os 5 provedores de LLM mais comuns e pedirá para você selecionar um.+Ao executar o comando `crewai create crew`, o CLI primeiro mostrará os 5 provedores de LLM mais comuns e pedirá para você selecionar um.Após selecionar um provedor de LLM, será solicitado que você informe as chaves de API.@@ -306,11 +342,11 @@ Após selecionar um provedor de LLM, será solicitado que você informe as chaveInicialmente, o CLI solicitará as chaves de API para os seguintes serviços:-* OpenAI-* Groq-* Anthropic-* Google Gemini-* SambaNova+- OpenAI+- Groq+- Anthropic+- Google Gemini+- SambaNovaAo selecionar um provedor, o CLI solicitará que você insira sua chave de API.@@ -322,7 +358,7 @@ Ao escolher um provedor, o CLI solicitará que você informe o nome da chave e aVeja o seguinte link para o nome de chave de cada provedor:-* [LiteLLM Providers](https://docs.litellm.ai/docs/providers)+- [LiteLLM Providers](https://docs.litellm.ai/docs/providers)### 12. Gerenciamento de Configuração@@ -335,23 +371,26 @@ crewai config [COMANDO] [OPÇÕES]#### Comandos:- `list`: Exibir todos os parâmetros de configuração do CLI+```shell Terminalcrewai config list```- `set`: Definir um parâmetro de configuração do CLI+```shell Terminalcrewai config set <chave> <valor>```- `reset`: Redefinir todos os parâmetros de configuração do CLI para valores padrão+```shell Terminalcrewai config reset```#### Parâmetros de Configuração Disponíveis-- `enterprise_base_url`: URL base da instância CrewAI AOP+- `enterprise_base_url`: URL base da instância CrewAI AMP- `oauth2_provider`: Provedor OAuth2 usado para autenticação (ex: workos, okta, auth0)- `oauth2_audience`: Valor de audiência OAuth2, tipicamente usado para identificar a API ou recurso de destino- `oauth2_client_id`: ID do cliente OAuth2 emitido pelo provedor, usado durante solicitações de autenticação@@ -360,42 +399,51 @@ crewai config reset#### ExemplosExibir configuração atual:+```shell Terminalcrewai config list```Exemplo de saída:-| Parâmetro | Valor | Descrição |-| :------------------- | :---------------------- | :------------------------------------------------------------ |-| enterprise_base_url | https://app.crewai.com | URL base da instância CrewAI AOP |-| org_name | Not set | Nome da organização atualmente ativa |-| org_uuid | Not set | UUID da organização atualmente ativa |-| oauth2_provider | workos | Provedor OAuth2 (ex.: workos, okta, auth0) |-| oauth2_audience | client_01YYY | Audience usada para identificar a API/recurso de destino |-| oauth2_client_id | client_01XXX | Client ID OAuth2 emitido pelo provedor (usado na autenticação) |-| oauth2_domain | login.crewai.com | Domínio do provedor OAuth2 (ex.: your-org.auth0.com) |+| Parâmetro | Valor | Descrição |+| :------------------ | :--------------------- | :------------------------------------------------------------- |+| enterprise_base_url | https://app.crewai.com | URL base da instância CrewAI AMP |+| org_name | Not set | Nome da organização atualmente ativa |+| org_uuid | Not set | UUID da organização atualmente ativa |+| oauth2_provider | workos | Provedor OAuth2 (ex.: workos, okta, auth0) |+| oauth2_audience | client_01YYY | Audience usada para identificar a API/recurso de destino |+| oauth2_client_id | client_01XXX | Client ID OAuth2 emitido pelo provedor (usado na autenticação) |+| oauth2_domain | login.crewai.com | Domínio do provedor OAuth2 (ex.: your-org.auth0.com) |Definir a URL base do enterprise:+```shell Terminalcrewai config set enterprise_base_url https://minha-empresa.crewai.com```Definir provedor OAuth2:+```shell Terminalcrewai config set oauth2_provider auth0```Definir domínio OAuth2:+```shell Terminalcrewai config set oauth2_domain minha-empresa.auth0.com```Redefinir todas as configurações para padrões:+```shell Terminalcrewai config reset```<Note>-As configurações são armazenadas em `~/.config/crewai/settings.json`. Algumas configurações como nome da organização e UUID são somente leitura e gerenciadas através de comandos de autenticação e organização. Configurações relacionadas ao repositório de ferramentas são ocultas e não podem ser definidas diretamente pelo usuário.+ As configurações são armazenadas em `~/.config/crewai/settings.json`. Algumas+ configurações como nome da organização e UUID são somente leitura e+ gerenciadas através de comandos de autenticação e organização. Configurações+ relacionadas ao repositório de ferramentas são ocultas e não podem ser+ definidas diretamente pelo usuário.</Note>diff --git a/docs/pt-BR/concepts/event-listener.mdx b/docs/pt-BR/concepts/event-listener.mdxindex af7b9c057..34d1f7505 100644--- a/docs/pt-BR/concepts/event-listener.mdx+++ b/docs/pt-BR/concepts/event-listener.mdx@@ -1,6 +1,6 @@----title: 'Listeners de Evento'-description: 'Acesse eventos do CrewAI para criar integrações e monitoramento personalizados'+title: "Listeners de Evento"+description: "Acesse eventos do CrewAI para criar integrações e monitoramento personalizados"icon: spinnermode: "wide"---@@ -20,11 +20,12 @@ O CrewAI utiliza uma arquitetura de event bus para emitir eventos ao longo do ciQuando ações específicas ocorrem no CrewAI (como a inicialização de um Crew, um Agent concluindo uma tarefa ou o uso de uma ferramenta), o sistema emite os eventos correspondentes. Você pode registrar handlers para esses eventos para executar código personalizado quando eles acontecerem.<Note type="info" title="Aprimoramento Enterprise: Prompt Tracing">-O CrewAI AOP fornece o recurso Prompt Tracing, que aproveita o sistema de eventos para rastrear, armazenar e visualizar todos os prompts, respostas e metadados associados. Isso proporciona poderosas capacidades de depuração e transparência nas operações dos seus agentes.+O CrewAI AMP fornece o recurso Prompt Tracing, que aproveita o sistema de eventos para rastrear, armazenar e visualizar todos os prompts, respostas e metadados associados. Isso proporciona poderosas capacidades de depuração e transparência nas operações dos seus agentes.Com o Prompt Tracing você pode:+- Visualizar o histórico completo de todos os prompts enviados ao seu LLM- Monitorar o uso de tokens e custos- Depurar falhas de raciocínio dos agentes@@ -263,7 +264,6 @@ A estrutura do objeto de evento depende do tipo do evento, mas todos herdam de `Campos adicionais variam pelo tipo de evento. Por exemplo, `CrewKickoffCompletedEvent` inclui os campos `crew_name` e `output`.-## Uso Avançado: Handlers EscopadosPara lidar temporariamente com eventos (útil para testes ou operações específicas), você pode usar o context manager `scoped_handlers`:diff --git a/docs/pt-BR/concepts/tasks.mdx b/docs/pt-BR/concepts/tasks.mdxindex 9b111a245..4ef324d90 100644--- a/docs/pt-BR/concepts/tasks.mdx+++ b/docs/pt-BR/concepts/tasks.mdx@@ -14,11 +14,12 @@ As tarefas fornecem todos os detalhes necessários para sua execução, como desAs tarefas dentro do CrewAI podem ser colaborativas, exigindo que múltiplos agentes trabalhem juntos. Isso é gerenciado por meio das propriedades da tarefa e orquestrado pelo processo do Crew, potencializando o trabalho em equipe e a eficiência.<Note type="info" title="Aprimoramento Empresarial: Construtor Visual de Tarefas">-O CrewAI AOP inclui um Construtor Visual de Tarefas no Crew Studio, que simplifica a criação e o encadeamento de tarefas complexas. Projete seus fluxos de tarefas visualmente e teste-os em tempo real sem necessidade de escrever código.+O CrewAI AMP inclui um Construtor Visual de Tarefas no Crew Studio, que simplifica a criação e o encadeamento de tarefas complexas. Projete seus fluxos de tarefas visualmente e teste-os em tempo real sem necessidade de escrever código.O Construtor Visual de Tarefas permite:+- Criação de tarefas via arrastar-e-soltar- Visualização de dependências e fluxo de tarefas- Testes e validações em tempo real@@ -28,10 +29,12 @@ O Construtor Visual de Tarefas permite:### Fluxo de Execução de TarefasAs tarefas podem ser executadas de duas maneiras:+- **Sequencial**: As tarefas são executadas na ordem em que são definidas- **Hierárquica**: As tarefas são atribuídas aos agentes com base em seus papéis e especialidadesO fluxo de execução é definido ao criar o crew:+```python Codecrew = Crew(agents=[agent1, agent2],@@ -42,25 +45,25 @@ crew = Crew(## Atributos da Tarefa-| Atributo | Parâmetros | Tipo | Descrição |-| :------------------------------- | :---------------- | :--------------------------- | :----------------------------------------------------------------------------------------------------------------- |-| **Descrição** | `description` | `str` | Uma declaração clara e concisa do que a tarefa envolve. |-| **Saída Esperada** | `expected_output` | `str` | Uma descrição detalhada de como deve ser o resultado da tarefa concluída. |-| **Nome** _(opcional)_ | `name` | `Optional[str]` | Um identificador de nome para a tarefa. |-| **Agente** _(opcional)_ | `agent` | `Optional[BaseAgent]` | O agente responsável por executar a tarefa. |-| **Ferramentas** _(opcional)_ | `tools` | `List[BaseTool]` | As ferramentas/recursos que o agente pode usar para esta tarefa. |-| **Contexto** _(opcional)_ | `context` | `Optional[List["Task"]]` | Outras tarefas cujas saídas serão usadas como contexto para esta tarefa. |-| **Execução Assíncrona** _(opc.)_ | `async_execution` | `Optional[bool]` | Se a tarefa deve ser executada de forma assíncrona. O padrão é False. |-| **Input Humano** _(opcional)_ | `human_input` | `Optional[bool]` | Se a tarefa deve ter uma revisão humana da resposta final do agente. O padrão é False. |-| **Markdown** _(opcional)_ | `markdown` | `Optional[bool]` | Se a tarefa deve instruir o agente a retornar a resposta final formatada em Markdown. O padrão é False. |-| **Config** _(opcional)_ | `config` | `Optional[Dict[str, Any]]` | Parâmetros de configuração específicos da tarefa. |-| **Arquivo de Saída** _(opcional)_| `output_file` | `Optional[str]` | Caminho do arquivo para armazenar a saída da tarefa. |-| **Criar Diretório** _(opcional)_ | `create_directory` | `Optional[bool]` | Se deve criar o diretório para output_file caso não exista. O padrão é True. |-| **Saída JSON** _(opcional)_ | `output_json` | `Optional[Type[BaseModel]]` | Um modelo Pydantic para estruturar a saída em JSON. |-| **Output Pydantic** _(opcional)_ | `output_pydantic` | `Optional[Type[BaseModel]]` | Um modelo Pydantic para a saída da tarefa. |-| **Callback** _(opcional)_ | `callback` | `Optional[Any]` | Função/objeto a ser executado após a conclusão da tarefa. |-| **Guardrail** _(opcional)_ | `guardrail` | `Optional[Callable]` | Função para validar a saída da tarefa antes de prosseguir para a próxima tarefa. |-| **Max Tentativas Guardrail** _(opcional)_ | `guardrail_max_retries` | `Optional[int]` | Número máximo de tentativas quando a validação do guardrail falha. Padrão é 3. |+| Atributo | Parâmetros | Tipo | Descrição |+| :---------------------------------------- | :---------------------- | :-------------------------- | :------------------------------------------------------------------------------------------------------ |+| **Descrição** | `description` | `str` | Uma declaração clara e concisa do que a tarefa envolve. |+| **Saída Esperada** | `expected_output` | `str` | Uma descrição detalhada de como deve ser o resultado da tarefa concluída. |+| **Nome** _(opcional)_ | `name` | `Optional[str]` | Um identificador de nome para a tarefa. |+| **Agente** _(opcional)_ | `agent` | `Optional[BaseAgent]` | O agente responsável por executar a tarefa. |+| **Ferramentas** _(opcional)_ | `tools` | `List[BaseTool]` | As ferramentas/recursos que o agente pode usar para esta tarefa. |+| **Contexto** _(opcional)_ | `context` | `Optional[List["Task"]]` | Outras tarefas cujas saídas serão usadas como contexto para esta tarefa. |+| **Execução Assíncrona** _(opc.)_ | `async_execution` | `Optional[bool]` | Se a tarefa deve ser executada de forma assíncrona. O padrão é False. |+| **Input Humano** _(opcional)_ | `human_input` | `Optional[bool]` | Se a tarefa deve ter uma revisão humana da resposta final do agente. O padrão é False. |+| **Markdown** _(opcional)_ | `markdown` | `Optional[bool]` | Se a tarefa deve instruir o agente a retornar a resposta final formatada em Markdown. O padrão é False. |+| **Config** _(opcional)_ | `config` | `Optional[Dict[str, Any]]` | Parâmetros de configuração específicos da tarefa. |+| **Arquivo de Saída** _(opcional)_ | `output_file` | `Optional[str]` | Caminho do arquivo para armazenar a saída da tarefa. |+| **Criar Diretório** _(opcional)_ | `create_directory` | `Optional[bool]` | Se deve criar o diretório para output_file caso não exista. O padrão é True. |+| **Saída JSON** _(opcional)_ | `output_json` | `Optional[Type[BaseModel]]` | Um modelo Pydantic para estruturar a saída em JSON. |+| **Output Pydantic** _(opcional)_ | `output_pydantic` | `Optional[Type[BaseModel]]` | Um modelo Pydantic para a saída da tarefa. |+| **Callback** _(opcional)_ | `callback` | `Optional[Any]` | Função/objeto a ser executado após a conclusão da tarefa. |+| **Guardrail** _(opcional)_ | `guardrail` | `Optional[Callable]` | Função para validar a saída da tarefa antes de prosseguir para a próxima tarefa. |+| **Max Tentativas Guardrail** _(opcional)_ | `guardrail_max_retries` | `Optional[int]` | Número máximo de tentativas quando a validação do guardrail falha. Padrão é 3. |## Criando Tarefas@@ -81,7 +84,7 @@ crew.kickoff(inputs={'topic': 'AI Agents'})Veja um exemplo de configuração de tarefas usando YAML:-```yaml tasks.yaml+````yaml tasks.yamlresearch_task:description: >Realize uma pesquisa detalhada sobre {topic}@@ -101,7 +104,7 @@ reporting_task:agent: reporting_analystmarkdown: trueoutput_file: report.md-```+````Para usar essa configuração YAML em seu código, crie uma classe crew que herda de `CrewBase`:@@ -159,7 +162,8 @@ class LatestAiDevelopmentCrew():```<Note>-Os nomes usados em seus arquivos YAML (`agents.yaml` e `tasks.yaml`) devem corresponder aos nomes dos métodos no seu código Python.+ Os nomes usados em seus arquivos YAML (`agents.yaml` e `tasks.yaml`) devem+ corresponder aos nomes dos métodos no seu código Python.</Note>### Definição Direta no Código (Alternativa)@@ -196,7 +200,8 @@ reporting_task = Task(```<Tip>- Especifique diretamente um `agent` para a tarefa ou permita que o processo `hierarchical` do CrewAI decida com base em papéis, disponibilidade, etc.+ Especifique diretamente um `agent` para a tarefa ou permita que o processo+ `hierarchical` do CrewAI decida com base em papéis, disponibilidade, etc.</Tip>## Saída da Tarefa@@ -209,22 +214,22 @@ Por padrão, o `TaskOutput` incluirá apenas a saída `raw`. Um `TaskOutput` só### Atributos do Task Output-| Atributo | Parâmetros | Tipo | Descrição |-| :---------------- | :------------- | :------------------------- | :------------------------------------------------------------------------------------------ |-| **Description** | `description` | `str` | Descrição da tarefa. |-| **Summary** | `summary` | `Optional[str]` | Resumo da tarefa, gerado automaticamente a partir das primeiras 10 palavras da descrição. |-| **Raw** | `raw` | `str` | Saída bruta da tarefa. Este é o formato padrão da saída. |-| **Pydantic** | `pydantic` | `Optional[BaseModel]` | Objeto modelo Pydantic representando a saída da tarefa de forma estruturada. |-| **JSON Dict** | `json_dict` | `Optional[Dict[str, Any]]` | Dicionário representando a saída da tarefa em JSON. |-| **Agent** | `agent` | `str` | O agente que executou a tarefa. |-| **Output Format** | `output_format`| `OutputFormat` | O formato da saída da tarefa, podendo ser RAW, JSON e Pydantic. O padrão é RAW. |+| Atributo | Parâmetros | Tipo | Descrição |+| :---------------- | :-------------- | :------------------------- | :---------------------------------------------------------------------------------------- |+| **Description** | `description` | `str` | Descrição da tarefa. |+| **Summary** | `summary` | `Optional[str]` | Resumo da tarefa, gerado automaticamente a partir das primeiras 10 palavras da descrição. |+| **Raw** | `raw` | `str` | Saída bruta da tarefa. Este é o formato padrão da saída. |+| **Pydantic** | `pydantic` | `Optional[BaseModel]` | Objeto modelo Pydantic representando a saída da tarefa de forma estruturada. |+| **JSON Dict** | `json_dict` | `Optional[Dict[str, Any]]` | Dicionário representando a saída da tarefa em JSON. |+| **Agent** | `agent` | `str` | O agente que executou a tarefa. |+| **Output Format** | `output_format` | `OutputFormat` | O formato da saída da tarefa, podendo ser RAW, JSON e Pydantic. O padrão é RAW. |### Métodos e Propriedades da Tarefa-| Método/Propriedade | Descrição |-| :----------------- | :--------------------------------------------------------------------------------------------- |-| **json** | Retorna a representação da saída da tarefa em JSON como string, se o formato de saída for JSON.|-| **to_dict** | Converte as saídas JSON e Pydantic para um dicionário. |+| Método/Propriedade | Descrição |+| :----------------- | :--------------------------------------------------------------------------------------------------- |+| **json** | Retorna a representação da saída da tarefa em JSON como string, se o formato de saída for JSON. |+| **to_dict** | Converte as saídas JSON e Pydantic para um dicionário. || **str** | Retorna a representação em string da saída da tarefa, priorizando Pydantic, depois JSON, depois raw. |### Acessando Saídas das Tarefas@@ -280,12 +285,13 @@ formatted_task = Task(```Quando `markdown=True`, o agente recebe instruções extras para formatar a saída usando:+- `#` para títulos- `**texto**` para negrito- `*texto*` para itálico- `-` ou `*` para bullet points- `` `código` `` para código inline-- ``` ```linguagem ``` para blocos de código+- ` `linguagem ``` para blocos de código### Configuração YAML com Markdown@@ -296,7 +302,7 @@ analysis_task:expected_output: >Uma análise completa com gráficos e descobertas-chaveagent: analyst- markdown: true # Habilita formatação em markdown+ markdown: true # Habilita formatação em markdownoutput_file: analysis.md```@@ -308,7 +314,9 @@ analysis_task:- **Compatibilidade Multi-plataforma**: Markdown é universalmente suportado<Note>-As instruções de formatação em markdown são adicionadas automaticamente ao prompt da tarefa quando `markdown=True`, então não é necessário detalhar os requisitos de formatação na descrição da tarefa.+ As instruções de formatação em markdown são adicionadas automaticamente ao+ prompt da tarefa quando `markdown=True`, então não é necessário detalhar os+ requisitos de formatação na descrição da tarefa.</Note>## Dependências de Tarefas e Contexto@@ -368,6 +376,7 @@ blog_task = Task(### Requisitos da Função Guardrail1. **Assinatura da Função**:+- Deve aceitar exatamente um parâmetro (a saída da tarefa)- Deve retornar uma tupla `(bool, Any)`- Type hints são recomendados, mas opcionais@@ -376,11 +385,10 @@ blog_task = Task(- Em caso de sucesso: retorna uma tupla `(True, resultado_validado)`- Em caso de falha: retorna uma tupla `(False, "mensagem de erro explicando a falha")`--### Melhores Práticas de Tratamento de Erros1. **Respostas de Erro Estruturadas**:+```python Codefrom crewai import TaskOutput, LLMGuardrail@@ -396,11 +404,13 @@ def validate_with_context(result: TaskOutput) -> Tuple[bool, Any]:```2. **Categorias de Erro**:+- Use códigos de erro específicos- Inclua contexto relevante- Forneça feedback acionável3. **Cadeia de Validação**:+```python Codefrom typing import Any, Dict, List, Tuple, Unionfrom crewai import TaskOutput@@ -427,6 +437,7 @@ def complex_validation(result: TaskOutput) -> Tuple[bool, Any]:### Tratamento dos Resultados do GuardrailQuando um guardrail retorna `(False, erro)`:+1. O erro é enviado de volta para o agente2. O agente tenta corrigir o problema3. O processo se repete até:@@ -434,6 +445,7 @@ Quando um guardrail retorna `(False, erro)`:- O número máximo de tentativas ser atingidoExemplo com manipulação de tentativas:+```python Codefrom typing import Optional, Tuple, Unionfrom crewai import TaskOutput, Task@@ -459,10 +471,12 @@ task = Task(## Obtendo Saídas Estruturadas e Consistentes das Tarefas<Note>-É importante também observar que a saída da última tarefa de um crew se torna a saída final do próprio crew.+ É importante também observar que a saída da última tarefa de um crew se torna+ a saída final do próprio crew.</Note>### Usando `output_pydantic`+A propriedade `output_pydantic` permite que você defina um modelo Pydantic que a saída da tarefa deve seguir. Isso garante que a saída seja não apenas estruturada, mas também validada de acordo com o modelo.Veja um exemplo de uso do output_pydantic:@@ -532,18 +546,22 @@ print("Acessando propriedades - Opção 5")print("Blog:", result)```+Neste exemplo:-* Um modelo Pydantic Blog é definido com os campos title e content.-* A tarefa task1 utiliza a propriedade output_pydantic para especificar que sua saída deve seguir o modelo Blog.-* Após executar o crew, você pode acessar a saída estruturada de várias formas, como mostrado.++- Um modelo Pydantic Blog é definido com os campos title e content.+- A tarefa task1 utiliza a propriedade output_pydantic para especificar que sua saída deve seguir o modelo Blog.+- Após executar o crew, você pode acessar a saída estruturada de várias formas, como mostrado.#### Explicação sobre o acesso à saída-1. Indexação estilo dicionário: Acesse os campos diretamente usando result["nome_do_campo"]. Isso funciona porque a classe CrewOutput implementa o método __getitem__.++1. Indexação estilo dicionário: Acesse os campos diretamente usando result["nome_do_campo"]. Isso funciona porque a classe CrewOutput implementa o método **getitem**.2. Diretamente do modelo Pydantic: Acesse os atributos diretamente do objeto result.pydantic.3. Usando o método to_dict(): Converta a saída para um dicionário e acesse os campos.4. Imprimindo o objeto inteiro: Simplesmente imprima o objeto result para ver a saída estruturada.### Usando `output_json`+A propriedade `output_json` permite definir o formato de saída esperado em JSON. Isso garante que a saída da tarefa seja uma estrutura JSON válida que pode ser facilmente analisada e utilizada na aplicação.Veja um exemplo de uso do `output_json`:@@ -603,14 +621,15 @@ print("Blog:", result)```Neste exemplo:-* Um modelo Pydantic Blog é definido com os campos title e content, usado para especificar a estrutura do JSON de saída.-* A tarefa task1 utiliza a propriedade output_json para indicar que espera uma saída JSON que segue o modelo Blog.-* Após executar o crew, você pode acessar a saída estruturada em JSON conforme demonstrado.++- Um modelo Pydantic Blog é definido com os campos title e content, usado para especificar a estrutura do JSON de saída.+- A tarefa task1 utiliza a propriedade output_json para indicar que espera uma saída JSON que segue o modelo Blog.+- Após executar o crew, você pode acessar a saída estruturada em JSON conforme demonstrado.#### Explicação sobre o acesso à saída-1. Acessando propriedades via indexação de dicionário: Você pode acessar os campos diretamente usando result["nome_do_campo"]. Isso é possível pois a classe CrewOutput implementa o método __getitem__, permitindo tratar a saída como um dicionário. Nesse caso, estamos acessando title e content do resultado.-2. Imprimindo o objeto Blog inteiro: Ao imprimir result, você obterá a representação em string do objeto CrewOutput. Como o método __str__ é implementado para retornar a saída em JSON, isso exibirá toda a saída como uma string formatada representando o objeto Blog.+1. Acessando propriedades via indexação de dicionário: Você pode acessar os campos diretamente usando result["nome_do_campo"]. Isso é possível pois a classe CrewOutput implementa o método **getitem**, permitindo tratar a saída como um dicionário. Nesse caso, estamos acessando title e content do resultado.+2. Imprimindo o objeto Blog inteiro: Ao imprimir result, você obterá a representação em string do objeto CrewOutput. Como o método **str** é implementado para retornar a saída em JSON, isso exibirá toda a saída como uma string formatada representando o objeto Blog.---@@ -827,8 +846,6 @@ task = Task()```--```python Code@CrewBaseclass InternalCrew:@@ -872,6 +889,7 @@ task = Task(### Casos Comuns de Uso#### Validação de Formato de Dados+```python Codedef validate_email_format(result: str) -> Tuple[bool, Union[str, str]]:"""Garante que a saída contenha um e-mail válido."""@@ -883,6 +901,7 @@ def validate_email_format(result: str) -> Tuple[bool, Union[str, str]]:```#### Filtragem de Conteúdo+```python Codedef filter_sensitive_info(result: str) -> Tuple[bool, Union[str, str]]:"""Remove ou valida informações sensíveis."""@@ -894,6 +913,7 @@ def filter_sensitive_info(result: str) -> Tuple[bool, Union[str, str]]:```#### Transformação de Dados+```python Codedef normalize_phone_number(result: str) -> Tuple[bool, Union[str, str]]:"""Garante que números de telefone estejam em formato consistente."""@@ -908,6 +928,7 @@ def normalize_phone_number(result: str) -> Tuple[bool, Union[str, str]]:### Recursos Avançados#### Encadeando Múltiplas Validações+```python Codedef chain_validations(*validators):"""Encadeia múltiplos validadores."""@@ -932,6 +953,7 @@ task = Task(```#### Lógica Customizada de Retentativas+```python Codetask = Task(description="Gerar dados",@@ -987,7 +1009,7 @@ analysis_task:Um relatório financeiro abrangente com insights trimestraisagent: financial_analystoutput_file: reports/quarterly/q4_2024_analysis.pdf- create_directory: true # Criar automaticamente o diretório 'reports/quarterly/'+ create_directory: true # Criar automaticamente o diretório 'reports/quarterly/'audit_task:description: >@@ -996,18 +1018,20 @@ audit_task:Um relatório de auditoria de conformidadeagent: auditoroutput_file: audit/compliance_report.md- create_directory: false # O diretório já deve existir+ create_directory: false # O diretório já deve existir```### Casos de Uso**Criação Automática de Diretórios (`create_directory=True`):**+- Ambientes de desenvolvimento e prototipagem- Geração dinâmica de relatórios com pastas baseadas em datas- Fluxos de trabalho automatizados onde a estrutura de diretórios pode variar- Aplicações multi-tenant com pastas específicas do usuário**Gerenciamento Manual de Diretórios (`create_directory=False`):**+- Ambientes de produção com controles rígidos do sistema de arquivos- Aplicações sensíveis à segurança onde diretórios devem ser pré-configurados- Sistemas com requisitos específicos de permissãodiff --git a/docs/pt-BR/concepts/tools.mdx b/docs/pt-BR/concepts/tools.mdxindex 26432a67c..21b1afed3 100644--- a/docs/pt-BR/concepts/tools.mdx+++ b/docs/pt-BR/concepts/tools.mdx@@ -17,9 +17,10 @@ Isso inclui ferramentas do [CrewAI Toolkit](https://github.com/joaomdmoura/crewapermitindo desde buscas simples até interações complexas e trabalho em equipe eficiente entre agentes.<Note type="info" title="Aprimoramento para Empresas: Repositório de Ferramentas">-O CrewAI AOP oferece um Repositório de Ferramentas abrangente, com integrações pré-construídas para sistemas empresariais e APIs comuns. Implemente agentes com ferramentas corporativas em minutos em vez de dias.+O CrewAI AMP oferece um Repositório de Ferramentas abrangente, com integrações pré-construídas para sistemas empresariais e APIs comuns. Implemente agentes com ferramentas corporativas em minutos em vez de dias.O Repositório de Ferramentas Empresariais inclui:+- Conectores pré-construídos para sistemas empresariais populares- Interface para criação de ferramentas personalizadas- Controle de versão e funcionalidades de compartilhamento@@ -116,44 +117,45 @@ crew.kickoff()Aqui está uma lista das ferramentas disponíveis e suas descrições:-| Ferramenta | Descrição |-| :------------------------------- | :------------------------------------------------------------------------------------------- |-| **ApifyActorsTool** | Ferramenta que integra Apify Actors aos seus fluxos de trabalho para web scraping e automação.|-| **BrowserbaseLoadTool** | Ferramenta para interação e extração de dados de navegadores web. |-| **CodeDocsSearchTool** | Uma ferramenta RAG otimizada para busca em documentações de código e documentos técnicos. |-| **CodeInterpreterTool** | Ferramenta para interpretar código Python. |-| **ComposioTool** | Permite o uso de ferramentas Composio. |-| **CSVSearchTool** | Ferramenta RAG projetada para busca em arquivos CSV, ideal para dados estruturados. |-| **DALL-E Tool** | Ferramenta para gerar imagens utilizando a API do DALL-E. |-| **DirectorySearchTool** | Ferramenta RAG para busca em diretórios, útil para navegação em sistemas de arquivos. |-| **DOCXSearchTool** | Ferramenta RAG voltada para busca em documentos DOCX, ideal para processar arquivos Word. |-| **DirectoryReadTool** | Facilita a leitura e processamento de estruturas de diretórios e seus conteúdos. |-| **EXASearchTool** | Ferramenta projetada para buscas exaustivas em diversas fontes de dados. |-| **FileReadTool** | Permite a leitura e extração de dados de arquivos, suportando diversos formatos. |-| **FirecrawlSearchTool** | Ferramenta para buscar páginas web usando Firecrawl e retornar os resultados. |-| **FirecrawlCrawlWebsiteTool** | Ferramenta para rastrear páginas web utilizando o Firecrawl. |-| **FirecrawlScrapeWebsiteTool** | Ferramenta para extrair o conteúdo de URLs usando Firecrawl. |-| **GithubSearchTool** | Ferramenta RAG para buscar em repositórios GitHub, útil para pesquisa de código e documentação.|-| **SerperDevTool** | Ferramenta especializada para finalidades de desenvolvimento, com funcionalidades em evolução. |-| **TXTSearchTool** | Ferramenta RAG voltada para busca em arquivos de texto (.txt), adaptada para dados não estruturados. |-| **JSONSearchTool** | Ferramenta RAG para busca em arquivos JSON, voltada ao manuseio de dados estruturados. |-| **LlamaIndexTool** | Permite o uso das ferramentas LlamaIndex. |-| **MDXSearchTool** | Ferramenta RAG para busca em arquivos Markdown (MDX), útil para documentação. |-| **PDFSearchTool** | Ferramenta RAG para busca em documentos PDF, ideal para processar documentos digitalizados. |-| **PGSearchTool** | Ferramenta RAG otimizada para busca em bancos de dados PostgreSQL, adequada para consultas. |-| **Vision Tool** | Ferramenta para gerar imagens utilizando a API do DALL-E. |-| **RagTool** | Ferramenta RAG de uso geral, capaz de lidar com diferentes fontes e tipos de dados. |-| **ScrapeElementFromWebsiteTool** | Permite extrair elementos específicos de sites, útil para extração de dados direcionada. |-| **ScrapeWebsiteTool** | Facilita o scraping de sites inteiros, ideal para coleta abrangente de dados. |-| **WebsiteSearchTool** | Ferramenta RAG para busca em conteúdos de sites, otimizada para extração de dados web. |-| **XMLSearchTool** | Ferramenta RAG para busca em arquivos XML, adequada para formatos de dados estruturados. |-| **YoutubeChannelSearchTool** | Ferramenta RAG para busca em canais do YouTube, útil para análise de conteúdo em vídeo. |-| **YoutubeVideoSearchTool** | Ferramenta RAG para busca em vídeos do YouTube, ideal para extração de dados de vídeo. |+| Ferramenta | Descrição |+| :------------------------------- | :--------------------------------------------------------------------------------------------------- |+| **ApifyActorsTool** | Ferramenta que integra Apify Actors aos seus fluxos de trabalho para web scraping e automação. |+| **BrowserbaseLoadTool** | Ferramenta para interação e extração de dados de navegadores web. |+| **CodeDocsSearchTool** | Uma ferramenta RAG otimizada para busca em documentações de código e documentos técnicos. |+| **CodeInterpreterTool** | Ferramenta para interpretar código Python. |+| **ComposioTool** | Permite o uso de ferramentas Composio. |+| **CSVSearchTool** | Ferramenta RAG projetada para busca em arquivos CSV, ideal para dados estruturados. |+| **DALL-E Tool** | Ferramenta para gerar imagens utilizando a API do DALL-E. |+| **DirectorySearchTool** | Ferramenta RAG para busca em diretórios, útil para navegação em sistemas de arquivos. |+| **DOCXSearchTool** | Ferramenta RAG voltada para busca em documentos DOCX, ideal para processar arquivos Word. |+| **DirectoryReadTool** | Facilita a leitura e processamento de estruturas de diretórios e seus conteúdos. |+| **EXASearchTool** | Ferramenta projetada para buscas exaustivas em diversas fontes de dados. |+| **FileReadTool** | Permite a leitura e extração de dados de arquivos, suportando diversos formatos. |+| **FirecrawlSearchTool** | Ferramenta para buscar páginas web usando Firecrawl e retornar os resultados. |+| **FirecrawlCrawlWebsiteTool** | Ferramenta para rastrear páginas web utilizando o Firecrawl. |+| **FirecrawlScrapeWebsiteTool** | Ferramenta para extrair o conteúdo de URLs usando Firecrawl. |+| **GithubSearchTool** | Ferramenta RAG para buscar em repositórios GitHub, útil para pesquisa de código e documentação. |+| **SerperDevTool** | Ferramenta especializada para finalidades de desenvolvimento, com funcionalidades em evolução. |+| **TXTSearchTool** | Ferramenta RAG voltada para busca em arquivos de texto (.txt), adaptada para dados não estruturados. |+| **JSONSearchTool** | Ferramenta RAG para busca em arquivos JSON, voltada ao manuseio de dados estruturados. |+| **LlamaIndexTool** | Permite o uso das ferramentas LlamaIndex. |+| **MDXSearchTool** | Ferramenta RAG para busca em arquivos Markdown (MDX), útil para documentação. |+| **PDFSearchTool** | Ferramenta RAG para busca em documentos PDF, ideal para processar documentos digitalizados. |+| **PGSearchTool** | Ferramenta RAG otimizada para busca em bancos de dados PostgreSQL, adequada para consultas. |+| **Vision Tool** | Ferramenta para gerar imagens utilizando a API do DALL-E. |+| **RagTool** | Ferramenta RAG de uso geral, capaz de lidar com diferentes fontes e tipos de dados. |+| **ScrapeElementFromWebsiteTool** | Permite extrair elementos específicos de sites, útil para extração de dados direcionada. |+| **ScrapeWebsiteTool** | Facilita o scraping de sites inteiros, ideal para coleta abrangente de dados. |+| **WebsiteSearchTool** | Ferramenta RAG para busca em conteúdos de sites, otimizada para extração de dados web. |+| **XMLSearchTool** | Ferramenta RAG para busca em arquivos XML, adequada para formatos de dados estruturados. |+| **YoutubeChannelSearchTool** | Ferramenta RAG para busca em canais do YouTube, útil para análise de conteúdo em vídeo. |+| **YoutubeVideoSearchTool** | Ferramenta RAG para busca em vídeos do YouTube, ideal para extração de dados de vídeo. |## Criando suas próprias Ferramentas<Tip>- Desenvolvedores podem criar `ferramentas personalizadas` adaptadas para as necessidades de seus agentes ou utilizar opções pré-construídas.+ Desenvolvedores podem criar `ferramentas personalizadas` adaptadas para as+ necessidades de seus agentes ou utilizar opções pré-construídas.</Tip>Existem duas formas principais de criar uma ferramenta CrewAI:@@ -248,8 +250,10 @@ def my_tool(question: str) -> str:### Mecanismo de Cache Personalizado<Tip>- As ferramentas podem implementar opcionalmente uma `cache_function` para ajuste fino do comportamento de cache.- Esta função determina quando armazenar resultados em cache com base em condições específicas, oferecendo controle granular sobre a lógica de cache.+ As ferramentas podem implementar opcionalmente uma `cache_function` para+ ajuste fino do comportamento de cache. Esta função determina quando armazenar+ resultados em cache com base em condições específicas, oferecendo controle+ granular sobre a lógica de cache.</Tip>```python Codediff --git a/docs/pt-BR/enterprise/features/rbac.mdx b/docs/pt-BR/enterprise/features/rbac.mdxindex 65f12c962..f87962c23 100644--- a/docs/pt-BR/enterprise/features/rbac.mdx+++ b/docs/pt-BR/enterprise/features/rbac.mdx@@ -7,10 +7,10 @@ mode: "wide"## Visão Geral-O RBAC no CrewAI AOP permite gerenciar acesso de forma segura e escalável combinando **funções em nível de organização** com **controles de visibilidade em nível de automação**.+O RBAC no CrewAI AMP permite gerenciar acesso de forma segura e escalável combinando **funções em nível de organização** com **controles de visibilidade em nível de automação**.<Frame>- <img src="/images/enterprise/users_and_roles.png" alt="Visão geral de RBAC no CrewAI AOP" />+ <img src="/images/enterprise/users_and_roles.png" alt="Visão geral de RBAC no CrewAI AMP" /></Frame>@@ -28,10 +28,11 @@ A configuração de usuários e funções é feita em Settings → Roles.<Steps><Step title="Abrir Roles">- Vá em <b>Settings → Roles</b> no CrewAI AOP.+ Vá em <b>Settings → Roles</b> no CrewAI AMP.</Step><Step title="Escolher a função">- Use <b>Owner</b> ou <b>Member</b>, ou clique em <b>Create role</b> para criar uma função personalizada.+ Use <b>Owner</b> ou <b>Member</b>, ou clique em <b>Create role</b> para+ criar uma função personalizada.</Step><Step title="Atribuir aos membros">Selecione os usuários e atribua a função. Você pode alterar depois.@@ -40,10 +41,10 @@ A configuração de usuários e funções é feita em Settings → Roles.### Resumo de configuração-| Área | Onde configurar | Opções |-|:---|:---|:---|-| Usuários & Funções | Settings → Roles | Pré-definidas: Owner, Member; Funções personalizadas |-| Visibilidade da automação | Automation → Settings → Visibility | Private; Lista de usuários/funções |+| Área | Onde configurar | Opções |+| :------------------------ | :--------------------------------- | :--------------------------------------------------- |+| Usuários & Funções | Settings → Roles | Pré-definidas: Owner, Member; Funções personalizadas |+| Visibilidade da automação | Automation → Settings → Visibility | Private; Lista de usuários/funções |## Controle de Acesso em Nível de Automação@@ -73,7 +74,8 @@ Configure em Automation → Settings → Visibility.Selecione <b>Private</b> para restringir o acesso. O owner mantém acesso.</Step><Step title="Permitir acesso">- Adicione usuários e funções que poderão ver/executar e acessar logs/métricas/configurações.+ Adicione usuários e funções que poderão ver/executar e acessar+ logs/métricas/configurações.</Step><Step title="Salvar e verificar">Salve e confirme que não listados não conseguem ver ou executar a automação.@@ -82,18 +84,19 @@ Configure em Automation → Settings → Visibility.### Resultado de acesso no modo Private-| Ação | Owner | Usuário/função na whitelist | Não listado |-|:---|:---|:---|:---|-| Ver automação | ✓ | ✓ | ✗ |-| Executar/API | ✓ | ✓ | ✗ |-| Logs/métricas/configurações | ✓ | ✓ | ✗ |+| Ação | Owner | Usuário/função na whitelist | Não listado |+| :-------------------------- | :---- | :-------------------------- | :---------- |+| Ver automação | ✓ | ✓ | ✗ |+| Executar/API | ✓ | ✓ | ✗ |+| Logs/métricas/configurações | ✓ | ✓ | ✗ |<Tip>-O owner sempre possui acesso. Em modo privado, somente usuários/funções na whitelist têm permissão.+ O owner sempre possui acesso. Em modo privado, somente usuários/funções na+ whitelist têm permissão.</Tip><Frame>- <img src="/images/enterprise/visibility.png" alt="Configuração de visibilidade no CrewAI AOP" />+ <img src="/images/enterprise/visibility.png" alt="Configuração de visibilidade no CrewAI AMP" /></Frame>diff --git a/docs/pt-BR/enterprise/features/tools-and-integrations.mdx b/docs/pt-BR/enterprise/features/tools-and-integrations.mdxindex b5d766d69..89082b880 100644--- a/docs/pt-BR/enterprise/features/tools-and-integrations.mdx+++ b/docs/pt-BR/enterprise/features/tools-and-integrations.mdx@@ -18,212 +18,221 @@ Ferramentas & Integrações é o hub central para conectar aplicações de terce<Tabs><Tab title="Integrações" icon="plug">- ## Aplicativos para Agentes (Integrações)-- Conecte aplicações empresariais (por exemplo, Gmail, Google Drive, HubSpot, Slack) via OAuth para habilitar ações de agentes.+## Aplicativos para Agentes (Integrações)++Conecte aplicações empresariais (por exemplo, Gmail, Google Drive, HubSpot, Slack) via OAuth para habilitar ações de agentes.++{" "}+<Steps>+ <Step title="Conectar">+ Clique em <b>Conectar</b> no app desejado e conclua o OAuth.+ </Step>+ <Step title="Configurar">+ Ajuste escopos, gatilhos e ações disponíveis conforme necessário.+ </Step>+ <Step title="Usar em Agentes">+ Os serviços conectados ficam disponíveis como ferramentas para seus agentes.+ </Step>+</Steps>++{" "}+<Frame></Frame>++### Conectar sua conta++1. Acesse <Link href="https://app.crewai.com/crewai_plus/connectors">Integrações</Link>+2. Clique em <b>Conectar</b> no serviço desejado+3. Conclua o fluxo OAuth e conceda os escopos+4. Copie seu Token Enterprise em <Link href="https://app.crewai.com/crewai_plus/settings/integrations">Configurações de Integração</Link>++{" "}+<Frame>+ +</Frame>- <Steps>- <Step title="Conectar">- Clique em <b>Conectar</b> no app desejado e conclua o OAuth.- </Step>- <Step title="Configurar">- Ajuste escopos, gatilhos e ações disponíveis conforme necessário.- </Step>- <Step title="Usar em Agentes">- Os serviços conectados ficam disponíveis como ferramentas para seus agentes.- </Step>- </Steps>+### Instalar ferramentas de integração- <Frame>- - </Frame>+Para usar as integrações localmente, instale a versão mais recente do pacote `crewai-tools`.- ### Conectar sua conta+```bash+uv add crewai-tools+```- 1. Acesse <Link href="https://app.crewai.com/crewai_plus/connectors">Integrações</Link>- 2. Clique em <b>Conectar</b> no serviço desejado- 3. Conclua o fluxo OAuth e conceda os escopos- 4. Copie seu Token Enterprise em <Link href="https://app.crewai.com/crewai_plus/settings/integrations">Configurações de Integração</Link>+### Configuração de variável de ambiente- <Frame>- - </Frame>+{" "}+<Note>+ Para usar integrações com `Agent(apps=[])`, você deve definir a variável de+ ambiente `CREWAI_PLATFORM_INTEGRATION_TOKEN` com seu Enterprise Token.+</Note>- ### Instalar ferramentas de integração+```bash+export CREWAI_PLATFORM_INTEGRATION_TOKEN="seu_enterprise_token"+```- Para usar as integrações localmente, instale a versão mais recente do pacote `crewai-tools`.+Ou adicione ao seu arquivo `.env`:- ```bash- uv add crewai-tools- ```+```+CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token+```- ### Configuração de variável de ambiente+### Exemplo de uso- <Note>- Para usar integrações com `Agent(apps=[])`, você deve definir a variável de ambiente `CREWAI_PLATFORM_INTEGRATION_TOKEN` com seu Enterprise Token.- </Note>+{" "}+<Tip>+ Use a nova abordagem simplificada para integrar aplicativos empresariais.+ Simplesmente especifique o aplicativo e suas ações diretamente na configuração+ do Agent.+</Tip>- ```bash- export CREWAI_PLATFORM_INTEGRATION_TOKEN="seu_enterprise_token"- ```+```python+from crewai import Agent, Task, Crew- Ou adicione ao seu arquivo `.env`:+# Crie um agente com capacidades do Gmail+email_agent = Agent(+ role="Gerente de Email",+ goal="Gerenciar e organizar comunicações por email",+ backstory="Assistente de IA especializado em gestão de emails",+ apps=['gmail', 'gmail/send_email'] # Usando nome canônico 'gmail'+)- ```- CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- ```+email_task = Task(+ description="Criar e enviar follow-up para [email protected] sobre a atualização do projeto",+ agent=email_agent,+ expected_output="Confirmação de envio do email com sucesso"+)- ### Exemplo de uso+crew = Crew(agents=[email_agent], tasks=[email_task])+crew.kickoff()+```- <Tip>- Use a nova abordagem simplificada para integrar aplicativos empresariais. Simplesmente especifique o aplicativo e suas ações diretamente na configuração do Agent.- </Tip>+### Filtrando ferramentas- ```python- from crewai import Agent, Task, Crew+```python+from crewai import Agent, Task, Crew- # Crie um agente com capacidades do Gmail- email_agent = Agent(- role="Gerente de Email",- goal="Gerenciar e organizar comunicações por email",- backstory="Assistente de IA especializado em gestão de emails",- apps=['gmail', 'gmail/send_email'] # Usando nome canônico 'gmail'- )+# Crie agente com ações específicas do Gmail apenas+gmail_agent = Agent(+ role="Gerente de Gmail",+ goal="Gerenciar comunicações e notificações no Gmail",+ backstory="Assistente de IA para coordenação de emails",+ apps=['gmail/fetch_emails'] # Usando nome canônico com ação específica+)- email_task = Task(- description="Criar e enviar follow-up para [email protected] sobre a atualização do projeto",- agent=email_agent,- expected_output="Confirmação de envio do email com sucesso"- )+notification_task = Task(+ description="Encontrar o email de [email protected]",+ agent=gmail_agent,+ expected_output="Email encontrado de [email protected]"+)- crew = Crew(agents=[email_agent], tasks=[email_task])- crew.kickoff()- ```+crew = Crew(agents=[gmail_agent], tasks=[notification_task])+```- ### Filtrando ferramentas+Em um crew implantado, você pode especificar quais ações ficam disponíveis em cada integração na página de configurações do serviço.- ```python- from crewai import Agent, Task, Crew+{" "}+<Frame>+ +</Frame>- # Crie agente com ações específicas do Gmail apenas- gmail_agent = Agent(- role="Gerente de Gmail",- goal="Gerenciar comunicações e notificações no Gmail",- backstory="Assistente de IA para coordenação de emails",- apps=['gmail/fetch_emails'] # Usando nome canônico com ação específica- )+### Implantações com escopo (organizações multiusuário)- notification_task = Task(- description="Encontrar o email de [email protected]",- agent=gmail_agent,- expected_output="Email encontrado de [email protected]"- )+Você pode escopar cada integração para um usuário específico (por exemplo, usar a conta Gmail de um usuário).- crew = Crew(agents=[gmail_agent], tasks=[notification_task])- ```+{" "}+<Tip>+ Útil quando diferentes equipes/usuários precisam manter o acesso a dados+ isolado.+</Tip>- Em um crew implantado, você pode especificar quais ações ficam disponíveis em cada integração na página de configurações do serviço.+Use `user_bearer_token` para escopar a autenticação ao usuário solicitante. Se o usuário não estiver logado, o crew não usará integrações conectadas; caso contrário, usa o token padrão configurado na implantação.- <Frame>- - </Frame>+{" "}+<Frame></Frame>- ### Implantações com escopo (organizações multiusuário)+{" "}+<div id="catalog"></div>+### Catálogo- Você pode escopar cada integração para um usuário específico (por exemplo, usar a conta Gmail de um usuário).+#### Comunicação & Colaboração- <Tip>- Útil quando diferentes equipes/usuários precisam manter o acesso a dados isolado.- </Tip>+- Gmail — Gerenciamento de emails e rascunhos+- Slack — Notificações e alertas do workspace+- Microsoft — Integração com Office 365 e Teams- Use `user_bearer_token` para escopar a autenticação ao usuário solicitante. Se o usuário não estiver logado, o crew não usará integrações conectadas; caso contrário, usa o token padrão configurado na implantação.+#### Gestão de Projetos- <Frame>- - </Frame>+- Jira — Rastreamento de issues e projetos+- ClickUp — Gestão de tarefas e produtividade+- Asana — Coordenação de tarefas de equipe+- Notion — Páginas e bancos de dados+- Linear — Gestão de bugs e projetos de software+- GitHub — Repositórios e issues- <div id="catalog"></div>- ### Catálogo+#### CRM- #### Comunicação & Colaboração- - Gmail — Gerenciamento de emails e rascunhos- - Slack — Notificações e alertas do workspace- - Microsoft — Integração com Office 365 e Teams+- Salesforce — Contas e oportunidades+- HubSpot — Pipeline de vendas e contatos+- Zendesk — Tickets de suporte- #### Gestão de Projetos- - Jira — Rastreamento de issues e projetos- - ClickUp — Gestão de tarefas e produtividade- - Asana — Coordenação de tarefas de equipe- - Notion — Páginas e bancos de dados- - Linear — Gestão de bugs e projetos de software- - GitHub — Repositórios e issues+#### Negócios & Finanças- #### CRM- - Salesforce — Contas e oportunidades- - HubSpot — Pipeline de vendas e contatos- - Zendesk — Tickets de suporte+- Stripe — Pagamentos e clientes+- Shopify — E‑commerce e produtos- #### Negócios & Finanças- - Stripe — Pagamentos e clientes- - Shopify — E‑commerce e produtos+#### Produtividade & Armazenamento- #### Produtividade & Armazenamento- - Google Sheets — Sincronização de planilhas- - Google Calendar — Eventos e agenda- - Box — Armazenamento de arquivos+- Google Sheets — Sincronização de planilhas+- Google Calendar — Eventos e agenda+- Box — Armazenamento de arquivos- …e mais por vir!+…e mais por vir!</Tab><Tab title="Ferramentas Internas" icon="toolbox">- ## Ferramentas Internas-- Crie ferramentas localmente, publique no Repositório de Ferramentas da CrewAI AOP e use nos seus agentes.-- <Tip>- Antes de executar os comandos abaixo, faça login na sua conta CrewAI AOP:- ```bash- crewai login- ```- </Tip>-- <Frame>- - </Frame>-- <Steps>- <Step title="Criar">- Criar uma nova ferramenta localmente.- ```bash- crewai tool create your-tool- ```- </Step>- <Step title="Publicar">- Publicar a ferramenta no Repositório de Ferramentas.- ```bash- crewai tool publish- ```- </Step>- <Step title="Instalar">- Instalar a ferramenta do Repositório de Ferramentas.- ```bash- crewai tool install your-tool- ```- </Step>- </Steps>-- Gerenciar:-- - Nome e descrição- - Visibilidade (Privado / Público)- - Variáveis de ambiente necessárias- - Histórico de versões e downloads- - Acesso por equipe e função-- <Frame>- - </Frame>+## Ferramentas Internas++Crie ferramentas localmente, publique no Repositório de Ferramentas da CrewAI AMP e use nos seus agentes.++{" "}+<Tip>+ Antes de executar os comandos abaixo, faça login na sua conta CrewAI AMP:+ ```bash crewai login ```+</Tip>++{" "}+<Frame>+ +</Frame>++{" "}+<Steps>+ <Step title="Criar">+ Criar uma nova ferramenta localmente. ```bash crewai tool create your-tool```+ </Step>+ <Step title="Publicar">+ Publicar a ferramenta no Repositório de Ferramentas. ```bash crewai tool+ publish ```+ </Step>+ <Step title="Instalar">+ Instalar a ferramenta do Repositório de Ferramentas. ```bash crewai tool+ install your-tool ```+ </Step>+</Steps>++Gerenciar:++- Nome e descrição+- Visibilidade (Privado / Público)+- Variáveis de ambiente necessárias+- Histórico de versões e downloads+- Acesso por equipe e função++{" "}+<Frame>+ +</Frame></Tab></Tabs>@@ -231,10 +240,18 @@ Ferramentas & Integrações é o hub central para conectar aplicações de terce## Relacionados<CardGroup cols={2}>- <Card title="Repositório de Ferramentas" href="/pt-BR/enterprise/guides/tool-repository" icon="toolbox">+ <Card+ title="Repositório de Ferramentas"+ href="/pt-BR/enterprise/guides/tool-repository"+ icon="toolbox"+ >Publique e instale ferramentas para ampliar as capacidades dos seus crews.</Card>- <Card title="Automação com Webhook" href="/pt-BR/enterprise/guides/webhook-automation" icon="bolt">+ <Card+ title="Automação com Webhook"+ href="/pt-BR/enterprise/guides/webhook-automation"+ icon="bolt"+ >Automatize fluxos e integre com plataformas e serviços externos.</Card></CardGroup>diff --git a/docs/pt-BR/enterprise/features/traces.mdx b/docs/pt-BR/enterprise/features/traces.mdxindex e62a2234b..8906eb9b8 100644--- a/docs/pt-BR/enterprise/features/traces.mdx+++ b/docs/pt-BR/enterprise/features/traces.mdx@@ -11,7 +11,7 @@ Traces fornecem visibilidade abrangente sobre as execuções dos seus crews, aju## O que são Traces?-Traces no CrewAI AOP são registros detalhados de execução que capturam todos os aspectos da operação do seu crew, desde as entradas iniciais até as saídas finais. Eles registram:+Traces no CrewAI AMP são registros detalhados de execução que capturam todos os aspectos da operação do seu crew, desde as entradas iniciais até as saídas finais. Eles registram:- Pensamentos e raciocínio do agente- Detalhes da execução das tarefas@@ -20,15 +20,13 @@ Traces no CrewAI AOP são registros detalhados de execução que capturam todos- Tempos de execução- Estimativas de custo-<Frame>- -</Frame>+<Frame></Frame>## Acessando os Traces<Steps><Step title="Navegue até a aba Traces">- No seu painel do CrewAI AOP, clique em **Traces** para ver todos os registros de execução.+ No seu painel do CrewAI AMP, clique em **Traces** para ver todos os registros de execução.</Step><Step title="Selecione uma Execução">@@ -51,9 +49,7 @@ A seção superior exibe métricas de alto nível sobre a execução:- **Tempo de Execução**: Duração total da execução do crew- **Custo Estimado**: Custo aproximado com base no uso de tokens-<Frame>- -</Frame>+<Frame></Frame>### 2. Tarefas & Agentes@@ -64,33 +60,25 @@ Esta seção mostra todas as tarefas e agentes que fizeram parte da execução d- Status (concluído/falhou)- Tempo de execução individual da tarefa-<Frame>- -</Frame>+<Frame></Frame>### 3. Saída FinalExibe o resultado final produzido pelo crew após a conclusão de todas as tarefas.-<Frame>- -</Frame>+<Frame></Frame>### 4. Linha do Tempo da ExecuçãoUma representação visual de quando cada tarefa começou e terminou, ajudando a identificar gargalos ou padrões de execução paralela.-<Frame>- -</Frame>+<Frame></Frame>### 5. Visão Detalhada da TarefaAo clicar em uma tarefa específica na linha do tempo ou na lista de tarefas, você verá:-<Frame>- -</Frame>+<Frame></Frame>- **Task Key**: Identificador único da tarefa- **Task ID**: Identificador técnico no sistema@@ -104,7 +92,6 @@ Ao clicar em uma tarefa específica na linha do tempo ou na lista de tarefas, vo- **Input**: Qualquer entrada fornecida a essa tarefa vinda de tarefas anteriores- **Output**: O resultado real produzido pelo agente-## Usando Traces para DepuraçãoTraces são indispensáveis para solucionar problemas nos seus crews:@@ -121,6 +108,7 @@ Traces são indispensáveis para solucionar problemas nos seus crews:<Frame></Frame>+</Step><Step title="Otimizar Desempenho">@@ -130,6 +118,7 @@ Traces são indispensáveis para solucionar problemas nos seus crews:- Uso excessivo de tokens- Operações redundantes de ferramentas- Chamadas de API desnecessárias+</Step><Step title="Melhore a Eficiência de Custos">@@ -139,9 +128,11 @@ Traces são indispensáveis para solucionar problemas nos seus crews:- Refine prompts para serem mais concisos- Faça cache de informações acessadas frequentemente- Estruture tarefas para minimizar operações redundantes+</Step></Steps><Card title="Precisa de ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para assistência com análise de traces ou outros recursos do CrewAI AOP.+ Entre em contato com nossa equipe de suporte para assistência com análise de+ traces ou outros recursos do CrewAI AMP.</Card>diff --git a/docs/pt-BR/enterprise/features/webhook-streaming.mdx b/docs/pt-BR/enterprise/features/webhook-streaming.mdxindex dd2e4f91f..d19ba6370 100644--- a/docs/pt-BR/enterprise/features/webhook-streaming.mdx+++ b/docs/pt-BR/enterprise/features/webhook-streaming.mdx@@ -7,16 +7,17 @@ mode: "wide"## Visão Geral-O Enterprise Event Streaming permite que você receba atualizações em tempo real via webhook sobre suas crews e flows implantados no CrewAI AOP, como chamadas de modelo, uso de ferramentas e etapas do flow.+O Enterprise Event Streaming permite que você receba atualizações em tempo real via webhook sobre suas crews e flows implantados no CrewAI AMP, como chamadas de modelo, uso de ferramentas e etapas do flow.## UsoAo utilizar a API Kickoff, inclua um objeto `webhooks` em sua requisição, por exemplo:# Exemplo de uso da API Kickoff com webhooks+```json{- "inputs": {"foo": "bar"},+ "inputs": { "foo": "bar" },"webhooks": {"events": ["crew_kickoff_started", "llm_call_started"],"url": "https://seu.endpoint/webhook",@@ -36,6 +37,7 @@ Se `realtime` estiver definido como `true`, cada evento será entregue individuaCada webhook envia uma lista de eventos:# Exemplo de evento enviado pelo webhook+```json{"events": [@@ -47,8 +49,8 @@ Cada webhook envia uma lista de eventos:"data": {"model": "gpt-4","messages": [- {"role": "system", "content": "Você é um assistente."},- {"role": "user", "content": "Resuma este artigo."}+ { "role": "system", "content": "Você é um assistente." },+ { "role": "user", "content": "Resuma este artigo." }]}}@@ -73,12 +75,13 @@ O CrewAI oferece suporte a eventos do sistema e eventos personalizados no Enterp- `tool_usage_started`- `tool_usage_completed`- `crew_test_failed`-- *...e outros*+- _...e outros_Os nomes dos eventos correspondem ao event bus interno. Veja o [código fonte no GitHub](https://github.com/crewAIInc/crewAI/tree/main/src/crewai/utilities/events) para a lista completa.Você pode emitir seus próprios eventos personalizados, e eles serão entregues através do webhook stream juntamente com os eventos do sistema.<Card title="Precisa de Ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para assistência com integração de webhook ou solução de problemas.+ Entre em contato com nossa equipe de suporte para assistência com integração+ de webhook ou solução de problemas.</Card>diff --git a/docs/pt-BR/enterprise/guides/automation-triggers.mdx b/docs/pt-BR/enterprise/guides/automation-triggers.mdxindex ce22b8ac0..85f866875 100644--- a/docs/pt-BR/enterprise/guides/automation-triggers.mdx+++ b/docs/pt-BR/enterprise/guides/automation-triggers.mdx@@ -1,11 +1,11 @@---title: "Visão Geral de Triggers"-description: "Entenda como os triggers da CrewAI AOP funcionam, como gerenciá-los e onde encontrar playbooks específicos de integração"+description: "Entenda como os triggers da CrewAI AMP funcionam, como gerenciá-los e onde encontrar playbooks específicos de integração"icon: "bolt"mode: "wide"----Os triggers da CrewAI AOP conectam suas automações a eventos em tempo real nas ferramentas que sua equipe já usa. Em vez de fazer polling ou depender de execuções manuais, os triggers escutam mudanças — novos e‑mails, atualizações de calendário, alterações no CRM — e iniciam imediatamente a crew ou flow que você definiu.+Os triggers da CrewAI AMP conectam suas automações a eventos em tempo real nas ferramentas que sua equipe já usa. Em vez de fazer polling ou depender de execuções manuais, os triggers escutam mudanças — novos e‑mails, atualizações de calendário, alterações no CRM — e iniciam imediatamente a crew ou flow que você definiu.<iframeclassName="w-full aspect-video rounded-xl"@@ -25,37 +25,62 @@ Os guias abaixo explicam, em detalhe, como habilitar e testar cada integração:<a href="/pt-BR/enterprise/guides/gmail-trigger">Dispare crews quando novos e‑mails chegarem ou threads forem atualizadas.</a></Card>- <Card title="Trigger do Google Calendar" icon="calendar-days">- <a href="/pt-BR/enterprise/guides/google-calendar-trigger">Reaja a eventos de calendário criados, atualizados ou cancelados.</a>- </Card>-- <Card title="Trigger do Google Drive" icon="folder-open">- <a href="/pt-BR/enterprise/guides/google-drive-trigger">Monitore uploads, edições e exclusões de arquivos no Drive.</a>- </Card>-- <Card title="Trigger do Outlook" icon="envelope-open">- <a href="/pt-BR/enterprise/guides/outlook-trigger">Automatize respostas a novos e‑mails ou eventos removidos no Outlook.</a>- </Card>-- <Card title="Trigger do OneDrive" icon="cloud">- <a href="/pt-BR/enterprise/guides/onedrive-trigger">Audite atividade e compartilhamentos de arquivos no OneDrive.</a>- </Card>-- <Card title="Trigger do Microsoft Teams" icon="comments">- <a href="/pt-BR/enterprise/guides/microsoft-teams-trigger">Inicie workflows quando novos chats forem criados no Teams.</a>- </Card>-- <Card title="Trigger do HubSpot" icon="hubspot">- <a href="/pt-BR/enterprise/guides/hubspot-trigger">Execute automações a partir de workflows e eventos de ciclo de vida no HubSpot.</a>- </Card>-- <Card title="Trigger do Salesforce" icon="salesforce">- <a href="/pt-BR/enterprise/guides/salesforce-trigger">Conecte processos do Salesforce às suas crews para automação de CRM.</a>- </Card>-- <Card title="Trigger do Slack" icon="slack">- <a href="/pt-BR/enterprise/guides/slack-trigger">Dispare crews diretamente de comandos slash no Slack.</a>- </Card>+{" "}+<Card title="Trigger do Google Calendar" icon="calendar-days">+ <a href="/pt-BR/enterprise/guides/google-calendar-trigger">+ Reaja a eventos de calendário criados, atualizados ou cancelados.+ </a>+</Card>++{" "}+<Card title="Trigger do Google Drive" icon="folder-open">+ <a href="/pt-BR/enterprise/guides/google-drive-trigger">+ Monitore uploads, edições e exclusões de arquivos no Drive.+ </a>+</Card>++{" "}+<Card title="Trigger do Outlook" icon="envelope-open">+ <a href="/pt-BR/enterprise/guides/outlook-trigger">+ Automatize respostas a novos e‑mails ou eventos removidos no Outlook.+ </a>+</Card>++{" "}+<Card title="Trigger do OneDrive" icon="cloud">+ <a href="/pt-BR/enterprise/guides/onedrive-trigger">+ Audite atividade e compartilhamentos de arquivos no OneDrive.+ </a>+</Card>++{" "}+<Card title="Trigger do Microsoft Teams" icon="comments">+ <a href="/pt-BR/enterprise/guides/microsoft-teams-trigger">+ Inicie workflows quando novos chats forem criados no Teams.+ </a>+</Card>++{" "}+<Card title="Trigger do HubSpot" icon="hubspot">+ <a href="/pt-BR/enterprise/guides/hubspot-trigger">+ Execute automações a partir de workflows e eventos de ciclo de vida no+ HubSpot.+ </a>+</Card>++{" "}+<Card title="Trigger do Salesforce" icon="salesforce">+ <a href="/pt-BR/enterprise/guides/salesforce-trigger">+ Conecte processos do Salesforce às suas crews para automação de CRM.+ </a>+</Card>++{" "}+<Card title="Trigger do Slack" icon="slack">+ <a href="/pt-BR/enterprise/guides/slack-trigger">+ Dispare crews diretamente de comandos slash no Slack.+ </a>+</Card><Card title="Trigger do Zapier" icon="bolt"><a href="/pt-BR/enterprise/guides/zapier-trigger">Integre a CrewAI com milhares de apps suportados pelo Zapier.</a>@@ -79,7 +104,10 @@ Com triggers você pode:2. Clique na aba **Triggers** para listar todas as integrações disponíveis<Frame>- <img src="/images/enterprise/list-available-triggers.png" alt="Lista de triggers disponíveis" />+ <img+ src="/images/enterprise/list-available-triggers.png"+ alt="Lista de triggers disponíveis"+ /></Frame>### Habilitando e Desabilitando@@ -87,7 +115,10 @@ Com triggers você pode:Cada trigger possui uma chave de ativação:<Frame>- <img src="/images/enterprise/trigger-selected.png" alt="Alternância de trigger habilitado" />+ <img+ src="/images/enterprise/trigger-selected.png"+ alt="Alternância de trigger habilitado"+ /></Frame>- **Habilitado (azul)** – Executa a automação quando o evento ocorrer@@ -100,7 +131,10 @@ As alterações são aplicadas imediatamente.Use a lista de execuções para acompanhar histórico, status e payloads:<Frame>- <img src="/images/enterprise/list-executions.png" alt="Lista de execuções acionadas por triggers" />+ <img+ src="/images/enterprise/list-executions.png"+ alt="Lista de execuções acionadas por triggers"+ /></Frame>## Construindo Automações Orientadas por Trigger@@ -129,6 +163,7 @@ crewai triggers list```Este comando exibe todos os triggers disponíveis baseados nas suas integrações conectadas, mostrando:+- Nome da integração e status de conexão- Tipos de triggers disponíveis- Nomes e descrições dos triggers@@ -148,6 +183,7 @@ crewai triggers run microsoft_onedrive/file_changed```Este comando:+- Executa sua crew localmente- Passa um payload de trigger completo e realista- Simula exatamente como sua crew será chamada em produção@@ -233,17 +269,20 @@ def delegar_para_crew(self, crewai_trigger_payload: dict = None):## Solução de Problemas**Trigger não dispara:**+- Verifique se o trigger está habilitado na aba Triggers do seu deployment- Confira o status da conexão em Tools & Integrations- Garanta que todas as variáveis de ambiente necessárias estão configuradas**Falhas de execução:**+- Consulte os logs de execução para detalhes do erro- Use `crewai triggers run <nome_do_trigger>` para testar localmente e ver a estrutura exata do payload- Verifique se sua crew pode processar o parâmetro `crewai_trigger_payload`- Garanta que sua crew não espera parâmetros que não estão incluídos no payload do trigger**Problemas de desenvolvimento:**+- Sempre teste com `crewai triggers run <trigger>` antes de fazer deploy para ver o payload completo- Lembre-se que `crewai run` NÃO simula chamadas de trigger—use `crewai triggers run` em vez disso- Use `crewai triggers list` para verificar quais triggers estão disponíveis para suas integrações conectadasdiff --git a/docs/pt-BR/enterprise/guides/azure-openai-setup.mdx b/docs/pt-BR/enterprise/guides/azure-openai-setup.mdxindex 97a0bb6d9..b234df95d 100644--- a/docs/pt-BR/enterprise/guides/azure-openai-setup.mdx+++ b/docs/pt-BR/enterprise/guides/azure-openai-setup.mdx@@ -20,7 +20,7 @@ Este guia orienta você na conexão do Azure OpenAI com o Crew Studio para opera</Step><Step title="Configure a Conexão Enterprise do CrewAI">- 4. Em outra aba, abra `CrewAI AOP > LLM Connections`. Dê um nome à sua LLM Connection, selecione Azure como provedor e escolha o mesmo modelo que você selecionou no Azure.+ 4. Em outra aba, abra `CrewAI AMP > LLM Connections`. Dê um nome à sua LLM Connection, selecione Azure como provedor e escolha o mesmo modelo que você selecionou no Azure.5. Na mesma página, adicione as variáveis de ambiente do passo 3:- Uma chamada `AZURE_DEPLOYMENT_TARGET_URL` (usando o Target URI). A URL deve ser parecida com: https://your-deployment.openai.azure.com/openai/deployments/gpt-4o/chat/completions?api-version=2024-08-01-preview- Outra chamada `AZURE_API_KEY` (usando a Key).@@ -28,7 +28,7 @@ Este guia orienta você na conexão do Azure OpenAI com o Crew Studio para opera</Step><Step title="Defina Configurações Padrão">- 7. Em `CrewAI AOP > Settings > Defaults > Crew Studio LLM Settings`, defina a nova LLM Connection e o modelo como padrão.+ 7. Em `CrewAI AMP > Settings > Defaults > Crew Studio LLM Settings`, defina a nova LLM Connection e o modelo como padrão.</Step><Step title="Configure o Acesso à Rede">@@ -37,6 +37,7 @@ Este guia orienta você na conexão do Azure OpenAI com o Crew Studio para opera- Navegue até `Resource Management > Networking`.- Certifique-se de que a opção `Allow access from all networks` está habilitada. Se essa configuração estiver restrita, o CrewAI pode ser impedido de acessar seu endpoint do Azure OpenAI.</Step>+</Steps>## Verificação@@ -46,6 +47,7 @@ Tudo pronto! O Crew Studio agora utilizará sua conexão Azure OpenAI. Teste a c## Solução de ProblemasSe você encontrar problemas:+- Verifique se o formato do Target URI corresponde ao padrão esperado- Confira se a API key está correta e com as permissões adequadas- Certifique-se de que o acesso à rede está configurado para permitir conexões do CrewAIdiff --git a/docs/pt-BR/enterprise/guides/build-crew.mdx b/docs/pt-BR/enterprise/guides/build-crew.mdxindex 56cc87135..9d2f86e4b 100644--- a/docs/pt-BR/enterprise/guides/build-crew.mdx+++ b/docs/pt-BR/enterprise/guides/build-crew.mdx@@ -7,7 +7,7 @@ mode: "wide"## Visão Geral-[CrewAI AOP](https://app.crewai.com) simplifica o processo de **criação**, **implantação** e **gerenciamento** dos seus agentes de IA em ambientes de produção.+[CrewAI AMP](https://app.crewai.com) simplifica o processo de **criação**, **implantação** e **gerenciamento** dos seus agentes de IA em ambientes de produção.## Primeiros Passos@@ -23,20 +23,26 @@ mode: "wide"### Instalação e Configuração<Card title="Siga a Instalação Padrão" icon="wrench" href="/pt-BR/installation">- Siga nosso guia de instalação padrão para configurar o CrewAI CLI e criar seu primeiro projeto.+ Siga nosso guia de instalação padrão para configurar o CrewAI CLI e criar seu+ primeiro projeto.</Card>### Construindo Sua Crew<Card title="Tutorial Rápido" icon="rocket" href="/pt-BR/quickstart">- Siga nosso tutorial rápido para criar sua primeira crew de agentes usando a configuração YAML.+ Siga nosso tutorial rápido para criar sua primeira crew de agentes usando a+ configuração YAML.</Card>## Suporte e RecursosPara suporte ou dúvidas específicas da versão Enterprise, entre em contato com nossa equipe dedicada através do [[email protected]](mailto:[email protected]).--<Card title="Agende uma Demonstração" icon="calendar" href="mailto:[email protected]">- Reserve um horário com nossa equipe para saber mais sobre os recursos Enterprise e como eles podem beneficiar sua organização.+<Card+ title="Agende uma Demonstração"+ icon="calendar"+ href="mailto:[email protected]"+>+ Reserve um horário com nossa equipe para saber mais sobre os recursos+ Enterprise e como eles podem beneficiar sua organização.</Card>diff --git a/docs/pt-BR/enterprise/guides/deploy-crew.mdx b/docs/pt-BR/enterprise/guides/deploy-crew.mdxindex fd60b5e43..438703979 100644--- a/docs/pt-BR/enterprise/guides/deploy-crew.mdx+++ b/docs/pt-BR/enterprise/guides/deploy-crew.mdx@@ -1,12 +1,15 @@---title: "Deploy Crew"-description: "Implantando um Crew na CrewAI AOP"+description: "Implantando um Crew na CrewAI AMP"icon: "rocket"mode: "wide"---<Note>-Depois de criar um crew localmente ou pelo Crew Studio, o próximo passo é implantá-lo na plataforma CrewAI AOP. Este guia cobre múltiplos métodos de implantação para ajudá-lo a escolher a melhor abordagem para o seu fluxo de trabalho.+ Depois de criar um crew localmente ou pelo Crew Studio, o próximo passo é+ implantá-lo na plataforma CrewAI AMP. Este guia cobre múltiplos métodos de+ implantação para ajudá-lo a escolher a melhor abordagem para o seu fluxo de+ trabalho.</Note>## Pré-requisitos@@ -16,7 +19,8 @@ Depois de criar um crew localmente ou pelo Crew Studio, o próximo passo é implVocê deve ter um crew funcional, criado localmente ou pelo Crew Studio</Card><Card title="Repositório GitHub" icon="github">- O código do seu crew deve estar em um repositório do GitHub (para o método de integração com GitHub)+ O código do seu crew deve estar em um repositório do GitHub (para o método+ de integração com GitHub)</Card></CardGroup>@@ -39,10 +43,10 @@ A CLI fornece a maneira mais rápida de implantar crews desenvolvidos localmente</Step><Step title="Autentique-se na Plataforma Enterprise">- Primeiro, você precisa autenticar sua CLI com a plataforma CrewAI AOP:+ Primeiro, você precisa autenticar sua CLI com a plataforma CrewAI AMP:```bash- # Se já possui uma conta CrewAI AOP, ou deseja criar uma:+ # Se já possui uma conta CrewAI AMP, ou deseja criar uma:crewai login```@@ -105,38 +109,38 @@ A CLI fornece a maneira mais rápida de implantar crews desenvolvidos localmenteO CrewAI CLI oferece vários comandos para gerenciar suas implantações:- ```bash- # Liste todas as suas implantações- crewai deploy list+```bash+# Liste todas as suas implantações+crewai deploy list- # Consulte o status de uma implantação- crewai deploy status+# Consulte o status de uma implantação+crewai deploy status- # Veja os logs da implantação- crewai deploy logs+# Veja os logs da implantação+crewai deploy logs- # Envie atualizações após alterações no código- crewai deploy push+# Envie atualizações após alterações no código+crewai deploy push- # Remova uma implantação- crewai deploy remove <deployment_id>- ```+# Remova uma implantação+crewai deploy remove <deployment_id>+```## Opção 2: Implantar Diretamente pela Interface Web-Você também pode implantar seus crews diretamente pela interface web da CrewAI AOP conectando sua conta do GitHub. Esta abordagem não requer utilizar a CLI na sua máquina local.+Você também pode implantar seus crews diretamente pela interface web da CrewAI AMP conectando sua conta do GitHub. Esta abordagem não requer utilizar a CLI na sua máquina local.<Steps><Step title="Enviar no GitHub">- Você precisa subir seu crew para um repositório do GitHub. Caso ainda não tenha criado um crew, você pode [seguir este tutorial](/pt-BR/quickstart).+Você precisa subir seu crew para um repositório do GitHub. Caso ainda não tenha criado um crew, você pode [seguir este tutorial](/pt-BR/quickstart).</Step>- <Step title="Conectando o GitHub ao CrewAI AOP">+ <Step title="Conectando o GitHub ao CrewAI AMP">- 1. Faça login em [CrewAI AOP](https://app.crewai.com)+ 1. Faça login em [CrewAI AMP](https://app.crewai.com)2. Clique no botão "Connect GitHub"<Frame>@@ -190,7 +194,9 @@ Você também pode implantar seus crews diretamente pela interface web da CrewAI## ⚠️ Requisitos de Segurança para Variáveis de Ambiente<Warning>-**Importante**: A CrewAI AOP possui restrições de segurança sobre os nomes de variáveis de ambiente que podem causar falha na implantação caso não sejam seguidas.+ **Importante**: A CrewAI AMP possui restrições de segurança sobre os nomes de+ variáveis de ambiente que podem causar falha na implantação caso não sejam+ seguidas.</Warning>### Padrões de Variáveis de Ambiente Bloqueados@@ -198,12 +204,14 @@ Você também pode implantar seus crews diretamente pela interface web da CrewAIPor motivos de segurança, os seguintes padrões de nome de variável de ambiente são **automaticamente filtrados** e causarão problemas de implantação:**Padrões Bloqueados:**+- Variáveis terminando em `_TOKEN` (ex: `MY_API_TOKEN`)- Variáveis terminando em `_PASSWORD` (ex: `DB_PASSWORD`)- Variáveis terminando em `_SECRET` (ex: `API_SECRET`)- Variáveis terminando em `_KEY` em certos contextos**Variáveis Bloqueadas Específicas:**+- `GITHUB_USER`, `GITHUB_TOKEN`- `AWS_REGION`, `AWS_DEFAULT_REGION`- Diversas variáveis internas do sistema CrewAI@@ -211,6 +219,7 @@ Por motivos de segurança, os seguintes padrões de nome de variável de ambient### Exceções PermitidasAlgumas variáveis são explicitamente permitidas mesmo coincidindo com os padrões bloqueados:+- `AZURE_AD_TOKEN`- `AZURE_OPENAI_AD_TOKEN`- `ENTERPRISE_ACTION_TOKEN`@@ -240,7 +249,9 @@ API_CONFIG=segredo1234. **Documente as mudanças**: Mantenha registro das variáveis renomeadas para seu time<Tip>-Se você se deparar com falhas de implantação com erros enigmáticos de variáveis de ambiente, confira primeiro os nomes das variáveis em relação a esses padrões.+ Se você se deparar com falhas de implantação com erros enigmáticos de+ variáveis de ambiente, confira primeiro os nomes das variáveis em relação a+ esses padrões.</Tip>### Interaja com Seu Crew Implantado@@ -248,6 +259,7 @@ Se você se deparar com falhas de implantação com erros enigmáticos de variáApós a implantação, você pode acessar seu crew por meio de:1. **REST API**: A plataforma gera um endpoint HTTPS exclusivo com estas rotas principais:+- `/inputs`: Lista os parâmetros de entrada requeridos- `/kickoff`: Inicia uma execução com os inputs fornecidos- `/status/{kickoff_id}`: Consulta o status da execução@@ -287,5 +299,6 @@ A plataforma Enterprise também oferece:- **Crew Studio**: Monte crews via interface de chat sem escrever código<Card title="Precisa de Ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para ajuda com questões de implantação ou dúvidas sobre a plataforma Enterprise.+ Entre em contato com nossa equipe de suporte para ajuda com questões de+ implantação ou dúvidas sobre a plataforma Enterprise.</Card>diff --git a/docs/pt-BR/enterprise/guides/enable-crew-studio.mdx b/docs/pt-BR/enterprise/guides/enable-crew-studio.mdxindex 4f450c490..621f84118 100644--- a/docs/pt-BR/enterprise/guides/enable-crew-studio.mdx+++ b/docs/pt-BR/enterprise/guides/enable-crew-studio.mdx@@ -1,12 +1,13 @@---title: "Ativar Crew Studio"-description: "Ativando o Crew Studio no CrewAI AOP"+description: "Ativando o Crew Studio no CrewAI AMP"icon: "comments"mode: "wide"---<Tip>-Crew Studio é uma poderosa ferramenta **no-code/low-code** que permite criar ou estruturar Crews rapidamente por meio de uma interface conversacional.+ Crew Studio é uma poderosa ferramenta **no-code/low-code** que permite criar+ ou estruturar Crews rapidamente por meio de uma interface conversacional.</Tip>## O que é o Crew Studio?@@ -24,7 +25,7 @@ Com o Crew Studio, você pode:- Selecionar as ferramentas apropriadas- Configurar os inputs necessários- Gerar código para download e personalização-- Fazer deploy diretamente na plataforma CrewAI AOP+- Fazer deploy diretamente na plataforma CrewAI AMP## Etapas de Configuração@@ -32,7 +33,7 @@ Antes de começar a usar o Crew Studio, você precisa configurar suas conexões<Steps><Step title="Configurar a Conexão LLM">- Acesse a aba **LLM Connections** no painel do CrewAI AOP e crie uma nova conexão LLM.+ Acesse a aba **LLM Connections** no painel do CrewAI AMP e crie uma nova conexão LLM.<Note>Sinta-se à vontade para utilizar qualquer provedor LLM suportado pelo CrewAI.@@ -52,6 +53,7 @@ Antes de começar a usar o Crew Studio, você precisa configurar suas conexões<Frame></Frame>+</Step><Step title="Verificar Conexão Adicionada">@@ -60,6 +62,7 @@ Antes de começar a usar o Crew Studio, você precisa configurar suas conexões<Frame></Frame>+</Step><Step title="Configurar Padrões do LLM">@@ -73,6 +76,7 @@ Antes de começar a usar o Crew Studio, você precisa configurar suas conexões<Frame></Frame>+</Step></Steps>@@ -82,7 +86,7 @@ Agora que você configurou sua conexão LLM e os padrões, está pronto para com<Steps><Step title="Acessar o Studio">- Navegue até a seção **Studio** no painel do CrewAI AOP.+ Navegue até a seção **Studio** no painel do CrewAI AMP.</Step><Step title="Iniciar uma Conversa">@@ -93,6 +97,7 @@ Agora que você configurou sua conexão LLM e os padrões, está pronto para com```O Crew Assistant fará perguntas de esclarecimento para entender melhor suas necessidades.+</Step><Step title="Revisar o Crew Gerado">@@ -104,14 +109,16 @@ Agora que você configurou sua conexão LLM e os padrões, está pronto para com- Ferramentas a serem utilizadasEsta é sua oportunidade para refinar a configuração antes de prosseguir.+</Step><Step title="Fazer Deploy ou Baixar">Quando estiver satisfeito com a configuração, você pode:- Baixar o código gerado para personalização local- - Fazer deploy do crew diretamente na plataforma CrewAI AOP+ - Fazer deploy do crew diretamente na plataforma CrewAI AMP- Modificar a configuração e gerar o crew novamente+</Step><Step title="Testar seu Crew">@@ -120,7 +127,9 @@ Agora que você configurou sua conexão LLM e os padrões, está pronto para com</Steps><Tip>-Para melhores resultados, forneça descrições claras e detalhadas do que deseja que seu crew realize. Inclua inputs específicos e outputs esperados em sua descrição.+ Para melhores resultados, forneça descrições claras e detalhadas do que deseja+ que seu crew realize. Inclua inputs específicos e outputs esperados em sua+ descrição.</Tip>## Exemplo de Fluxo de Trabalho@@ -134,27 +143,33 @@ Veja um fluxo de trabalho típico para criação de um crew com o Crew Studio:```mdI need a crew that can analyze financial news and provide investment recommendations```- </Step>- <Step title="Responder Perguntas">- Responda às perguntas de esclarecimento do Crew Assistant para refinar seus requisitos.</Step>+{" "}+<Step title="Responder Perguntas">+ Responda às perguntas de esclarecimento do Crew Assistant para refinar seus+ requisitos.+</Step>+<Step title="Revisar o Plano">Revise o plano do crew gerado, que pode incluir:- Um Research Agent para coletar notícias financeiras- Um Analysis Agent para interpretar os dados- Um Recommendations Agent para fornecer conselhos de investimento- </Step>- <Step title="Aprovar ou Modificar">- Aprove o plano ou solicite alterações, se necessário.</Step>- <Step title="Baixar ou Fazer Deploy">- Baixe o código para personalização ou faça o deploy diretamente na plataforma.- </Step>+{" "}+<Step title="Aprovar ou Modificar">+ Aprove o plano ou solicite alterações, se necessário.+</Step>++{" "}+<Step title="Baixar ou Fazer Deploy">+ Baixe o código para personalização ou faça o deploy diretamente na plataforma.+</Step><Step title="Testar e Refinar">Teste seu crew com inputs de exemplo e faça ajustes conforme necessário.@@ -162,5 +177,6 @@ Veja um fluxo de trabalho típico para criação de um crew com o Crew Studio:</Steps><Card title="Precisa de ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para obter assistência com o Crew Studio ou qualquer outro recurso do CrewAI AOP.+ Entre em contato com nossa equipe de suporte para obter assistência com o Crew+ Studio ou qualquer outro recurso do CrewAI AMP.</Card>diff --git a/docs/pt-BR/enterprise/guides/gmail-trigger.mdx b/docs/pt-BR/enterprise/guides/gmail-trigger.mdxindex d976f5054..f5a2115c1 100644--- a/docs/pt-BR/enterprise/guides/gmail-trigger.mdx+++ b/docs/pt-BR/enterprise/guides/gmail-trigger.mdx@@ -10,17 +10,21 @@ mode: "wide"Use the Gmail Trigger to kick off your deployed crews when Gmail events happen in connected accounts, such as receiving a new email or messages matching a label/filter.<Tip>- Make sure Gmail is connected in Tools & Integrations and the trigger is enabled for your deployment.+ Make sure Gmail is connected in Tools & Integrations and the trigger is+ enabled for your deployment.</Tip>## Enabling the Gmail Trigger-1. Open your deployment in CrewAI AOP+1. Open your deployment in CrewAI AMP2. Go to the **Triggers** tab3. Locate **Gmail** and switch the toggle to enable<Frame>- <img src="/images/enterprise/trigger-selected.png" alt="Enable or disable triggers with toggle" />+ <img+ src="/images/enterprise/trigger-selected.png"+ alt="Enable or disable triggers with toggle"+ /></Frame>## Example: Process new emails@@ -68,7 +72,9 @@ crewai triggers run gmail/new_email_receivedO comando `crewai triggers run` executará sua crew com um payload completo do Gmail, permitindo que você teste sua lógica de parsing antes do deployment.<Warning>- Use `crewai triggers run gmail/new_email_received` (não `crewai run`) para simular execução de trigger durante o desenvolvimento. Após o deployment, sua crew receberá automaticamente o payload do trigger.+ Use `crewai triggers run gmail/new_email_received` (não `crewai run`) para+ simular execução de trigger durante o desenvolvimento. Após o deployment, sua+ crew receberá automaticamente o payload do trigger.</Warning>## Monitoring Executions@@ -76,7 +82,10 @@ O comando `crewai triggers run` executará sua crew com um payload completo do GTrack history and performance of triggered runs:<Frame>- <img src="/images/enterprise/list-executions.png" alt="List of executions triggered by automation" />+ <img+ src="/images/enterprise/list-executions.png"+ alt="List of executions triggered by automation"+ /></Frame>## Troubleshootingdiff --git a/docs/pt-BR/enterprise/guides/google-calendar-trigger.mdx b/docs/pt-BR/enterprise/guides/google-calendar-trigger.mdxindex 159c9138b..852d3a2a8 100644--- a/docs/pt-BR/enterprise/guides/google-calendar-trigger.mdx+++ b/docs/pt-BR/enterprise/guides/google-calendar-trigger.mdx@@ -10,17 +10,21 @@ mode: "wide"Use the Google Calendar trigger to launch automations whenever calendar events change. Common use cases include briefing a team before a meeting, notifying stakeholders when a critical event is cancelled, or summarizing daily schedules.<Tip>- Make sure Google Calendar is connected in **Tools & Integrations** and enabled for the deployment you want to automate.+ Make sure Google Calendar is connected in **Tools & Integrations** and enabled+ for the deployment you want to automate.</Tip>## Enabling the Google Calendar Trigger-1. Open your deployment in CrewAI AOP+1. Open your deployment in CrewAI AMP2. Go to the **Triggers** tab3. Locate **Google Calendar** and switch the toggle to enable<Frame>- <img src="/images/enterprise/calendar-trigger.png" alt="Enable or disable triggers with toggle" />+ <img+ src="/images/enterprise/calendar-trigger.png"+ alt="Enable or disable triggers with toggle"+ /></Frame>## Example: Summarize meeting details@@ -54,7 +58,9 @@ crewai triggers run google_calendar/event_changedO comando `crewai triggers run` executará sua crew com um payload completo do Calendar, permitindo que você teste sua lógica de parsing antes do deployment.<Warning>- Use `crewai triggers run google_calendar/event_changed` (não `crewai run`) para simular execução de trigger durante o desenvolvimento. Após o deployment, sua crew receberá automaticamente o payload do trigger.+ Use `crewai triggers run google_calendar/event_changed` (não `crewai run`)+ para simular execução de trigger durante o desenvolvimento. Após o deployment,+ sua crew receberá automaticamente o payload do trigger.</Warning>## Monitoring Executions@@ -62,7 +68,10 @@ O comando `crewai triggers run` executará sua crew com um payload completo do CThe **Executions** list in the deployment dashboard tracks every triggered run and surfaces payload metadata, output summaries, and errors.<Frame>- <img src="/images/enterprise/list-executions.png" alt="List of executions triggered by automation" />+ <img+ src="/images/enterprise/list-executions.png"+ alt="List of executions triggered by automation"+ /></Frame>## Troubleshootingdiff --git a/docs/pt-BR/enterprise/guides/google-drive-trigger.mdx b/docs/pt-BR/enterprise/guides/google-drive-trigger.mdxindex ba608d762..90f8f4ff8 100644--- a/docs/pt-BR/enterprise/guides/google-drive-trigger.mdx+++ b/docs/pt-BR/enterprise/guides/google-drive-trigger.mdx@@ -10,17 +10,21 @@ mode: "wide"Trigger your automations when files are created, updated, or removed in Google Drive. Typical workflows include summarizing newly uploaded content, enforcing sharing policies, or notifying owners when critical files change.<Tip>- Connect Google Drive in **Tools & Integrations** and confirm the trigger is enabled for the automation you want to monitor.+ Connect Google Drive in **Tools & Integrations** and confirm the trigger is+ enabled for the automation you want to monitor.</Tip>## Enabling the Google Drive Trigger-1. Open your deployment in CrewAI AOP+1. Open your deployment in CrewAI AMP2. Go to the **Triggers** tab3. Locate **Google Drive** and switch the toggle to enable<Frame>- <img src="/images/enterprise/gdrive-trigger.png" alt="Enable or disable triggers with toggle" />+ <img+ src="/images/enterprise/gdrive-trigger.png"+ alt="Enable or disable triggers with toggle"+ /></Frame>## Example: Summarize file activity@@ -51,7 +55,9 @@ crewai triggers run google_drive/file_changedO comando `crewai triggers run` executará sua crew com um payload completo do Drive, permitindo que você teste sua lógica de parsing antes do deployment.<Warning>- Use `crewai triggers run google_drive/file_changed` (não `crewai run`) para simular execução de trigger durante o desenvolvimento. Após o deployment, sua crew receberá automaticamente o payload do trigger.+ Use `crewai triggers run google_drive/file_changed` (não `crewai run`) para+ simular execução de trigger durante o desenvolvimento. Após o deployment, sua+ crew receberá automaticamente o payload do trigger.</Warning>## Monitoring Executions@@ -59,7 +65,10 @@ O comando `crewai triggers run` executará sua crew com um payload completo do DTrack history and performance of triggered runs with the **Executions** list in the deployment dashboard.<Frame>- <img src="/images/enterprise/list-executions.png" alt="List of executions triggered by automation" />+ <img+ src="/images/enterprise/list-executions.png"+ alt="List of executions triggered by automation"+ /></Frame>## Troubleshootingdiff --git a/docs/pt-BR/enterprise/guides/hubspot-trigger.mdx b/docs/pt-BR/enterprise/guides/hubspot-trigger.mdxindex 09db89f5a..8bc1a1340 100644--- a/docs/pt-BR/enterprise/guides/hubspot-trigger.mdx+++ b/docs/pt-BR/enterprise/guides/hubspot-trigger.mdx@@ -5,48 +5,59 @@ icon: "hubspot"mode: "wide"----Este guia fornece um processo passo a passo para configurar gatilhos do HubSpot para o CrewAI AOP, permitindo iniciar crews diretamente a partir de Workflows do HubSpot.+Este guia fornece um processo passo a passo para configurar gatilhos do HubSpot para o CrewAI AMP, permitindo iniciar crews diretamente a partir de Workflows do HubSpot.## Pré-requisitos-- Uma conta CrewAI AOP+- Uma conta CrewAI AMP- Uma conta HubSpot com o recurso de [Workflows do HubSpot](https://knowledge.hubspot.com/workflows/create-workflows)## Etapas de Configuração<Steps>- <Step title="Conecte sua conta HubSpot com o CrewAI AOP">- - Faça login na sua `Conta CrewAI AOP > Triggers`- - Selecione `HubSpot` na lista de gatilhos disponíveis- - Escolha a conta HubSpot que deseja conectar ao CrewAI AOP- - Siga as instruções na tela para autorizar o acesso do CrewAI AOP à sua conta HubSpot- - Uma mensagem de confirmação aparecerá assim que o HubSpot estiver conectado com sucesso ao CrewAI AOP- </Step>- <Step title="Crie um Workflow no HubSpot">- - Faça login na sua `Conta HubSpot > Automations > Workflows > New workflow`- - Selecione o tipo de workflow que atende às suas necessidades (por exemplo, Começar do zero)- - No construtor de workflow, clique no ícone de mais (+) para adicionar uma nova ação.- - Escolha `Integrated apps > CrewAI > Kickoff a Crew`.- - Selecione a Crew que deseja iniciar.- - Clique em `Save` para adicionar a ação ao seu workflow- <Frame>- <img src="/images/enterprise/hubspot-workflow-1.png" alt="HubSpot Workflow 1" />- </Frame>- </Step>- <Step title="Use os resultados da Crew com outras ações">- - Após a etapa Kickoff a Crew, clique no ícone de mais (+) para adicionar uma nova ação.- - Por exemplo, para enviar uma notificação de e-mail interna, escolha `Communications > Send internal email notification`- - No campo Body, clique em `Insert data`, selecione `View properties or action outputs from > Action outputs > Crew Result` para incluir dados da Crew no e-mail- <Frame>- <img src="/images/enterprise/hubspot-workflow-2.png" alt="HubSpot Workflow 2" />- </Frame>- - Configure quaisquer ações adicionais necessárias- - Revise as etapas do seu workflow para garantir que tudo está configurado corretamente- - Ative o workflow- <Frame>- <img src="/images/enterprise/hubspot-workflow-3.png" alt="HubSpot Workflow 3" />- </Frame>- </Step>+ <Step title="Conecte sua conta HubSpot com o CrewAI AMP">+ - Faça login na sua `Conta CrewAI AMP > Triggers` - Selecione `HubSpot` na+ lista de gatilhos disponíveis - Escolha a conta HubSpot que deseja conectar+ ao CrewAI AMP - Siga as instruções na tela para autorizar o acesso do CrewAI+ AMP à sua conta HubSpot - Uma mensagem de confirmação aparecerá assim que o+ HubSpot estiver conectado com sucesso ao CrewAI AMP+ </Step>+ <Step title="Crie um Workflow no HubSpot">+ - Faça login na sua `Conta HubSpot > Automations > Workflows > New workflow`+ - Selecione o tipo de workflow que atende às suas necessidades (por exemplo,+ Começar do zero) - No construtor de workflow, clique no ícone de mais (+)+ para adicionar uma nova ação. - Escolha `Integrated apps > CrewAI > Kickoff+ a Crew`. - Selecione a Crew que deseja iniciar. - Clique em `Save` para+ adicionar a ação ao seu workflow+ <Frame>+ <img+ src="/images/enterprise/hubspot-workflow-1.png"+ alt="HubSpot Workflow 1"+ />+ </Frame>+ </Step>+ <Step title="Use os resultados da Crew com outras ações">+ - Após a etapa Kickoff a Crew, clique no ícone de mais (+) para adicionar+ uma nova ação. - Por exemplo, para enviar uma notificação de e-mail interna,+ escolha `Communications > Send internal email notification` - No campo Body,+ clique em `Insert data`, selecione `View properties or action outputs from >+ Action outputs > Crew Result` para incluir dados da Crew no e-mail+ <Frame>+ <img+ src="/images/enterprise/hubspot-workflow-2.png"+ alt="HubSpot Workflow 2"+ />+ </Frame>+ - Configure quaisquer ações adicionais necessárias - Revise as+ etapas do seu workflow para garantir que tudo está configurado corretamente+ - Ative o workflow+ <Frame>+ <img+ src="/images/enterprise/hubspot-workflow-3.png"+ alt="HubSpot Workflow 3"+ />+ </Frame>+ </Step></Steps>## Recursos Adicionaisdiff --git a/docs/pt-BR/enterprise/guides/kickoff-crew.mdx b/docs/pt-BR/enterprise/guides/kickoff-crew.mdxindex b5aa02305..b5a0a1049 100644--- a/docs/pt-BR/enterprise/guides/kickoff-crew.mdx+++ b/docs/pt-BR/enterprise/guides/kickoff-crew.mdx@@ -1,25 +1,23 @@---title: "Kickoff Crew"-description: "Inicie um Crew no CrewAI AOP"+description: "Inicie um Crew no CrewAI AMP"icon: "flag-checkered"mode: "wide"---## Visão Geral-Uma vez que você tenha implantado seu crew na plataforma CrewAI AOP, é possível iniciar execuções pela interface web ou pela API. Este guia aborda ambos os métodos.+Uma vez que você tenha implantado seu crew na plataforma CrewAI AMP, é possível iniciar execuções pela interface web ou pela API. Este guia aborda ambos os métodos.## Método 1: Usando a Interface Web### Passo 1: Navegue até seu Crew Implantado-1. Faça login no [CrewAI AOP](https://app.crewai.com)+1. Faça login no [CrewAI AMP](https://app.crewai.com)2. Clique no nome do crew na sua lista de projetos3. Você será direcionado para a página de detalhes do crew-<Frame>- -</Frame>+<Frame></Frame>### Passo 2: Iniciar Execução@@ -31,9 +29,7 @@ Na página de detalhes do seu crew, você tem duas opções para iniciar uma exe2. Insira os parâmetros de entrada necessários para seu crew no editor JSON3. Clique no botão `Send Request`-<Frame>- -</Frame>+<Frame></Frame>#### Opção B: Usando a Interface Visual@@ -41,9 +37,7 @@ Na página de detalhes do seu crew, você tem duas opções para iniciar uma exe2. Insira os inputs necessários nos campos do formulário3. Clique no botão `Run Crew`-<Frame>- -</Frame>+<Frame></Frame>### Passo 3: Monitorar o Progresso da Execução@@ -52,9 +46,7 @@ Após iniciar a execução:1. Você receberá uma resposta contendo um `kickoff_id` - **copie este ID**2. Esse ID é fundamental para o acompanhamento da sua execução-<Frame>- -</Frame>+<Frame></Frame>### Passo 4: Verificar o Status da Execução@@ -64,11 +56,10 @@ Para monitorar o andamento da sua execução:2. Cole o `kickoff_id` no campo indicado3. Clique no botão "Get Status"-<Frame>- -</Frame>+<Frame></Frame>A resposta de status mostrará:+- Estado atual da execução (`running`, `completed`, etc.)- Detalhes sobre quais tarefas estão em andamento- Quaisquer outputs gerados até o momento@@ -83,7 +74,7 @@ Quando a execução for concluída:## Método 2: Usando a API-Você também pode iniciar crews programaticamente usando a REST API do CrewAI AOP.+Você também pode iniciar crews programaticamente usando a REST API do CrewAI AMP.### Autenticação@@ -122,7 +113,7 @@ curl -X GET \A resposta será um objeto JSON contendo um array de parâmetros de entrada obrigatórios, por exemplo:```json-{"inputs":["topic","current_year"]}+{ "inputs": ["topic", "current_year"] }```Este exemplo mostra que este crew em particular requer dois inputs: `topic` e `current_year`.@@ -142,7 +133,7 @@ curl -X POST \A resposta incluirá um `kickoff_id` que você precisará para o acompanhamento:```json-{"kickoff_id":"abcd1234-5678-90ef-ghij-klmnopqrstuv"}+{ "kickoff_id": "abcd1234-5678-90ef-ghij-klmnopqrstuv" }```### Passo 3: Verificar Status da Execução@@ -182,5 +173,6 @@ Se uma execução falhar:3. Procure por respostas LLM e uso de ferramentas nos detalhes do trace<Card title="Precisa de Ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para obter ajuda com problemas de execução ou dúvidas sobre a plataforma Enterprise.+ Entre em contato com nossa equipe de suporte para obter ajuda com problemas de+ execução ou dúvidas sobre a plataforma Enterprise.</Card>diff --git a/docs/pt-BR/enterprise/guides/microsoft-teams-trigger.mdx b/docs/pt-BR/enterprise/guides/microsoft-teams-trigger.mdxindex 3f3f0b4dc..7c3c6182f 100644--- a/docs/pt-BR/enterprise/guides/microsoft-teams-trigger.mdx+++ b/docs/pt-BR/enterprise/guides/microsoft-teams-trigger.mdx@@ -10,17 +10,21 @@ mode: "wide"Use the Microsoft Teams trigger to start automations whenever a new chat is created. Common patterns include summarizing inbound requests, routing urgent messages to support teams, or creating follow-up tasks in other systems.<Tip>- Confirm Microsoft Teams is connected under **Tools & Integrations** and enabled in the **Triggers** tab for your deployment.+ Confirm Microsoft Teams is connected under **Tools & Integrations** and+ enabled in the **Triggers** tab for your deployment.</Tip>## Enabling the Microsoft Teams Trigger-1. Open your deployment in CrewAI AOP+1. Open your deployment in CrewAI AMP2. Go to the **Triggers** tab3. Locate **Microsoft Teams** and switch the toggle to enable<Frame caption="Microsoft Teams trigger connection">- <img src="/images/enterprise/msteams-trigger.png" alt="Enable or disable triggers with toggle" />+ <img+ src="/images/enterprise/msteams-trigger.png"+ alt="Enable or disable triggers with toggle"+ /></Frame>## Example: Summarize a new chat thread@@ -52,7 +56,9 @@ crewai triggers run microsoft_teams/teams_message_createdO comando `crewai triggers run` executará sua crew com um payload completo do Teams, permitindo que você teste sua lógica de parsing antes do deployment.<Warning>- Use `crewai triggers run microsoft_teams/teams_message_created` (não `crewai run`) para simular execução de trigger durante o desenvolvimento. Após o deployment, sua crew receberá automaticamente o payload do trigger.+ Use `crewai triggers run microsoft_teams/teams_message_created` (não `crewai+ run`) para simular execução de trigger durante o desenvolvimento. Após o+ deployment, sua crew receberá automaticamente o payload do trigger.</Warning>## Troubleshootingdiff --git a/docs/pt-BR/enterprise/guides/onedrive-trigger.mdx b/docs/pt-BR/enterprise/guides/onedrive-trigger.mdxindex cf28f714f..a5e81cf88 100644--- a/docs/pt-BR/enterprise/guides/onedrive-trigger.mdx+++ b/docs/pt-BR/enterprise/guides/onedrive-trigger.mdx@@ -10,17 +10,21 @@ mode: "wide"Start automations when files change inside OneDrive. You can generate audit summaries, notify security teams about external sharing, or update downstream line-of-business systems with new document metadata.<Tip>- Connect OneDrive in **Tools & Integrations** and toggle the trigger on for your deployment.+ Connect OneDrive in **Tools & Integrations** and toggle the trigger on for+ your deployment.</Tip>## Enabling the OneDrive Trigger-1. Open your deployment in CrewAI AOP+1. Open your deployment in CrewAI AMP2. Go to the **Triggers** tab3. Locate **OneDrive** and switch the toggle to enable<Frame caption="Microsoft OneDrive trigger connection">- <img src="/images/enterprise/onedrive-trigger.png" alt="Enable or disable triggers with toggle" />+ <img+ src="/images/enterprise/onedrive-trigger.png"+ alt="Enable or disable triggers with toggle"+ /></Frame>## Example: Audit file permissions@@ -51,7 +55,9 @@ crewai triggers run microsoft_onedrive/file_changedO comando `crewai triggers run` executará sua crew com um payload completo do OneDrive, permitindo que você teste sua lógica de parsing antes do deployment.<Warning>- Use `crewai triggers run microsoft_onedrive/file_changed` (não `crewai run`) para simular execução de trigger durante o desenvolvimento. Após o deployment, sua crew receberá automaticamente o payload do trigger.+ Use `crewai triggers run microsoft_onedrive/file_changed` (não `crewai run`)+ para simular execução de trigger durante o desenvolvimento. Após o deployment,+ sua crew receberá automaticamente o payload do trigger.</Warning>## Troubleshootingdiff --git a/docs/pt-BR/enterprise/guides/outlook-trigger.mdx b/docs/pt-BR/enterprise/guides/outlook-trigger.mdxindex f1e21964d..e373685c2 100644--- a/docs/pt-BR/enterprise/guides/outlook-trigger.mdx+++ b/docs/pt-BR/enterprise/guides/outlook-trigger.mdx@@ -10,17 +10,21 @@ mode: "wide"Automate responses when Outlook delivers a new message or when an event is removed from the calendar. Teams commonly route escalations, file tickets, or alert attendees of cancellations.<Tip>- Connect Outlook in **Tools & Integrations** and ensure the trigger is enabled for your deployment.+ Connect Outlook in **Tools & Integrations** and ensure the trigger is enabled+ for your deployment.</Tip>## Enabling the Outlook Trigger-1. Open your deployment in CrewAI AOP+1. Open your deployment in CrewAI AMP2. Go to the **Triggers** tab3. Locate **Outlook** and switch the toggle to enable<Frame caption="Microsoft Outlook trigger connection">- <img src="/images/enterprise/outlook-trigger.png" alt="Enable or disable triggers with toggle" />+ <img+ src="/images/enterprise/outlook-trigger.png"+ alt="Enable or disable triggers with toggle"+ /></Frame>## Example: Summarize a new email@@ -51,7 +55,9 @@ crewai triggers run microsoft_outlook/email_receivedO comando `crewai triggers run` executará sua crew com um payload completo do Outlook, permitindo que você teste sua lógica de parsing antes do deployment.<Warning>- Use `crewai triggers run microsoft_outlook/email_received` (não `crewai run`) para simular execução de trigger durante o desenvolvimento. Após o deployment, sua crew receberá automaticamente o payload do trigger.+ Use `crewai triggers run microsoft_outlook/email_received` (não `crewai run`)+ para simular execução de trigger durante o desenvolvimento. Após o deployment,+ sua crew receberá automaticamente o payload do trigger.</Warning>## Troubleshootingdiff --git a/docs/pt-BR/enterprise/guides/react-component-export.mdx b/docs/pt-BR/enterprise/guides/react-component-export.mdxindex 4f527190d..49b4c19cb 100644--- a/docs/pt-BR/enterprise/guides/react-component-export.mdx+++ b/docs/pt-BR/enterprise/guides/react-component-export.mdx@@ -1,11 +1,11 @@---title: "Exportação de Componentes React"-description: "Aprenda como exportar e integrar componentes React do CrewAI AOP em suas aplicações"+description: "Aprenda como exportar e integrar componentes React do CrewAI AMP em suas aplicações"icon: "react"mode: "wide"----Este guia explica como exportar crews do CrewAI AOP como componentes React e integrá-los às suas próprias aplicações.+Este guia explica como exportar crews do CrewAI AMP como componentes React e integrá-los às suas próprias aplicações.## Exportando um Componente React@@ -17,6 +17,7 @@ Este guia explica como exportar crews do CrewAI AOP como componentes React e int<img src="/images/enterprise/export-react-component.png" alt="Exportar Componente React" /></Frame></Step>+</Steps>## Configurando seu Ambiente React@@ -83,6 +84,7 @@ Para executar este componente React localmente, você precisará configurar um a```- Isso iniciará o servidor de desenvolvimento, e seu navegador padrão será aberto automaticamente em http://localhost:3000, onde você verá sua aplicação React rodando.</Step>+</Steps>## Personalização@@ -90,10 +92,16 @@ Para executar este componente React localmente, você precisará configurar um aVocê pode então personalizar o `CrewLead.jsx` para adicionar cor, título etc.<Frame>- <img src="/images/enterprise/customise-react-component.png" alt="Personalizar Componente React" />+ <img+ src="/images/enterprise/customise-react-component.png"+ alt="Personalizar Componente React"+ /></Frame><Frame>- <img src="/images/enterprise/customise-react-component-2.png" alt="Personalizar Componente React" />+ <img+ src="/images/enterprise/customise-react-component-2.png"+ alt="Personalizar Componente React"+ /></Frame>## Próximos Passosdiff --git a/docs/pt-BR/enterprise/guides/salesforce-trigger.mdx b/docs/pt-BR/enterprise/guides/salesforce-trigger.mdxindex 63731b02b..229923e88 100644--- a/docs/pt-BR/enterprise/guides/salesforce-trigger.mdx+++ b/docs/pt-BR/enterprise/guides/salesforce-trigger.mdx@@ -5,7 +5,7 @@ icon: "salesforce"mode: "wide"----A CrewAI AOP pode ser acionada a partir do Salesforce para automatizar fluxos de trabalho de gestão de relacionamento com o cliente e aprimorar suas operações de vendas.+A CrewAI AMP pode ser acionada a partir do Salesforce para automatizar fluxos de trabalho de gestão de relacionamento com o cliente e aprimorar suas operações de vendas.## Visão Geral@@ -31,7 +31,7 @@ O Salesforce é uma das principais plataformas de gestão de relacionamento comPara configurar triggers no Salesforce:-1. **Contato com o Suporte**: Entre em contato com o suporte da CrewAI AOP para obter assistência na configuração dos triggers no Salesforce+1. **Contato com o Suporte**: Entre em contato com o suporte da CrewAI AMP para obter assistência na configuração dos triggers no Salesforce2. **Revisar Requisitos**: Certifique-se de possuir as permissões necessárias no Salesforce e acesso à API3. **Configurar Conexão**: Trabalhe com a equipe de suporte para estabelecer a conexão entre a CrewAI e sua instância do Salesforce4. **Testar Triggers**: Verifique se os triggers funcionam corretamente para os seus casos de uso específicos@@ -47,4 +47,4 @@ Cenários comuns de uso de triggers Salesforce + CrewAI incluem:## Próximos Passos-Para instruções detalhadas de configuração e opções avançadas, entre em contato com o suporte da CrewAI AOP, que pode fornecer orientações personalizadas para o seu ambiente Salesforce e necessidades de negócio.+Para instruções detalhadas de configuração e opções avançadas, entre em contato com o suporte da CrewAI AMP, que pode fornecer orientações personalizadas para o seu ambiente Salesforce e necessidades de negócio.diff --git a/docs/pt-BR/enterprise/guides/team-management.mdx b/docs/pt-BR/enterprise/guides/team-management.mdxindex e1333a401..b92956541 100644--- a/docs/pt-BR/enterprise/guides/team-management.mdx+++ b/docs/pt-BR/enterprise/guides/team-management.mdx@@ -1,40 +1,44 @@---title: "Gestão de Equipes"-description: "Aprenda como convidar e gerenciar membros da equipe em sua organização CrewAI AOP"+description: "Aprenda como convidar e gerenciar membros da equipe em sua organização CrewAI AMP"icon: "users"mode: "wide"----Como administrador de uma conta CrewAI AOP, você pode facilmente convidar novos membros para sua organização. Este guia irá orientá-lo passo a passo pelo processo.+Como administrador de uma conta CrewAI AMP, você pode facilmente convidar novos membros para sua organização. Este guia irá orientá-lo passo a passo pelo processo.## Convidando Membros da Equipe<Steps>- <Step title="Acesse a Página de Configurações">- - Faça login na sua conta CrewAI AOP- - Procure o ícone de engrenagem (⚙️) no canto superior direito do painel- - Clique no ícone de engrenagem para acessar a página de **Configurações**:- <Frame>- <img src="/images/enterprise/settings-page.png" alt="Página de Configurações" />- </Frame>- </Step>- <Step title="Navegue até a Seção de Membros">- - Na página de Configurações, você verá a aba `Members`- - Clique na aba `Members` para acessar a página de **Membros**:- <Frame>- <img src="/images/enterprise/members-tab.png" alt="Aba Membros" />- </Frame>- </Step>- <Step title="Convidar Novos Membros">- - Na seção de Membros, você verá uma lista dos membros atuais (incluindo você)- - Localize o campo de entrada `Email`- - Digite o endereço de e-mail da pessoa que você deseja convidar- - Clique no botão `Invite` para enviar o convite- </Step>- <Step title="Repita Conforme Necessário">- - Você pode repetir esse processo para convidar vários membros da equipe- - Cada membro convidado receberá um convite por e-mail para ingressar na sua organização- </Step>+ <Step title="Acesse a Página de Configurações">+ - Faça login na sua conta CrewAI AMP - Procure o ícone de engrenagem (⚙️) no+ canto superior direito do painel - Clique no ícone de engrenagem para+ acessar a página de **Configurações**:+ <Frame>+ <img+ src="/images/enterprise/settings-page.png"+ alt="Página de Configurações"+ />+ </Frame>+ </Step>+ <Step title="Navegue até a Seção de Membros">+ - Na página de Configurações, você verá a aba `Members` - Clique na aba+ `Members` para acessar a página de **Membros**:+ <Frame>+ <img src="/images/enterprise/members-tab.png" alt="Aba Membros" />+ </Frame>+ </Step>+ <Step title="Convidar Novos Membros">+ - Na seção de Membros, você verá uma lista dos membros atuais (incluindo+ você) - Localize o campo de entrada `Email` - Digite o endereço de e-mail da+ pessoa que você deseja convidar - Clique no botão `Invite` para enviar o+ convite+ </Step>+ <Step title="Repita Conforme Necessário">+ - Você pode repetir esse processo para convidar vários membros da equipe -+ Cada membro convidado receberá um convite por e-mail para ingressar na sua+ organização+ </Step></Steps>## Adicionando Funções@@ -42,40 +46,54 @@ Como administrador de uma conta CrewAI AOP, você pode facilmente convidar novosVocê pode adicionar funções aos membros da equipe para controlar o acesso a diferentes partes da plataforma.<Steps>- <Step title="Acesse a Página de Configurações">- - Faça login na sua conta CrewAI AOP- - Procure o ícone de engrenagem (⚙️) no canto superior direito do painel- - Clique no ícone de engrenagem para acessar a página de **Configurações**:- <Frame>- <img src="/images/enterprise/settings-page.png" alt="Página de Configurações" />- </Frame>- </Step>- <Step title="Navegue até a Seção de Funções">- - Na página de Configurações, você verá a aba `Roles`- - Clique na aba `Roles` para acessar a página de **Funções**.- <Frame>- <img src="/images/enterprise/roles-tab.png" alt="Aba Funções" />- </Frame>- - Clique no botão `Add Role` para adicionar uma nova função.- - Insira os detalhes e as permissões da função e clique no botão `Create Role` para criar a função.- <Frame>- <img src="/images/enterprise/add-role-modal.png" alt="Modal Adicionar Função" />- </Frame>- </Step>- <Step title="Adicionar Funções aos Membros">- - Na seção de Membros, você verá uma lista dos membros atuais (incluindo você)- <Frame>- <img src="/images/enterprise/member-accepted-invitation.png" alt="Membro Aceitou Convite" />- </Frame>- - Após o membro aceitar o convite, você poderá adicionar uma função a ele.- - Volte para a aba `Roles`- - Vá até o membro ao qual deseja adicionar uma função e, na coluna `Role`, clique no menu suspenso- - Selecione a função que deseja atribuir ao membro- - Clique no botão `Update` para salvar a função- <Frame>- <img src="/images/enterprise/assign-role.png" alt="Adicionar Função ao Membro" />- </Frame>- </Step>+ <Step title="Acesse a Página de Configurações">+ - Faça login na sua conta CrewAI AMP - Procure o ícone de engrenagem (⚙️) no+ canto superior direito do painel - Clique no ícone de engrenagem para+ acessar a página de **Configurações**:+ <Frame>+ <img+ src="/images/enterprise/settings-page.png"+ alt="Página de Configurações"+ />+ </Frame>+ </Step>+ <Step title="Navegue até a Seção de Funções">+ - Na página de Configurações, você verá a aba `Roles` - Clique na aba+ `Roles` para acessar a página de **Funções**.+ <Frame>+ <img src="/images/enterprise/roles-tab.png" alt="Aba Funções" />+ </Frame>+ - Clique no botão `Add Role` para adicionar uma nova função. -+ Insira os detalhes e as permissões da função e clique no botão `Create Role`+ para criar a função.+ <Frame>+ <img+ src="/images/enterprise/add-role-modal.png"+ alt="Modal Adicionar Função"+ />+ </Frame>+ </Step>+ <Step title="Adicionar Funções aos Membros">+ - Na seção de Membros, você verá uma lista dos membros atuais (incluindo+ você)+ <Frame>+ <img+ src="/images/enterprise/member-accepted-invitation.png"+ alt="Membro Aceitou Convite"+ />+ </Frame>+ - Após o membro aceitar o convite, você poderá adicionar uma função+ a ele. - Volte para a aba `Roles` - Vá até o membro ao qual deseja adicionar+ uma função e, na coluna `Role`, clique no menu suspenso - Selecione a função+ que deseja atribuir ao membro - Clique no botão `Update` para salvar a+ função+ <Frame>+ <img+ src="/images/enterprise/assign-role.png"+ alt="Adicionar Função ao Membro"+ />+ </Frame>+ </Step></Steps>## Notas Importantes@@ -85,4 +103,4 @@ Você pode adicionar funções aos membros da equipe para controlar o acesso a d- **Aceite do Convite**: Os membros convidados precisarão aceitar o convite para ingressar na sua organização- **Notificações por E-mail**: Oriente seus membros a verificarem o e-mail (incluindo a pasta de spam) para localizar o convite-Seguindo estes passos, você conseguirá expandir sua equipe e colaborar de forma mais eficaz dentro da sua organização CrewAI AOP.+Seguindo estes passos, você conseguirá expandir sua equipe e colaborar de forma mais eficaz dentro da sua organização CrewAI AMP.diff --git a/docs/pt-BR/enterprise/guides/tool-repository.mdx b/docs/pt-BR/enterprise/guides/tool-repository.mdxindex e080df4a6..d925d5485 100644--- a/docs/pt-BR/enterprise/guides/tool-repository.mdx+++ b/docs/pt-BR/enterprise/guides/tool-repository.mdx@@ -20,11 +20,11 @@ O repositório não é um sistema de controle de versões. Use Git para rastrearAntes de usar o Repositório de Ferramentas, certifique-se de que você possui:-- Uma conta [CrewAI AOP](https://app.crewai.com)+- Uma conta [CrewAI AMP](https://app.crewai.com)- [CrewAI CLI](/pt-BR/concepts/cli#cli) instalada- uv>=0.5.0 instalado. Veja [como atualizar](https://docs.astral.sh/uv/getting-started/installation/#upgrading-uv)- [Git](https://git-scm.com) instalado e configurado-- Permissões de acesso para publicar ou instalar ferramentas em sua organização CrewAI AOP+- Permissões de acesso para publicar ou instalar ferramentas em sua organização CrewAI AMP## Instalando ferramentas@@ -85,13 +85,14 @@ crewai tool publishPara excluir uma ferramenta:-1. Acesse o [CrewAI AOP](https://app.crewai.com)+1. Acesse o [CrewAI AMP](https://app.crewai.com)2. Navegue até **Ferramentas**3. Selecione a ferramenta4. Clique em **Excluir**<Warning>-A exclusão é permanente. Ferramentas excluídas não podem ser restauradas ou reinstaladas.+ A exclusão é permanente. Ferramentas excluídas não podem ser restauradas ou+ reinstaladas.</Warning>## Verificações de segurança@@ -100,8 +101,9 @@ Cada versão publicada passa por verificações automáticas de segurança e sóVocê pode verificar o status das verificações de segurança de uma ferramenta em:-`CrewAI AOP > Tools > Your Tool > Versions`+`CrewAI AMP > Tools > Your Tool > Versions`<Card title="Precisa de ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para assistência com integração de API ou resolução de problemas.+ Entre em contato com nossa equipe de suporte para assistência com integração+ de API ou resolução de problemas.</Card>diff --git a/docs/pt-BR/enterprise/guides/update-crew.mdx b/docs/pt-BR/enterprise/guides/update-crew.mdxindex e746f9dc9..8ecf0d91b 100644--- a/docs/pt-BR/enterprise/guides/update-crew.mdx+++ b/docs/pt-BR/enterprise/guides/update-crew.mdx@@ -1,13 +1,14 @@---title: "Atualizar Crew"-description: "Atualizando uma Crew no CrewAI AOP"+description: "Atualizando uma Crew no CrewAI AMP"icon: "pencil"mode: "wide"---<Note>-Após implantar sua crew no CrewAI AOP, pode ser necessário fazer atualizações no código, configurações de segurança ou configuração.-Este guia explica como realizar essas operações de atualização comuns.+ Após implantar sua crew no CrewAI AMP, pode ser necessário fazer atualizações+ no código, configurações de segurança ou configuração. Este guia explica como+ realizar essas operações de atualização comuns.</Note>## Por que atualizar sua Crew?@@ -15,6 +16,7 @@ Este guia explica como realizar essas operações de atualização comuns.Por padrão, o CrewAI não irá buscar atualizações do GitHub automaticamente, então você precisará acionar manualmente as atualizações, a menos que tenha marcado a opção `Auto-update` ao implantar sua crew.Há várias razões para querer atualizar sua implantação de crew:+- Você deseja atualizar o código com o commit mais recente que enviou para o GitHub- Você deseja redefinir o bearer token por motivos de segurança- Você deseja atualizar variáveis de ambiente@@ -23,12 +25,10 @@ Há várias razões para querer atualizar sua implantação de crew:Quando você fizer push de novos commits no seu repositório do GitHub e quiser atualizar sua implantação:-1. Navegue até sua crew na plataforma CrewAI AOP+1. Navegue até sua crew na plataforma CrewAI AMP2. Clique no botão `Re-deploy` na página de detalhes da sua crew-<Frame>- -</Frame>+<Frame></Frame>Isso irá acionar uma atualização que pode ser acompanhada pela barra de progresso. O sistema irá buscar o código mais recente do seu repositório e reconstruir sua implantação.@@ -36,16 +36,16 @@ Isso irá acionar uma atualização que pode ser acompanhada pela barra de progrSe precisar gerar um novo bearer token (por exemplo, se suspeitar que o token atual possa ter sido comprometido):-1. Navegue até sua crew na plataforma CrewAI AOP+1. Navegue até sua crew na plataforma CrewAI AMP2. Encontre a seção `Bearer Token`3. Clique no botão `Reset` ao lado do token atual-<Frame>- -</Frame>+<Frame></Frame><Warning>-A redefinição do bearer token invalidará imediatamente o token anterior. Certifique-se de atualizar quaisquer aplicações ou scripts que estejam utilizando o token antigo.+ A redefinição do bearer token invalidará imediatamente o token anterior.+ Certifique-se de atualizar quaisquer aplicações ou scripts que estejam+ utilizando o token antigo.</Warning>## 3. Atualizando Variáveis de Ambiente@@ -69,7 +69,8 @@ Para atualizar as variáveis de ambiente da sua crew:5. Por fim, clique no botão `Update Deployment` na parte inferior da página para aplicar as alterações<Note>-A atualização das variáveis de ambiente irá acionar uma nova implantação, mas isso atualizará apenas a configuração de ambiente e não o código em si.+ A atualização das variáveis de ambiente irá acionar uma nova implantação, mas+ isso atualizará apenas a configuração de ambiente e não o código em si.</Note>## Após atualizar@@ -81,9 +82,12 @@ Após realizar qualquer atualização:3. Quando finalizado, teste sua crew para garantir que as alterações estão funcionando como esperado<Tip>-Se encontrar algum problema após a atualização, é possível visualizar os logs de implantação na plataforma ou entrar em contato com o suporte para obter assistência.+ Se encontrar algum problema após a atualização, é possível visualizar os logs+ de implantação na plataforma ou entrar em contato com o suporte para obter+ assistência.</Tip><Card title="Precisa de Ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para obter assistência com a atualização da sua crew ou solução de problemas de implantação.+ Entre em contato com nossa equipe de suporte para obter assistência com a+ atualização da sua crew ou solução de problemas de implantação.</Card>diff --git a/docs/pt-BR/enterprise/guides/webhook-automation.mdx b/docs/pt-BR/enterprise/guides/webhook-automation.mdxindex 16dde4318..1eedfd5f5 100644--- a/docs/pt-BR/enterprise/guides/webhook-automation.mdx+++ b/docs/pt-BR/enterprise/guides/webhook-automation.mdx@@ -1,17 +1,17 @@---title: "Automação com Webhook"-description: "Automatize fluxos de trabalho do CrewAI AOP usando webhooks com plataformas como ActivePieces, Zapier e Make.com"+description: "Automatize fluxos de trabalho do CrewAI AMP usando webhooks com plataformas como ActivePieces, Zapier e Make.com"icon: "webhook"mode: "wide"----O CrewAI AOP permite que você automatize seu fluxo de trabalho usando webhooks. Este artigo irá guiá-lo no processo de configuração e uso de webhooks para iniciar a execução do crew, com foco na integração com o ActivePieces, uma plataforma de automação de fluxos de trabalho semelhante ao Zapier e Make.com.+O CrewAI AMP permite que você automatize seu fluxo de trabalho usando webhooks. Este artigo irá guiá-lo no processo de configuração e uso de webhooks para iniciar a execução do crew, com foco na integração com o ActivePieces, uma plataforma de automação de fluxos de trabalho semelhante ao Zapier e Make.com.## Configurando Webhooks<Steps><Step title="Acessando a Interface de Kickoff">- - Navegue até o painel do CrewAI AOP+ - Navegue até o painel do CrewAI AMP- Procure pela seção `/kickoff`, que é usada para iniciar a execução do crew<Frame><img src="/images/enterprise/kickoff-interface.png" alt="Interface Kickoff" />@@ -44,7 +44,7 @@ O CrewAI AOP permite que você automatize seu fluxo de trabalho usando webhooks.3. Adicione uma etapa de ação HTTP- Configure a ação como `Send HTTP request`- Use o método `POST`- - Defina a URL para o endpoint de kickoff do CrewAI AOP+ - Defina a URL para o endpoint de kickoff do CrewAI AMP- Adicione os headers necessários (ex.: `Bearer Token`)<Frame><img src="/images/enterprise/activepieces-headers.png" alt="Headers ActivePieces" />@@ -76,6 +76,7 @@ O CrewAI AOP permite que você automatize seu fluxo de trabalho usando webhooks.<img src="/images/enterprise/activepieces-email.png" alt="Email ActivePieces" /></Frame></Step>+</Steps>## Exemplos de Output do Webhook@@ -121,4 +122,5 @@ O CrewAI AOP permite que você automatize seu fluxo de trabalho usando webhooks.}```</Tab>+</Tabs>diff --git a/docs/pt-BR/enterprise/guides/zapier-trigger.mdx b/docs/pt-BR/enterprise/guides/zapier-trigger.mdxindex a592c0789..70f562998 100644--- a/docs/pt-BR/enterprise/guides/zapier-trigger.mdx+++ b/docs/pt-BR/enterprise/guides/zapier-trigger.mdx@@ -5,11 +5,11 @@ icon: "bolt"mode: "wide"----Este guia irá conduzi-lo pelo processo de configuração de triggers no Zapier para o CrewAI AOP, permitindo automatizar fluxos de trabalho entre CrewAI AOP e outros aplicativos.+Este guia irá conduzi-lo pelo processo de configuração de triggers no Zapier para o CrewAI AMP, permitindo automatizar fluxos de trabalho entre CrewAI AMP e outros aplicativos.## Pré-requisitos-- Uma conta CrewAI AOP+- Uma conta CrewAI AMP- Uma conta Zapier- Uma conta Slack (para este exemplo específico)@@ -32,7 +32,7 @@ Este guia irá conduzi-lo pelo processo de configuração de triggers no Zapier- Conecte sua conta Slack, caso ainda não tenha feito isso.</Step>- <Step title="Configure a ação do CrewAI AOP">+ <Step title="Configure a ação do CrewAI AMP">- Adicione uma nova etapa de ação ao seu Zap.- Escolha CrewAI+ como o app de ação e Kickoff como Evento de Ação.@@ -41,8 +41,8 @@ Este guia irá conduzi-lo pelo processo de configuração de triggers no Zapier</Frame></Step>- <Step title="Conecte sua conta CrewAI AOP">- - Conecte sua conta CrewAI AOP.+ <Step title="Conecte sua conta CrewAI AMP">+ - Conecte sua conta CrewAI AMP.- Selecione o Crew apropriado para seu fluxo de trabalho.<Frame>@@ -51,8 +51,8 @@ Este guia irá conduzi-lo pelo processo de configuração de triggers no Zapier- Configure as entradas para o Crew usando os dados da mensagem do Slack.</Step>- <Step title="Formate a saída do CrewAI AOP">- - Adicione outra etapa de ação para formatar a saída de texto do CrewAI AOP.+ <Step title="Formate a saída do CrewAI AMP">+ - Adicione outra etapa de ação para formatar a saída de texto do CrewAI AMP.- Utilize as ferramentas de formatação do Zapier para converter a saída em Markdown para HTML.<Frame>@@ -67,7 +67,7 @@ Este guia irá conduzi-lo pelo processo de configuração de triggers no Zapier- Adicione uma etapa final de ação para enviar a saída formatada por e-mail.- Escolha seu serviço de e-mail preferido (ex.: Gmail, Outlook).- Configure os detalhes do e-mail, incluindo destinatário, assunto e corpo.- - Insira a saída formatada do CrewAI AOP no corpo do e-mail.+ - Insira a saída formatada do CrewAI AMP no corpo do e-mail.<Frame><img src="/images/enterprise/zapier-7.png" alt="Zapier 7" />@@ -93,12 +93,13 @@ Este guia irá conduzi-lo pelo processo de configuração de triggers no Zapier<img src="/images/enterprise/zapier-9.png" alt="Zapier 12" /></Frame></Step>+</Steps>## Dicas para o Sucesso-- Certifique-se de que as entradas do CrewAI AOP estejam corretamente mapeadas a partir da mensagem do Slack.+- Certifique-se de que as entradas do CrewAI AMP estejam corretamente mapeadas a partir da mensagem do Slack.- Teste seu Zap cuidadosamente antes de ativá-lo para identificar possíveis problemas.- Considere adicionar etapas de tratamento de erros para gerenciar possíveis falhas no fluxo.-Seguindo estes passos, você terá configurado com sucesso triggers no Zapier para o CrewAI AOP, permitindo fluxos de trabalho automatizados disparados por mensagens no Slack e resultando em notificações por e-mail com a saída do CrewAI AOP.+Seguindo estes passos, você terá configurado com sucesso triggers no Zapier para o CrewAI AMP, permitindo fluxos de trabalho automatizados disparados por mensagens no Slack e resultando em notificações por e-mail com a saída do CrewAI AMP.diff --git a/docs/pt-BR/enterprise/integrations/asana.mdx b/docs/pt-BR/enterprise/integrations/asana.mdxindex e7f138789..8a0f45ffa 100644--- a/docs/pt-BR/enterprise/integrations/asana.mdx+++ b/docs/pt-BR/enterprise/integrations/asana.mdx@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem tarefas, projetos e a coordenação da equipeAntes de usar a integração com o Asana, assegure-se de ter:-- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa+- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa- Uma conta Asana com as permissões apropriadas- Sua conta Asana conectada através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Antes de usar a integração com o Asana, assegure-se de ter:### 1. Conecte sua Conta Asana-1. Acesse [CrewAI AOP Integrações](https://app.crewai.com/crewai_plus/connectors)+1. Acesse [CrewAI AMP Integrações](https://app.crewai.com/crewai_plus/connectors)2. Encontre **Asana** na seção Integrações de Autenticação3. Clique em **Conectar** e complete o fluxo OAuth4. Conceda as permissões necessárias para gerenciamento de tarefas e projetos@@ -36,7 +36,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@@ -58,6 +59,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**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.").+</Accordion><Accordion title="asana/create_project">@@ -68,6 +70,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `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.").+</Accordion><Accordion title="asana/get_projects">@@ -76,6 +79,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**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`+</Accordion><Accordion title="asana/get_project_by_id">@@ -83,6 +87,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `projectFilterId` (string, obrigatório): ID do Projeto.+</Accordion><Accordion title="asana/create_task">@@ -97,6 +102,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `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.+</Accordion><Accordion title="asana/update_task">@@ -112,6 +118,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `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.+</Accordion><Accordion title="asana/get_tasks">@@ -122,6 +129,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `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").+</Accordion><Accordion title="asana/get_tasks_by_id">@@ -129,6 +137,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `taskId` (string, obrigatório): ID da Tarefa.+</Accordion><Accordion title="asana/get_task_by_external_id">@@ -136,6 +145,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `gid` (string, obrigatório): ID Externo - O ID que esta tarefa está associada ou sincronizada, de sua aplicação.+</Accordion><Accordion title="asana/add_task_to_section">@@ -146,6 +156,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `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").+</Accordion><Accordion title="asana/get_teams">@@ -153,12 +164,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `workspace` (string, obrigatório): Área de trabalho - Retorna as equipes nesta área de trabalho visíveis para o usuário autorizado.+</Accordion><Accordion title="asana/get_workspaces">**Descrição:** Obtém uma lista de áreas de trabalho do Asana.**Parâmetros:** Nenhum obrigatório.+</Accordion></AccordionGroup>diff --git a/docs/pt-BR/enterprise/integrations/box.mdx b/docs/pt-BR/enterprise/integrations/box.mdxindex 4f4e983af..ca76beb1c 100644--- a/docs/pt-BR/enterprise/integrations/box.mdx+++ b/docs/pt-BR/enterprise/integrations/box.mdx@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem arquivos, pastas e documentos através do BoxAntes de utilizar a integração com o Box, assegure-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 Box com as permissões apropriadas- Sua conta Box conectada através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Antes de utilizar a integração com o Box, assegure-se de que você possui:### 1. Conecte sua conta Box-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. Encontre **Box** na seção de Integrações de Autenticação3. Clique em **Conectar** e conclua o fluxo de OAuth4. Conceda as permissões necessárias para gerenciamento de arquivos e pastas@@ -50,6 +50,7 @@ uv add crewai-tools}```- `file` (string, obrigatório): URL do arquivo - Os arquivos devem ter menos de 50MB. (exemplo: "https://picsum.photos/200/300").+</Accordion><Accordion title="box/save_file_from_object">@@ -59,6 +60,7 @@ uv add crewai-tools- `file` (string, obrigatório): Arquivo - Aceita um Objeto de Arquivo contendo os dados. O arquivo deve ter menos de 50MB.- `fileName` (string, obrigatório): Nome do Arquivo (exemplo: "qwerty.png").- `folder` (string, opcional): Pasta - Use as configurações de workflow do Connect Portal para permitir que usuários escolham o destino da pasta. Caso em branco, o padrão é a pasta raiz do usuário.+</Accordion><Accordion title="box/get_file_by_id">@@ -66,6 +68,7 @@ uv add crewai-tools**Parâmetros:**- `fileId` (string, obrigatório): ID do arquivo - Identificador único que representa um arquivo. (exemplo: "12345").+</Accordion><Accordion title="box/list_files">@@ -91,6 +94,7 @@ uv add crewai-tools]}```+</Accordion><Accordion title="box/create_folder">@@ -104,6 +108,7 @@ uv add crewai-tools"id": "123456"}```+</Accordion><Accordion title="box/move_folder">@@ -118,6 +123,7 @@ uv add crewai-tools"id": "123456"}```+</Accordion><Accordion title="box/get_folder_by_id">@@ -125,6 +131,7 @@ uv add crewai-tools**Parâmetros:**- `folderId` (string, obrigatório): ID da pasta - Identificador único que representa uma pasta. (exemplo: "0").+</Accordion><Accordion title="box/search_folders">@@ -150,6 +157,7 @@ uv add crewai-tools]}```+</Accordion><Accordion title="box/delete_folder">@@ -158,6 +166,7 @@ uv add crewai-tools**Parâmetros:**- `folderId` (string, obrigatório): ID da pasta - Identificador único que representa uma pasta. (exemplo: "0").- `recursive` (boolean, opcional): Recursivo - Exclui uma pasta que não está vazia, deletando de forma recursiva a pasta e todo o seu conteúdo.+</Accordion></AccordionGroup>diff --git a/docs/pt-BR/enterprise/integrations/clickup.mdx b/docs/pt-BR/enterprise/integrations/clickup.mdxindex f38a3eff0..93c011514 100644--- a/docs/pt-BR/enterprise/integrations/clickup.mdx+++ b/docs/pt-BR/enterprise/integrations/clickup.mdx@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem tarefas, projetos e fluxos de produtividade pAntes de utilizar a integração com o ClickUp, 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 ClickUp com as permissões apropriadas- Sua conta ClickUp conectada pela [Página de Integrações](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Antes de utilizar a integração com o ClickUp, certifique-se de que você possu### 1. Conecte sua Conta ClickUp-1. Acesse [CrewAI AOP Integrações](https://app.crewai.com/crewai_plus/connectors)+1. Acesse [CrewAI AMP Integrações](https://app.crewai.com/crewai_plus/connectors)2. Encontre **ClickUp** na seção Integrações de Autenticação3. Clique em **Conectar** e complete o fluxo OAuth4. Conceda as permissões necessárias para gerenciamento de tarefas e projetos@@ -36,7 +36,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@@ -75,6 +76,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token}```Campos disponíveis: `space_ids%5B%5D`, `project_ids%5B%5D`, `list_ids%5B%5D`, `statuses%5B%5D`, `include_closed`, `assignees%5B%5D`, `tags%5B%5D`, `due_date_gt`, `due_date_lt`, `date_created_gt`, `date_created_lt`, `date_updated_gt`, `date_updated_lt`+</Accordion><Accordion title="clickup/get_task_in_list">@@ -83,6 +85,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `listId` (string, obrigatório): Lista - Selecione uma Lista da qual obter as tarefas. Use as Configurações do Usuário no Portal de Conexão para permitir que os usuários selecionem uma Lista ClickUp.- `taskFilterFormula` (string, opcional): Busque tarefas que correspondam aos filtros especificados. Por exemplo: name=task1.+</Accordion><Accordion title="clickup/create_task">@@ -96,6 +99,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `assignees` (string, opcional): Responsáveis - Selecione um Membro (ou um array de IDs de membros) para ser responsável por esta tarefa. Use as Configurações do Usuário no Portal de Conexão para permitir que os usuários selecionem um Membro ClickUp.- `dueDate` (string, opcional): Data de Vencimento - Especifique uma data para a conclusão desta tarefa.- `additionalFields` (string, opcional): Campos Adicionais - Especifique campos adicionais para incluir nesta tarefa em formato JSON.+</Accordion><Accordion title="clickup/update_task">@@ -110,6 +114,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `assignees` (string, opcional): Responsáveis - Selecione um Membro (ou um array de IDs de membros) para ser responsável por esta tarefa. Use as Configurações do Usuário no Portal de Conexão para permitir que os usuários selecionem um Membro ClickUp.- `dueDate` (string, opcional): Data de Vencimento - Especifique uma data para a conclusão desta tarefa.- `additionalFields` (string, opcional): Campos Adicionais - Especifique campos adicionais para incluir nesta tarefa em formato JSON.+</Accordion><Accordion title="clickup/delete_task">@@ -117,6 +122,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `taskId` (string, obrigatório): ID da tarefa - O ID da tarefa a ser excluída.+</Accordion><Accordion title="clickup/get_list">@@ -124,6 +130,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `spaceId` (string, obrigatório): ID do Espaço - O ID do espaço que contém as listas.+</Accordion><Accordion title="clickup/get_custom_fields_in_list">@@ -131,6 +138,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `listId` (string, obrigatório): ID da Lista - O ID da lista da qual obter os campos personalizados.+</Accordion><Accordion title="clickup/get_all_fields_in_list">@@ -138,6 +146,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `listId` (string, obrigatório): ID da Lista - O ID da lista da qual obter todos os campos.+</Accordion><Accordion title="clickup/get_space">@@ -145,6 +154,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `spaceId` (string, opcional): ID do Espaço - O ID do espaço a ser recuperado.+</Accordion><Accordion title="clickup/get_folders">@@ -152,12 +162,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `spaceId` (string, obrigatório): ID do Espaço - O ID do espaço que contém as pastas.+</Accordion><Accordion title="clickup/get_member">**Descrição:** Obtenha informações de Membro no ClickUp.**Parâmetros:** Nenhum obrigatório.+</Accordion></AccordionGroup>@@ -283,5 +295,6 @@ crew.kickoff()### Precisa de Ajuda?<Card title="Precisa de Ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para auxílio na configuração ou solução de problemas da integração com ClickUp.+ Entre em contato com nossa equipe de suporte para auxílio na configuração ou+ solução de problemas da integração com ClickUp.</Card>diff --git a/docs/pt-BR/enterprise/integrations/github.mdx b/docs/pt-BR/enterprise/integrations/github.mdxindex 9894ed7dd..4ef8731f2 100644--- a/docs/pt-BR/enterprise/integrations/github.mdx+++ b/docs/pt-BR/enterprise/integrations/github.mdx@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem repositórios, issues e releases através doAntes de usar a integração do GitHub, assegure-se de ter:-- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa+- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa- Uma conta GitHub com permissões adequadas no repositório- Conta do GitHub conectada através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Antes de usar a integração do GitHub, assegure-se de ter:### 1. Conecte sua conta GitHub-1. Acesse [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)+1. Acesse [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)2. Encontre **GitHub** na seção de Integrações de Autenticação3. Clique em **Conectar** e complete o fluxo OAuth4. Conceda as permissões necessárias para gerenciamento de repositório e issues@@ -45,6 +45,7 @@ uv add crewai-tools- `title` (string, obrigatório): Título da Issue - Especifique o título da issue a ser criada.- `body` (string, opcional): Corpo da Issue - Especifique o conteúdo do corpo da issue a ser criada.- `assignees` (string, opcional): Responsáveis - Especifique o login dos responsáveis no GitHub como um array de strings para esta issue. (exemplo: `["octocat"]`).+</Accordion><Accordion title="github/update_issue">@@ -59,6 +60,7 @@ uv add crewai-tools- `assignees` (string, opcional): Responsáveis - Especifique o login dos responsáveis no GitHub como um array de strings para esta issue. (exemplo: `["octocat"]`).- `state` (string, opcional): Estado - Especifique o estado atualizado da issue.- Opções: `open`, `closed`+</Accordion><Accordion title="github/get_issue_by_number">@@ -68,6 +70,7 @@ uv add crewai-tools- `owner` (string, obrigatório): Proprietário - Especifique o nome do proprietário da conta do repositório associado a esta Issue. (exemplo: "abc").- `repo` (string, obrigatório): Repositório - Especifique o nome do repositório associado a esta Issue.- `issue_number` (string, obrigatório): Número da Issue - Especifique o número da issue a ser buscada.+</Accordion><Accordion title="github/lock_issue">@@ -79,6 +82,7 @@ uv add crewai-tools- `issue_number` (string, obrigatório): Número da Issue - Especifique o número da issue a ser bloqueada.- `lock_reason` (string, obrigatório): Motivo do Bloqueio - Especifique um motivo para bloquear a discussão da issue ou pull request.- Opções: `off-topic`, `too heated`, `resolved`, `spam`+</Accordion><Accordion title="github/search_issue">@@ -106,6 +110,7 @@ uv add crewai-tools}```Campos disponíveis: `assignee`, `creator`, `mentioned`, `labels`+</Accordion><Accordion title="github/create_release">@@ -124,6 +129,7 @@ uv add crewai-tools- `discussion_category_name` (string, opcional): Nome da Categoria de Discussão - Se especificado, uma discussão da categoria indicada é criada e vinculada ao release. O valor deve ser uma categoria já existente no repositório.- `generate_release_notes` (string, opcional): Notas de Release - Especifique se o release criado deve criar automaticamente notas de release usando o nome e a descrição fornecidos.- Opções: `true`, `false`+</Accordion><Accordion title="github/update_release">@@ -143,6 +149,7 @@ uv add crewai-tools- `discussion_category_name` (string, opcional): Nome da Categoria de Discussão - Se especificado, uma discussão da categoria indicada é criada e vinculada ao release. O valor deve ser uma categoria já existente no repositório.- `generate_release_notes` (string, opcional): Notas de Release - Especifique se o release criado deve criar automaticamente notas de release usando o nome e a descrição fornecidos.- Opções: `true`, `false`+</Accordion><Accordion title="github/get_release_by_id">@@ -152,6 +159,7 @@ uv add crewai-tools- `owner` (string, obrigatório): Proprietário - Especifique o nome do proprietário da conta do repositório associado a este Release. (exemplo: "abc").- `repo` (string, obrigatório): Repositório - Especifique o nome do repositório associado a este Release.- `id` (string, obrigatório): ID do Release - Especifique o ID do release a ser recuperado.+</Accordion><Accordion title="github/get_release_by_tag_name">@@ -161,6 +169,7 @@ uv add crewai-tools- `owner` (string, obrigatório): Proprietário - Especifique o nome do proprietário da conta do repositório associado a este Release. (exemplo: "abc").- `repo` (string, obrigatório): Repositório - Especifique o nome do repositório associado a este Release.- `tag_name` (string, obrigatório): Nome - Especifique o nome da tag do release a ser recuperado. (exemplo: "v1.0.0").+</Accordion><Accordion title="github/delete_release">@@ -170,6 +179,7 @@ uv add crewai-tools- `owner` (string, obrigatório): Proprietário - Especifique o nome do proprietário da conta do repositório associado a este Release. (exemplo: "abc").- `repo` (string, obrigatório): Repositório - Especifique o nome do repositório associado a este Release.- `id` (string, obrigatório): ID do Release - Especifique o ID do release a ser excluído.+</Accordion></AccordionGroup>@@ -297,5 +307,6 @@ crew.kickoff()### Obtendo Ajuda<Card title="Precisa de Ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para auxílio na configuração ou solução de problemas com a integração do GitHub.+ Entre em contato com nossa equipe de suporte para auxílio na configuração ou+ solução de problemas com a integração do GitHub.</Card>diff --git a/docs/pt-BR/enterprise/integrations/gmail.mdx b/docs/pt-BR/enterprise/integrations/gmail.mdxindex 36ef12180..6e13e8967 100644--- a/docs/pt-BR/enterprise/integrations/gmail.mdx+++ b/docs/pt-BR/enterprise/integrations/gmail.mdx@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem e-mails, contatos e rascunhos através do GmaAntes de usar a integração com o Gmail, 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 do Gmail com as permissões adequadas- Conectou sua conta do Gmail através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Antes de usar a integração com o Gmail, certifique-se de que você possui:### 1. Conecte sua Conta do Gmail-1. Navegue até [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)+1. Navegue até [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)2. Encontre **Gmail** na seção de Integrações de Autenticação3. Clique em **Conectar** e conclua o fluxo OAuth4. Conceda as permissões necessárias para o gerenciamento de e-mail e contato@@ -36,7 +36,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@@ -73,6 +74,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token"reply-to": "Nome do Remetente <[email protected]>"}```+</Accordion><Accordion title="gmail/get_email_by_id">@@ -81,6 +83,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `userId` (string, obrigatório): ID do Usuário - Especifique o endereço de e-mail do usuário. (exemplo: "[email protected]").- `messageId` (string, obrigatório): ID da Mensagem - Especifique o ID da mensagem a ser recuperada.+</Accordion><Accordion title="gmail/fetch_emails">@@ -112,6 +115,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token"pageCursor": "page_cursor_string"}```+</Accordion><Accordion title="gmail/delete_email">@@ -120,6 +124,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `userId` (string, obrigatório): ID do Usuário - Especifique o endereço de e-mail do usuário. (exemplo: "[email protected]").- `messageId` (string, obrigatório): ID da Mensagem - Especifique o ID da mensagem para enviar para a lixeira.+</Accordion><Accordion title="gmail/create_a_contact">@@ -140,6 +145,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token]}```+</Accordion><Accordion title="gmail/get_contact_by_resource_name">@@ -147,6 +153,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `resourceName` (string, obrigatório): Nome do Recurso - Especifique o nome do recurso do contato a ser buscado.+</Accordion><Accordion title="gmail/search_for_contact">@@ -154,6 +161,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `searchTerm` (string, obrigatório): Termo - Especifique um termo para buscar correspondências aproximadas ou exatas nos campos nome, apelido, endereços de e-mail, números de telefone ou organizações do contato.+</Accordion><Accordion title="gmail/delete_contact">@@ -161,6 +169,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `resourceName` (string, obrigatório): Nome do Recurso - Especifique o nome do recurso do contato a ser excluído.+</Accordion><Accordion title="gmail/create_draft">@@ -184,6 +193,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token"reply-to": "Nome do Remetente <[email protected]>"}```+</Accordion></AccordionGroup>@@ -341,5 +351,6 @@ crew.kickoff()### Precisa de Ajuda?<Card title="Precisa de Ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nosso time de suporte para obter assistência na configuração ou solução de problemas da integração Gmail.+ Entre em contato com nosso time de suporte para obter assistência na+ configuração ou solução de problemas da integração Gmail.</Card>diff --git a/docs/pt-BR/enterprise/integrations/google_calendar.mdx b/docs/pt-BR/enterprise/integrations/google_calendar.mdxindex c000b8a1b..1bc7352b4 100644--- a/docs/pt-BR/enterprise/integrations/google_calendar.mdx+++ b/docs/pt-BR/enterprise/integrations/google_calendar.mdx@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem eventos de calendário, agendas e disponibiliAntes de usar a integração com o Google Calendar, certifique-se de ter:-- 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 Calendar- Sua conta Google conectada pela [página de Integrações](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Antes de usar a integração com o Google Calendar, certifique-se de ter:### 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. Encontre **Google Calendar** na seção de Integrações de Autenticação3. Clique em **Conectar** e complete o fluxo OAuth4. Conceda as permissões necessárias para acesso ao calendário e contatos@@ -36,7 +36,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@@ -65,6 +66,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `eventDescription` (string, opcional): Descrição do evento.- `eventId` (string, opcional): ID do evento – Um ID da sua aplicação para associar a este evento. Você pode usar esse ID para sincronizar atualizações posteriores neste evento.- `includeMeetLink` (boolean, opcional): Incluir link do Google Meet? – Cria automaticamente um link para conferência Google Meet para este evento.+</Accordion><Accordion title="google_calendar/update_event">@@ -79,6 +81,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `attendees` (string, opcional): Participantes – Aceita um array de e-mails ou e-mails separados por vírgula.- `eventLocation` (string, opcional): Local do evento.- `eventDescription` (string, opcional): Descrição do evento.+</Accordion><Accordion title="google_calendar/view_events">@@ -88,6 +91,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `calendar` (string, opcional): Calendário – Use as Configurações de Workflow do Connect Portal para permitir que o usuário selecione em qual calendário o evento será adicionado. Padrão para o calendário principal do usuário se deixado em branco.- `after` (string, opcional): Após – Filtra eventos que começam após a data fornecida (Unix em milissegundos ou timestamp ISO). (exemplo: "2025-04-12T10:00:00Z ou 1712908800000").- `before` (string, opcional): Antes – Filtra eventos que terminam antes da data fornecida (Unix em milissegundos ou timestamp ISO). (exemplo: "2025-04-12T10:00:00Z ou 1712908800000").+</Accordion><Accordion title="google_calendar/get_event_by_id">@@ -96,6 +100,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `eventId` (string, obrigatório): ID do evento.- `calendar` (string, opcional): Calendário – Use as Configurações de Workflow do Connect Portal para permitir que o usuário selecione em qual calendário o evento será adicionado. Padrão para o calendário principal do usuário se deixado em branco.+</Accordion><Accordion title="google_calendar/delete_event">@@ -104,6 +109,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `eventId` (string, obrigatório): ID do evento – O ID do evento do calendário a ser excluído.- `calendar` (string, opcional): Calendário – Use as Configurações de Workflow do Connect Portal para permitir que o usuário selecione em qual calendário o evento será adicionado. Padrão para o calendário principal do usuário se deixado em branco.+</Accordion><Accordion title="google_calendar/get_contacts">@@ -116,6 +122,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token"pageCursor": "page_cursor_string"}```+</Accordion><Accordion title="google_calendar/search_contacts">@@ -123,6 +130,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `query` (string, opcional): Termo de pesquisa para buscar contatos.+</Accordion><Accordion title="google_calendar/list_directory_people">@@ -135,6 +143,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token"pageCursor": "page_cursor_string"}```+</Accordion><Accordion title="google_calendar/search_directory_people">@@ -148,6 +157,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token"pageCursor": "page_cursor_string"}```+</Accordion><Accordion title="google_calendar/list_other_contacts">@@ -160,6 +170,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token"pageCursor": "page_cursor_string"}```+</Accordion><Accordion title="google_calendar/search_other_contacts">@@ -167,6 +178,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `query` (string, opcional): Termo de pesquisa para buscar contatos.+</Accordion><Accordion title="google_calendar/get_availability">@@ -187,6 +199,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token}]```+</Accordion></AccordionGroup>@@ -354,27 +367,32 @@ crew.kickoff()### Problemas Comuns**Erros de Autenticação**+- Certifique-se de que sua conta Google possui as permissões necessárias para acessar o calendário- Verifique se a conexão OAuth inclui todos os escopos necessários para a API do Google Calendar- Confirme se as configurações de compartilhamento do calendário permitem o nível de acesso necessário**Problemas na Criação de Eventos**+- Verifique se os formatos de horário estão corretos (ISO8601 ou timestamps Unix)- Assegure-se de que os endereços de e-mail dos participantes estão corretamente formatados- Verifique se o calendário de destino existe e está acessível- Confirme se os fusos horários estão especificados corretamente**Disponibilidade e Conflitos de Horário**+- Use formato ISO adequado para os intervalos de horário ao verificar disponibilidade- Certifique-se de que os fusos horários estão consistentes em todas as operações- Verifique se os IDs dos calendários estão corretos ao consultar múltiplos calendários**Pesquisa de Contatos e Pessoas**+- Assegure-se de que os termos de pesquisa estão devidamente formatados- Verifique se as permissões para acesso ao diretório foram concedidas- Certifique-se de que as informações de contato estão atualizadas e acessíveis**Atualização e Exclusão de Eventos**+- Verifique se os IDs dos eventos estão corretos e se os eventos existem- Assegure-se de que você possui permissões de edição para os eventos- Verifique se a propriedade do calendário permite modificações@@ -382,5 +400,6 @@ crew.kickoff()### Obtendo Ajuda<Card title="Precisa de ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nosso time de suporte para assistência na configuração da integração com o Google Calendar ou solução de problemas.+ Entre em contato com nosso time de suporte para assistência na configuração da+ integração com o Google Calendar ou solução de problemas.</Card>diff --git a/docs/pt-BR/enterprise/integrations/google_contacts.mdx b/docs/pt-BR/enterprise/integrations/google_contacts.mdxindex fc80ccf11..31f1803f9 100644--- a/docs/pt-BR/enterprise/integrations/google_contacts.mdx+++ b/docs/pt-BR/enterprise/integrations/google_contacts.mdx@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem informações de contatos e diretório atravAntes de usar a integração Google Contacts, certifique-se de ter:-- 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 Contacts- Conectado sua conta Google através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Antes de usar a integração Google Contacts, certifique-se de ter:### 1. Conecte sua Conta Google-1. Navegue para [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)+1. Navegue para [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)2. Encontre **Google Contacts** na seção de Integrações de Autenticação3. Clique em **Conectar** e complete o fluxo OAuth4. Conceda as permissões necessárias para acesso a contatos e diretório@@ -36,7 +36,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@@ -61,6 +62,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `personFields` (string, opcional): Campos a incluir (ex: 'names,emailAddresses,phoneNumbers'). Padrão: names,emailAddresses,phoneNumbers- `requestSyncToken` (boolean, opcional): Se a resposta deve incluir um token de sincronização. Padrão: false- `sortOrder` (string, opcional): A ordem na qual as conexões devem ser classificadas. Opções: LAST_MODIFIED_ASCENDING, LAST_MODIFIED_DESCENDING, FIRST_NAME_ASCENDING, LAST_NAME_ASCENDING+</Accordion><Accordion title="google_contacts/search_contacts">@@ -72,6 +74,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `pageSize` (integer, opcional): Número de resultados a retornar. Mínimo: 1, Máximo: 30- `pageToken` (string, opcional): Token especificando qual página de resultado retornar.- `sources` (array, opcional): As fontes para pesquisar. Opções: READ_SOURCE_TYPE_CONTACT, READ_SOURCE_TYPE_PROFILE. Padrão: READ_SOURCE_TYPE_CONTACT+</Accordion><Accordion title="google_contacts/list_directory_people">@@ -84,6 +87,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `readMask` (string, opcional): Campos a ler (ex: 'names,emailAddresses')- `requestSyncToken` (boolean, opcional): Se a resposta deve incluir um token de sincronização. Padrão: false- `mergeSources` (array, opcional): Dados adicionais para mesclar nas respostas de pessoas do diretório. Opções: CONTACT+</Accordion><Accordion title="google_contacts/search_directory_people">@@ -94,6 +98,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `sources` (string, obrigatório): Fontes de diretório (use 'DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE')- `pageSize` (integer, opcional): Número de resultados a retornar- `readMask` (string, opcional): Campos a ler+</Accordion><Accordion title="google_contacts/list_other_contacts">@@ -104,6 +109,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `pageToken` (string, opcional): Token especificando qual página de resultado retornar.- `readMask` (string, opcional): Campos a ler- `requestSyncToken` (boolean, opcional): Se a resposta deve incluir um token de sincronização. Padrão: false+</Accordion><Accordion title="google_contacts/search_other_contacts">@@ -113,6 +119,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `query` (string, obrigatório): Consulta de pesquisa- `readMask` (string, obrigatório): Campos a ler (ex: 'names,emailAddresses')- `pageSize` (integer, opcional): Número de resultados+</Accordion><Accordion title="google_contacts/get_person">@@ -121,6 +128,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `resourceName` (string, obrigatório): O nome do recurso da pessoa a obter (ex: 'people/c123456789')- `personFields` (string, opcional): Campos a incluir (ex: 'names,emailAddresses,phoneNumbers'). Padrão: names,emailAddresses,phoneNumbers+</Accordion><Accordion title="google_contacts/create_contact">@@ -132,6 +140,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `phoneNumbers` (array, opcional): Números de telefone. Cada item é um objeto com `value` (string, número de telefone) e `type` (string, 'home', 'work', 'mobile', 'other', padrão 'other').- `addresses` (array, opcional): Endereços postais. Cada item é um objeto com `formattedValue` (string, endereço formatado) e `type` (string, 'home', 'work', 'other', padrão 'other').- `organizations` (array, opcional): Organizações/empresas. Cada item é um objeto com `name` (string, nome da organização), `title` (string, cargo) e `type` (string, 'work', 'other', padrão 'work').+</Accordion><Accordion title="google_contacts/update_contact">@@ -143,6 +152,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `names` (array, opcional): Nomes da pessoa. Cada item é um objeto com `givenName` (string), `familyName` (string), `displayName` (string).- `emailAddresses` (array, opcional): Endereços de email. Cada item é um objeto com `value` (string, endereço de email) e `type` (string, 'home', 'work', 'other').- `phoneNumbers` (array, opcional): Números de telefone. Cada item é um objeto com `value` (string, número de telefone) e `type` (string, 'home', 'work', 'mobile', 'other').+</Accordion><Accordion title="google_contacts/delete_contact">@@ -150,6 +160,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `resourceName` (string, obrigatório): O nome do recurso da pessoa a excluir (ex: 'people/c123456789').+</Accordion><Accordion title="google_contacts/batch_get_people">@@ -158,6 +169,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `resourceNames` (array, obrigatório): Nomes de recursos das pessoas a obter (máx 200 itens).- `personFields` (string, opcional): Campos a incluir (ex: 'names,emailAddresses,phoneNumbers'). Padrão: names,emailAddresses,phoneNumbers+</Accordion><Accordion title="google_contacts/list_contact_groups">@@ -167,6 +179,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `pageSize` (integer, opcional): Número de grupos de contatos a retornar. Mínimo: 1, Máximo: 1000- `pageToken` (string, opcional): Token especificando qual página de resultado retornar.- `groupFields` (string, opcional): Campos a incluir (ex: 'name,memberCount,clientData'). Padrão: name,memberCount+</Accordion><Accordion title="google_contacts/get_contact_group">@@ -176,6 +189,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `resourceName` (string, obrigatório): O nome do recurso do grupo de contatos (ex: 'contactGroups/myContactGroup').- `maxMembers` (integer, opcional): Número máximo de membros a incluir. Mínimo: 0, Máximo: 20000- `groupFields` (string, opcional): Campos a incluir (ex: 'name,memberCount,clientData'). Padrão: name,memberCount+</Accordion><Accordion title="google_contacts/create_contact_group">@@ -184,6 +198,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `name` (string, obrigatório): O nome do grupo de contatos.- `clientData` (array, opcional): Dados específicos do cliente. Cada item é um objeto com `key` (string) e `value` (string).+</Accordion></AccordionGroup>@@ -279,24 +294,29 @@ crew.kickoff()### Problemas Comuns**Erros de Autenticação**+- Certifique-se de que sua conta Google tenha as permissões necessárias para acesso a contatos e diretório.- Verifique se a conexão OAuth inclui todos os escopos necessários para a API Google People.**Problemas de Criação/Atualização de Contatos**+- Certifique-se de que campos obrigatórios como `email` sejam fornecidos para criação de contatos.- Verifique se o `resourceName` está correto ao atualizar ou excluir contatos.- Confirme se o formato dos dados para `names`, `emailAddresses`, `phoneNumbers`, etc., corresponde às especificações da API.**Problemas de Pesquisa e Filtro**+- Certifique-se de que os parâmetros de `query` e `readMask` estejam especificados corretamente para `search_contacts` e `search_other_contacts`.- Para pesquisas de diretório, certifique-se de que `sources` esteja definido corretamente (ex: 'DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE').**Gerenciamento de Grupos de Contatos**+- Ao criar um grupo de contatos, certifique-se de que o `name` seja fornecido.- Para `get_contact_group`, certifique-se de que o `resourceName` esteja correto.### Obtendo Ajuda<Card title="Precisa de Ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para assistência com configuração ou solução de problemas da integração Google Contacts.+ Entre em contato com nossa equipe de suporte para assistência com configuração+ ou solução de problemas da integração Google Contacts.</Card>diff --git a/docs/pt-BR/enterprise/integrations/google_docs.mdx b/docs/pt-BR/enterprise/integrations/google_docs.mdxindex 308265ad7..f30fbf64e 100644--- a/docs/pt-BR/enterprise/integrations/google_docs.mdx+++ b/docs/pt-BR/enterprise/integrations/google_docs.mdx@@ -13,7 +13,7 @@ Permita que seus agentes criem, editem e gerenciem documentos do Google Docs comAntes de usar a integração Google Docs, certifique-se de ter:-- 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 Docs- Conectado sua conta Google através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Antes de usar a integração Google Docs, certifique-se de ter:### 1. Conecte sua Conta Google-1. Navegue para [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)+1. Navegue para [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)2. Encontre **Google Docs** na seção de Integrações de Autenticação3. Clique em **Conectar** e complete o fluxo OAuth4. Conceda as permissões necessárias para acesso a documentos@@ -36,7 +36,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@@ -57,6 +58,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `title` (string, opcional): O título para o novo documento.+</Accordion><Accordion title="google_docs/get_document">@@ -66,6 +68,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `documentId` (string, obrigatório): O ID do documento a recuperar.- `includeTabsContent` (boolean, opcional): Se deve incluir conteúdo de abas. Padrão: false- `suggestionsViewMode` (string, opcional): O modo de visualização de sugestões a aplicar ao documento. Opções: DEFAULT_FOR_CURRENT_ACCESS, PREVIEW_SUGGESTIONS_ACCEPTED, PREVIEW_WITHOUT_SUGGESTIONS. Padrão: DEFAULT_FOR_CURRENT_ACCESS+</Accordion><Accordion title="google_docs/batch_update">@@ -75,6 +78,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `documentId` (string, obrigatório): O ID do documento a atualizar.- `requests` (array, obrigatório): Uma lista de atualizações a aplicar ao documento. Cada item é um objeto representando uma solicitação.- `writeControl` (object, opcional): Fornece controle sobre como as solicitações de escrita são executadas. Contém `requiredRevisionId` (string) e `targetRevisionId` (string).+</Accordion><Accordion title="google_docs/insert_text">@@ -84,6 +88,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `documentId` (string, obrigatório): O ID do documento a atualizar.- `text` (string, obrigatório): O texto a inserir.- `index` (integer, opcional): O índice baseado em zero onde inserir o texto. Padrão: 1+</Accordion><Accordion title="google_docs/replace_text">@@ -94,6 +99,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `containsText` (string, obrigatório): O texto a encontrar e substituir.- `replaceText` (string, obrigatório): O texto para substituir.- `matchCase` (boolean, opcional): Se a pesquisa deve respeitar maiúsculas e minúsculas. Padrão: false+</Accordion><Accordion title="google_docs/delete_content_range">@@ -103,6 +109,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `documentId` (string, obrigatório): O ID do documento a atualizar.- `startIndex` (integer, obrigatório): O índice inicial do intervalo a excluir.- `endIndex` (integer, obrigatório): O índice final do intervalo a excluir.+</Accordion><Accordion title="google_docs/insert_page_break">@@ -111,6 +118,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `documentId` (string, obrigatório): O ID do documento a atualizar.- `index` (integer, opcional): O índice baseado em zero onde inserir a quebra de página. Padrão: 1+</Accordion><Accordion title="google_docs/create_named_range">@@ -121,6 +129,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `name` (string, obrigatório): O nome para o intervalo nomeado.- `startIndex` (integer, obrigatório): O índice inicial do intervalo.- `endIndex` (integer, obrigatório): O índice final do intervalo.+</Accordion></AccordionGroup>@@ -216,29 +225,35 @@ crew.kickoff()### Problemas Comuns**Erros de Autenticação**+- Certifique-se de que sua conta Google tenha as permissões necessárias para acesso ao Google Docs.- Verifique se a conexão OAuth inclui todos os escopos necessários (`https://www.googleapis.com/auth/documents`).**Problemas de ID do Documento**+- Verifique novamente os IDs dos documentos para correção.- Certifique-se de que o documento existe e está acessível à sua conta.- IDs de documentos podem ser encontrados na URL do Google Docs.**Inserção de Texto e Operações de Intervalo**+- Ao usar `insert_text` ou `delete_content_range`, certifique-se de que as posições de índice sejam válidas.- Lembre-se de que o Google Docs usa indexação baseada em zero.- O documento deve ter conteúdo nas posições de índice especificadas.**Formatação de Solicitação de Atualização em Lote**+- Ao usar `batch_update`, certifique-se de que o array `requests` esteja formatado corretamente de acordo com a documentação da API do Google Docs.- Atualizações complexas requerem estruturas JSON específicas para cada tipo de solicitação.**Operações de Substituição de Texto**+- Para `replace_text`, certifique-se de que o parâmetro `containsText` corresponda exatamente ao texto que você deseja substituir.- Use o parâmetro `matchCase` para controlar a sensibilidade a maiúsculas e minúsculas.### Obtendo Ajuda<Card title="Precisa de Ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para assistência com configuração ou solução de problemas da integração Google Docs.+ Entre em contato com nossa equipe de suporte para assistência com configuração+ ou solução de problemas da integração Google Docs.</Card>diff --git a/docs/pt-BR/enterprise/integrations/google_drive.mdx b/docs/pt-BR/enterprise/integrations/google_drive.mdxindex c1a499388..c47d6abc3 100644--- a/docs/pt-BR/enterprise/integrations/google_drive.mdx+++ b/docs/pt-BR/enterprise/integrations/google_drive.mdx@@ -13,7 +13,7 @@ Permita que seus agentes acessem e gerenciem arquivos e pastas no Google Drive.Antes de usar a integração Google Drive, certifique-se de ter:-- 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 Drive- Conectado sua conta Google através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Antes de usar a integração Google Drive, certifique-se de ter:### 1. Conecte sua Conta Google-1. Navegue para [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)+1. Navegue para [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)2. Encontre **Google Drive** na seção de Integrações de Autenticação3. Clique em **Conectar** e complete o fluxo OAuth4. Conceda as permissões necessárias para acesso a arquivos@@ -36,7 +36,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@@ -58,10 +59,12 @@ Para informações detalhadas sobre parâmetros e uso, consulte a [documentaçã### Problemas Comuns**Erros de Autenticação**+- Certifique-se de que sua conta Google tenha as permissões necessárias para acesso ao Google Drive.### Obtendo Ajuda<Card title="Precisa de Ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para assistência com configuração ou solução de problemas da integração Google Drive.+ Entre em contato com nossa equipe de suporte para assistência com configuração+ ou solução de problemas da integração Google Drive.</Card>diff --git a/docs/pt-BR/enterprise/integrations/google_sheets.mdx b/docs/pt-BR/enterprise/integrations/google_sheets.mdxindex c438fd641..aa3809a60 100644--- a/docs/pt-BR/enterprise/integrations/google_sheets.mdx+++ b/docs/pt-BR/enterprise/integrations/google_sheets.mdx@@ -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ção3. Clique em **Conectar** e conclua o fluxo OAuth4. 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:[email protected]">- 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>diff --git a/docs/pt-BR/enterprise/integrations/google_slides.mdx b/docs/pt-BR/enterprise/integrations/google_slides.mdxindex 66682dde9..d6d781f87 100644--- a/docs/pt-BR/enterprise/integrations/google_slides.mdx+++ b/docs/pt-BR/enterprise/integrations/google_slides.mdx@@ -13,7 +13,7 @@ Permita que seus agentes criem, editem e gerenciem apresentações do Google SliAntes de usar a integração Google Slides, certifique-se de ter:-- 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 Slides- Conectado sua conta Google através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Antes de usar a integração Google Slides, certifique-se de ter:### 1. Conecte sua Conta Google-1. Navegue para [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)+1. Navegue para [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)2. Encontre **Google Slides** na seção de Integrações de Autenticação3. Clique em **Conectar** e complete o fluxo OAuth4. Conceda as permissões necessárias para acesso a apresentações, planilhas e drive@@ -36,7 +36,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@@ -57,6 +58,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `title` (string, obrigatório): O título da apresentação.+</Accordion><Accordion title="google_slides/get_presentation">@@ -65,6 +67,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `presentationId` (string, obrigatório): O ID da apresentação a ser recuperada.- `fields` (string, opcional): Os campos a incluir na resposta. Use isso para melhorar o desempenho retornando apenas os dados necessários.+</Accordion><Accordion title="google_slides/batch_update_presentation">@@ -74,6 +77,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `presentationId` (string, obrigatório): O ID da apresentação a ser atualizada.- `requests` (array, obrigatório): Uma lista de atualizações a aplicar à apresentação. Cada item é um objeto representando uma solicitação.- `writeControl` (object, opcional): Fornece controle sobre como as solicitações de escrita são executadas. Contém `requiredRevisionId` (string).+</Accordion><Accordion title="google_slides/get_page">@@ -82,6 +86,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `presentationId` (string, obrigatório): O ID da apresentação.- `pageObjectId` (string, obrigatório): O ID da página a ser recuperada.+</Accordion><Accordion title="google_slides/get_thumbnail">@@ -90,6 +95,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `presentationId` (string, obrigatório): O ID da apresentação.- `pageObjectId` (string, obrigatório): O ID da página para geração de miniatura.+</Accordion><Accordion title="google_slides/import_data_from_sheet">@@ -99,6 +105,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `presentationId` (string, obrigatório): O ID da apresentação.- `sheetId` (string, obrigatório): O ID da planilha do Google para importar.- `dataRange` (string, obrigatório): O intervalo de dados a importar da planilha.+</Accordion><Accordion title="google_slides/upload_file_to_drive">@@ -107,6 +114,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `file` (string, obrigatório): Os dados do arquivo a fazer upload.- `presentationId` (string, obrigatório): O ID da apresentação para vincular o arquivo carregado.+</Accordion><Accordion title="google_slides/link_file_to_presentation">@@ -115,6 +123,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `presentationId` (string, obrigatório): O ID da apresentação.- `fileId` (string, obrigatório): O ID do arquivo a vincular.+</Accordion><Accordion title="google_slides/get_all_presentations">@@ -123,6 +132,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `pageSize` (integer, opcional): O número de apresentações a retornar por página.- `pageToken` (string, opcional): Um token para paginação.+</Accordion><Accordion title="google_slides/delete_presentation">@@ -130,6 +140,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `presentationId` (string, obrigatório): O ID da apresentação a ser excluída.+</Accordion></AccordionGroup>@@ -225,18 +236,22 @@ crew.kickoff()### Problemas Comuns**Erros de Autenticação**+- Certifique-se de que sua conta Google tenha as permissões necessárias para acesso ao Google Slides e Google Drive.- Verifique se a conexão OAuth inclui todos os escopos necessários.**Problemas de ID de Apresentação/Página**+- Verifique novamente os IDs de apresentação e IDs de objeto de página para correção.- Certifique-se de que a apresentação ou página existe e está acessível.**Formatação de Solicitação de Atualização em Lote**+- Ao usar `batch_update_presentation`, certifique-se de que o array `requests` esteja formatado corretamente de acordo com a documentação da API do Google Slides.- Atualizações complexas frequentemente requerem estruturas JSON específicas para cada tipo de solicitação (ex: `createText`, `insertShape`).**Problemas de Upload/Vinculação de Arquivos**+- Certifique-se de que o conteúdo do `file` esteja fornecido corretamente para `upload_file_to_drive`.- Verifique se o `fileId` está correto ao vincular arquivos a uma apresentação.- Verifique as permissões do Google Drive para acesso a arquivos.@@ -244,5 +259,6 @@ crew.kickoff()### Obtendo Ajuda<Card title="Precisa de Ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para assistência com configuração ou solução de problemas da integração Google Slides.+ Entre em contato com nossa equipe de suporte para assistência com configuração+ ou solução de problemas da integração Google Slides.</Card>diff --git a/docs/pt-BR/enterprise/integrations/hubspot.mdx b/docs/pt-BR/enterprise/integrations/hubspot.mdxindex 643c5451c..16999abdd 100644--- a/docs/pt-BR/enterprise/integrations/hubspot.mdx+++ b/docs/pt-BR/enterprise/integrations/hubspot.mdx@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem empresas e contatos dentro do HubSpot. Crie nAntes de utilizar a integração com o HubSpot, 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 HubSpot com permissões adequadas.- Sua conta HubSpot conectada pela [página de Integrações](https://app.crewai.com/crewai_plus/connectors).@@ -21,7 +21,7 @@ Antes de utilizar a integração com o HubSpot, certifique-se de que você possu### 1. Conecte Sua Conta HubSpot-1. Navegue até [CrewAI AOP Integrações](https://app.crewai.com/crewai_plus/connectors).+1. Navegue até [CrewAI AMP Integrações](https://app.crewai.com/crewai_plus/connectors).2. Encontre **HubSpot** na seção de Integrações de Autenticação.3. Clique em **Conectar** e complete o fluxo OAuth.4. Conceda as permissões necessárias para gerenciamento de empresas e contatos.@@ -36,7 +36,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@@ -115,6 +116,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `web_technologies` (string, opcional): Tecnologias web utilizadas. Deve ser um dos valores predefinidos.- `website` (string, opcional): URL do site.- `founded_year` (string, opcional): Ano de fundação.+</Accordion><Accordion title="hubspot/create_contact">@@ -214,6 +216,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `hs_whatsapp_phone_number` (string, opcional): Número do WhatsApp.- `work_email` (string, opcional): E-mail corporativo.- `hs_googleplusid` (string, opcional): googleplus ID.+</Accordion><Accordion title="hubspot/create_deal">@@ -229,6 +232,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `dealtype` (string, opcional): Tipo do negócio. Valores disponíveis: `newbusiness`, `existingbusiness`.- `description` (string, opcional): Descrição do negócio.- `hs_priority` (string, opcional): Prioridade do negócio. Valores disponíveis: `low`, `medium`, `high`.+</Accordion><Accordion title="hubspot/create_record_engagements">@@ -246,6 +250,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `hs_meeting_body` (string, opcional): Descrição da reunião. (Utilizado para `MEETING`)- `hs_meeting_start_time` (string, opcional): Horário de início da reunião. (Utilizado para `MEETING`)- `hs_meeting_end_time` (string, opcional): Horário de término da reunião. (Utilizado para `MEETING`)+</Accordion><Accordion title="hubspot/update_company">@@ -263,6 +268,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `numberofemployees` (number, opcional): Número de funcionários.- `annualrevenue` (number, opcional): Receita anual.- `description` (string, opcional): Descrição.+</Accordion><Accordion title="hubspot/create_record_any">@@ -271,6 +277,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `recordType` (string, obrigatório): ID do tipo de objeto personalizado.- Parâmetros adicionais dependem do esquema do objeto personalizado.+</Accordion><Accordion title="hubspot/update_contact">@@ -285,6 +292,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `company` (string, opcional): Nome da empresa.- `jobtitle` (string, opcional): Cargo.- `lifecyclestage` (string, opcional): Estágio no ciclo de vida.+</Accordion><Accordion title="hubspot/update_deal">@@ -298,6 +306,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `pipeline` (string, opcional): Pipeline ao qual o negócio pertence.- `closedate` (string, opcional): Data prevista de fechamento.- `dealtype` (string, opcional): Tipo de negócio.+</Accordion><Accordion title="hubspot/update_record_engagements">@@ -309,6 +318,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `hs_task_subject` (string, opcional): Título da tarefa.- `hs_task_body` (string, opcional): Notas da tarefa.- `hs_task_status` (string, opcional): Status da tarefa.+</Accordion><Accordion title="hubspot/update_record_any">@@ -318,6 +328,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `recordId` (string, obrigatório): ID do registro a ser atualizado.- `recordType` (string, obrigatório): ID do tipo de objeto personalizado.- Parâmetros adicionais dependem do esquema do objeto personalizado.+</Accordion><Accordion title="hubspot/list_companies">@@ -325,6 +336,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `paginationParameters` (object, opcional): Use `pageCursor` para buscar páginas subsequentes.+</Accordion><Accordion title="hubspot/list_contacts">@@ -332,6 +344,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `paginationParameters` (object, opcional): Use `pageCursor` para buscar páginas subsequentes.+</Accordion><Accordion title="hubspot/list_deals">@@ -339,6 +352,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `paginationParameters` (object, opcional): Use `pageCursor` para buscar páginas subsequentes.+</Accordion><Accordion title="hubspot/get_records_engagements">@@ -347,6 +361,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `objectName` (string, obrigatório): O tipo de engajamento a ser buscado (ex.: "notes").- `paginationParameters` (object, opcional): Use `pageCursor` para buscar páginas subsequentes.+</Accordion><Accordion title="hubspot/get_records_any">@@ -355,6 +370,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `recordType` (string, obrigatório): O ID do tipo de objeto personalizado.- `paginationParameters` (object, opcional): Use `pageCursor` para buscar páginas subsequentes.+</Accordion><Accordion title="hubspot/get_company">@@ -362,6 +378,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `recordId` (string, obrigatório): ID da empresa a ser consultada.+</Accordion><Accordion title="hubspot/get_contact">@@ -369,6 +386,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `recordId` (string, obrigatório): ID do contato a ser consultado.+</Accordion><Accordion title="hubspot/get_deal">@@ -376,6 +394,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `recordId` (string, obrigatório): ID do negócio a ser consultado.+</Accordion><Accordion title="hubspot/get_record_by_id_engagements">@@ -383,6 +402,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `recordId` (string, obrigatório): ID do engajamento a ser consultado.+</Accordion><Accordion title="hubspot/get_record_by_id_any">@@ -391,6 +411,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `recordType` (string, obrigatório): ID do tipo de objeto personalizado.- `recordId` (string, obrigatório): ID do registro a ser consultado.+</Accordion><Accordion title="hubspot/search_companies">@@ -399,6 +420,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `filterFormula` (object, opcional): Filtro em forma normal disjuntiva (OU de E).- `paginationParameters` (object, opcional): Use `pageCursor` para buscar páginas subsequentes.+</Accordion><Accordion title="hubspot/search_contacts">@@ -407,6 +429,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `filterFormula` (object, opcional): Filtro em forma normal disjuntiva (OU de E).- `paginationParameters` (object, opcional): Use `pageCursor` para buscar páginas subsequentes.+</Accordion><Accordion title="hubspot/search_deals">@@ -415,6 +438,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `filterFormula` (object, opcional): Filtro em forma normal disjuntiva (OU de E).- `paginationParameters` (object, opcional): Use `pageCursor` para buscar páginas subsequentes.+</Accordion><Accordion title="hubspot/search_records_engagements">@@ -423,6 +447,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `engagementFilterFormula` (object, opcional): Filtro para engajamentos.- `paginationParameters` (object, opcional): Use `pageCursor` para buscar páginas subsequentes.+</Accordion><Accordion title="hubspot/search_records_any">@@ -432,6 +457,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `recordType` (string, obrigatório): O ID do tipo de objeto para pesquisa.- `filterFormula` (string, opcional): Fórmula de filtro a aplicar.- `paginationParameters` (object, opcional): Use `pageCursor` para buscar páginas subsequentes.+</Accordion><Accordion title="hubspot/delete_record_companies">@@ -439,6 +465,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `recordId` (string, obrigatório): ID da empresa a ser excluída.+</Accordion><Accordion title="hubspot/delete_record_contacts">@@ -446,6 +473,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `recordId` (string, obrigatório): ID do contato a ser excluído.+</Accordion><Accordion title="hubspot/delete_record_deals">@@ -453,6 +481,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `recordId` (string, obrigatório): ID do negócio a ser excluído.+</Accordion><Accordion title="hubspot/delete_record_engagements">@@ -460,6 +489,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `recordId` (string, obrigatório): ID do engajamento a ser excluído.+</Accordion><Accordion title="hubspot/delete_record_any">@@ -468,6 +498,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `recordType` (string, obrigatório): ID do tipo de objeto personalizado.- `recordId` (string, obrigatório): ID do registro a ser excluído.+</Accordion><Accordion title="hubspot/get_contacts_by_list_id">@@ -476,6 +507,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `listId` (string, obrigatório): ID da lista da qual obter os contatos.- `paginationParameters` (object, opcional): Use `pageCursor` para páginas subsequentes.+</Accordion><Accordion title="hubspot/describe_action_schema">@@ -484,6 +516,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `recordType` (string, obrigatório): ID do tipo de objeto (ex.: 'companies').- `operation` (string, obrigatório): Tipo de operação (ex.: 'CREATE_RECORD').+</Accordion></AccordionGroup>@@ -580,5 +613,6 @@ crew.kickoff()### Precisa de Ajuda?<Card title="Precisa de Ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para assistência na configuração ou solução de problemas com a integração HubSpot.+ Entre em contato com nossa equipe de suporte para assistência na configuração+ ou solução de problemas com a integração HubSpot.</Card>diff --git a/docs/pt-BR/enterprise/integrations/jira.mdx b/docs/pt-BR/enterprise/integrations/jira.mdxindex 18ed5f4db..7a5f7b856 100644--- a/docs/pt-BR/enterprise/integrations/jira.mdx+++ b/docs/pt-BR/enterprise/integrations/jira.mdx@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem problemas, projetos e fluxos de trabalho peloAntes de usar a integração com o Jira, certifique-se de ter:-- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa+- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa- Uma conta Jira com permissões adequadas para o projeto- Sua conta Jira conectada pela [Página de Integrações](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Antes de usar a integração com o Jira, certifique-se de ter:### 1. Conectar Sua Conta Jira-1. Acesse [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)+1. Acesse [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)2. Encontre **Jira** na seção de Integrações de Autenticação3. Clique em **Conectar** e complete o fluxo do OAuth4. Conceda as permissões necessárias para gestão de issues e projetos@@ -54,6 +54,7 @@ uv add crewai-tools"customfield_10001": "value"}```+</Accordion><Accordion title="jira/update_issue">@@ -69,6 +70,7 @@ uv add crewai-tools- Opções: `description`, `descriptionJSON`- `description` (string, opcional): Descrição - Descrição detalhada da issue. Este campo aparece apenas se 'descriptionType' = 'description'.- `additionalFields` (string, opcional): Campos Adicionais - Especifique outros campos em formato JSON.+</Accordion><Accordion title="jira/get_issue_by_key">@@ -76,6 +78,7 @@ uv add crewai-tools**Parâmetros:**- `issueKey` (string, obrigatório): Chave da Issue (exemplo: "TEST-1234").+</Accordion><Accordion title="jira/filter_issues">@@ -102,6 +105,7 @@ uv add crewai-tools```Operadores disponíveis: `$stringExactlyMatches`, `$stringDoesNotExactlyMatch`, `$stringIsIn`, `$stringIsNotIn`, `$stringContains`, `$stringDoesNotContain`, `$stringGreaterThan`, `$stringLessThan`- `limit` (string, opcional): Limitar resultados - Limite máximo de issues retornados. Padrão para 10 se estiver em branco.+</Accordion><Accordion title="jira/search_by_jql">@@ -115,12 +119,14 @@ uv add crewai-tools"pageCursor": "cursor_string"}```+</Accordion><Accordion title="jira/update_issue_any">**Descrição:** Atualiza qualquer issue no Jira. Use DESCRIBE_ACTION_SCHEMA para obter o schema de propriedades dessa função.**Parâmetros:** Nenhum parâmetro específico - use JIRA_DESCRIBE_ACTION_SCHEMA primeiro para obter o schema esperado.+</Accordion><Accordion title="jira/describe_action_schema">@@ -130,6 +136,7 @@ uv add crewai-tools- `issueTypeId` (string, obrigatório): ID do Tipo de Issue.- `projectKey` (string, obrigatório): Chave do projeto.- `operation` (string, obrigatório): Tipo de Operação, por exemplo CREATE_ISSUE ou UPDATE_ISSUE.+</Accordion><Accordion title="jira/get_projects">@@ -142,6 +149,7 @@ uv add crewai-tools"pageCursor": "cursor_string"}```+</Accordion><Accordion title="jira/get_issue_types_by_project">@@ -149,12 +157,14 @@ uv add crewai-tools**Parâmetros:**- `project` (string, obrigatório): Chave do projeto.+</Accordion><Accordion title="jira/get_issue_types">**Descrição:** Obtém todos os tipos de issues no Jira.**Parâmetros:** Nenhum obrigatório.+</Accordion><Accordion title="jira/get_issue_status_by_project">@@ -162,6 +172,7 @@ uv add crewai-tools**Parâmetros:**- `project` (string, obrigatório): Chave do projeto.+</Accordion><Accordion title="jira/get_all_assignees_by_project">@@ -169,6 +180,7 @@ uv add crewai-tools**Parâmetros:**- `project` (string, obrigatório): Chave do projeto.+</Accordion></AccordionGroup>@@ -337,31 +349,37 @@ crew.kickoff()### Problemas Comuns**Erros de Permissão**+- Certifique-se de que sua conta Jira tem as permissões necessárias nos projetos alvo- Verifique se a conexão OAuth inclui os escopos necessários da API Jira- Confira se você possui permissões de criar/editar issues nos projetos especificados**Chaves de Projeto ou Issue Inválidas**+- Confira o formato das chaves dos projetos e issues (ex: "PROJ-123")- Verifique se os projetos existem e são acessíveis pela sua conta- Certifique-se de que chaves de issues referenciam issues existentes**Problemas de Tipo ou Status de Issue**+- Use JIRA_GET_ISSUE_TYPES_BY_PROJECT para obter tipos válidos de issue para um projeto- Use JIRA_GET_ISSUE_STATUS_BY_PROJECT para obter status válidos- Certifique-se de que tipos e status de issue estão disponíveis no projeto alvo**Problemas com Queries JQL**+- Teste as queries JQL na busca de issues do Jira antes de utilizar em chamadas de API- Certifique-se de que os nomes dos campos em JQL estejam corretos e existam em sua instância do Jira- Use a sintaxe correta de JQL para queries complexas**Problemas com Campos Customizados e Schemas**+- Use JIRA_DESCRIBE_ACTION_SCHEMA para obter o schema correto para tipos de issues complexas- Certifique-se de que os IDs dos campos customizados estão corretos (ex: "customfield_10001")- Verifique se esses campos estão disponíveis no projeto e tipo de issue alvo**Problemas de Fórmulas de Filtro**+- Garanta que as fórmulas de filtro sigam a estrutura JSON correta para forma normal disjuntiva- Use apenas campos válidos conforme configuração do seu Jira- Teste filtros simples antes de construir queries complexas com múltiplas condições@@ -369,5 +387,6 @@ crew.kickoff()### Obtenha Ajuda<Card title="Precisa de Ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nosso time de suporte para obter assistência na configuração ou solução de problemas da integração Jira.+ Entre em contato com nosso time de suporte para obter assistência na+ configuração ou solução de problemas da integração Jira.</Card>diff --git a/docs/pt-BR/enterprise/integrations/linear.mdx b/docs/pt-BR/enterprise/integrations/linear.mdxindex c33f36d87..5a6f63b3f 100644--- a/docs/pt-BR/enterprise/integrations/linear.mdx+++ b/docs/pt-BR/enterprise/integrations/linear.mdx@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem issues, projetos e fluxos de trabalho de deseAntes de utilizar a integração com o Linear, certifique-se de que você possui:-- Uma conta [CrewAI AOP](https://app.crewai.com) com uma assinatura ativa+- Uma conta [CrewAI AMP](https://app.crewai.com) com uma assinatura ativa- Uma conta Linear com permissões apropriadas no workspace- Conectou sua conta Linear através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Antes de utilizar a integração com o Linear, certifique-se de que você possui### 1. Conecte sua Conta Linear-1. Navegue até [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)+1. Navegue até [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)2. Encontre **Linear** na seção Integrações de Autenticação3. Clique em **Conectar** e complete o fluxo OAuth4. Conceda as permissões necessárias para gerenciamento de issues e projetos@@ -36,7 +36,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@@ -70,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token"labelIds": ["a70bdf0f-530a-4887-857d-46151b52b47c"]}```+</Accordion><Accordion title="linear/update_issue">@@ -90,6 +92,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token"labelIds": ["a70bdf0f-530a-4887-857d-46151b52b47c"]}```+</Accordion><Accordion title="linear/get_issue_by_id">@@ -97,6 +100,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `issueId` (string, obrigatório): ID da Issue - Especifique o ID do registro da issue a ser buscada. (exemplo: "90fbc706-18cd-42c9-ae66-6bd344cc8977").+</Accordion><Accordion title="linear/get_issue_by_issue_identifier">@@ -104,6 +108,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `externalId` (string, obrigatório): ID Externo - Especifique o identificador legível da issue a ser buscada. (exemplo: "ABC-1").+</Accordion><Accordion title="linear/search_issue">@@ -131,6 +136,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token```Campos disponíveis: `title`, `number`, `project`, `createdAt`Operadores disponíveis: `$stringExactlyMatches`, `$stringDoesNotExactlyMatch`, `$stringIsIn`, `$stringIsNotIn`, `$stringStartsWith`, `$stringDoesNotStartWith`, `$stringEndsWith`, `$stringDoesNotEndWith`, `$stringContains`, `$stringDoesNotContain`, `$stringGreaterThan`, `$stringLessThan`, `$numberGreaterThanOrEqualTo`, `$numberLessThanOrEqualTo`, `$numberGreaterThan`, `$numberLessThan`, `$dateTimeAfter`, `$dateTimeBefore`+</Accordion><Accordion title="linear/delete_issue">@@ -138,6 +144,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `issueId` (string, obrigatório): ID da Issue - Especifique o ID do registro da issue a ser excluída. (exemplo: "90fbc706-18cd-42c9-ae66-6bd344cc8977").+</Accordion><Accordion title="linear/archive_issue">@@ -145,6 +152,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `issueId` (string, obrigatório): ID da Issue - Especifique o ID do registro da issue a ser arquivada. (exemplo: "90fbc706-18cd-42c9-ae66-6bd344cc8977").+</Accordion><Accordion title="linear/create_sub_issue">@@ -161,6 +169,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token"lead": "linear_user_id"}```+</Accordion><Accordion title="linear/create_project">@@ -183,6 +192,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token"description": ""}```+</Accordion><Accordion title="linear/update_project">@@ -199,6 +209,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token"description": ""}```+</Accordion><Accordion title="linear/get_project_by_id">@@ -206,6 +217,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `projectId` (string, obrigatório): ID do Projeto - Especifique o ID do projeto a ser buscado. (exemplo: "a6634484-6061-4ac7-9739-7dc5e52c796b").+</Accordion><Accordion title="linear/delete_project">@@ -213,6 +225,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `projectId` (string, obrigatório): ID do Projeto - Especifique o ID do projeto a ser excluído. (exemplo: "a6634484-6061-4ac7-9739-7dc5e52c796b").+</Accordion><Accordion title="linear/search_teams">@@ -238,6 +251,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token}```Campos disponíveis: `id`, `name`+</Accordion></AccordionGroup>@@ -406,37 +420,44 @@ crew.kickoff()### Problemas Comuns**Erros de Permissão**+- Certifique-se de que sua conta Linear possui as permissões necessárias no workspace de destino- Verifique se a conexão OAuth inclui os escopos requeridos pela API do Linear- Confirme se você tem permissões para criar/editar issues e projetos no workspace**IDs e Referências Inválidas**+- Verifique os IDs de equipes, IDs de issues e IDs de projetos para garantir o formato UUID correto- Assegure que as entidades referenciadas (equipes, projetos, ciclos) existem e estão acessíveis- Verifique se os identificadores de issues seguem o formato correto (ex: "ABC-1")**Problemas de Associação entre Equipe e Projeto**+- Use LINEAR_SEARCH_TEAMS para obter IDs de equipe válidos antes de criar issues ou projetos- Certifique-se de que as equipes existem e estão ativas no seu workspace- Verifique se os IDs das equipes estão devidamente formatados como UUIDs**Problemas com Status e Prioridade das Issues**+- Verifique se os IDs de status referenciam estados de workflow válidos para a equipe- Certifique-se de que os valores de prioridade estão dentro do intervalo válido para sua configuração do Linear- Confirme que campos personalizados e labels existem antes de referenciá-los**Problemas com Formato de Data e Hora**+- Use o formato ISO 8601 para datas de vencimento e timestamps- Certifique-se de que os fusos horários estão corretos para cálculos de datas de vencimento- Verifique se os valores de data são válidos e posteriores à data atual para datas de vencimento**Problemas de Pesquisa e Filtros**+- Garanta que as consultas de busca estejam formatadas corretamente e não estejam vazias- Utilize nomes de campos válidos nas fórmulas de filtro: `title`, `number`, `project`, `createdAt`- Teste filtros simples antes de montar consultas complexas com múltiplas condições- Verifique se os tipos de operadores correspondem aos tipos de dados dos campos filtrados**Problemas na Criação de Sub-issues**+- Certifique-se de que os IDs das issues pai são válidos e acessíveis- Verifique se o ID da equipe para as sub-issues corresponde ou é compatível com o da issue pai- Assegure-se de que as issues pai não estejam arquivadas ou excluídas@@ -444,5 +465,6 @@ crew.kickoff()### Obtendo Ajuda<Card title="Precisa de Ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para assistência na configuração ou solução de problemas da integração com o Linear.+ Entre em contato com nossa equipe de suporte para assistência na configuração+ ou solução de problemas da integração com o Linear.</Card>diff --git a/docs/pt-BR/enterprise/integrations/microsoft_excel.mdx b/docs/pt-BR/enterprise/integrations/microsoft_excel.mdxindex 5ab5845dc..beb39d126 100644--- a/docs/pt-BR/enterprise/integrations/microsoft_excel.mdx+++ b/docs/pt-BR/enterprise/integrations/microsoft_excel.mdx@@ -13,7 +13,7 @@ Permita que seus agentes criem e gerenciem pastas de trabalho, planilhas, tabelaAntes de usar a integração Microsoft Excel, certifique-se de ter:-- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa+- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa- Uma conta Microsoft 365 com acesso ao Excel e OneDrive/SharePoint- Conectado sua conta Microsoft através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Antes de usar a integração Microsoft Excel, certifique-se de ter:### 1. Conecte sua Conta Microsoft-1. Navegue para [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)+1. Navegue para [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)2. Encontre **Microsoft Excel** na seção de Integrações de Autenticação3. Clique em **Conectar** e complete o fluxo OAuth4. Conceda as permissões necessárias para acesso a arquivos e pastas de trabalho do Excel@@ -36,7 +36,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@@ -58,6 +59,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `file_path` (string, obrigatório): Caminho onde criar a pasta de trabalho (ex: 'MinhaPastaDeTrabalho.xlsx')- `worksheets` (array, opcional): Planilhas iniciais para criar. Cada item é um objeto com `name` (string, nome da planilha).+</Accordion><Accordion title="microsoft_excel/get_workbooks">@@ -69,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `expand` (string, opcional): Expandir recursos relacionados inline.- `top` (integer, opcional): Número de itens a retornar (mín 1, máx 999).- `orderby` (string, opcional): Ordenar resultados por propriedades especificadas.+</Accordion><Accordion title="microsoft_excel/get_worksheets">@@ -81,6 +84,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `expand` (string, opcional): Expandir recursos relacionados inline.- `top` (integer, opcional): Número de itens a retornar (mín 1, máx 999).- `orderby` (string, opcional): Ordenar resultados por propriedades especificadas.+</Accordion><Accordion title="microsoft_excel/create_worksheet">@@ -89,6 +93,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `file_id` (string, obrigatório): O ID do arquivo Excel.- `name` (string, obrigatório): Nome da nova planilha.+</Accordion><Accordion title="microsoft_excel/get_range_data">@@ -98,6 +103,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `file_id` (string, obrigatório): O ID do arquivo Excel.- `worksheet_name` (string, obrigatório): Nome da planilha.- `range` (string, obrigatório): Endereço do intervalo (ex: 'A1:C10').+</Accordion><Accordion title="microsoft_excel/update_range_data">@@ -108,6 +114,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `worksheet_name` (string, obrigatório): Nome da planilha.- `range` (string, obrigatório): Endereço do intervalo (ex: 'A1:C10').- `values` (array, obrigatório): Array 2D de valores para definir no intervalo. Cada array interno representa uma linha, e elementos podem ser string, number ou integer.+</Accordion><Accordion title="microsoft_excel/add_table">@@ -118,6 +125,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `worksheet_name` (string, obrigatório): Nome da planilha.- `range` (string, obrigatório): Intervalo para a tabela (ex: 'A1:D10').- `has_headers` (boolean, opcional): Se a primeira linha contém cabeçalhos. Padrão: true.+</Accordion><Accordion title="microsoft_excel/get_tables">@@ -126,6 +134,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `file_id` (string, obrigatório): O ID do arquivo Excel.- `worksheet_name` (string, obrigatório): Nome da planilha.+</Accordion><Accordion title="microsoft_excel/add_table_row">@@ -136,6 +145,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `worksheet_name` (string, obrigatório): Nome da planilha.- `table_name` (string, obrigatório): Nome da tabela.- `values` (array, obrigatório): Array de valores para a nova linha. Elementos podem ser string, number ou integer.+</Accordion><Accordion title="microsoft_excel/create_chart">@@ -147,6 +157,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `chart_type` (string, obrigatório): Tipo de gráfico (ex: 'ColumnClustered', 'Line', 'Pie').- `source_data` (string, obrigatório): Intervalo de dados para o gráfico (ex: 'A1:B10').- `series_by` (string, opcional): Como interpretar os dados ('Auto', 'Columns' ou 'Rows'). Padrão: 'Auto'.+</Accordion><Accordion title="microsoft_excel/get_cell">@@ -157,6 +168,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `worksheet_name` (string, obrigatório): Nome da planilha.- `row` (integer, obrigatório): Número da linha (baseado em 0).- `column` (integer, obrigatório): Número da coluna (baseado em 0).+</Accordion><Accordion title="microsoft_excel/get_used_range">@@ -165,6 +177,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `file_id` (string, obrigatório): O ID do arquivo Excel.- `worksheet_name` (string, obrigatório): Nome da planilha.+</Accordion><Accordion title="microsoft_excel/list_charts">@@ -173,6 +186,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `file_id` (string, obrigatório): O ID do arquivo Excel.- `worksheet_name` (string, obrigatório): Nome da planilha.+</Accordion><Accordion title="microsoft_excel/delete_worksheet">@@ -181,6 +195,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `file_id` (string, obrigatório): O ID do arquivo Excel.- `worksheet_name` (string, obrigatório): Nome da planilha a excluir.+</Accordion><Accordion title="microsoft_excel/delete_table">@@ -190,6 +205,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `file_id` (string, obrigatório): O ID do arquivo Excel.- `worksheet_name` (string, obrigatório): Nome da planilha.- `table_name` (string, obrigatório): Nome da tabela a excluir.+</Accordion><Accordion title="microsoft_excel/list_names">@@ -197,6 +213,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `file_id` (string, obrigatório): O ID do arquivo Excel.+</Accordion></AccordionGroup>@@ -236,15 +253,18 @@ crew.kickoff()### Problemas Comuns**Erros de Autenticação**+- Certifique-se de que sua conta Microsoft tenha as permissões necessárias para acesso a arquivos (ex: `Files.Read.All`, `Files.ReadWrite.All`).- Verifique se a conexão OAuth inclui todos os escopos necessários.**Problemas de Criação de Arquivos**+- Ao criar pastas de trabalho, certifique-se de que o `file_path` termine com extensão `.xlsx`.- Verifique se você tem permissões de escrita no local de destino (OneDrive/SharePoint).### Obtendo Ajuda<Card title="Precisa de Ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para assistência com configuração ou solução de problemas da integração Microsoft Excel.+ Entre em contato com nossa equipe de suporte para assistência com configuração+ ou solução de problemas da integração Microsoft Excel.</Card>diff --git a/docs/pt-BR/enterprise/integrations/microsoft_onedrive.mdx b/docs/pt-BR/enterprise/integrations/microsoft_onedrive.mdxindex 2ec266768..730d0ff59 100644--- a/docs/pt-BR/enterprise/integrations/microsoft_onedrive.mdx+++ b/docs/pt-BR/enterprise/integrations/microsoft_onedrive.mdx@@ -13,7 +13,7 @@ Permita que seus agentes façam upload, download e gerenciem arquivos e pastas nAntes de usar a integração Microsoft OneDrive, certifique-se de ter:-- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa+- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa- Uma conta Microsoft com acesso ao OneDrive- Conectado sua conta Microsoft através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Antes de usar a integração Microsoft OneDrive, certifique-se de ter:### 1. Conecte sua Conta Microsoft-1. Navegue para [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)+1. Navegue para [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)2. Encontre **Microsoft OneDrive** na seção de Integrações de Autenticação3. Clique em **Conectar** e complete o fluxo OAuth4. Conceda as permissões necessárias para acesso a arquivos@@ -36,7 +36,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- `top` (integer, opcional): Número de itens a recuperar (máx 1000). Padrão: 50.- `orderby` (string, opcional): Ordenar por campo (ex: "name asc", "lastModifiedDateTime desc"). Padrão: "name asc".- `filter` (string, opcional): Expressão de filtro OData.+</Accordion><Accordion title="microsoft_onedrive/get_file_info">@@ -66,6 +68,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `item_id` (string, obrigatório): O ID do arquivo ou pasta.+</Accordion><Accordion title="microsoft_onedrive/download_file">@@ -73,6 +76,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `item_id` (string, obrigatório): O ID do arquivo a baixar.+</Accordion><Accordion title="microsoft_onedrive/upload_file">@@ -81,6 +85,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `file_name` (string, obrigatório): Nome do arquivo a fazer upload.- `content` (string, obrigatório): Conteúdo do arquivo codificado em Base64.+</Accordion><Accordion title="microsoft_onedrive/create_folder">@@ -88,6 +93,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `folder_name` (string, obrigatório): Nome da pasta a criar.+</Accordion><Accordion title="microsoft_onedrive/delete_item">@@ -95,6 +101,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `item_id` (string, obrigatório): O ID do arquivo ou pasta a excluir.+</Accordion><Accordion title="microsoft_onedrive/copy_item">@@ -104,6 +111,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `item_id` (string, obrigatório): O ID do arquivo ou pasta a copiar.- `parent_id` (string, opcional): O ID da pasta de destino (opcional, padrão para raiz).- `new_name` (string, opcional): Novo nome para o item copiado (opcional).+</Accordion><Accordion title="microsoft_onedrive/move_item">@@ -113,6 +121,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `item_id` (string, obrigatório): O ID do arquivo ou pasta a mover.- `parent_id` (string, obrigatório): O ID da pasta de destino.- `new_name` (string, opcional): Novo nome para o item (opcional).+</Accordion><Accordion title="microsoft_onedrive/search_files">@@ -121,6 +130,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `query` (string, obrigatório): String de consulta de pesquisa.- `top` (integer, opcional): Número de resultados a retornar (máx 1000). Padrão: 50.+</Accordion><Accordion title="microsoft_onedrive/share_item">@@ -130,6 +140,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `item_id` (string, obrigatório): O ID do arquivo ou pasta a compartilhar.- `type` (string, opcional): Tipo de link de compartilhamento. Opções: view, edit, embed. Padrão: view.- `scope` (string, opcional): Escopo do link de compartilhamento. Opções: anonymous, organization. Padrão: anonymous.+</Accordion><Accordion title="microsoft_onedrive/get_thumbnails">@@ -137,6 +148,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `item_id` (string, obrigatório): O ID do arquivo.+</Accordion></AccordionGroup>@@ -176,10 +188,12 @@ crew.kickoff()### Problemas Comuns**Erros de Autenticação**+- Certifique-se de que sua conta Microsoft tenha as permissões necessárias para acesso a arquivos (ex: `Files.Read`, `Files.ReadWrite`).- Verifique se a conexão OAuth inclui todos os escopos necessários.**Problemas de Upload de Arquivos**+- Certifique-se de que `file_name` e `content` sejam fornecidos para uploads de arquivos.- O conteúdo deve ser codificado em Base64 para arquivos binários.- Verifique se você tem permissões de escrita no OneDrive.@@ -187,5 +201,6 @@ crew.kickoff()### Obtendo Ajuda<Card title="Precisa de Ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para assistência com configuração ou solução de problemas da integração Microsoft OneDrive.+ Entre em contato com nossa equipe de suporte para assistência com configuração+ ou solução de problemas da integração Microsoft OneDrive.</Card>diff --git a/docs/pt-BR/enterprise/integrations/microsoft_outlook.mdx b/docs/pt-BR/enterprise/integrations/microsoft_outlook.mdxindex bafed9d8d..952109710 100644--- a/docs/pt-BR/enterprise/integrations/microsoft_outlook.mdx+++ b/docs/pt-BR/enterprise/integrations/microsoft_outlook.mdx@@ -13,7 +13,7 @@ Permita que seus agentes acessem e gerenciem emails, eventos de calendário e coAntes de usar a integração Microsoft Outlook, certifique-se de ter:-- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa+- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa- Uma conta Microsoft com acesso ao Outlook- Conectado sua conta Microsoft através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Antes de usar a integração Microsoft Outlook, certifique-se de ter:### 1. Conecte sua Conta Microsoft-1. Navegue para [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)+1. Navegue para [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)2. Encontre **Microsoft Outlook** na seção de Integrações de Autenticação3. Clique em **Conectar** e complete o fluxo OAuth4. Conceda as permissões necessárias para acesso a email, calendário e contatos@@ -36,7 +36,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@@ -62,6 +63,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `orderby` (string, opcional): Ordenar por campo (ex: "receivedDateTime desc"). Padrão: "receivedDateTime desc".- `select` (string, opcional): Selecionar propriedades específicas para retornar.- `expand` (string, opcional): Expandir recursos relacionados inline.+</Accordion><Accordion title="microsoft_outlook/send_email">@@ -77,6 +79,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `importance` (string, opcional): Nível de importância da mensagem. Opções: low, normal, high. Padrão: normal.- `reply_to` (array, opcional): Array de endereços de email para resposta.- `save_to_sent_items` (boolean, opcional): Se deve salvar a mensagem na pasta Itens Enviados. Padrão: true.+</Accordion><Accordion title="microsoft_outlook/get_calendar_events">@@ -87,6 +90,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `skip` (integer, opcional): Número de eventos a pular. Padrão: 0.- `filter` (string, opcional): Expressão de filtro OData (ex: "start/dateTime ge '2024-01-01T00:00:00Z'").- `orderby` (string, opcional): Ordenar por campo (ex: "start/dateTime asc"). Padrão: "start/dateTime asc".+</Accordion><Accordion title="microsoft_outlook/create_calendar_event">@@ -100,6 +104,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `timezone` (string, opcional): Fuso horário (ex: 'Pacific Standard Time'). Padrão: UTC.- `location` (string, opcional): Local do evento.- `attendees` (array, opcional): Array de endereços de email dos participantes.+</Accordion><Accordion title="microsoft_outlook/get_contacts">@@ -110,6 +115,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `skip` (integer, opcional): Número de contatos a pular. Padrão: 0.- `filter` (string, opcional): Expressão de filtro OData.- `orderby` (string, opcional): Ordenar por campo (ex: "displayName asc"). Padrão: "displayName asc".+</Accordion><Accordion title="microsoft_outlook/create_contact">@@ -124,6 +130,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `homePhones` (array, opcional): Array de números de telefone residenciais.- `jobTitle` (string, opcional): Cargo do contato.- `companyName` (string, opcional): Nome da empresa do contato.+</Accordion></AccordionGroup>@@ -163,15 +170,18 @@ crew.kickoff()### Problemas Comuns**Erros de Autenticação**+- Certifique-se de que sua conta Microsoft tenha as permissões necessárias para acesso a email, calendário e contatos.- Escopos necessários incluem: `Mail.Read`, `Mail.Send`, `Calendars.Read`, `Calendars.ReadWrite`, `Contacts.Read`, `Contacts.ReadWrite`.**Problemas de Envio de Email**+- Certifique-se de que `to_recipients`, `subject` e `body` sejam fornecidos para `send_email`.- Verifique se os endereços de email estão formatados corretamente.### Obtendo Ajuda<Card title="Precisa de Ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para assistência com configuração ou solução de problemas da integração Microsoft Outlook.+ Entre em contato com nossa equipe de suporte para assistência com configuração+ ou solução de problemas da integração Microsoft Outlook.</Card>diff --git a/docs/pt-BR/enterprise/integrations/microsoft_sharepoint.mdx b/docs/pt-BR/enterprise/integrations/microsoft_sharepoint.mdxindex 755074005..8c2cfe265 100644--- a/docs/pt-BR/enterprise/integrations/microsoft_sharepoint.mdx+++ b/docs/pt-BR/enterprise/integrations/microsoft_sharepoint.mdx@@ -13,7 +13,7 @@ Permita que seus agentes acessem e gerenciem sites, listas e bibliotecas de docuAntes de usar a integração Microsoft SharePoint, certifique-se de ter:-- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa+- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa- Uma conta Microsoft com acesso ao SharePoint- Conectado sua conta Microsoft através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Antes de usar a integração Microsoft SharePoint, certifique-se de ter:### 1. Conecte sua Conta Microsoft-1. Navegue para [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)+1. Navegue para [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)2. Encontre **Microsoft SharePoint** na seção de Integrações de Autenticação3. Clique em **Conectar** e complete o fluxo OAuth4. Conceda as permissões necessárias para acesso a sites e arquivos do SharePoint@@ -36,7 +36,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@@ -63,6 +64,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `top` (integer, opcional): Número de itens a retornar (mín 1, máx 999).- `skip` (integer, opcional): Número de itens a pular (mín 0).- `orderby` (string, opcional): Ordenar resultados por propriedades especificadas (ex: 'displayName desc').+</Accordion><Accordion title="microsoft_sharepoint/get_site">@@ -72,6 +74,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `site_id` (string, obrigatório): O ID do site do SharePoint.- `select` (string, opcional): Selecionar propriedades específicas para retornar (ex: 'displayName,id,webUrl,drives').- `expand` (string, opcional): Expandir recursos relacionados inline (ex: 'drives,lists').+</Accordion><Accordion title="microsoft_sharepoint/get_site_lists">@@ -79,6 +82,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `site_id` (string, obrigatório): O ID do site do SharePoint.+</Accordion><Accordion title="microsoft_sharepoint/get_list">@@ -87,6 +91,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `site_id` (string, obrigatório): O ID do site do SharePoint.- `list_id` (string, obrigatório): O ID da lista.+</Accordion><Accordion title="microsoft_sharepoint/get_list_items">@@ -96,6 +101,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `site_id` (string, obrigatório): O ID do site do SharePoint.- `list_id` (string, obrigatório): O ID da lista.- `expand` (string, opcional): Expandir dados relacionados (ex: 'fields').+</Accordion><Accordion title="microsoft_sharepoint/create_list_item">@@ -105,6 +111,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `site_id` (string, obrigatório): O ID do site do SharePoint.- `list_id` (string, obrigatório): O ID da lista.- `fields` (object, obrigatório): Os valores de campo para o novo item.+</Accordion><Accordion title="microsoft_sharepoint/update_list_item">@@ -115,6 +122,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `list_id` (string, obrigatório): O ID da lista.- `item_id` (string, obrigatório): O ID do item a atualizar.- `fields` (object, obrigatório): Os valores de campo a atualizar.+</Accordion><Accordion title="microsoft_sharepoint/delete_list_item">@@ -124,6 +132,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `site_id` (string, obrigatório): O ID do site do SharePoint.- `list_id` (string, obrigatório): O ID da lista.- `item_id` (string, obrigatório): O ID do item a excluir.+</Accordion><Accordion title="microsoft_sharepoint/upload_file_to_library">@@ -133,6 +142,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `site_id` (string, obrigatório): O ID do site do SharePoint.- `file_path` (string, obrigatório): O caminho onde fazer upload do arquivo (ex: 'pasta/nomeDoArquivo.txt').- `content` (string, obrigatório): O conteúdo do arquivo a fazer upload.+</Accordion><Accordion title="microsoft_sharepoint/get_drive_items">@@ -140,6 +150,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `site_id` (string, obrigatório): O ID do site do SharePoint.+</Accordion><Accordion title="microsoft_sharepoint/delete_drive_item">@@ -148,6 +159,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `site_id` (string, obrigatório): O ID do site do SharePoint.- `item_id` (string, obrigatório): O ID do arquivo ou pasta a excluir.+</Accordion></AccordionGroup>@@ -187,15 +199,18 @@ crew.kickoff()### Problemas Comuns**Erros de Autenticação**+- Certifique-se de que sua conta Microsoft tenha as permissões necessárias para acesso ao SharePoint (ex: `Sites.Read.All`, `Sites.ReadWrite.All`).- Verifique se a conexão OAuth inclui todos os escopos necessários.**Problemas de ID de Site/Lista/Item**+- Verifique novamente os IDs de site, lista e item para correção.- Certifique-se de que os recursos referenciados existem e estão acessíveis.### Obtendo Ajuda<Card title="Precisa de Ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para assistência com configuração ou solução de problemas da integração Microsoft SharePoint.+ Entre em contato com nossa equipe de suporte para assistência com configuração+ ou solução de problemas da integração Microsoft SharePoint.</Card>diff --git a/docs/pt-BR/enterprise/integrations/microsoft_teams.mdx b/docs/pt-BR/enterprise/integrations/microsoft_teams.mdxindex 3bc6ebb30..54a9891d6 100644--- a/docs/pt-BR/enterprise/integrations/microsoft_teams.mdx+++ b/docs/pt-BR/enterprise/integrations/microsoft_teams.mdx@@ -13,7 +13,7 @@ Permita que seus agentes acessem dados do Teams, enviem mensagens, criem reuniõAntes de usar a integração Microsoft Teams, certifique-se de ter:-- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa+- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa- Uma conta Microsoft com acesso ao Teams- Conectado sua conta Microsoft através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Antes de usar a integração Microsoft Teams, certifique-se de ter:### 1. Conecte sua Conta Microsoft-1. Navegue para [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)+1. Navegue para [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)2. Encontre **Microsoft Teams** na seção de Integrações de Autenticação3. Clique em **Conectar** e complete o fluxo OAuth4. Conceda as permissões necessárias para acesso ao Teams@@ -36,7 +36,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@@ -57,6 +58,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- Nenhum parâmetro necessário.+</Accordion><Accordion title="microsoft_teams/get_channels">@@ -64,6 +66,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `team_id` (string, obrigatório): O ID da equipe.+</Accordion><Accordion title="microsoft_teams/send_message">@@ -74,6 +77,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `channel_id` (string, obrigatório): O ID do canal.- `message` (string, obrigatório): O conteúdo da mensagem.- `content_type` (string, opcional): Tipo de conteúdo (html ou text). Opções: html, text. Padrão: text.+</Accordion><Accordion title="microsoft_teams/get_messages">@@ -83,6 +87,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `team_id` (string, obrigatório): O ID da equipe.- `channel_id` (string, obrigatório): O ID do canal.- `top` (integer, opcional): Número de mensagens a recuperar (máx 50). Padrão: 20.+</Accordion><Accordion title="microsoft_teams/create_meeting">@@ -92,6 +97,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `subject` (string, obrigatório): Assunto/título da reunião.- `startDateTime` (string, obrigatório): Hora de início da reunião (formato ISO 8601 com fuso horário).- `endDateTime` (string, obrigatório): Hora de término da reunião (formato ISO 8601 com fuso horário).+</Accordion><Accordion title="microsoft_teams/search_online_meetings_by_join_url">@@ -99,6 +105,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `join_web_url` (string, obrigatório): A URL de participação na web da reunião a pesquisar.+</Accordion></AccordionGroup>@@ -138,15 +145,18 @@ crew.kickoff()### Problemas Comuns**Erros de Autenticação**+- Certifique-se de que sua conta Microsoft tenha as permissões necessárias para acesso ao Teams.- Escopos necessários incluem: `Team.ReadBasic.All`, `Channel.ReadBasic.All`, `ChannelMessage.Send`, `ChannelMessage.Read.All`, `OnlineMeetings.ReadWrite`, `OnlineMeetings.Read`.**Acesso a Equipes e Canais**+- Certifique-se de que você é membro das equipes que está tentando acessar.- Verifique novamente os IDs de equipe e canal para correção.### Obtendo Ajuda<Card title="Precisa de Ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para assistência com configuração ou solução de problemas da integração Microsoft Teams.+ Entre em contato com nossa equipe de suporte para assistência com configuração+ ou solução de problemas da integração Microsoft Teams.</Card>diff --git a/docs/pt-BR/enterprise/integrations/microsoft_word.mdx b/docs/pt-BR/enterprise/integrations/microsoft_word.mdxindex 85c92d6ac..9d8663c44 100644--- a/docs/pt-BR/enterprise/integrations/microsoft_word.mdx+++ b/docs/pt-BR/enterprise/integrations/microsoft_word.mdx@@ -13,7 +13,7 @@ Permita que seus agentes criem, leiam e gerenciem documentos do Word e arquivosAntes de usar a integração Microsoft Word, certifique-se de ter:-- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa+- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa- Uma conta Microsoft com acesso ao Word e OneDrive/SharePoint- Conectado sua conta Microsoft através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Antes de usar a integração Microsoft Word, certifique-se de ter:### 1. Conecte sua Conta Microsoft-1. Navegue para [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)+1. Navegue para [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)2. Encontre **Microsoft Word** na seção de Integrações de Autenticação3. Clique em **Conectar** e complete o fluxo OAuth4. Conceda as permissões necessárias para acesso a arquivos@@ -36,7 +36,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@@ -61,6 +62,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `expand` (string, opcional): Expandir recursos relacionados inline.- `top` (integer, opcional): Número de itens a retornar (mín 1, máx 999).- `orderby` (string, opcional): Ordenar resultados por propriedades especificadas.+</Accordion><Accordion title="microsoft_word/create_text_document">@@ -69,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `file_name` (string, obrigatório): Nome do documento de texto (deve terminar com .txt).- `content` (string, opcional): Conteúdo de texto para o documento. Padrão: "Este é um novo documento de texto criado via API."+</Accordion><Accordion title="microsoft_word/get_document_content">@@ -76,6 +79,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `file_id` (string, obrigatório): O ID do documento.+</Accordion><Accordion title="microsoft_word/get_document_properties">@@ -83,6 +87,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `file_id` (string, obrigatório): O ID do documento.+</Accordion><Accordion title="microsoft_word/delete_document">@@ -90,6 +95,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `file_id` (string, obrigatório): O ID do documento a excluir.+</Accordion></AccordionGroup>@@ -129,15 +135,18 @@ crew.kickoff()### Problemas Comuns**Erros de Autenticação**+- Certifique-se de que sua conta Microsoft tenha as permissões necessárias para acesso a arquivos (ex: `Files.Read.All`, `Files.ReadWrite.All`).- Verifique se a conexão OAuth inclui todos os escopos necessários.**Problemas de Criação de Arquivos**+- Ao criar documentos de texto, certifique-se de que o `file_name` termine com extensão `.txt`.- Verifique se você tem permissões de escrita no local de destino (OneDrive/SharePoint).### Obtendo Ajuda<Card title="Precisa de Ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para assistência com configuração ou solução de problemas da integração Microsoft Word.+ Entre em contato com nossa equipe de suporte para assistência com configuração+ ou solução de problemas da integração Microsoft Word.</Card>diff --git a/docs/pt-BR/enterprise/integrations/notion.mdx b/docs/pt-BR/enterprise/integrations/notion.mdxindex 2a1d70690..d61df08f0 100644--- a/docs/pt-BR/enterprise/integrations/notion.mdx+++ b/docs/pt-BR/enterprise/integrations/notion.mdx@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem páginas, bancos de dados e conteúdos atravAntes de usar a integração com o Notion, certifique-se de que você tem:-- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa+- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa- Uma conta Notion com permissões adequadas no workspace- Sua conta Notion conectada através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)@@ -21,7 +21,7 @@ Antes de usar a integração com o Notion, certifique-se de que você tem:### 1. Conecte sua Conta Notion-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. Procure por **Notion** na seção de Integrações de Autenticação3. Clique em **Conectar** e complete o fluxo de OAuth4. Conceda as permissões necessárias para gerenciamento de páginas e bancos de dados@@ -36,7 +36,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@@ -107,6 +108,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token}}```+</Accordion><Accordion title="notion/update_page">@@ -141,6 +143,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token}}```+</Accordion><Accordion title="notion/get_page_by_id">@@ -148,6 +151,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `pageId` (string, obrigatório): Page ID - Especifique o ID da Página a ser buscada. (exemplo: "59833787-2cf9-4fdf-8782-e53db20768a5").+</Accordion><Accordion title="notion/archive_page">@@ -155,6 +159,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `pageId` (string, obrigatório): Page ID - Especifique o ID da Página a ser arquivada. (exemplo: "59833787-2cf9-4fdf-8782-e53db20768a5").+</Accordion><Accordion title="notion/search_pages">@@ -180,6 +185,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token}```Campos disponíveis: `query`, `filter.value`, `direction`, `page_size`+</Accordion><Accordion title="notion/get_page_content">@@ -187,6 +193,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `blockId` (string, obrigatório): Page ID - Especifique o ID de um Bloco ou Página para receber todos os seus blocos filhos na ordem correta. (exemplo: "59833787-2cf9-4fdf-8782-e53db20768a5").+</Accordion><Accordion title="notion/update_block">@@ -274,6 +281,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token}}```+</Accordion><Accordion title="notion/get_block_by_id">@@ -281,6 +289,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `blockId` (string, obrigatório): Block ID - Especifique o ID do Bloco a ser buscado. (exemplo: "9bc30ad4-9373-46a5-84ab-0a7845ee52e6").+</Accordion><Accordion title="notion/delete_block">@@ -288,6 +297,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `blockId` (string, obrigatório): Block ID - Especifique o ID do Bloco a ser excluído. (exemplo: "9bc30ad4-9373-46a5-84ab-0a7845ee52e6").+</Accordion></AccordionGroup>@@ -452,41 +462,49 @@ crew.kickoff()### Problemas Comuns**Erros de Permissão**+- Certifique-se de que sua conta Notion possui acesso de edição ao workspace desejado- Verifique se a conexão OAuth inclui os escopos necessários para a API do Notion- Confira se as páginas e bancos de dados estão compartilhados com a integração autenticada**IDs de Página e Bloco Inválidos**+- Revise os IDs de página e bloco para garantir que estejam no formato UUID correto- Garanta que as páginas e blocos referenciados existem e são acessíveis- Verifique se os IDs da página ou banco de dados pai são válidos ao criar novas páginas**Problemas com Schema de Propriedades**+- Assegure que as propriedades da página correspondem ao schema do banco de dados ao criar páginas em bancos de dados- Verifique se os nomes e tipos das propriedades estão corretos para o banco de dados alvo- Confirme que as propriedades obrigatórias estão incluídas ao criar ou atualizar páginas**Estrutura dos Blocos de Conteúdo**+- Assegure que o conteúdo dos blocos segue as especificações de rich text do Notion- Verifique se estruturas aninhadas de blocos estão devidamente formatadas- Confira se URLs de mídias são acessíveis e estão corretamente formatadas**Problemas de Pesquisa e Filtros**+- Certifique-se de que as queries de pesquisa estão devidamente formatadas e não estão vazias- Use nomes de campos válidos em fórmulas de filtro: `query`, `filter.value`, `direction`, `page_size`- Teste pesquisas simples antes de construir condições de filtro mais complexas**Relacionamentos Pai-Filho**+- Verifique se a página ou banco de dados pai existe antes de criar páginas filhas- Assegure que existam permissões apropriadas para o container pai- Confirme que os schemas do banco permitem definir as propriedades desejadas**Rich Text e Conteúdo de Mídia**+- Assegure que URLs para imagens externas, PDFs e bookmarks sejam acessíveis- Verifique se a formatação rich text segue as especificações da API do Notion- Confira se os tipos de linguagem nos blocos de código são suportados pelo Notion**Operações de Arquivamento e Exclusão**+- Entenda a diferença entre arquivar (reversível) e excluir (permanente)- Certifique-se de ter permissões para arquivar ou excluir o conteúdo desejado- Tenha cuidado com operações em massa que possam afetar múltiplas páginas ou blocos@@ -494,5 +512,6 @@ crew.kickoff()### Obtendo Ajuda<Card title="Precisa de ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nosso time de suporte para auxílio na configuração ou solução de problemas com a integração Notion.+ Entre em contato com nosso time de suporte para auxílio na configuração ou+ solução de problemas com a integração Notion.</Card>diff --git a/docs/pt-BR/enterprise/integrations/salesforce.mdx b/docs/pt-BR/enterprise/integrations/salesforce.mdxindex 26d985036..8697577e4 100644--- a/docs/pt-BR/enterprise/integrations/salesforce.mdx+++ b/docs/pt-BR/enterprise/integrations/salesforce.mdx@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem relacionamentos com clientes, processos de veAntes de usar a integração Salesforce, 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 Salesforce com permissões apropriadas- Sua conta Salesforce conectada via a [página de Integrações](https://app.crewai.com/integrations)@@ -21,7 +21,7 @@ Antes de usar a integração Salesforce, certifique-se de que você possui:### 1. Conecte sua Conta Salesforce-1. Acesse [CrewAI AOP Integrações](https://app.crewai.com/crewai_plus/connectors)+1. Acesse [CrewAI AMP Integrações](https://app.crewai.com/crewai_plus/connectors)2. Encontre **Salesforce** na seção Integrações de Autenticação3. Clique em **Conectar** e complete o fluxo OAuth4. Conceda as permissões necessárias para gerenciamento de CRM e vendas@@ -36,7 +36,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@@ -65,6 +66,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `Title` (string, opcional): Cargo do contato, como CEO ou Vice-presidente- `Description` (string, opcional): Descrição do contato- `additionalFields` (object, opcional): Campos adicionais no formato JSON para campos personalizados de Contato+</Accordion><Accordion title="salesforce/create_record_lead">@@ -81,6 +83,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `Status` (string, opcional): Status do Lead - Use as Configurações de Workflow do Connect Portal para selecionar o status do Lead- `Description` (string, opcional): Descrição do lead- `additionalFields` (object, opcional): Campos adicionais no formato JSON para campos personalizados de Lead+</Accordion><Accordion title="salesforce/create_record_opportunity">@@ -96,6 +99,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `OwnerId` (string, opcional): Usuário Salesforce designado para esta Oportunidade- `NextStep` (string, opcional): Descrição da próxima tarefa no fechamento da Oportunidade- `additionalFields` (object, opcional): Campos adicionais no formato JSON para campos personalizados de Oportunidade+</Accordion><Accordion title="salesforce/create_record_task">@@ -114,6 +118,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `isReminderSet` (boolean, opcional): Se o lembrete está definido- `reminderDateTime` (string, opcional): Data/Hora do lembrete no formato ISO- `additionalFields` (object, opcional): Campos adicionais no formato JSON para campos personalizados de Tarefa+</Accordion><Accordion title="salesforce/create_record_account">@@ -126,12 +131,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `Phone` (string, opcional): Número de telefone- `Description` (string, opcional): Descrição da conta- `additionalFields` (object, opcional): Campos adicionais no formato JSON para campos personalizados de Conta+</Accordion><Accordion title="salesforce/create_record_any">**Descrição:** Crie um registro de qualquer tipo de objeto no Salesforce.**Nota:** Esta é uma ferramenta flexível para criar registros de tipos de objetos personalizados ou desconhecidos.+</Accordion></AccordionGroup>@@ -150,6 +157,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `Title` (string, opcional): Cargo do contato- `Description` (string, opcional): Descrição do contato- `additionalFields` (object, opcional): Campos adicionais no formato JSON para campos personalizados de Contato+</Accordion><Accordion title="salesforce/update_record_lead">@@ -167,6 +175,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `Status` (string, opcional): Status do Lead- `Description` (string, opcional): Descrição do lead- `additionalFields` (object, opcional): Campos adicionais no formato JSON para campos personalizados de Lead+</Accordion><Accordion title="salesforce/update_record_opportunity">@@ -183,6 +192,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `OwnerId` (string, opcional): Usuário Salesforce responsável por esta Oportunidade- `NextStep` (string, opcional): Descrição da próxima tarefa no fechamento da Oportunidade- `additionalFields` (object, opcional): Campos adicionais no formato JSON para campos personalizados de Oportunidade+</Accordion><Accordion title="salesforce/update_record_task">@@ -201,6 +211,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `isReminderSet` (boolean, opcional): Se o lembrete está definido- `reminderDateTime` (string, opcional): Data/Hora do lembrete em formato ISO- `additionalFields` (object, opcional): Campos adicionais no formato JSON para campos personalizados de Tarefa+</Accordion><Accordion title="salesforce/update_record_account">@@ -214,12 +225,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `Phone` (string, opcional): Número de telefone- `Description` (string, opcional): Descrição da conta- `additionalFields` (object, opcional): Campos adicionais no formato JSON para campos personalizados de Conta+</Accordion><Accordion title="salesforce/update_record_any">**Descrição:** Atualize um registro de qualquer tipo de objeto no Salesforce.**Nota:** Esta é uma ferramenta flexível para atualizar registros de tipos de objetos personalizados ou desconhecidos.+</Accordion></AccordionGroup>@@ -231,6 +244,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `recordId` (string, obrigatório): ID do registro do Contato+</Accordion><Accordion title="salesforce/get_record_by_id_lead">@@ -238,6 +252,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `recordId` (string, obrigatório): ID do registro do Lead+</Accordion><Accordion title="salesforce/get_record_by_id_opportunity">@@ -245,6 +260,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `recordId` (string, obrigatório): ID do registro da Oportunidade+</Accordion><Accordion title="salesforce/get_record_by_id_task">@@ -252,6 +268,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `recordId` (string, obrigatório): ID do registro da Tarefa+</Accordion><Accordion title="salesforce/get_record_by_id_account">@@ -259,6 +276,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `recordId` (string, obrigatório): ID do registro da Conta+</Accordion><Accordion title="salesforce/get_record_by_id_any">@@ -267,6 +285,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `recordType` (string, obrigatório): Tipo do registro (ex.: "CustomObject__c")- `recordId` (string, obrigatório): ID do registro+</Accordion></AccordionGroup>@@ -282,6 +301,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `sortDirection` (string, opcional): Direção da ordenação - Opções: ASC, DESC- `includeAllFields` (boolean, opcional): Incluir todos os campos nos resultados- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor+</Accordion><Accordion title="salesforce/search_records_lead">@@ -293,6 +313,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `sortDirection` (string, opcional): Direção da ordenação - Opções: ASC, DESC- `includeAllFields` (boolean, opcional): Incluir todos os campos nos resultados- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor+</Accordion><Accordion title="salesforce/search_records_opportunity">@@ -304,6 +325,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `sortDirection` (string, opcional): Direção da ordenação - Opções: ASC, DESC- `includeAllFields` (boolean, opcional): Incluir todos os campos nos resultados- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor+</Accordion><Accordion title="salesforce/search_records_task">@@ -315,6 +337,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `sortDirection` (string, opcional): Direção da ordenação - Opções: ASC, DESC- `includeAllFields` (boolean, opcional): Incluir todos os campos nos resultados- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor+</Accordion><Accordion title="salesforce/search_records_account">@@ -326,6 +349,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `sortDirection` (string, opcional): Direção da ordenação - Opções: ASC, DESC- `includeAllFields` (boolean, opcional): Incluir todos os campos nos resultados- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor+</Accordion><Accordion title="salesforce/search_records_any">@@ -336,6 +360,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `filterFormula` (string, opcional): Critérios de busca por filtro- `includeAllFields` (boolean, opcional): Incluir todos os campos nos resultados- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor+</Accordion></AccordionGroup>@@ -348,6 +373,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `listViewId` (string, obrigatório): ID do List View- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor+</Accordion><Accordion title="salesforce/get_record_by_view_id_lead">@@ -356,6 +382,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `listViewId` (string, obrigatório): ID do List View- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor+</Accordion><Accordion title="salesforce/get_record_by_view_id_opportunity">@@ -364,6 +391,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `listViewId` (string, obrigatório): ID do List View- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor+</Accordion><Accordion title="salesforce/get_record_by_view_id_task">@@ -372,6 +400,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `listViewId` (string, obrigatório): ID do List View- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor+</Accordion><Accordion title="salesforce/get_record_by_view_id_account">@@ -380,6 +409,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `listViewId` (string, obrigatório): ID do List View- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor+</Accordion><Accordion title="salesforce/get_record_by_view_id_any">@@ -389,6 +419,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `recordType` (string, obrigatório): Tipo do registro- `listViewId` (string, obrigatório): ID do List View- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor+</Accordion></AccordionGroup>@@ -409,6 +440,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `description` (string, opcional): Descrição do campo- `helperText` (string, opcional): Texto de ajuda exibido ao passar o mouse- `defaultFieldValue` (string, opcional): Valor padrão do campo+</Accordion><Accordion title="salesforce/create_custom_field_lead">@@ -425,6 +457,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `description` (string, opcional): Descrição do campo- `helperText` (string, opcional): Texto de ajuda exibido ao passar o mouse- `defaultFieldValue` (string, opcional): Valor padrão do campo+</Accordion><Accordion title="salesforce/create_custom_field_opportunity">@@ -441,6 +474,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `description` (string, opcional): Descrição do campo- `helperText` (string, opcional): Texto de ajuda exibido ao passar o mouse- `defaultFieldValue` (string, opcional): Valor padrão do campo+</Accordion><Accordion title="salesforce/create_custom_field_task">@@ -457,6 +491,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `description` (string, opcional): Descrição do campo- `helperText` (string, opcional): Texto de ajuda exibido ao passar o mouse- `defaultFieldValue` (string, opcional): Valor padrão do campo+</Accordion><Accordion title="salesforce/create_custom_field_account">@@ -473,12 +508,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `description` (string, opcional): Descrição do campo- `helperText` (string, opcional): Texto de ajuda exibido ao passar o mouse- `defaultFieldValue` (string, opcional): Valor padrão do campo+</Accordion><Accordion title="salesforce/create_custom_field_any">**Descrição:** Crie campos personalizados para qualquer tipo de objeto.**Nota:** Esta é uma ferramenta flexível para criar campos personalizados para tipos de objetos personalizados ou desconhecidos.+</Accordion></AccordionGroup>@@ -490,6 +527,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `query` (string, obrigatório): Consulta SOQL (ex.: "SELECT Id, Name FROM Account WHERE Name = 'Exemplo'")+</Accordion><Accordion title="salesforce/create_custom_object">@@ -500,6 +538,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `pluralLabel` (string, obrigatório): Rótulo plural (ex.: "Contas")- `description` (string, opcional): Uma descrição do Objeto Personalizado- `recordName` (string, obrigatório): Nome do registro exibido em layouts e buscas (ex.: "Nome da Conta")+</Accordion><Accordion title="salesforce/describe_action_schema">@@ -510,6 +549,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `operation` (string, obrigatório): Tipo de Operação (ex.: "CREATE_RECORD" ou "UPDATE_RECORD")**Nota:** Use esta função primeiro ao trabalhar com objetos personalizados para entender seu schema antes de realizar operações.+</Accordion></AccordionGroup>@@ -644,5 +684,6 @@ Esta documentação abrangente cobre todas as ferramentas Salesforce organizadas### Precisa de ajuda?<Card title="Precisa de ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para assistência na configuração da integração com Salesforce ou para resolução de problemas.+ Entre em contato com nossa equipe de suporte para assistência na configuração+ da integração com Salesforce ou para resolução de problemas.</Card>diff --git a/docs/pt-BR/enterprise/integrations/shopify.mdx b/docs/pt-BR/enterprise/integrations/shopify.mdxindex 92c46397d..d7c919d1a 100644--- a/docs/pt-BR/enterprise/integrations/shopify.mdx+++ b/docs/pt-BR/enterprise/integrations/shopify.mdx@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem operações de e-commerce através do ShopifyAntes de utilizar a integração com o Shopify, certifique-se de que você possui:-- Uma conta [CrewAI AOP](https://app.crewai.com) com uma assinatura ativa+- Uma conta [CrewAI AMP](https://app.crewai.com) com uma assinatura ativa- Uma loja Shopify com permissões administrativas adequadas- Sua loja Shopify conectada através da [página de Integrações](https://app.crewai.com/integrations)@@ -21,7 +21,7 @@ Antes de utilizar a integração com o Shopify, certifique-se de que você possu### 1. Conecte sua Loja Shopify-1. Acesse [CrewAI AOP Integrações](https://app.crewai.com/crewai_plus/connectors)+1. Acesse [CrewAI AMP Integrações](https://app.crewai.com/crewai_plus/connectors)2. Encontre **Shopify** na seção Integrações de Autenticação3. Clique em **Conectar** e complete o fluxo OAuth4. Conceda as permissões necessárias para gerenciamento de loja e produtos@@ -36,7 +36,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@@ -64,6 +65,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `updatedAtMin` (string, opcional): Retorna somente clientes atualizados após esta data (ISO ou timestamp Unix)- `updatedAtMax` (string, opcional): Retorna somente clientes atualizados antes desta data (ISO ou timestamp Unix)- `limit` (string, opcional): Número máximo de clientes a retornar (padrão 250)+</Accordion><Accordion title="shopify/search_customers">@@ -72,6 +74,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `filterFormula` (object, opcional): Filtro avançado em forma normal disjuntiva com operadores específicos de campo- `limit` (string, opcional): Número máximo de clientes a retornar (padrão 250)+</Accordion><Accordion title="shopify/create_customer">@@ -93,6 +96,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `note` (string, opcional): Observação sobre o cliente- `sendEmailInvite` (boolean, opcional): Se deve enviar convite por e-mail- `metafields` (object, opcional): Metacampos adicionais em formato JSON+</Accordion><Accordion title="shopify/update_customer">@@ -115,6 +119,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `note` (string, opcional): Observação sobre o cliente- `sendEmailInvite` (boolean, opcional): Se deve enviar convite por e-mail- `metafields` (object, opcional): Metacampos adicionais em formato JSON+</Accordion></AccordionGroup>@@ -131,6 +136,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `updatedAtMin` (string, opcional): Retorna somente pedidos atualizados após esta data (ISO ou timestamp Unix)- `updatedAtMax` (string, opcional): Retorna somente pedidos atualizados antes desta data (ISO ou timestamp Unix)- `limit` (string, opcional): Número máximo de pedidos a retornar (padrão 250)+</Accordion><Accordion title="shopify/create_order">@@ -144,6 +150,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `financialStatus` (string, opcional): Status financeiro - Opções: pending, authorized, partially_paid, paid, partially_refunded, refunded, voided- `inventoryBehaviour` (string, opcional): Comportamento de inventário - Opções: bypass, decrement_ignoring_policy, decrement_obeying_policy- `note` (string, opcional): Observação do pedido+</Accordion><Accordion title="shopify/update_order">@@ -158,6 +165,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `financialStatus` (string, opcional): Status financeiro - Opções: pending, authorized, partially_paid, paid, partially_refunded, refunded, voided- `inventoryBehaviour` (string, opcional): Comportamento de inventário - Opções: bypass, decrement_ignoring_policy, decrement_obeying_policy- `note` (string, opcional): Observação do pedido+</Accordion><Accordion title="shopify/get_abandoned_carts">@@ -170,6 +178,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `createdAtMin` (string, opcional): Retorna somente carrinhos criados após esta data (ISO ou timestamp Unix)- `createdAtMax` (string, opcional): Retorna somente carrinhos criados antes desta data (ISO ou timestamp Unix)- `limit` (string, opcional): Número máximo de carrinhos a retornar (padrão 250)+</Accordion></AccordionGroup>@@ -190,6 +199,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `updatedAtMin` (string, opcional): Retorna somente produtos atualizados após esta data (ISO ou timestamp Unix)- `updatedAtMax` (string, opcional): Retorna somente produtos atualizados antes desta data (ISO ou timestamp Unix)- `limit` (string, opcional): Número máximo de produtos a retornar (padrão 250)+</Accordion><Accordion title="shopify/create_product">@@ -206,6 +216,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `imageUrl` (string, opcional): URL da imagem do produto- `isPublished` (boolean, opcional): Se o produto está publicado- `publishToPointToSale` (boolean, opcional): Se deve publicar no ponto de venda+</Accordion><Accordion title="shopify/update_product">@@ -223,6 +234,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `imageUrl` (string, opcional): URL da imagem do produto- `isPublished` (boolean, opcional): Se o produto está publicado- `publishToPointToSale` (boolean, opcional): Se deve publicar no ponto de venda+</Accordion></AccordionGroup>@@ -234,6 +246,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `productFilterFormula` (object, opcional): Filtro avançado em forma normal disjuntiva com suporte a campos como id, title, vendor, status, handle, tag, created_at, updated_at, published_at+</Accordion><Accordion title="shopify/create_product_graphql">@@ -247,6 +260,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `tags` (string, opcional): Tags do produto como array ou lista separada por vírgula- `media` (object, opcional): Objetos de mídia com texto alternativo, tipo de conteúdo e URL de origem- `additionalFields` (object, opcional): Campos adicionais do produto como status, requiresSellingPlan, giftCard+</Accordion><Accordion title="shopify/update_product_graphql">@@ -261,6 +275,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `tags` (string, opcional): Tags do produto como array ou lista separada por vírgula- `media` (object, opcional): Objetos de mídia atualizados com texto alternativo, tipo de conteúdo e URL de origem- `additionalFields` (object, opcional): Campos adicionais do produto como status, requiresSellingPlan, giftCard+</Accordion></AccordionGroup>@@ -388,5 +403,6 @@ crew.kickoff()### Precisa de Ajuda?<Card title="Precisa de Ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para assistência na configuração ou resolução de problemas de integração com o Shopify.+ Entre em contato com nossa equipe de suporte para assistência na configuração+ ou resolução de problemas de integração com o Shopify.</Card>diff --git a/docs/pt-BR/enterprise/integrations/slack.mdx b/docs/pt-BR/enterprise/integrations/slack.mdxindex bcb01da80..c295bb288 100644--- a/docs/pt-BR/enterprise/integrations/slack.mdx+++ b/docs/pt-BR/enterprise/integrations/slack.mdx@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem a comunicação da equipe pelo Slack. Envie mAntes de usar a integração com o Slack, certifique-se de que você tenha:-- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa+- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa- Um workspace do Slack com permissões apropriadas- Seu workspace do Slack conectado por meio da [página de Integrações](https://app.crewai.com/integrations)@@ -21,7 +21,7 @@ Antes de usar a integração com o Slack, certifique-se de que você tenha:### 1. Conecte seu Workspace do Slack-1. Acesse [CrewAI AOP Integrações](https://app.crewai.com/crewai_plus/connectors)+1. Acesse [CrewAI AMP Integrações](https://app.crewai.com/crewai_plus/connectors)2. Encontre **Slack** na seção Integrações de Autenticação3. Clique em **Conectar** e complete o fluxo OAuth4. Conceda as permissões necessárias para comunicação em equipe@@ -36,7 +36,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:**- Nenhum parâmetro necessário – recupera todos os membros do canal+</Accordion><Accordion title="slack/get_user_by_email">@@ -66,6 +68,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `email` (string, obrigatório): O endereço de e-mail de um usuário do workspace+</Accordion><Accordion title="slack/get_users_by_name">@@ -76,6 +79,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `displayName` (string, obrigatório): Nome de exibição do usuário para a pesquisa- `paginationParameters` (object, opcional): Configurações de paginação- `pageCursor` (string, opcional): Cursor de página para paginação+</Accordion></AccordionGroup>@@ -87,6 +91,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- Nenhum parâmetro necessário – recupera todos os canais acessíveis+</Accordion></AccordionGroup>@@ -103,6 +108,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `botIcon` (string, obrigatório): Ícone do bot – Pode ser uma URL de imagem ou um emoji (ex.: ":dog:")- `blocks` (object, opcional): JSON do Slack Block Kit para mensagens ricas com anexos e elementos interativos- `authenticatedUser` (boolean, opcional): Se verdadeiro, a mensagem aparecerá como enviada pelo seu usuário autenticado do Slack ao invés do aplicativo (por padrão é falso)+</Accordion><Accordion title="slack/send_direct_message">@@ -115,6 +121,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `botIcon` (string, obrigatório): Ícone do bot – Pode ser uma URL de imagem ou um emoji (ex.: ":dog:")- `blocks` (object, opcional): JSON do Slack Block Kit para formatação rica com anexos e elementos interativos- `authenticatedUser` (boolean, opcional): Se verdadeiro, a mensagem aparecerá como enviada pelo seu usuário autenticado do Slack (padrão é falso)+</Accordion></AccordionGroup>@@ -132,6 +139,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `from:@john in:#general` – Busca mensagens do John no canal #general- `has:link after:2023-01-01` – Busca mensagens com links após 1º de janeiro de 2023- `in:@channel before:yesterday` – Busca mensagens em um canal específico antes de ontem+</Accordion></AccordionGroup>@@ -140,6 +148,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_tokenO Block Kit do Slack permite criar mensagens ricas e interativas. Veja alguns exemplos de como usar o parâmetro `blocks`:### Texto Simples com Anexo+```json[{@@ -154,6 +163,7 @@ O Block Kit do Slack permite criar mensagens ricas e interativas. Veja alguns ex```### Formatação Rica com Seções+```json[{@@ -299,5 +309,6 @@ crew.kickoff()## Fale com o Suporte<Card title="Precisa de Ajuda?" icon="headset" href="mailto:[email protected]">- Entre em contato com nossa equipe de suporte para obter ajuda na configuração ou solução de problemas da integração com o Slack.+ Entre em contato com nossa equipe de suporte para obter ajuda na configuração+ ou solução de problemas da integração com o Slack.</Card>diff --git a/docs/pt-BR/enterprise/integrations/stripe.mdx b/docs/pt-BR/enterprise/integrations/stripe.mdxindex 0e1cebbd3..d8ee50ba1 100644--- a/docs/pt-BR/enterprise/integrations/stripe.mdx+++ b/docs/pt-BR/enterprise/integrations/stripe.mdx@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem pagamentos, assinaturas e faturamento de clieAntes de usar a integração com o Stripe, certifique-se de que você tem:-- Uma conta [CrewAI AOP](https://app.crewai.com) com uma assinatura ativa+- Uma conta [CrewAI AMP](https://app.crewai.com) com uma assinatura ativa- Uma conta Stripe com permissões apropriadas de API- Sua conta Stripe conectada através da [página de Integrações](https://app.crewai.com/integrations)@@ -21,7 +21,7 @@ Antes de usar a integração com o Stripe, certifique-se de que você tem:### 1. Conecte sua Conta Stripe-1. Acesse [CrewAI AOP Integrações](https://app.crewai.com/crewai_plus/connectors)+1. Acesse [CrewAI AMP Integrações](https://app.crewai.com/crewai_plus/connectors)2. Encontre **Stripe** na seção Integrações de Autenticação3. Clique em **Conectar** e complete o fluxo OAuth4. Conceda as permissões necessárias para processamento de pagamentos@@ -36,7 +36,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@@ -62,6 +63,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `name` (string, opcional): Nome completo do cliente- `description` (string, opcional): Descrição do cliente para referência interna- `metadataCreateCustomer` (objeto, opcional): Metadados adicionais como pares chave-valor (exemplo: `{"field1": 1, "field2": 2}`)+</Accordion><Accordion title="stripe/get_customer_by_id">@@ -69,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `idGetCustomer` (string, obrigatório): O ID do cliente Stripe a ser recuperado+</Accordion><Accordion title="stripe/get_customers">@@ -79,6 +82,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `createdAfter` (string, opcional): Filtra clientes criados após esta data (timestamp Unix)- `createdBefore` (string, opcional): Filtra clientes criados antes desta data (timestamp Unix)- `limitGetCustomers` (string, opcional): Número máximo de clientes a retornar (padrão: 10)+</Accordion><Accordion title="stripe/update_customer">@@ -90,6 +94,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `name` (string, opcional): Novo nome do cliente- `description` (string, opcional): Nova descrição do cliente- `metadataUpdateCustomer` (objeto, opcional): Novos metadados como pares chave-valor+</Accordion></AccordionGroup>@@ -103,6 +108,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `customerIdCreateSubscription` (string, obrigatório): O ID do cliente para o qual a assinatura será criada- `plan` (string, obrigatório): O ID do plano para assinatura - Use as Configurações do Workflow do Portal Connect para permitir que usuários selecionem um plano- `metadataCreateSubscription` (objeto, opcional): Metadados adicionais para a assinatura+</Accordion><Accordion title="stripe/get_subscriptions">@@ -112,6 +118,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `customerIdGetSubscriptions` (string, opcional): Filtra assinaturas por ID do cliente- `subscriptionStatus` (string, opcional): Filtra por status da assinatura - Opções: incomplete, incomplete_expired, trialing, active, past_due, canceled, unpaid- `limitGetSubscriptions` (string, opcional): Número máximo de assinaturas a retornar (padrão: 10)+</Accordion></AccordionGroup>@@ -125,6 +132,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `productName` (string, obrigatório): Nome do produto- `description` (string, opcional): Descrição do produto- `metadataProduct` (objeto, opcional): Metadados adicionais do produto como pares chave-valor+</Accordion><Accordion title="stripe/get_product_by_id">@@ -132,6 +140,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `productId` (string, obrigatório): O ID do produto Stripe a ser recuperado+</Accordion><Accordion title="stripe/get_products">@@ -141,6 +150,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `createdAfter` (string, opcional): Filtra produtos criados após esta data (timestamp Unix)- `createdBefore` (string, opcional): Filtra produtos criados antes desta data (timestamp Unix)- `limitGetProducts` (string, opcional): Número máximo de produtos a retornar (padrão: 10)+</Accordion></AccordionGroup>@@ -154,6 +164,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `balanceTransactionType` (string, opcional): Filtra por tipo de transação - Opções: charge, refund, payment, payment_refund- `paginationParameters` (objeto, opcional): Configurações de paginação- `pageCursor` (string, opcional): Cursor da página para paginação+</Accordion><Accordion title="stripe/get_plans">@@ -163,6 +174,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `isPlanActive` (boolean, opcional): Filtra por status do plano - true para planos ativos, false para inativos- `paginationParameters` (objeto, opcional): Configurações de paginação- `pageCursor` (string, opcional): Cursor da página para paginação+</Accordion></AccordionGroup>diff --git a/docs/pt-BR/enterprise/integrations/zendesk.mdx b/docs/pt-BR/enterprise/integrations/zendesk.mdxindex 663a13f9c..db22e1b93 100644--- a/docs/pt-BR/enterprise/integrations/zendesk.mdx+++ b/docs/pt-BR/enterprise/integrations/zendesk.mdx@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem operações de suporte ao cliente através doAntes de usar a integração com o Zendesk, certifique-se de que você possui:-- Uma conta [CrewAI AOP](https://app.crewai.com) com uma assinatura ativa+- Uma conta [CrewAI AMP](https://app.crewai.com) com uma assinatura ativa- Uma conta Zendesk com permissões apropriadas de API- Sua conta Zendesk conectada através da [página de Integrações](https://app.crewai.com/integrations)@@ -21,7 +21,7 @@ Antes de usar a integração com o Zendesk, certifique-se de que você possui:### 1. Conecte sua Conta Zendesk-1. Acesse [CrewAI AOP Integrações](https://app.crewai.com/crewai_plus/connectors)+1. Acesse [CrewAI AMP Integrações](https://app.crewai.com/crewai_plus/connectors)2. Encontre **Zendesk** na seção Integrações de Autenticação3. Clique em **Conectar** e complete o fluxo OAuth4. Conceda as permissões necessárias para gerenciamento de tickets e usuários@@ -36,7 +36,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@@ -70,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `ticketTags` (string, opcional): Array de tags a aplicar (ex.: `["enterprise", "outra_tag"]`)- `ticketExternalId` (string, opcional): ID externo para vincular tickets a registros locais- `ticketCustomFields` (object, opcional): Valores de campos personalizados em formato JSON+</Accordion><Accordion title="zendesk/update_ticket">@@ -88,6 +90,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `ticketTags` (string, opcional): Array de tags atualizadas- `ticketExternalId` (string, opcional): Novo ID externo- `ticketCustomFields` (object, opcional): Valores atualizados dos campos personalizados+</Accordion><Accordion title="zendesk/get_ticket_by_id">@@ -95,6 +98,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `ticketId` (string, obrigatório): ID do ticket a ser recuperado (ex.: "35436")+</Accordion><Accordion title="zendesk/add_comment_to_ticket">@@ -105,6 +109,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `commentBody` (string, obrigatório): Mensagem do comentário (aceita texto simples ou HTML, ex.: "Obrigado pela sua ajuda!")- `isInternalNote` (boolean, opcional): Defina como verdadeiro para notas internas ao invés de respostas públicas (padrão é falso)- `isPublic` (boolean, opcional): Verdadeiro para comentários públicos, falso para notas internas+</Accordion><Accordion title="zendesk/search_tickets">@@ -126,6 +131,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `dueDate` (object, opcional): Filtrar por data de vencimento com operador e valor- `sort_by` (string, opcional): Campo de ordenação - Opções: created_at, updated_at, priority, status, ticket_type- `sort_order` (string, opcional): Direção da ordenação - Opções: asc, desc+</Accordion></AccordionGroup>@@ -143,6 +149,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `externalId` (string, opcional): Identificador único de outro sistema- `details` (string, opcional): Detalhes adicionais do usuário- `notes` (string, opcional): Notas internas sobre o usuário+</Accordion><Accordion title="zendesk/update_user">@@ -157,6 +164,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `externalId` (string, opcional): Novo ID externo- `details` (string, opcional): Novos detalhes do usuário- `notes` (string, opcional): Novas notas internas+</Accordion><Accordion title="zendesk/get_user_by_id">@@ -164,6 +172,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `userId` (string, obrigatório): ID do usuário a ser recuperado+</Accordion><Accordion title="zendesk/search_users">@@ -176,6 +185,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `externalId` (string, opcional): Filtrar por ID externo- `sort_by` (string, opcional): Campo de ordenação - Opções: created_at, updated_at- `sort_order` (string, opcional): Direção de ordenação - Opções: asc, desc+</Accordion></AccordionGroup>@@ -188,6 +198,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token**Parâmetros:**- `paginationParameters` (object, opcional): Configurações de paginação- `pageCursor` (string, opcional): Cursor de página para paginação+</Accordion><Accordion title="zendesk/get_ticket_audits">@@ -197,6 +208,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token- `ticketId` (string, opcional): Obtenha auditorias para um ticket específico (se vazio, recupera auditorias de todos os tickets não arquivados, ex.: "1234")- `paginationParameters` (object, opcional): Configurações de paginação- `pageCursor` (string, opcional): Cursor de página para paginação+</Accordion></AccordionGroup>diff --git a/docs/pt-BR/enterprise/introduction.mdx b/docs/pt-BR/enterprise/introduction.mdxindex 5bbd7f785..d9081ac71 100644--- a/docs/pt-BR/enterprise/introduction.mdx+++ b/docs/pt-BR/enterprise/introduction.mdx@@ -1,5 +1,5 @@----title: "CrewAI AOP"+title: "CrewAI AMP"description: "Implemente, monitore e escale seus fluxos de trabalho de agentes de IA"icon: "globe"mode: "wide"@@ -7,22 +7,27 @@ mode: "wide"## Introdução-CrewAI AOP(Agent Operation Platform) fornece uma plataforma para implementar, monitorar e escalar seus crews e agentes em um ambiente de produção.+CrewAI AMP(Agent Management Platform) fornece uma plataforma para implementar, monitorar e escalar seus crews e agentes em um ambiente de produção.<Frame>- <img src="/images/enterprise/crewai-enterprise-dashboard.png" alt="CrewAI AOP Dashboard" />+ <img+ src="/images/enterprise/crewai-enterprise-dashboard.png"+ alt="CrewAI AMP Dashboard"+ /></Frame>-CrewAI AOP expande o poder do framework open-source com funcionalidades projetadas para implantações em produção, colaboração e escalabilidade. Implemente seus crews em uma infraestrutura gerenciada e monitore sua execução em tempo real.+CrewAI AMP expande o poder do framework open-source com funcionalidades projetadas para implantações em produção, colaboração e escalabilidade. Implemente seus crews em uma infraestrutura gerenciada e monitore sua execução em tempo real.## Principais Funcionalidades<CardGroup cols={2}><Card title="Implantação de Crews" icon="rocket">- Implemente seus crews em uma infraestrutura gerenciada com apenas alguns cliques+ Implemente seus crews em uma infraestrutura gerenciada com apenas alguns+ cliques</Card><Card title="Acesso via API" icon="code">- Acesse seus crews implantados via REST API para integração com sistemas existentes+ Acesse seus crews implantados via REST API para integração com sistemas+ existentes</Card><Card title="Observabilidade" icon="chart-line">Monitore seus crews com rastreamentos de execução e logs detalhados@@ -42,7 +47,8 @@ CrewAI AOP expande o poder do framework open-source com funcionalidades projetad<CardGroup cols={3}><Card title="Integração com GitHub" icon="github">- Conecte-se diretamente aos seus repositórios do GitHub para implementar código+ Conecte-se diretamente aos seus repositórios do GitHub para implementar+ código</Card><Card title="Crew Studio" icon="palette">Implemente crews criados pela interface no-code do Crew Studio@@ -57,11 +63,7 @@ CrewAI AOP expande o poder do framework open-source com funcionalidades projetad<Steps><Step title="Cadastre-se para uma conta">Crie sua conta em [app.crewai.com](https://app.crewai.com)- <Card- title="Cadastre-se"- icon="user"- href="https://app.crewai.com/signup"- >+ <Card title="Cadastre-se" icon="user" href="https://app.crewai.com/signup">Cadastre-se</Card></Step>diff --git a/docs/pt-BR/enterprise/resources/frequently-asked-questions.mdx b/docs/pt-BR/enterprise/resources/frequently-asked-questions.mdxindex 83e8b884a..245f9a35b 100644--- a/docs/pt-BR/enterprise/resources/frequently-asked-questions.mdx+++ b/docs/pt-BR/enterprise/resources/frequently-asked-questions.mdx@@ -1,6 +1,6 @@---title: FAQs-description: "Perguntas frequentes sobre CrewAI AOP"+description: "Perguntas frequentes sobre CrewAI AMP"icon: "circle-question"mode: "wide"---@@ -148,4 +148,5 @@ mode: "wide"<Accordion title="Como controlar o número máximo de solicitações por minuto que toda a crew pode realizar?">O atributo `max_rpm` define o número máximo de solicitações por minuto que a crew pode realizar para evitar limites de taxa, e irá sobrescrever as definições de `max_rpm` dos agentes individuais se você defini-lo.</Accordion>+</AccordionGroup>diff --git a/docs/pt-BR/installation.mdx b/docs/pt-BR/installation.mdxindex f940ae745..0331b04cc 100644--- a/docs/pt-BR/installation.mdx+++ b/docs/pt-BR/installation.mdx@@ -6,6 +6,7 @@ mode: "wide"---## Tutorial em Vídeo+Assista a este tutorial em vídeo para uma demonstração passo a passo do processo de instalação:<iframe@@ -18,15 +19,18 @@ Assista a este tutorial em vídeo para uma demonstração passo a passo do proce></iframe>## Tutorial em Texto+<Note>**Requisitos de Versão do Python**- CrewAI requer `Python >=3.10 e <3.14`. Veja como verificar sua versão:- ```bash- python3 --version- ```+CrewAI requer `Python >=3.10 e <3.14`. Veja como verificar sua versão:++```bash+python3 --version+```++Se você precisar atualizar o Python, acesse [python.org/downloads](https://python.org/downloads)- Se você precisar atualizar o Python, acesse [python.org/downloads](https://python.org/downloads)</Note>CrewAI utiliza o `uv` como ferramenta de gerenciamento de dependências e pacotes. Ele simplifica a configuração e execução do projeto, oferecendo uma experiência fluida.@@ -89,6 +93,7 @@ Se você ainda não instalou o `uv`, siga o **passo 1** para instalá-lo rapidam```<Check>Instalação realizada com sucesso! Você está pronto para criar seu primeiro crew! 🎉</Check></Step>+</Steps># Criando um Projeto CrewAI@@ -124,6 +129,7 @@ Recomendamos utilizar o template de scaffolding `YAML` para uma abordagem estrut└── tasks.yaml```</Frame>+</Step><Step title="Personalize Seu Projeto">@@ -140,6 +146,7 @@ Recomendamos utilizar o template de scaffolding `YAML` para uma abordagem estrut- Comece editando `agents.yaml` e `tasks.yaml` para definir o comportamento do seu crew.- Mantenha informações sensíveis como chaves de API no arquivo `.env`.+</Step><Step title="Execute seu Crew">@@ -163,13 +170,15 @@ Recomendamos utilizar o template de scaffolding `YAML` para uma abordagem estrut<Note type="info">Para equipes e organizações, o CrewAI oferece opções de implantação corporativa que eliminam a complexidade da configuração:-### CrewAI AOP (SaaS)+### CrewAI AMP (SaaS)+- Zero instalação necessária - basta se cadastrar gratuitamente em [app.crewai.com](https://app.crewai.com)- Atualizações e manutenção automáticas- Infraestrutura e escalabilidade gerenciadas- Construa crews sem código### CrewAI Factory (Auto-Hospedado)+- Implantação containerizada para sua infraestrutura- Compatível com qualquer hyperscaler, incluindo ambientes on-premises- Integração com seus sistemas de segurança existentes@@ -187,13 +196,15 @@ Para equipes e organizações, o CrewAI oferece opções de implantação corporicon="code"href="/pt-BR/quickstart">- Siga nosso guia de início rápido para criar seu primeiro agente CrewAI e obter experiência prática.+ Siga nosso guia de início rápido para criar seu primeiro agente CrewAI e+ obter experiência prática.</Card><Cardtitle="Junte-se à Comunidade"icon="comments"href="https://community.crewai.com">- Conecte-se com outros desenvolvedores, obtenha ajuda e compartilhe suas experiências com o CrewAI.+ Conecte-se com outros desenvolvedores, obtenha ajuda e compartilhe suas+ experiências com o CrewAI.</Card></CardGroup>diff --git a/docs/pt-BR/learn/llm-selection-guide.mdx b/docs/pt-BR/learn/llm-selection-guide.mdxindex 07ca4a1e0..ce85c3351 100644--- a/docs/pt-BR/learn/llm-selection-guide.mdx+++ b/docs/pt-BR/learn/llm-selection-guide.mdx@@ -1,7 +1,7 @@----title: 'Guia Estratégico de Seleção de LLMs'-description: 'Framework estratégico para escolher o LLM certo para seus agentes CrewAI e escrever definições eficazes de tarefas e agentes'-icon: 'brain-circuit'+title: "Guia Estratégico de Seleção de LLMs"+description: "Framework estratégico para escolher o LLM certo para seus agentes CrewAI e escrever definições eficazes de tarefas e agentes"+icon: "brain-circuit"mode: "wide"---@@ -10,23 +10,36 @@ mode: "wide"Em vez de recomendações prescritivas de modelos, defendemos um **framework de pensamento** que ajude você a tomar decisões informadas com base no seu caso de uso, restrições e requisitos específicos. O cenário de LLMs evolui rapidamente, com novos modelos surgindo regularmente e os existentes sendo atualizados frequentemente. O que mais importa é desenvolver uma abordagem sistemática de avaliação que permaneça relevante independentemente dos modelos disponíveis no momento.<Note>-Este guia foca em pensamento estratégico em vez de recomendações de modelos específicos, já que o cenário dos LLMs evolui rapidamente.+ Este guia foca em pensamento estratégico em vez de recomendações de modelos+ específicos, já que o cenário dos LLMs evolui rapidamente.</Note>## Framework de Decisão Rápida<Steps><Step title="Analise Suas Tarefas">- Comece entendendo profundamente o que suas tarefas realmente exigem. Considere a complexidade cognitiva envolvida, a profundidade de raciocínio necessária, o formato dos resultados esperados e a quantidade de contexto que o modelo precisará processar. Essa análise fundamental guiará todas as decisões seguintes.+ Comece entendendo profundamente o que suas tarefas realmente exigem.+ Considere a complexidade cognitiva envolvida, a profundidade de raciocínio+ necessária, o formato dos resultados esperados e a quantidade de contexto+ que o modelo precisará processar. Essa análise fundamental guiará todas as+ decisões seguintes.</Step><Step title="Mapeie as Capacidades dos Modelos">- Assim que você compreende seus requisitos, mapeie-os para as forças dos modelos. Diferentes famílias de modelos se destacam em diferentes tipos de trabalho; alguns são otimizados para raciocínio e análise, outros para criatividade e geração de conteúdo, e outros para velocidade e eficiência.+ Assim que você compreende seus requisitos, mapeie-os para as forças dos+ modelos. Diferentes famílias de modelos se destacam em diferentes tipos de+ trabalho; alguns são otimizados para raciocínio e análise, outros para+ criatividade e geração de conteúdo, e outros para velocidade e eficiência.</Step><Step title="Considere Restrições">- Leve em conta suas reais restrições operacionais, incluindo limitações orçamentárias, requisitos de latência, necessidades de privacidade de dados e capacidades de infraestrutura. O melhor modelo teoricamente pode não ser a melhor escolha prática para sua situação.+ Leve em conta suas reais restrições operacionais, incluindo limitações+ orçamentárias, requisitos de latência, necessidades de privacidade de dados+ e capacidades de infraestrutura. O melhor modelo teoricamente pode não ser a+ melhor escolha prática para sua situação.</Step><Step title="Teste e Itere">- Comece com modelos confiáveis e bem conhecidos e otimize com base no desempenho real no seu caso de uso. Os resultados práticos frequentemente diferem dos benchmarks teóricos, então testes empíricos são cruciais.+ Comece com modelos confiáveis e bem conhecidos e otimize com base no+ desempenho real no seu caso de uso. Os resultados práticos frequentemente+ diferem dos benchmarks teóricos, então testes empíricos são cruciais.</Step></Steps>@@ -43,6 +56,7 @@ O passo mais crítico na seleção de LLMs é entender o que sua tarefa realment- **Tarefas Complexas** exigem raciocínio de múltiplas etapas, pensamento estratégico e a capacidade de lidar com informações ambíguas ou incompletas. Podem envolver análise de múltiplas fontes de dados, desenvolvimento de estratégias abrangentes ou resolução de problemas que precisam ser decompostos em componentes menores. O modelo deve manter o contexto ao longo de várias etapas de raciocínio e frequentemente precisa inferir informações não explicitamente declaradas.- **Tarefas Criativas** exigem um tipo diferente de capacidade cognitiva, focada em gerar conteúdo novo, envolvente e adequado ao contexto. Isso inclui storytelling, criação de textos de marketing e solução criativa de problemas. O modelo deve compreender nuances, tom e público, produzindo conteúdo autêntico e envolvente, não apenas fórmulas.+</Tab><Tab title="Requisitos de Saída">@@ -51,6 +65,7 @@ O passo mais crítico na seleção de LLMs é entender o que sua tarefa realment- **Conteúdo Criativo** requer equilíbrio entre competência técnica e criatividade. O modelo precisa compreender o público, tom e voz da marca, ao mesmo tempo em que produz conteúdo que engaja leitores e atinge objetivos comunicativos específicos. A qualidade aqui é mais subjetiva e exige modelos capazes de adaptar o estilo de escrita a diferentes contextos e propósitos.- **Conteúdo Técnico** situa-se entre dados estruturados e conteúdo criativo, demandando precisão e clareza. Documentação, geração de código e análises técnicas precisam ser exatas e completas, mas ainda assim acessíveis ao público-alvo. O modelo deve entender conceitos técnicos complexos e comunicá-los de forma eficaz.+</Tab><Tab title="Necessidades de Contexto">@@ -59,6 +74,7 @@ O passo mais crítico na seleção de LLMs é entender o que sua tarefa realment- **Contexto Longo** é necessário ao lidar com documentos substanciais, conversas extensas ou tarefas complexas de múltiplas partes. O modelo precisa manter coerência ao longo de milhares de tokens, referenciando informações anteriores com precisão. Essencial para análise de documentos, pesquisa abrangente e sistemas de diálogo sofisticados.- **Contexto Muito Longo** ultrapassa os limites do possível hoje, com processamento de documentos massivos, síntese de pesquisas extensas ou interações multi-sessão. São casos que exigem modelos projetados especificamente para lidar com contexto estendido e envolvem trade-offs entre extensão e velocidade.+</Tab></Tabs>@@ -73,6 +89,7 @@ Entender as capacidades dos modelos exige ir além do marketing e dos benchmarksO ponto forte é manter consistência lógica em cadeias longas de raciocínio e decompor problemas complexos em partes gerenciáveis. São especialmente valiosos para planejamento estratégico, análise complexa e situações onde a qualidade do raciocínio importa mais que a velocidade.Entretanto, há trade-offs em termos de custo e velocidade. Podem ser menos adequados para tarefas criativas ou operações simples, onde suas capacidades avançadas não são necessárias. Considere-os quando as tarefas realmente se beneficiarem dessa análise detalhada.+</Accordion><Accordion title="Modelos de Uso Geral" icon="microchip">@@ -81,6 +98,7 @@ Entender as capacidades dos modelos exige ir além do marketing e dos benchmarksA principal vantagem é a confiabilidade previsível em diversos trabalhos: pesquisa, análise, criação de conteúdo, processamento de dados. São ótimas opções iniciais para equipes que buscam consistência ao lidar com fluxos variados.Embora não atinjam picos de desempenho como modelos especializados, oferecem simplicidade operacional e baixa complexidade na gestão. São o melhor ponto de partida para novos projetos, permitindo descobertas de necessidades antes de avançar para otimizações.+</Accordion><Accordion title="Modelos Rápidos & Eficientes" icon="bolt">@@ -89,6 +107,7 @@ Entender as capacidades dos modelos exige ir além do marketing e dos benchmarksBrilham em operações rotineiras, processamento simples de dados, chamadas de funções e tarefas de alto volume. Aplicações que processam muitos pedidos rapidamente ou operam sob restrições orçamentárias se beneficiam desses modelos.O ponto crucial é garantir que suas capacidades atendam às exigências da tarefa. Podem não atender tarefas que exijam entendimento profundo, raciocínio complexo ou geração de conteúdo sofisticado. São ideais para tarefas rotineiras bem definidas.+</Accordion><Accordion title="Modelos Criativos" icon="pen">@@ -97,6 +116,7 @@ Entender as capacidades dos modelos exige ir além do marketing e dos benchmarksO ponto forte está em adaptar o estilo para diferentes públicos, manter voz e tom consistentes e engajar leitores. Performam melhor em storytelling, textos publicitários, comunicações de marca e outras tarefas com criatividade como foco.Ao selecionar esses modelos, considere não apenas a habilidade de gerar texto, mas a compreensão de público, contexto e objetivo. Os melhores modelos criativos adaptam a saída à voz da marca, diferentes segmentos e mantêm consistência em peças longas.+</Accordion><Accordion title="Modelos Open Source" icon="code">@@ -105,6 +125,7 @@ Entender as capacidades dos modelos exige ir além do marketing e dos benchmarksOs principais benefícios incluem eliminação de custos por token, possibilidade de fine-tuning, privacidade total e independência de fornecedores externos. Perfeitos para organizações com necessidade de privacidade, orçamento limitado ou desejo de customização.Contudo, requerem maior expertise técnica para implantar e manter. Considere custos de infraestrutura, complexidade de gestão e esforços contínuos de atualização e otimização ao avaliar modelos open source. O custo total pode ser maior que o de alternativas em nuvem devido a esse overhead.+</Accordion></AccordionGroup>@@ -113,7 +134,8 @@ Entender as capacidades dos modelos exige ir além do marketing e dos benchmarks### a. Abordagem Multi-Modelo<Tip>-Use diferentes modelos para diferentes propósitos dentro da mesma crew para otimizar desempenho e custos.+ Use diferentes modelos para diferentes propósitos dentro da mesma crew para+ otimizar desempenho e custos.</Tip>As implementações CrewAI mais sofisticadas empregam múltiplos modelos estrategicamente, designando-os conforme as funções e necessidades dos agentes. Assim, é possível otimizar desempenho e custos usando o modelo mais adequado para cada tipo de tarefa.@@ -177,6 +199,7 @@ O segredo do sucesso na implementação multi-modelo está em entender como os aLLMs de manager eficazes exigem forte raciocínio para delegar bem, desempenho consistente para coordenar previsivelmente e excelente gestão de contexto para acompanhar o estado dos agentes. O modelo deve entender capacidades e limitações dos agentes enquanto otimiza a alocação de tarefas.O custo é especialmente relevante, já que este LLM participa de todas as operações. O modelo precisa entregar capacidades suficientes, sem o preço premium de opções sofisticadas demais, buscando sempre o equilíbrio entre performance e valor.+</Tab><Tab title="Function Calling LLM">@@ -185,6 +208,7 @@ O segredo do sucesso na implementação multi-modelo está em entender como os aAs características mais importantes são precisão e confiabilidade, não criatividade ou raciocínio avançado. O modelo deve extrair parâmetros corretos de comandos em linguagem natural consistentemente e processar respostas de ferramentas adequadamente. Velocidade também importa, pois o uso de ferramentas pode envolver múltiplas idas e vindas de informação.Muitas equipes descobrem que modelos especializados em function calling ou de uso geral com forte suporte a ferramentas funcionam melhor do que modelos criativos ou de raciocínio nesse papel. O fundamental é assegurar que o modelo consiga converter instruções em chamadas estruturadas sem falhas.+</Tab><Tab title="Sobrescritas Específicas de Agente">@@ -193,6 +217,7 @@ O segredo do sucesso na implementação multi-modelo está em entender como os aConsidere sobrescritas quando a função do agente exige capacidades distintas. Por exemplo, um agente de redação criativa pode se beneficiar de um LLM otimizado para geração de conteúdo, enquanto um analista de dados pode preferir um modelo voltado ao raciocínio.O desafio é balancear otimização com complexidade operacional. Cada modelo adicional aumenta a complexidade de deployment, monitoramento e custos. Foque em sobrescritas apenas quando a melhoria justificar essa complexidade.+</Tab></Tabs>@@ -209,6 +234,7 @@ Definir bem as tarefas é frequentemente mais importante do que a seleção do mDescrições eficazes incluem contexto relevante e restrições, ajudando o agente a entender o propósito maior e quaisquer limitações. Divida trabalhos complexos em etapas gerenciáveis em vez de objetivos genéricos e sobrecarregados.Erros comuns incluem objetivos vagos, falta de contexto, critérios de sucesso mal definidos ou mistura de tarefas totalmente distintas em um mesmo texto. O objetivo é passar informação suficiente para o sucesso, mas mantendo foco no resultado claro.+</Accordion><Accordion title="Diretrizes para a Saída Esperada" icon="bullseye">@@ -217,6 +243,7 @@ Definir bem as tarefas é frequentemente mais importante do que a seleção do mAs melhores diretrizes incluem exemplos concretos de indicadores de qualidade e critérios claros de conclusão, de modo que agente e revisores humanos possam avaliar o resultado facilmente. Isso reduz ambiguidades e garante resultados consistentes.Evite descrições genéricas que serviriam para qualquer tarefa, ausência de especificações de formato, padrões vagos ou falta de exemplos/modelos que ajudem o agente a entender as expectativas.+</Accordion></AccordionGroup>@@ -229,6 +256,7 @@ Definir bem as tarefas é frequentemente mais importante do que a seleção do mPara implementar bem, use o parâmetro de contexto para encadear tarefas, desenvolvendo gradualmente a complexidade. Cada tarefa deve gerar saídas que alimentam as próximas. O objetivo é manter um fluxo lógico entre as tarefas dependentes, evitando gargalos desnecessários.Funciona melhor quando há progressão lógica evidente e quando a saída de uma tarefa realmente agrega valor nas etapas seguintes. Cuidado com os gargalos; foque nas dependências essenciais.+</Tab><Tab title="Execução Paralela">@@ -237,6 +265,7 @@ Definir bem as tarefas é frequentemente mais importante do que a seleção do mPara isso, identifique tarefas realmente independentes, agrupe fluxos de trabalho distintos e planeje a integração dos resultados posteriormente. O ponto-chave é garantir que tarefas paralelas não gerem conflitos ou redundâncias.Considere o paralelo em múltiplos fluxos independentes, diferentes tipos de análise autônoma, ou criação de conteúdo que pode ser feita ao mesmo tempo. Mas atente-se à alocação de recursos, evitando sobrecarga de modelos ou estouro no orçamento.+</Tab></Tabs>@@ -245,7 +274,8 @@ Definir bem as tarefas é frequentemente mais importante do que a seleção do m### a. Seleção de LLM Guiada pelo Papel<Warning>-Funções genéricas de agentes tornam impossível escolher o LLM certo. Funções específicas permitem otimização do modelo conforme a função.+ Funções genéricas de agentes tornam impossível escolher o LLM certo. Funções+ específicas permitem otimização do modelo conforme a função.</Warning>A especificidade das funções dos agentes determina quais capacidades de LLM mais importam para alto desempenho, criando oportunidade estratégica de alinhar forças do modelo ao papel do agente.@@ -253,6 +283,7 @@ A especificidade das funções dos agentes determina quais capacidades de LLM ma**Impacto de Funções Genéricas vs. Específicas:**Ao definir funções, pense no conhecimento do domínio, estilo de trabalho e frameworks decisórios mais valiosos para o tipo de tarefa do agente. Quanto mais específica e contextualizada a função, melhor o modelo incorporará esse papel.+```python# ✅ Função específica - requisitos claros de LLMspecific_agent = Agent(@@ -273,7 +304,8 @@ specific_agent = Agent(### b. Backstory como Amplificador de Contexto do Modelo<Info>-Backstories estratégicos maximizam a eficácia do LLM ao contextualizar as respostas de forma que prompts genéricos não conseguem.+ Backstories estratégicos maximizam a eficácia do LLM ao contextualizar as+ respostas de forma que prompts genéricos não conseguem.</Info>Um bom backstory transforma a escolha do LLM de genérica a especializada. Isso é crucial para otimizar custos: um modelo eficiente com contexto certo pode superar um premium sem contexto.@@ -300,6 +332,7 @@ domain_expert = Agent(```**Elementos de Backstory que Potencializam a Performance de LLMs:**+- **Experiência de Domínio**: "10+ anos em vendas enterprise SaaS"- **Expertise Específica**: "Especialista em due diligence técnica para Série B+"- **Estilo de Trabalho**: "Decisões orientadas a dados, documentação clara"@@ -332,6 +365,7 @@ tech_writer = Agent(```**Checklist de Alinhamento:**+- ✅ **Função Específica**: Domínio e responsabilidades claras- ✅ **Correspondência do LLM**: Forças do modelo conectadas à função- ✅ **Profundidade do Backstory**: Contexto de domínio disponível pro modelo@@ -353,6 +387,7 @@ Em vez de repetir o framework estratégico, segue um checklist tático para impl- Algum agente depende fortemente de ferramentas?**Ação**: Documente funções dos agentes e identifique oportunidades de otimização.+</Step><Step title="Implemente Estratégia no Nível da Crew" icon="users-gear">@@ -369,6 +404,7 @@ Em vez de repetir o framework estratégico, segue um checklist tático para impl```**Ação**: Defina o LLM padrão da crew antes de otimizar agentes individuais.+</Step><Step title="Otimize Agentes de Maior Impacto" icon="star">@@ -390,16 +426,18 @@ Em vez de repetir o framework estratégico, segue um checklist tático para impl```**Ação**: Faça upgrade dos 20% dos agentes que tratam 80% da complexidade.+</Step><Step title="Valide com Testes Empresariais" icon="test-tube">**Após colocar os agentes em produção:**- - Use [CrewAI AOP platform](https://app.crewai.com) para testar seleções de modelo A/B+ - Use [CrewAI AMP platform](https://app.crewai.com) para testar seleções de modelo A/B- Execute múltiplas iterações com inputs reais para medir consistência e performance- Compare custo vs performance na configuração otimizada- Compartilhe resultados com o time para tomada coletiva de decisão**Ação**: Substitua achismos por validação com dados reais usando a plataforma de testes.+</Step></Steps>@@ -412,6 +450,7 @@ Em vez de repetir o framework estratégico, segue um checklist tático para implConsidere-os para desenvolvimento de estratégias de negócios, análise de dados combinados de múltiplas fontes, resolução de problemas dependente de etapas sucessivas e planejamento estratégico envolvendo múltiplas variáveis.Entretanto, esses modelos são mais caros e lentos, devendo ser reservados para tarefas onde suas capacidades agregam valor real — evite usá-los apenas para operações simples.+</Tab><Tab title="Modelos Criativos">@@ -420,6 +459,7 @@ Em vez de repetir o framework estratégico, segue um checklist tático para implUse-os em redação de posts, criação de artigos, textos de marketing com viés persuasivo, storytelling e comunicações da marca. Costumam captar nuances e contexto melhor do que generalistas.Podem ser menos adequados para tarefas técnicas ou analíticas, onde precisão supera criatividade. Use-os quando aspectos comunicativos são fatores críticos de sucesso.+</Tab><Tab title="Modelos Eficientes">@@ -428,6 +468,7 @@ Em vez de repetir o framework estratégico, segue um checklist tático para implConsidere-os para processamento e transformação de dados, formatação simples, chamadas de funções (function calling) e operações em alto volume onde custo importa mais.O ponto crítico é verificar adequação à tarefa. Funcionam para muitos fluxos rotineiros, mas podem falhar se a tarefa exigir compreensão técnica ou raciocínio.+</Tab><Tab title="Modelos Open Source">@@ -436,6 +477,7 @@ Em vez de repetir o framework estratégico, segue um checklist tático para implConsidere para ferramentas internas de empresas, aplicações sensíveis, projetos onde não é possível usar APIs externas, casos com orçamento apertado ou requisitos de customização.Mas lembre-se: exigem mais expertise, manutenção e investimentos em infraestrutura. Avalie o custo total da operação ao avaliar esses modelos.+</Tab></Tabs>@@ -455,6 +497,7 @@ Em vez de repetir o framework estratégico, segue um checklist tático para impl# Agente de processamento recebe modelo eficienteprocessor = Agent(role="Data Processor", llm=LLM(model="gpt-4o-mini"))```+</Accordion><Accordion title="Ignorar Hierarquia de LLM entre Crew e Agente" icon="shuffle">@@ -474,6 +517,7 @@ Em vez de repetir o framework estratégico, segue um checklist tático para impl# Agentes herdam o LLM da crew, salvo sobrescritaagent1 = Agent(llm=LLM(model="claude-3-5-sonnet"))```+</Accordion><Accordion title="Incompatibilidade para Function Calling" icon="screwdriver-wrench">@@ -492,6 +536,7 @@ Em vez de repetir o framework estratégico, segue um checklist tático para implllm=LLM(model="claude-3-5-sonnet"))```+</Accordion><Accordion title="Otimização Prematura sem Teste" icon="gear">@@ -507,6 +552,7 @@ Em vez de repetir o framework estratégico, segue um checklist tático para impl# Teste a performance e só depois otimize agentes específicos# Use testes Enterprise para validar melhorias```+</Accordion><Accordion title="Ignorar Limites de Contexto e Memória" icon="brain">@@ -515,6 +561,7 @@ Em vez de repetir o framework estratégico, segue um checklist tático para impl**Exemplo real**: Usar modelo de contexto curto para agentes que precisam manter histórico ao longo de múltiplas iterações ou equipes com comunicação extensiva agent-to-agent.**Solução CrewAI**: Alinhe capacidades de contexto ao padrão de comunicação da crew.+</Accordion></AccordionGroup>@@ -522,26 +569,36 @@ Em vez de repetir o framework estratégico, segue um checklist tático para impl<Steps><Step title="Comece Simples" icon="play">- Comece com modelos de uso geral, confiáveis e amplamente suportados. Isso estabelece base estável para entender necessidades e expectativas de desempenho antes de otimizar para demandas especializadas.+ Comece com modelos de uso geral, confiáveis e amplamente suportados. Isso+ estabelece base estável para entender necessidades e expectativas de+ desempenho antes de otimizar para demandas especializadas.</Step><Step title="Meça o que Importa" icon="chart-line">- Desenvolva métricas alinhadas ao seu caso de uso e metas de negócio, não apenas benchmarks gerais. Foque na mensuração de resultados relevantes ao seu sucesso.+ Desenvolva métricas alinhadas ao seu caso de uso e metas de negócio, não+ apenas benchmarks gerais. Foque na mensuração de resultados relevantes ao+ seu sucesso.</Step><Step title="Itere Baseado em Resultados" icon="arrows-rotate">- Faça mudanças baseadas no desempenho observado no seu contexto, não apenas considerações teóricas ou recomendações genéricas. O desempenho prático costuma ser bem diferente dos benchmarks.+ Faça mudanças baseadas no desempenho observado no seu contexto, não apenas+ considerações teóricas ou recomendações genéricas. O desempenho prático+ costuma ser bem diferente dos benchmarks.</Step><Step title="Considere o Custo Total" icon="calculator">- Avalie todo custo de operação, incluindo modelo, tempo de desenvolvimento, manutenção e complexidade. O modelo mais barato por token pode não ser o mais econômico ao considerar todos os fatores.+ Avalie todo custo de operação, incluindo modelo, tempo de desenvolvimento,+ manutenção e complexidade. O modelo mais barato por token pode não ser o+ mais econômico ao considerar todos os fatores.</Step></Steps><Tip>-Foque em entender seus requisitos primeiro, e então escolha modelos que melhor correspondam a essas necessidades. O melhor LLM é aquele que consistentemente entrega os resultados esperados dentro das suas restrições.+ Foque em entender seus requisitos primeiro, e então escolha modelos que melhor+ correspondam a essas necessidades. O melhor LLM é aquele que consistentemente+ entrega os resultados esperados dentro das suas restrições.</Tip>### Validação de Modelos em Nível Enterprise-Para equipes sérias sobre otimização, a **plataforma CrewAI AOP** oferece testes sofisticados que vão além do CLI. Ela permite avaliação completa para decisões orientadas por dados na estratégia de LLM.+Para equipes sérias sobre otimização, a **plataforma CrewAI AMP** oferece testes sofisticados que vão além do CLI. Ela permite avaliação completa para decisões orientadas por dados na estratégia de LLM.<Frame>@@ -562,7 +619,9 @@ Para equipes sérias sobre otimização, a **plataforma CrewAI AOP** oferece tesAcesse [app.crewai.com](https://app.crewai.com) para começar!<Info>-A plataforma Enterprise transforma a seleção de modelos de um "palpite" para um processo orientado por dados, permitindo validar os princípios deste guia com seus próprios casos de uso.+ A plataforma Enterprise transforma a seleção de modelos de um "palpite" para+ um processo orientado por dados, permitindo validar os princípios deste guia+ com seus próprios casos de uso.</Info>## Resumo dos Princípios-Chave@@ -572,21 +631,27 @@ A plataforma Enterprise transforma a seleção de modelos de um "palpite" para uEscolha os modelos pelo que sua tarefa realmente requer, não por reputação ou capacidades teóricas.</Card>- <Card title="Combinação de Capacidades" icon="puzzle-piece">- Alinhe forças do modelo a papéis e responsabilidades dos agentes para melhor desempenho.- </Card>+{" "}+<Card title="Combinação de Capacidades" icon="puzzle-piece">+ Alinhe forças do modelo a papéis e responsabilidades dos agentes para melhor+ desempenho.+</Card>- <Card title="Consistência Estratégica" icon="link">- Mantenha uma estratégia coerente de seleção de modelos em fluxos e componentes relacionados.- </Card>+{" "}+<Card title="Consistência Estratégica" icon="link">+ Mantenha uma estratégia coerente de seleção de modelos em fluxos e componentes+ relacionados.+</Card>- <Card title="Testes Práticos" icon="flask">- Valide escolhas em uso real, não apenas em benchmarks.- </Card>+{" "}+<Card title="Testes Práticos" icon="flask">+ Valide escolhas em uso real, não apenas em benchmarks.+</Card>- <Card title="Iteração Contínua" icon="arrow-up">- Comece simples e otimize com base na performance e necessidade práticas.- </Card>+{" "}+<Card title="Iteração Contínua" icon="arrow-up">+ Comece simples e otimize com base na performance e necessidade práticas.+</Card><Card title="Equilíbrio Operacional" icon="scale-balanced">Equilibre performance requerida, custo e complexidade.@@ -594,13 +659,19 @@ A plataforma Enterprise transforma a seleção de modelos de um "palpite" para u</CardGroup><Check>-Lembre-se: o melhor LLM é o que entrega consistentemente os resultados de que você precisa dentro de suas restrições. Conheça seu requisito primeiro, depois selecione o modelo mais adequado.+ Lembre-se: o melhor LLM é o que entrega consistentemente os resultados de que+ você precisa dentro de suas restrições. Conheça seu requisito primeiro, depois+ selecione o modelo mais adequado.</Check>## Panorama Atual dos Modelos (Junho/2025)<Warning>-**Retrato do Momento**: Os rankings a seguir representam o estado da arte em Junho de 2025, compilados do [LMSys Arena](https://arena.lmsys.org/), [Artificial Analysis](https://artificialanalysis.ai/) e outros benchmarks líderes. Performance, disponibilidade e preço mudam rapidamente. Sempre valide com seus dados e casos reais.+ **Retrato do Momento**: Os rankings a seguir representam o estado da arte em+ Junho de 2025, compilados do [LMSys Arena](https://arena.lmsys.org/),+ [Artificial Analysis](https://artificialanalysis.ai/) e outros benchmarks+ líderes. Performance, disponibilidade e preço mudam rapidamente. Sempre valide+ com seus dados e casos reais.</Warning>### Principais Modelos por Categoria@@ -608,7 +679,9 @@ Lembre-se: o melhor LLM é o que entrega consistentemente os resultados de que vAs tabelas abaixo mostram uma amostra dos modelos de maior destaque em cada categoria, junto de orientação sobre aplicação em agentes CrewAI:<Note>-Estas tabelas exibem apenas alguns modelos líderes por categoria. Existem muitos outros excelentes. O objetivo é ilustrar exemplos de capacidades buscadas em vez de apresentar um catálogo completo.+ Estas tabelas exibem apenas alguns modelos líderes por categoria. Existem+ muitos outros excelentes. O objetivo é ilustrar exemplos de capacidades+ buscadas em vez de apresentar um catálogo completo.</Note><Tabs>@@ -624,6 +697,7 @@ Estas tabelas exibem apenas alguns modelos líderes por categoria. Existem muito| **Qwen3 235B (Reasoning)** | 62 | $2.63 | Moderada | Alternativa open source para raciocínio |Esses modelos se destacam em raciocínio multi-etapas e são ideais para agentes que desenvolvem estratégias, coordenam outros agentes ou analisam informações complexas.+</Tab><Tab title="Codificação & Técnica">@@ -638,6 +712,7 @@ Estas tabelas exibem apenas alguns modelos líderes por categoria. Existem muito| **Llama 3.1 405B** | Bom | 81.1% | $3.50 | LLM para function calling em workflows intensivos em ferramentas |Otimizados para geração de código, debugging e solução técnica, ideais para equipes de desenvolvimento.+</Tab><Tab title="Velocidade & Eficiência">@@ -652,6 +727,7 @@ Estas tabelas exibem apenas alguns modelos líderes por categoria. Existem muito| **Nova Micro** | Alto | 0.30s | $0.04 | Execução rápida de tarefas simples |Priorizam velocidade e eficiência, perfeitos para agentes em operações de rotina ou resposta ágil. **Dica:** Usar provedores de inference rápidos como Groq potencializa open source como Llama.+</Tab><Tab title="Performance Equilibrada">@@ -666,6 +742,7 @@ Estas tabelas exibem apenas alguns modelos líderes por categoria. Existem muito| **Qwen3 32B** | 44 | Boa | $1.23 | Versatilidade econômica |Oferecem bom desempenho geral, adequados para crews com demandas amplas.+</Tab></Tabs>@@ -676,24 +753,28 @@ Estas tabelas exibem apenas alguns modelos líderes por categoria. Existem muito**Priorizando performance**: Use modelos topo de linha como **o3**, **Gemini 2.5 Pro** ou **Claude 4 Sonnet** para managers e agentes críticos. Excelentes em raciocínio e coordenação, porém mais caros.**Estratégia**: Implemente abordagem multi-modelo, reservando premium para raciocínio estratégico e eficientes para operações rotineiras.+</Accordion><Accordion title="Crews de Baixo Custo" icon="dollar-sign">**Foco no orçamento**: Foque em modelos como **DeepSeek R1**, **Llama 4 Scout** ou **Gemini 2.0 Flash**, que trazem ótimo desempenho com investimento reduzido.**Estratégia**: Use modelos econômicos para maioria dos agentes, reservando premium apenas para funções críticas.+</Accordion><Accordion title="Workflows Especializados" icon="screwdriver-wrench">**Para expertise específica**: Escolha modelos otimizados para seu principal caso de uso: **Claude 4** em código, **Gemini 2.5 Pro** em pesquisa, **Llama 405B** em function calling.**Estratégia**: Selecione conforme a principal função da crew, garantindo alinhamento de capacidade e modelo.+</Accordion><Accordion title="Empresa & Privacidade" icon="shield">**Para operações sensíveis**: Avalie modelos open source como **Llama 4** series, **DeepSeek V3** ou **Qwen3** para deployment privado, mantendo performance competitiva.**Estratégia**: Use open source em infraestrutura própria e aceite possíveis trade-offs por controle dos dados.+</Accordion></AccordionGroup>@@ -704,7 +785,9 @@ Estas tabelas exibem apenas alguns modelos líderes por categoria. Existem muito- **Viabilidade Open Source**: A distância entre open source e proprietários diminui a cada mês, com Llama 4 Maverick e DeepSeek V3 entregando performance competitiva a preços atrativos. Inferência rápida via Groq maximiza custo-benefício nesses casos.<Info>-**Testes são essenciais**: Rankings servem de orientação geral, mas seu caso de uso, prompt e critério podem gerar resultados distintos. Sempre teste modelos candidatos com suas tarefas e dados reais antes de decidir.+ **Testes são essenciais**: Rankings servem de orientação geral, mas seu caso+ de uso, prompt e critério podem gerar resultados distintos. Sempre teste+ modelos candidatos com suas tarefas e dados reais antes de decidir.</Info>### Estratégia Prática de Implementação@@ -714,13 +797,19 @@ Estas tabelas exibem apenas alguns modelos líderes por categoria. Existem muitoInicie com opções consagradas como **GPT-4.1**, **Claude 3.7 Sonnet** ou **Gemini 2.0 Flash**, que oferecem bom desempenho e ampla validação.</Step>- <Step title="Identifique Demandas Especializadas">- Descubra se sua crew possui requisitos específicos (código, raciocínio, velocidade) que justifiquem modelos como **Claude 4 Sonnet** para desenvolvimento ou **o3** para análise. Para aplicações críticas em velocidade, considere Groq aliado à seleção do modelo.- </Step>-- <Step title="Implemente Estratégia Multi-Modelo">- Use modelos diferentes para agentes distintos conforme o papel. Modelos de alta capacidade para managers e tarefas complexas, eficientes para rotinas.- </Step>+{" "}+<Step title="Identifique Demandas Especializadas">+ Descubra se sua crew possui requisitos específicos (código, raciocínio,+ velocidade) que justifiquem modelos como **Claude 4 Sonnet** para+ desenvolvimento ou **o3** para análise. Para aplicações críticas em+ velocidade, considere Groq aliado à seleção do modelo.+</Step>++{" "}+<Step title="Implemente Estratégia Multi-Modelo">+ Use modelos diferentes para agentes distintos conforme o papel. Modelos de+ alta capacidade para managers e tarefas complexas, eficientes para rotinas.+</Step><Step title="Monitore e Otimize">Acompanhe métricas relevantes ao seu caso e esteja pronto para ajustar modelos conforme lançamentos ou mudanças de preços.diff --git a/docs/pt-BR/mcp/dsl-integration.mdx b/docs/pt-BR/mcp/dsl-integration.mdxindex dd184f95a..3d22c1047 100644--- a/docs/pt-BR/mcp/dsl-integration.mdx+++ b/docs/pt-BR/mcp/dsl-integration.mdx@@ -10,7 +10,9 @@ mode: "wide"A integração DSL (Domain Specific Language) MCP do CrewAI oferece a **forma mais simples** de conectar seus agentes aos servidores MCP (Model Context Protocol). Basta adicionar um campo `mcps` ao seu agente e o CrewAI cuida de toda a complexidade automaticamente.<Info>-Esta é a **abordagem recomendada** para a maioria dos casos de uso de MCP. Para cenários avançados que requerem gerenciamento manual de conexão, veja [MCPServerAdapter](/pt-BR/mcp/overview#advanced-mcpserveradapter).+ Esta é a **abordagem recomendada** para a maioria dos casos de uso de MCP.+ Para cenários avançados que requerem gerenciamento manual de conexão, veja+ [MCPServerAdapter](/pt-BR/mcp/overview#advanced-mcpserveradapter).</Info>## Uso Básico@@ -60,9 +62,9 @@ Use a sintaxe `#` para selecionar ferramentas específicas de um servidor:"https://mcp.exa.ai/mcp?api_key=sua_chave#web_search_exa"```-### Marketplace CrewAI AOP+### Marketplace CrewAI AMP-Acesse ferramentas do marketplace CrewAI AOP:+Acesse ferramentas do marketplace CrewAI AMP:```python# Serviço completo com todas as ferramentas@@ -97,7 +99,7 @@ agente_multi_fonte = Agent("https://mcp.exa.ai/mcp?api_key=sua_chave_exa&profile=pesquisa","https://weather.api.com/mcp#get_current_conditions",- # Marketplace CrewAI AOP+ # Marketplace CrewAI AMP"crewai-amp:financial-insights","crewai-amp:academic-research#pubmed_search","crewai-amp:market-intelligence#competitor_analysis"diff --git a/docs/pt-BR/mcp/overview.mdx b/docs/pt-BR/mcp/overview.mdxindex 2d8d178e3..53aaaa32c 100644--- a/docs/pt-BR/mcp/overview.mdx+++ b/docs/pt-BR/mcp/overview.mdx@@ -1,6 +1,6 @@----title: 'Servidores MCP como Ferramentas no CrewAI'-description: 'Aprenda como integrar servidores MCP como ferramentas nos seus agentes CrewAI usando a biblioteca `crewai-tools`.'+title: "Servidores MCP como Ferramentas no CrewAI"+description: "Aprenda como integrar servidores MCP como ferramentas nos seus agentes CrewAI usando a biblioteca `crewai-tools`."icon: plugmode: "wide"---@@ -25,7 +25,7 @@ agent = Agent(mcps=["https://mcp.exa.ai/mcp?api_key=sua_chave", # Servidor MCP externo"https://api.weather.com/mcp#get_forecast", # Ferramenta específica do servidor- "crewai-amp:financial-data", # Marketplace CrewAI AOP+ "crewai-amp:financial-data", # Marketplace CrewAI AMP"crewai-amp:research-tools#pubmed_search" # Ferramenta AMP específica])@@ -43,6 +43,7 @@ Atualmente, suportamos os seguintes mecanismos de transporte:- **Streamable HTTP**: para servidores remotos (comunicação flexível e potencialmente bidirecional via HTTP, geralmente utilizando SSE para streams do servidor para o cliente)## Tutorial em Vídeo+Assista a este tutorial em vídeo para um guia abrangente sobre a integração do MCP com o CrewAI:<iframe@@ -120,6 +121,7 @@ with MCPServerAdapter(server_params, connect_timeout=60) as mcp_tools:)# ... restante da configuração do seu crew ...```+Este padrão geral mostra como integrar ferramentas. Para exemplos específicos para cada transporte, consulte os guias detalhados abaixo.## Filtrando Ferramentas@@ -182,6 +184,7 @@ Quando uma classe é decorada com `@CrewBase`, o ciclo de vida do adaptador é c- Se `mcp_server_params` não estiver definido, `get_mcp_tools()` retorna uma lista vazia, permitindo manter o mesmo fluxo de código com ou sem MCP configurado.Assim, é seguro chamar `get_mcp_tools()` em vários agentes ou habilitar/desabilitar MCP dependendo do ambiente.+</Tip>### Configuração de Timeout de Conexão@@ -238,6 +241,7 @@ class CrewWithCustomTimeout:tools=self.get_mcp_tools("tool_1", "tool_2") # ferramentas específicas com timeout personalizado)```+## Explore Integrações MCP<CardGroup cols={2}>@@ -247,7 +251,8 @@ class CrewWithCustomTimeout:href="/pt-BR/mcp/stdio"color="#3B82F6">- Conecte-se a servidores MCP locais via entrada/saída padrão. Ideal para scripts e executáveis locais.+ Conecte-se a servidores MCP locais via entrada/saída padrão. Ideal para+ scripts e executáveis locais.</Card><Cardtitle="Transporte SSE"@@ -255,7 +260,8 @@ class CrewWithCustomTimeout:href="/pt-BR/mcp/sse"color="#10B981">- Integre com servidores MCP remotos usando Server-Sent Events para streaming de dados em tempo real.+ Integre com servidores MCP remotos usando Server-Sent Events para streaming+ de dados em tempo real.</Card><Cardtitle="Transporte HTTP Streamable"@@ -263,7 +269,8 @@ class CrewWithCustomTimeout:href="/pt-BR/mcp/streamable-http"color="#F59E0B">- Utilize HTTP Streamable para uma comunicação robusta com servidores MCP remotos.+ Utilize HTTP Streamable para uma comunicação robusta com servidores MCP+ remotos.</Card><Cardtitle="Conectando a Múltiplos Servidores"@@ -271,7 +278,8 @@ class CrewWithCustomTimeout:href="/pt-BR/mcp/multiple-servers"color="#8B5CF6">- Agregue ferramentas de vários servidores MCP simultaneamente usando um único adaptador.+ Agregue ferramentas de vários servidores MCP simultaneamente usando um único+ adaptador.</Card><Cardtitle="Considerações de Segurança"@@ -279,27 +287,30 @@ class CrewWithCustomTimeout:href="/pt-BR/mcp/security"color="#EF4444">- Revise práticas importantes de segurança para integração MCP e mantenha seus agentes protegidos.+ Revise práticas importantes de segurança para integração MCP e mantenha seus+ agentes protegidos.</Card></CardGroup>Confira este repositório para demonstrações completas e exemplos de integração MCP com CrewAI! 👇<Card-title="Repositório GitHub"-icon="github"-href="https://github.com/tonykipkemboi/crewai-mcp-demo"-target="_blank"+ title="Repositório GitHub"+ icon="github"+ href="https://github.com/tonykipkemboi/crewai-mcp-demo"+ target="_blank">-Demo MCP do CrewAI+ Demo MCP do CrewAI</Card>## Segurança ao Usar MCP+<Warning>-Sempre assegure-se de confiar no servidor MCP antes de utilizá-lo.+ Sempre assegure-se de confiar no servidor MCP antes de utilizá-lo.</Warning>#### Aviso de Segurança: Ataques de DNS Rebinding+Transportes SSE podem ser vulneráveis a ataques de DNS rebinding se não forem devidamente protegidos.Para prevenir isso:@@ -312,6 +323,7 @@ Sem essas proteções, invasores podem usar DNS rebinding para interagir com serPara mais detalhes, consulte a [documentação de Segurança de Transporte da MCP da Anthropic](https://modelcontextprotocol.io/docs/concepts/transports#security-considerations).### Limitações-* **Primitivas Suportadas**: Atualmente, o `MCPServerAdapter` suporta principalmente a adaptação de `tools` MCP.-Outras primitivas MCP como `prompts` ou `resources` não são integradas diretamente como componentes CrewAI através deste adaptador por enquanto.-* **Manipulação de Saída**: O adaptador normalmente processa a saída principal de texto de uma ferramenta MCP (por exemplo, `.content[0].text`). Saídas complexas ou multimodais podem exigir tratamento customizado caso não se encaixem nesse padrão.++- **Primitivas Suportadas**: Atualmente, o `MCPServerAdapter` suporta principalmente a adaptação de `tools` MCP.+ Outras primitivas MCP como `prompts` ou `resources` não são integradas diretamente como componentes CrewAI através deste adaptador por enquanto.+- **Manipulação de Saída**: O adaptador normalmente processa a saída principal de texto de uma ferramenta MCP (por exemplo, `.content[0].text`). Saídas complexas ou multimodais podem exigir tratamento customizado caso não se encaixem nesse padrão.diff --git a/docs/pt-BR/observability/tracing.mdx b/docs/pt-BR/observability/tracing.mdxindex 220f7ada1..ba6c1b40a 100644--- a/docs/pt-BR/observability/tracing.mdx+++ b/docs/pt-BR/observability/tracing.mdx@@ -1,6 +1,6 @@---title: CrewAI Tracing-description: Rastreamento integrado para Crews e Flows do CrewAI com a plataforma CrewAI AOP+description: Rastreamento integrado para Crews e Flows do CrewAI com a plataforma CrewAI AMPicon: magnifying-glass-chartmode: "wide"---@@ -9,7 +9,7 @@ mode: "wide"O CrewAI fornece recursos de rastreamento integrados que permitem monitorar e depurar seus Crews e Flows em tempo real. Este guia demonstra como habilitar o rastreamento para **Crews** e **Flows** usando a plataforma de observabilidade integrada do CrewAI.-> **O que é o CrewAI Tracing?** O rastreamento integrado do CrewAI fornece observabilidade abrangente para seus agentes de IA, incluindo decisões de agentes, cronogramas de execução de tarefas, uso de ferramentas e chamadas de LLM - tudo acessível através da [plataforma CrewAI AOP](https://app.crewai.com).+> **O que é o CrewAI Tracing?** O rastreamento integrado do CrewAI fornece observabilidade abrangente para seus agentes de IA, incluindo decisões de agentes, cronogramas de execução de tarefas, uso de ferramentas e chamadas de LLM - tudo acessível através da [plataforma CrewAI AMP](https://app.crewai.com).@@ -17,7 +17,7 @@ O CrewAI fornece recursos de rastreamento integrados que permitem monitorar e deAntes de usar o rastreamento do CrewAI, você precisa:-1. **Conta CrewAI AOP**: Cadastre-se para uma conta gratuita em [app.crewai.com](https://app.crewai.com)+1. **Conta CrewAI AMP**: Cadastre-se para uma conta gratuita em [app.crewai.com](https://app.crewai.com)2. **Autenticação CLI**: Use a CLI do CrewAI para autenticar seu ambiente local```bash@@ -26,9 +26,9 @@ crewai login## Instruções de Configuração-### Passo 1: Crie sua Conta CrewAI AOP+### Passo 1: Crie sua Conta CrewAI AMP-Visite [app.crewai.com](https://app.crewai.com) e crie sua conta gratuita. Isso lhe dará acesso à plataforma CrewAI AOP, onde você pode visualizar rastreamentos, métricas e gerenciar seus crews.+Visite [app.crewai.com](https://app.crewai.com) e crie sua conta gratuita. Isso lhe dará acesso à plataforma CrewAI AMP, onde você pode visualizar rastreamentos, métricas e gerenciar seus crews.### Passo 2: Instale a CLI do CrewAI e Autentique@@ -38,16 +38,17 @@ Se você ainda não o fez, instale o CrewAI com as ferramentas CLI:uv add crewai[tools]```-Em seguida, autentique sua CLI com sua conta CrewAI AOP:+Em seguida, autentique sua CLI com sua conta CrewAI AMP:```bashcrewai login```Este comando irá:+1. Abrir seu navegador na página de autenticação2. Solicitar que você insira um código de dispositivo-3. Autenticar seu ambiente local com sua conta CrewAI AOP+3. Autenticar seu ambiente local com sua conta CrewAI AMP4. Habilitar recursos de rastreamento para seu desenvolvimento local### Passo 3: Habilite o Rastreamento em seu Crew@@ -147,13 +148,12 @@ flow = ExampleFlow(tracing=True)result = flow.kickoff()```-### Passo 5: Visualize os Rastreamentos no Painel CrewAI AOP+### Passo 5: Visualize os Rastreamentos no Painel CrewAI AMP-Após executar o crew ou flow, você pode visualizar os rastreamentos gerados pela sua aplicação CrewAI no painel CrewAI AOP. Você verá etapas detalhadas das interações dos agentes, usos de ferramentas e chamadas de LLM.+Após executar o crew ou flow, você pode visualizar os rastreamentos gerados pela sua aplicação CrewAI no painel CrewAI AMP. Você verá etapas detalhadas das interações dos agentes, usos de ferramentas e chamadas de LLM.Basta clicar no link abaixo para visualizar os rastreamentos ou ir para a aba de rastreamentos no painel [aqui](https://app.crewai.com/crewai_plus/trace_batches)-### Alternativa: Configuração de Variável de AmbienteVocê também pode habilitar o rastreamento globalmente definindo uma variável de ambiente:@@ -172,7 +172,7 @@ Quando esta variável de ambiente estiver definida, todos os Crews e Flows terã## Visualizando seus Rastreamentos-### Acesse o Painel CrewAI AOP+### Acesse o Painel CrewAI AMP1. Visite [app.crewai.com](https://app.crewai.com) e faça login em sua conta2. Navegue até o painel do seu projeto@@ -190,6 +190,7 @@ O rastreamento do CrewAI fornece visibilidade abrangente sobre:- **Rastreamento de Erros**: Informações detalhadas de erros e rastreamentos de pilha### Recursos de Rastreamento+- **Cronograma de Execução**: Clique através de diferentes estágios de execução- **Logs Detalhados**: Acesse logs abrangentes para depuração- **Análise de Desempenho**: Analise padrões de execução e otimize o desempenhodiff --git a/docs/pt-BR/quickstart.mdx b/docs/pt-BR/quickstart.mdxindex c5742a31f..58d079bc1 100644--- a/docs/pt-BR/quickstart.mdx+++ b/docs/pt-BR/quickstart.mdx@@ -54,6 +54,7 @@ Siga os passos abaixo para começar a tripular! 🚣♂️backstory: >Você é um analista meticuloso com um olhar atento aos detalhes. É conhecido por sua capacidade de transformar dados complexos em relatórios claros e concisos, facilitando o entendimento e a tomada de decisão por parte dos outros.```+</Step><Step title="Modifique seu arquivo `tasks.yaml`">```yaml tasks.yaml@@ -76,6 +77,7 @@ Siga os passos abaixo para começar a tripular! 🚣♂️agent: reporting_analystoutput_file: report.md```+</Step><Step title="Modifique seu arquivo `crew.py`">```python crew.py@@ -131,6 +133,7 @@ Siga os passos abaixo para começar a tripular! 🚣♂️verbose=True,)```+</Step><Step title="[Opcional] Adicione funções de pré e pós execução da tripulação">```python crew.py@@ -155,6 +158,7 @@ Siga os passos abaixo para começar a tripular! 🚣♂️# ... remaining code```+</Step><Step title="Fique à vontade para passar entradas personalizadas para sua tripulação">Por exemplo, você pode passar o input `topic` para sua tripulação para personalizar a pesquisa e o relatório.@@ -173,6 +177,7 @@ Siga os passos abaixo para começar a tripular! 🚣♂️}LatestAiDevelopmentCrew().crew().kickoff(inputs=inputs)```+</Step><Step title="Defina suas variáveis de ambiente">Antes de executar sua tripulação, certifique-se de ter as seguintes chaves configuradas como variáveis de ambiente no seu arquivo `.env`:@@ -204,24 +209,24 @@ Siga os passos abaixo para começar a tripular! 🚣♂️</Step><Step title="Alternativa para Empresas: Crie no Crew Studio">- Para usuários do CrewAI AOP, você pode criar a mesma tripulação sem escrever código:+ Para usuários do CrewAI AMP, você pode criar a mesma tripulação sem escrever código:- 1. Faça login na sua conta CrewAI AOP (crie uma conta gratuita em [app.crewai.com](https://app.crewai.com))- 2. Abra o Crew Studio- 3. Digite qual automação deseja construir- 4. Crie suas tarefas visualmente e conecte-as em sequência- 5. Configure seus inputs e clique em "Download Code" ou "Deploy"+1. Faça login na sua conta CrewAI AMP (crie uma conta gratuita em [app.crewai.com](https://app.crewai.com))+2. Abra o Crew Studio+3. Digite qual automação deseja construir+4. Crie suas tarefas visualmente e conecte-as em sequência+5. Configure seus inputs e clique em "Download Code" ou "Deploy"- +- <Card title="Experimente o CrewAI AOP" icon="rocket" href="https://app.crewai.com">- Comece sua conta gratuita no CrewAI AOP+ <Card title="Experimente o CrewAI AMP" icon="rocket" href="https://app.crewai.com">+ Comece sua conta gratuita no CrewAI AMP</Card></Step><Step title="Veja seu relatório final">Você verá a saída no console e o arquivo `report.md` deve ser criado na raiz do seu projeto com o relatório final.- Veja um exemplo de como o relatório deve ser:+Veja um exemplo de como o relatório deve ser:<CodeGroup>```markdown output/report.md@@ -284,6 +289,7 @@ Siga os passos abaixo para começar a tripular! 🚣♂️## 8. ConclusionThe emergence of AI agents is undeniably reshaping the workplace landscape in 5. With their ability to automate tasks, enhance efficiency, and improve decision-making, AI agents are critical in driving operational success. Organizations must embrace and adapt to AI developments to thrive in an increasingly digital business environment.```+</CodeGroup></Step></Steps>@@ -292,6 +298,7 @@ Siga os passos abaixo para começar a tripular! 🚣♂️Parabéns!Você configurou seu projeto de tripulação com sucesso e está pronto para começar a construir seus próprios fluxos de trabalho baseados em agentes!+</Check>### Observação sobre Consistência nos Nomes@@ -303,41 +310,44 @@ Essa consistência de nomes permite que a CrewAI conecte automaticamente suas co#### Exemplos de Referências<Tip>- Observe como usamos o mesmo nome para o agente no arquivo `agents.yaml` (`email_summarizer`) e no método do arquivo `crew.py` (`email_summarizer`).+ Observe como usamos o mesmo nome para o agente no arquivo `agents.yaml`+ (`email_summarizer`) e no método do arquivo `crew.py` (`email_summarizer`).</Tip>```yaml agents.yamlemail_summarizer:- role: >- Email Summarizer- goal: >- Summarize emails into a concise and clear summary- backstory: >- You will create a 5 bullet point summary of the report- llm: provider/model-id # Add your choice of model here+ role: >+ Email Summarizer+ goal: >+ Summarize emails into a concise and clear summary+ backstory: >+ You will create a 5 bullet point summary of the report+ llm: provider/model-id # Add your choice of model here```<Tip>- Observe como usamos o mesmo nome para a tarefa no arquivo `tasks.yaml` (`email_summarizer_task`) e no método no arquivo `crew.py` (`email_summarizer_task`).+ Observe como usamos o mesmo nome para a tarefa no arquivo `tasks.yaml`+ (`email_summarizer_task`) e no método no arquivo `crew.py`+ (`email_summarizer_task`).</Tip>```yaml tasks.yamlemail_summarizer_task:- description: >- Summarize the email into a 5 bullet point summary- expected_output: >- A 5 bullet point summary of the email- agent: email_summarizer- context:- - reporting_task- - research_task+ description: >+ Summarize the email into a 5 bullet point summary+ expected_output: >+ A 5 bullet point summary of the email+ agent: email_summarizer+ context:+ - reporting_task+ - research_task```## Fazendo o Deploy da Sua Tripulação-A forma mais fácil de fazer deploy da sua tripulação em produção é através da [CrewAI AOP](http://app.crewai.com).+A forma mais fácil de fazer deploy da sua tripulação em produção é através da [CrewAI AMP](http://app.crewai.com).-Assista a este vídeo tutorial para uma demonstração detalhada de como fazer deploy da sua tripulação na [CrewAI AOP](http://app.crewai.com) usando a CLI.+Assista a este vídeo tutorial para uma demonstração detalhada de como fazer deploy da sua tripulação na [CrewAI AMP](http://app.crewai.com) usando a CLI.<iframeclassName="w-full aspect-video rounded-xl"@@ -349,18 +359,16 @@ Assista a este vídeo tutorial para uma demonstração detalhada de como fazer d></iframe><CardGroup cols={2}>- <Card- title="Deploy no Enterprise"- icon="rocket"- href="http://app.crewai.com"- >- Comece com o CrewAI AOP e faça o deploy da sua tripulação em ambiente de produção com apenas alguns cliques.+ <Card title="Deploy no Enterprise" icon="rocket" href="http://app.crewai.com">+ Comece com o CrewAI AMP e faça o deploy da sua tripulação em ambiente de+ produção com apenas alguns cliques.</Card><Cardtitle="Junte-se à Comunidade"icon="comments"href="https://community.crewai.com">- Participe da nossa comunidade open source para discutir ideias, compartilhar seus projetos e conectar-se com outros desenvolvedores CrewAI.+ Participe da nossa comunidade open source para discutir ideias, compartilhar+ seus projetos e conectar-se com outros desenvolvedores CrewAI.</Card></CardGroup>diff --git a/lib/crewai-tools/src/crewai_tools/tools/generate_crewai_automation_tool/README.md b/lib/crewai-tools/src/crewai_tools/tools/generate_crewai_automation_tool/README.mdindex a331de33a..5e506b253 100644--- a/lib/crewai-tools/src/crewai_tools/tools/generate_crewai_automation_tool/README.md+++ b/lib/crewai-tools/src/crewai_tools/tools/generate_crewai_automation_tool/README.md@@ -6,7 +6,7 @@ The GenerateCrewaiAutomationTool integrates with CrewAI Studio API to generate c## Environment Variables-Set your CrewAI Personal Access Token (CrewAI AOP > Settings > Account > Personal Access Token):+Set your CrewAI Personal Access Token (CrewAI AMP > Settings > Account > Personal Access Token):```bashexport CREWAI_PERSONAL_ACCESS_TOKEN="your_personal_access_token_here"diff --git a/lib/crewai-tools/src/crewai_tools/tools/generate_crewai_automation_tool/generate_crewai_automation_tool.py b/lib/crewai-tools/src/crewai_tools/tools/generate_crewai_automation_tool/generate_crewai_automation_tool.pyindex 4f8b70547..4fd13b978 100644--- a/lib/crewai-tools/src/crewai_tools/tools/generate_crewai_automation_tool/generate_crewai_automation_tool.py+++ b/lib/crewai-tools/src/crewai_tools/tools/generate_crewai_automation_tool/generate_crewai_automation_tool.py@@ -11,7 +11,7 @@ class GenerateCrewaiAutomationToolSchema(BaseModel):)organization_id: str | None = Field(default=None,- description="The identifier for the CrewAI AOP organization. If not specified, a default organization will be used.",+ description="The identifier for the CrewAI AMP organization. If not specified, a default organization will be used.",)@@ -25,11 +25,11 @@ class GenerateCrewaiAutomationTool(BaseTool):args_schema: type[BaseModel] = GenerateCrewaiAutomationToolSchemacrewai_enterprise_url: str = Field(default_factory=lambda: os.getenv("CREWAI_PLUS_URL", "https://app.crewai.com"),- description="The base URL of CrewAI AOP. If not provided, it will be loaded from the environment variable CREWAI_PLUS_URL with default https://app.crewai.com.",+ description="The base URL of CrewAI AMP. If not provided, it will be loaded from the environment variable CREWAI_PLUS_URL with default https://app.crewai.com.",)personal_access_token: str | None = Field(default_factory=lambda: os.getenv("CREWAI_PERSONAL_ACCESS_TOKEN"),- description="The user's Personal Access Token to access CrewAI AOP API. If not provided, it will be loaded from the environment variable CREWAI_PERSONAL_ACCESS_TOKEN.",+ description="The user's Personal Access Token to access CrewAI AMP API. If not provided, it will be loaded from the environment variable CREWAI_PERSONAL_ACCESS_TOKEN.",)env_vars: list[EnvVar] = Field(default_factory=lambda: [diff --git a/lib/crewai-tools/tool.specs.json b/lib/crewai-tools/tool.specs.jsonindex ea2cef07a..ea38e6941 100644--- a/lib/crewai-tools/tool.specs.json+++ b/lib/crewai-tools/tool.specs.json@@ -3195,13 +3195,13 @@"env_vars": [{"default": null,- "description": "Personal Access Token for CrewAI AOP API",+ "description": "Personal Access Token for CrewAI AMP API","name": "CREWAI_PERSONAL_ACCESS_TOKEN","required": true},{"default": null,- "description": "Base URL for CrewAI AOP API",+ "description": "Base URL for CrewAI AMP API","name": "CREWAI_PLUS_URL","required": false}@@ -3247,7 +3247,7 @@},"properties": {"crewai_enterprise_url": {- "description": "The base URL of CrewAI AOP. If not provided, it will be loaded from the environment variable CREWAI_PLUS_URL with default https://app.crewai.com.",+ "description": "The base URL of CrewAI AMP. If not provided, it will be loaded from the environment variable CREWAI_PLUS_URL with default https://app.crewai.com.","title": "Crewai Enterprise Url","type": "string"},@@ -3260,7 +3260,7 @@"type": "null"}],- "description": "The user's Personal Access Token to access CrewAI AOP API. If not provided, it will be loaded from the environment variable CREWAI_PERSONAL_ACCESS_TOKEN.",+ "description": "The user's Personal Access Token to access CrewAI AMP API. If not provided, it will be loaded from the environment variable CREWAI_PERSONAL_ACCESS_TOKEN.","title": "Personal Access Token"}},@@ -3281,7 +3281,7 @@}],"default": null,- "description": "The identifier for the CrewAI AOP organization. If not specified, a default organization will be used.",+ "description": "The identifier for the CrewAI AMP organization. If not specified, a default organization will be used.","title": "Organization Id"},"prompt": {diff --git a/lib/crewai/README.md b/lib/crewai/README.mdindex 65723b39f..7faeae0fa 100644--- a/lib/crewai/README.md+++ b/lib/crewai/README.md@@ -62,9 +62,9 @@With over 100,000 developers certified through our community courses at [learn.crewai.com](https://learn.crewai.com), CrewAI is rapidly becoming thestandard for enterprise-ready AI automation.-# CrewAI AOP Suite+# CrewAI AMP Suite-CrewAI AOP Suite is a comprehensive bundle tailored for organizations that require secure, scalable, and easy-to-manage agent-driven automation.+CrewAI AMP Suite is a comprehensive bundle tailored for organizations that require secure, scalable, and easy-to-manage agent-driven automation.You can try one part of the suite the [Crew Control Plane for free](https://app.crewai.com)@@ -76,9 +76,9 @@ You can try one part of the suite the [Crew Control Plane for free](https://app.- **Advanced Security**: Built-in robust security and compliance measures ensuring safe deployment and management.- **Actionable Insights**: Real-time analytics and reporting to optimize performance and decision-making.- **24/7 Support**: Dedicated enterprise support to ensure uninterrupted operation and quick resolution of issues.-- **On-premise and Cloud Deployment Options**: Deploy CrewAI AOP on-premise or in the cloud, depending on your security and compliance requirements.+- **On-premise and Cloud Deployment Options**: Deploy CrewAI AMP on-premise or in the cloud, depending on your security and compliance requirements.-CrewAI AOP is designed for enterprises seeking a powerful, reliable solution to transform complex business processes into efficient,+CrewAI AMP is designed for enterprises seeking a powerful, reliable solution to transform complex business processes into efficient,intelligent automations.## Table of contents@@ -124,7 +124,8 @@ Setup and run your first CrewAI agents by following this tutorial.[](https://www.youtube.com/watch?v=-kSOTtYzgEw "CrewAI Getting Started Tutorial")###- Learning Resources++Learning ResourcesLearn CrewAI through our comprehensive courses:@@ -141,6 +142,7 @@ CrewAI offers two powerful, complementary approaches that work seamlessly togeth- Dynamic task delegation and collaboration- Specialized roles with defined goals and expertise- Flexible problem-solving approaches+2. **Flows**: Production-ready, event-driven workflows that deliver precise control over complex automations. Flows provide:- Fine-grained control over execution paths for real-world scenarios@@ -187,6 +189,7 @@ If you encounter issues during installation or usage, here are some common solut- Install tiktoken explicitly: `pip install 'crewai[embeddings]'`- If using embedchain or other tools: `pip install 'crewai[tools]'`+2. **Failed building wheel for tiktoken**- Ensure Rust compiler is installed (see installation steps above)@@ -270,7 +273,7 @@ reporting_analyst:**tasks.yaml**-```yaml+````yaml# src/my_project/config/tasks.yamlresearch_task:description: >@@ -290,7 +293,7 @@ reporting_task:Formatted as markdown without '```'agent: reporting_analystoutput_file: report.md-```+````**crew.py**@@ -556,7 +559,7 @@ Please refer to the [Connect CrewAI to LLMs](https://docs.crewai.com/how-to/LLM-- **LangGraph**: While LangGraph provides a foundation for building agent workflows, its approach requires significant boilerplate code and complex state management patterns. The framework's tight coupling with LangChain can limit flexibility when implementing custom agent behaviors or integrating with external systems.-*P.S. CrewAI demonstrates significant performance advantages over LangGraph, executing 5.76x faster in certain cases like this QA task example ([see comparison](https://github.com/crewAIInc/crewAI-examples/tree/main/Notebooks/CrewAI%20Flows%20%26%20Langgraph/QA%20Agent)) while achieving higher evaluation scores with faster completion times in certain coding tasks, like in this example ([detailed analysis](https://github.com/crewAIInc/crewAI-examples/blob/main/Notebooks/CrewAI%20Flows%20%26%20Langgraph/Coding%20Assistant/coding_assistant_eval.ipynb)).*+_P.S. CrewAI demonstrates significant performance advantages over LangGraph, executing 5.76x faster in certain cases like this QA task example ([see comparison](https://github.com/crewAIInc/crewAI-examples/tree/main/Notebooks/CrewAI%20Flows%20%26%20Langgraph/QA%20Agent)) while achieving higher evaluation scores with faster completion times in certain coding tasks, like in this example ([detailed analysis](https://github.com/crewAIInc/crewAI-examples/blob/main/Notebooks/CrewAI%20Flows%20%26%20Langgraph/Coding%20Assistant/coding_assistant_eval.ipynb))._- **Autogen**: While Autogen excels at creating conversational agents capable of working together, it lacks an inherent concept of process. In Autogen, orchestrating agents' interactions requires additional programming, which can become complex and cumbersome as the scale of tasks grows.- **ChatDev**: ChatDev introduced the idea of processes into the realm of AI agents, but its implementation is quite rigid. Customizations in ChatDev are limited and not geared towards production environments, which can hinder scalability and flexibility in real-world applications.@@ -674,9 +677,9 @@ CrewAI is released under the [MIT License](https://github.com/crewAIInc/crewAI/b### Enterprise Features-- [What additional features does CrewAI AOP offer?](#q-what-additional-features-does-crewai-enterprise-offer)-- [Is CrewAI AOP available for cloud and on-premise deployments?](#q-is-crewai-enterprise-available-for-cloud-and-on-premise-deployments)-- [Can I try CrewAI AOP for free?](#q-can-i-try-crewai-enterprise-for-free)+- [What additional features does CrewAI AMP offer?](#q-what-additional-features-does-crewai-enterprise-offer)+- [Is CrewAI AMP available for cloud and on-premise deployments?](#q-is-crewai-enterprise-available-for-cloud-and-on-premise-deployments)+- [Can I try CrewAI AMP for free?](#q-can-i-try-crewai-enterprise-for-free)### Q: What exactly is CrewAI?@@ -732,17 +735,17 @@ A: Check out practical examples in the [CrewAI-examples repository](https://githA: Contributions are warmly welcomed! Fork the repository, create your branch, implement your changes, and submit a pull request. See the Contribution section of the README for detailed guidelines.-### Q: What additional features does CrewAI AOP offer?+### Q: What additional features does CrewAI AMP offer?-A: CrewAI AOP provides advanced features such as a unified control plane, real-time observability, secure integrations, advanced security, actionable insights, and dedicated 24/7 enterprise support.+A: CrewAI AMP provides advanced features such as a unified control plane, real-time observability, secure integrations, advanced security, actionable insights, and dedicated 24/7 enterprise support.-### Q: Is CrewAI AOP available for cloud and on-premise deployments?+### Q: Is CrewAI AMP available for cloud and on-premise deployments?-A: Yes, CrewAI AOP supports both cloud-based and on-premise deployment options, allowing enterprises to meet their specific security and compliance requirements.+A: Yes, CrewAI AMP supports both cloud-based and on-premise deployment options, allowing enterprises to meet their specific security and compliance requirements.-### Q: Can I try CrewAI AOP for free?+### Q: Can I try CrewAI AMP for free?-A: Yes, you can explore part of the CrewAI AOP Suite by accessing the [Crew Control Plane](https://app.crewai.com) for free.+A: Yes, you can explore part of the CrewAI AMP Suite by accessing the [Crew Control Plane](https://app.crewai.com) for free.### Q: Does CrewAI support fine-tuning or training custom models?@@ -762,7 +765,7 @@ A: CrewAI is highly scalable, supporting simple automations and large-scale ente### Q: Does CrewAI offer debugging and monitoring tools?-A: Yes, CrewAI AOP includes advanced debugging, tracing, and real-time observability features, simplifying the management and troubleshooting of your automations.+A: Yes, CrewAI AMP includes advanced debugging, tracing, and real-time observability features, simplifying the management and troubleshooting of your automations.### Q: What programming languages does CrewAI support?diff --git a/lib/crewai/src/crewai/agent/core.py b/lib/crewai/src/crewai/agent/core.pyindex 3658a330b..d06b3b6f7 100644--- a/lib/crewai/src/crewai/agent/core.py+++ b/lib/crewai/src/crewai/agent/core.py@@ -1100,7 +1100,7 @@ class Agent(BaseAgent):raise RuntimeError(f"Failed to get native MCP tools: {e}") from edef _get_amp_mcp_tools(self, amp_ref: str) -> list[BaseTool]:- """Get tools from CrewAI AOP MCP marketplace."""+ """Get tools from CrewAI AMP MCP marketplace."""# Parse: "crewai-amp:mcp-name" or "crewai-amp:mcp-name#tool_name"amp_part = amp_ref.replace("crewai-amp:", "")if "#" in amp_part:@@ -1355,7 +1355,7 @@ class Agent(BaseAgent):@staticmethoddef _fetch_amp_mcp_servers(mcp_name: str) -> list[dict[str, Any]]:- """Fetch MCP server configurations from CrewAI AOP API."""+ """Fetch MCP server configurations from CrewAI AMP API."""# TODO: Implement AMP API call to "integrations/mcps" endpoint# Should return list of server configs with URLsreturn []diff --git a/lib/crewai/src/crewai/agents/agent_builder/base_agent.py b/lib/crewai/src/crewai/agents/agent_builder/base_agent.pyindex 93907c7c1..c58837cba 100644--- a/lib/crewai/src/crewai/agents/agent_builder/base_agent.py+++ b/lib/crewai/src/crewai/agents/agent_builder/base_agent.py@@ -83,7 +83,7 @@ class BaseAgent(BaseModel, ABC, metaclass=AgentMeta):knowledge_sources: Knowledge sources for the agent.knowledge_storage: Custom knowledge storage for the agent.security_config: Security configuration for the agent, including fingerprinting.- apps: List of enterprise applications that the agent can access through CrewAI AOP Tools.+ apps: List of enterprise applications that the agent can access through CrewAI AMP Tools.Methods:execute_task(task: Any, context: str | None = None, tools: list[BaseTool] | None = None) -> str:diff --git a/lib/crewai/src/crewai/cli/authentication/main.py b/lib/crewai/src/crewai/cli/authentication/main.pyindex 9f300fe54..996fd7c63 100644--- a/lib/crewai/src/crewai/cli/authentication/main.py+++ b/lib/crewai/src/crewai/cli/authentication/main.py@@ -83,7 +83,7 @@ class AuthenticationCommand:def login(self) -> None:"""Sign up to CrewAI+"""- console.print("Signing in to CrewAI AOP...\n", style="bold blue")+ console.print("Signing in to CrewAI AMP...\n", style="bold blue")device_code_data = self._get_device_code()self._display_auth_instructions(device_code_data)@@ -145,7 +145,7 @@ class AuthenticationCommand:self._login_to_tool_repository()- console.print("\n[bold green]Welcome to CrewAI AOP![/bold green]\n")+ console.print("\n[bold green]Welcome to CrewAI AMP![/bold green]\n")returnif token_data["error"] not in ("authorization_pending", "slow_down"):diff --git a/lib/crewai/src/crewai/cli/cli.py b/lib/crewai/src/crewai/cli/cli.pyindex 2fb5d9887..a8f9571cc 100644--- a/lib/crewai/src/crewai/cli/cli.py+++ b/lib/crewai/src/crewai/cli/cli.py@@ -271,7 +271,7 @@ def update():@crewai.command()def login():- """Sign Up/Login to CrewAI AOP."""+ """Sign Up/Login to CrewAI AMP."""Settings().clear_user_settings()AuthenticationCommand().login()@@ -460,7 +460,7 @@ def enterprise():@enterprise.command("configure")@click.argument("enterprise_url")def enterprise_configure(enterprise_url: str):- """Configure CrewAI AOP OAuth2 settings from the provided Enterprise URL."""+ """Configure CrewAI AMP OAuth2 settings from the provided Enterprise URL."""enterprise_command = EnterpriseConfigureCommand()enterprise_command.configure(enterprise_url)diff --git a/lib/crewai/src/crewai/cli/config.py b/lib/crewai/src/crewai/cli/config.pyindex 9f2d203f9..d156d8488 100644--- a/lib/crewai/src/crewai/cli/config.py+++ b/lib/crewai/src/crewai/cli/config.py@@ -103,7 +103,7 @@ HIDDEN_SETTINGS_KEYS = [class Settings(BaseModel):enterprise_base_url: str | None = Field(default=DEFAULT_CLI_SETTINGS["enterprise_base_url"],- description="Base URL of the CrewAI AOP instance",+ description="Base URL of the CrewAI AMP instance",)tool_repository_username: str | None = Field(None, description="Username for interacting with the Tool Repository"diff --git a/lib/crewai/src/crewai/cli/enterprise/main.py b/lib/crewai/src/crewai/cli/enterprise/main.pyindex 99f0c15e6..2a73f1ae0 100644--- a/lib/crewai/src/crewai/cli/enterprise/main.py+++ b/lib/crewai/src/crewai/cli/enterprise/main.py@@ -27,7 +27,7 @@ class EnterpriseConfigureCommand(BaseCommand):self._update_oauth_settings(enterprise_url, oauth_config)console.print(- f"✅ Successfully configured CrewAI AOP with OAuth2 settings from {enterprise_url}",+ f"✅ Successfully configured CrewAI AMP with OAuth2 settings from {enterprise_url}",style="bold green",)diff --git a/lib/crewai/tests/cli/authentication/test_auth_main.py b/lib/crewai/tests/cli/authentication/test_auth_main.pyindex 1825b50e1..5f7308e20 100644--- a/lib/crewai/tests/cli/authentication/test_auth_main.py+++ b/lib/crewai/tests/cli/authentication/test_auth_main.py@@ -55,7 +55,7 @@ class TestAuthenticationCommand:self.auth_command.login()mock_console_print.assert_called_once_with(- "Signing in to CrewAI AOP...\n", style="bold blue"+ "Signing in to CrewAI AMP...\n", style="bold blue")mock_get_device.assert_called_once()mock_display.assert_called_once_with(@@ -301,7 +301,7 @@ class TestAuthenticationCommand:expected_calls = [call("\nWaiting for authentication... ", style="bold blue", end=""),call("Success!", style="bold green"),- call("\n[bold green]Welcome to CrewAI AOP![/bold green]\n"),+ call("\n[bold green]Welcome to CrewAI AMP![/bold green]\n"),]mock_console_print.assert_has_calls(expected_calls)