> ## Documentation Index > Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt > Use this file to discover all available pages before exploring further. # Conectores de dados > Conecte serviços externos por meio de Integrations, MCP ou Custom API e use as ferramentas deles nas Skills do AI Agent. Os conectores de dados permitem que os AI Agents usem ferramentas de serviços externos. Configure uma conexão uma vez e adicione às Skills as ferramentas específicas de que cada Agent precisa. Abra **AI Agent > Data connectors** para visualizar e gerenciar suas conexões. ![Página Data connectors mostrando as abas Integrations, MCP e Custom API e as integrações disponíveis.](https://mintcdn.com/lchnan/RNoD5r5OXiTray6k/product-assets/english-help-2026-10-30/data-connectors-integrations.png?fit=max\&auto=format\&n=RNoD5r5OXiTray6k\&q=85\&s=f70d467e86e5027f147b3b063f161a36) Open AI Agent > Data connectors to view Integrations, MCP servers, and Custom API connectors. ## Escolher um tipo de conector A página Data connectors oferece três maneiras de conectar um serviço externo: | Tipo | Use para | | - | - | | **Integrations** | Conectar um serviço compatível por meio de um fluxo de autorização guiado. Por exemplo, o Shopify Admin fornece ferramentas somente leitura para pedidos, rastreamento de envios, devoluções e reembolsos. | | **MCP** | Conectar um servidor MCP e disponibilizar aos seus AI Agents as ferramentas expostas por esse servidor. | | **Custom API** | Criar uma solicitação HTTP personalizada para um endpoint HTTPS quando você precisar conectar sua própria API. | Selecione a aba correspondente para pesquisar conexões existentes ou configurar uma nova. ## Adicionar ferramentas de conectores a uma Skill do AI Agent Conectar um serviço não adiciona automaticamente todas as ferramentas disponíveis a todos os AI Agents. Escolha nas Skills as ferramentas que cada Agent pode usar. 1. Abra o AI Agent que você deseja configurar. 2. Em **Profile**, localize **Skills** e selecione **Manage**. 3. Crie uma Skill ou abra uma existente. 4. Em **Step-by-Step instructions**, digite **/**. 5. Expanda o grupo relevante de **Integration**, **MCP** ou **Data connectors** e selecione a ferramenta que deseja inserir. 6. Explique quando usar a ferramenta, quais informações coletar e o que fazer com o resultado. 7. Salve a Skill, teste-a no Preview e publique o AI Agent quando estiver pronto. ![Editor de Skill do AI Agent mostrando o menu de comandos com as ferramentas do Shopify Admin.](https://mintcdn.com/lchnan/RNoD5r5OXiTray6k/product-assets/english-help-2026-10-30/shopify-skill-command-menu.png?fit=max\&auto=format\&n=RNoD5r5OXiTray6k\&q=85\&s=beb0f5f6d2938e563088e177eca982c4) Type / in Step-by-Step instructions, then select a tool from the connected Shopify Admin integration. > [!TIP] > > Defina para cada etapa do conector um caminho claro para sucesso, resultado vazio e falha. Não peça ao AI Agent que deduza informações que a ferramenta não retorna. Para saber mais sobre gatilhos, instruções e testes, consulte [AI Skills](https://docs.ycloud.com/pt/documentation/agents/ai-agent/ai-skills.md). ## Exemplo: Consultar um pedido da Shopify Este exemplo cria uma Skill que pode responder a perguntas sobre o pedido e o envio de um cliente na Shopify. ### 1. Conectar o Shopify Admin 1. Acesse **AI Agent > Data connectors**. 2. Na aba **Integrations**, abra **Shopify Admin** e conclua o fluxo de autorização. 3. Confirme se a integração mostra **Connected**. O Shopify Admin fornece ferramentas somente leitura, como: * `find_orders` para encontrar um pedido com base nas informações fornecidas pelo cliente * `get_order` para recuperar o pedido selecionado * `get_order_fulfillments` para recuperar detalhes de envio e atendimento do pedido * `get_fulfillment_events` para recuperar eventos de rastreamento do envio * `get_order_returns` e `get_return` para recuperar detalhes de devolução * `get_order_refunds` e `get_refund` para recuperar detalhes de reembolso ### 2. Criar a Skill Em **Profile** do AI Agent, selecione **Manage** em **Skills** e crie uma Skill com a configuração a seguir. **Name** > Consultar um pedido da Shopify **Start trigger** > Use esta Skill quando um cliente perguntar sobre o status de um pedido, envio, devolução ou reembolso da Shopify. Não a use para recomendações de produtos, dúvidas sobre checkout ou solicitações para alterar um pedido. **Step-by-Step instructions** 1. Peça ao cliente as informações necessárias para identificar o pedido. 2. Digite **/** e insira `find_orders` em **Integration · Shopify Admin**. Use essa ferramenta para encontrar o pedido correspondente. 3. Se nenhum pedido ou mais de um pedido corresponder, peça ao cliente informações adicionais de identificação. Não tente adivinhar a qual pedido ele se refere. 4. Insira e use `get_order` para o pedido correspondente. 5. Se o cliente perguntar sobre o envio, insira e use `get_order_fulfillments`. Use `get_fulfillment_events` quando precisar dos detalhes dos eventos de rastreamento. 6. Se o cliente perguntar sobre uma devolução ou um reembolso, insira a ferramenta correspondente. 7. Resuma somente as informações retornadas pelas ferramentas. Se uma ferramenta falhar ou a informação solicitada não estiver disponível, explique que não é possível confirmar o resultado e transfira a conversa quando apropriado. > [!NOTE] > > Os nomes das ferramentas acima aparecem no menu de comandos **/** depois que o Shopify Admin é conectado. Selecione os comandos nesse menu em vez de inserir os nomes como texto simples. ### 3. Testar antes de publicar No Preview, teste pelo menos estes casos: * Um pedido corresponde às informações do cliente * Nenhum pedido corresponde * Vários pedidos correspondem * Os detalhes de atendimento ou rastreamento não estão disponíveis * A ferramenta da Shopify retorna um erro * O cliente pede ao Agent para alterar um pedido, o que a integração somente leitura do Shopify Admin não pode fazer ## Criar um conector Custom API Use um conector Custom API quando quiser que uma Skill do AI Agent chame sua própria API HTTPS. Na aba **Custom API**, selecione **New data connector**. Você também pode pesquisar conectores Custom API existentes por nome e filtrá-los por status. ![Página completa Data connectors com pesquisa, filtros de status, conectores existentes e New data connector.](https://mintcdn.com/lchnan/6u8ntRayC38GXyQF/product-assets/english-help-context-2026-09-25/final-connector-list-annotated.svg?fit=max\&auto=format\&n=6u8ntRayC38GXyQF\&q=85\&s=1e69a488687c963b905ed5916ebd9b9c) Open AI Agent > Data connectors, then select New data connector. ### Nome e descrição Dê ao conector um nome que descreva sua função, como `retrieve_order`. Na descrição, explique quando o conector deve ser usado e o que ele retorna. ![Etapa About do conector de dados com os campos de nome e descrição destacados.](https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/connector-about-annotated.svg?fit=max\&auto=format\&n=gXEJIQXV2JH2VUQJ\&q=85\&s=a57c6777577f87f55494f26d51d28eb2) Describe the connector's purpose in About before configuring its API request. This draft has not been saved. ### Configurar a solicitação de API Insira o endpoint HTTPS e selecione o método da solicitação: * **GET** lê informações. * **POST** cria informações. * **PUT** substitui ou atualiza informações. * **PATCH** atualiza parte de um recurso. * **DELETE** remove informações. ![Etapa de conexão de API do conector de dados com o método HTTP e a URL destacados.](https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/connector-api-annotated.svg?fit=max\&auto=format\&n=gXEJIQXV2JH2VUQJ\&q=85\&s=5effb08c414cdb9ecc3bce86ed58e377) Choose the HTTP method and enter the endpoint URL. This incomplete draft has not sent a request. #### Cabeçalhos HTTP Selecione **Add header** e insira cada cabeçalho obrigatório como um par chave-valor. ![Formulário completo de conexão de API mostrando os cabeçalhos de solicitação Content-Type e Accept.](https://mintcdn.com/lchnan/6u8ntRayC38GXyQF/product-assets/english-help-context-2026-09-25/final-connector-headers-annotated.svg?fit=max\&auto=format\&n=6u8ntRayC38GXyQF\&q=85\&s=f23c6cb0a8f850aa38a904ed0d1900cf) Select Add header and enter each header as a key-value pair. This example has not been saved or sent. #### Corpo da solicitação Para solicitações que enviam dados, insira um corpo JSON válido contendo os campos exigidos pela sua API. ![Página do conector de dados rolada até o corpo JSON da solicitação POST.](https://mintcdn.com/lchnan/6u8ntRayC38GXyQF/product-assets/english-help-context-2026-09-25/final-connector-body-annotated.svg?fit=max\&auto=format\&n=6u8ntRayC38GXyQF\&q=85\&s=5099ae99db2d135e6253c53ecefb9937) Enter valid JSON in Request Body. This fictional order example has not been sent. ### Testar a resposta Selecione **Test request** para verificar se o conector retorna a resposta esperada. > [!WARNING] > > **O teste envia uma solicitação de API real.** Uma solicitação POST, PUT, PATCH ou DELETE pode criar, alterar ou remover dados. Sempre que possível, teste em um ambiente seguro ou comece com uma solicitação GET somente leitura. ![Etapa Test response com Test Request e um botão Set live desativado.](https://mintcdn.com/lchnan/6u8ntRayC38GXyQF/product-assets/english-help-context-2026-09-25/final-connector-test-entry-annotated.svg?fit=max\&auto=format\&n=6u8ntRayC38GXyQF\&q=85\&s=087754abdc3b082833f41e0822a3261c) Select Test Request to run the configured API call. No request has been run in this example. ### Ativar o conector Após um teste bem-sucedido, selecione **Set live**. Os conectores Custom API ativos podem ser selecionados no menu de comandos **/** das instruções da Skill. Para deixar de usar um conector Custom API, abra-o e selecione **Set to draft**, ou desative o status na lista de conectores. Revise e resolva todas as dependências listadas antes de movê-lo para rascunho. ![Lista completa de Data connectors com os botões Status dos conectores ativos existentes.](https://mintcdn.com/lchnan/6u8ntRayC38GXyQF/product-assets/english-help-context-2026-09-25/final-connector-status-annotated.svg?fit=max\&auto=format\&n=6u8ntRayC38GXyQF\&q=85\&s=36fb2456c31e1e068179cc06e978feed) Use the Status switch in the list to move a live connector to draft. The switches shown here have not been changed. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.